home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 559b.lha / MonoHAM_v0.85 / MonoHAM.Doc < prev    next >
Text File  |  1991-09-27  |  11KB  |  270 lines
  1.                 M o n o H A M
  2.                  version 0.85
  3.             The IFF to monochome-HAM converter
  4.         for AMIGA computers with composite mono ports
  5.                   by Roman Thomas Valderrama 
  6.  
  7.               September 30, 1991
  8.         This program is NOT in the Public Domain.
  9.             Permission is hereby granted to freely distribute
  10.         this program as long as archive contents are intact
  11.         and unchanged.
  12.         
  13.              Program code is copyrighted  1991 by
  14.              by AV Systems;  All Rights Reserved.
  15.  
  16.     If you like this program; Use it!  I don't require a trial period
  17.     or some ludicrous requests like "Delete this program if you
  18.     use it for 2 weeks without sending money".  Go Ahead-  Play,
  19.     frolic- fold it into funny hats... Have fun! 
  20.  
  21. Archive contents:
  22.  
  23. MonoHAM.ReadMe        -    Make sure you've read this first.
  24. MonoHAM            -    The executeable
  25. MonoHAM.Doc        -    You're reading it  
  26. Gurth.iff        -    A picture showing what MonoHAM did.
  27.  
  28. DISCLAIMER: THIS PROGRAM IS PROVIDED "AS IS"; NO WARRANTIES ARE MADE
  29. REGARDING ITS USE.  ALL USE IS AT YOUR OWN RISK, AND NO LIABILITIES OR
  30. RESPONSIBILITY IS ASSUMED.
  31.  
  32. IN ENGLISH: Although it takes little knowledge more then common sense
  33. (something seriously wacko has to happpen to blow something up), all
  34. disclaimers apply.  If anything bad happens I'm not responsible!
  35. (And neither is AV Systems)
  36.  
  37. A QUICK INTRODUCTION (TRY THIS NOW!)
  38.  
  39.    CONNECTING MONOCHROME OUTPUT TO COMPOSITE INPUT
  40.  
  41.     1. Turn everything off.
  42.     2. Get an RCA cable (you could borrow the one that connect to
  43.        your audio ports if you don't have one laying around)
  44.     3. Connect one side of the cable to the MONO-OUT near the RGB port.
  45.     4. Connect the other side to the cable to the COMPOSITE-IN of
  46.        the monitor (On 1084 monitors this is labled CVBS/L on 
  47.        the back).  
  48.     5. Turn on the monitor.  Turn on your Amiga.
  49.     6. Press the CVBS/RGB switch on the 1084 monitor; the screen should
  50.        look the same but in black & white.  If the text looks a little
  51.        fuzzy on 1084 monitors then hit the CVBS/LCA switch on the back-
  52.        text should look clear in B&W.
  53.     7. Using a standard IFF viewer, take a look at Gurth.iff...
  54.        It should look like my pet skull I bought from Disneyland.
  55.        Notice his shadow in the background is very gradiant-- in
  56.        the normal 16 shades of grey it's banded badly-- but here
  57.        it's real smooth.  It's what's possible in the many levels
  58.        of grey you can get under MonoHAM.
  59.  
  60.  
  61. WHAT IS MonoHAM?
  62.  
  63. MonoHAM will allow you to view IFF, IFF-24, and RAW (explained below)
  64. pictures in what looks like hundereds of shades of grey; near-photographic
  65. B&W images without the need of dithering, custom hardware, or funny
  66. machine-code tricks.  All it needs is any Amiga with a Monochome-Output
  67. capability (all A500s, most A2000), and anything capable of composite
  68. input (Expensive TV's, any VCR, Commodores 1084, any old Apple II monitor,
  69. Video Toasters, DCTV, Digi-View, 'snapshot' video-thermal transfers, ect)
  70. although the easiest way would be to have/use another monitor.  Paper-white
  71. monochrome would be best.
  72.  
  73.  
  74. WHAT IT CAN DO:
  75.  
  76. MonoHAM will read and convert any IFF-ILBM (most IFF picture files) to it's
  77. monochome HAM equivalent.  Although it'll look like a colorful mess in
  78. RGB color, the composite mono-out will give an accurate representation of the
  79. same picture in it's luminance (B&W) intensity.
  80. MonoHAM will read standard IFF (including HAM & EHB), IFF-24 with CMAP
  81. (color palette - up to 256 colors or greyscale), IFF-24 'pure', and a 
  82. special RAW format that I've made.  
  83. MonoHAM will save the HAM image as normal IFF-HAM; for use with HAM paint
  84. programs/animators and most Amiga IFF picture viewers.  There are no
  85. special considerations in a saved MonoHAM picture; it's just a typical
  86. IFF-HAM picture (the trick is to just use the composite monochome output)
  87. One useful application is creating a B&W animation from a series of
  88. MonoHAM pictures, since each picture can be pretty close to B&W video.
  89.  
  90.  
  91. WHY MonoHAM --- Why I made it;
  92.  
  93. Thanks to wonderful Commodore quality control, My 1084S RGB monitor blew up
  94. 2 weeks after buying it-  My dealer was nice enough to replace it, but in
  95. the mean time I noticed the composite Mono out at the back of my A500. 
  96. Never to pass up an oppertunity, I plugged my old Apple II monitor into it-
  97. and there it was; a black & white Amiga.  Although using an Amiga in B&W
  98. seemed sacralige, I noticed that I was getting a lot more then 16 shades of
  99. grey; in fact, the manual stated "4,096 shades of grey" using the composite
  100. mono port.  I later found this to be an exaggeraton-- after some
  101. calculations and mulling over, I found 150 shades of grey was a more
  102. accurate number;  most of the RGB shade combinations are repeated shade
  103. values.
  104. Anyways, I found that this is a cheap and effective way to gets tons of
  105. greyscale without the resorting to some of those elaborate graphic enhancers
  106. out today.
  107.  
  108.  
  109. HOW TO USE:
  110.     MonoHAM [<switches>] <source-file> [<destination-file>]
  111.  
  112.     Switches:
  113.         -r    RAW format: 320x200             (See below)
  114.         -i    RAW format: 320x400 interlaced  (See below)
  115.         -l    Lighten picture by 1/3rd
  116.         -x    Don't use palette colors
  117.         -a    Antialienise/Smoothen pixels
  118.  
  119. Note that if a destination-file isn't given, you must press [ESC] to
  120. clear the picture.
  121.  
  122. THE RAW FORMAT: 
  123.     The raw format is pretty simple.  It's just a collection of
  124. unsigned integers ranging from 0 to 65535 (0x0000-0xFFFF) and kept in a
  125. 320x200 (128,000 byte) or 320x400 (256,000 byte) file.  For those who
  126. aren't sure, an unsigned integer is a two-byte value, in most-least
  127. (MSB/LSB) order.  The file is read in from the top down; sweeping left to
  128. right... this is the easiest and most obvious form of storing a raw raster
  129. picture file.  The reason I implimented this is so that anyone can make
  130. a program for creating/displaying pictures in the MonoHAM format.
  131.  
  132.            320    
  133.     o------->     Integers are lined up this way---> 
  134.     | 2 BYTE|    First from left to right
  135.     |INTEGER|    Then down 1 line and left to right again.
  136.     V-------+    -- until all lines are done.
  137.        200 lines  (400 interlaced)
  138.  
  139. - WORTHLESS TECHNICAL NOTE -
  140. I'm using a integer scale (0-65535) instead of a byte scale (0-255) because
  141. the luminance accuracy is dependant on a fractional basis; this is to
  142. derive the 'best-fit' out of 150 shades of grey from 256 shades...
  143. Originally I was going to use a floating point algorithm but found that
  144. it would be unbearably slow; so instead I just used an integer math
  145. expression and just 'overscaled' it a bit.
  146.  
  147.  
  148. OTHER SWITCHES
  149.     -l    Lighten picture;
  150.         There is pretty much for printing pictures; most printer
  151.         drivers (especially preferences) tend to print picture
  152.         files too dark.  In order to 'loosen' some of the darker,
  153.         more subtle contrasts, I've put this switch in to 
  154.         lighten them up during the conversion.
  155.  
  156.     -x    Don't use palette colors
  157.         You'll probrobly never need to use this, but I've found
  158.         some interesting color results by not using the normal
  159.         palette and just use HAM pixels.  It's more of an
  160.         art effect (like image processing) then a needed 
  161.         technique-  Useful for whatever.
  162.  
  163.     -a    Antialias/Smoothen picture.
  164.         This will weigh each pixel with the one next to it and
  165.         reduce the contrast between them.  This works best with
  166.         heavily dithered IFF pictures, making it look softer and
  167.         less 'dithery'.  The reduce in contrast will give digitized
  168.         pictures a 'soft' look.
  169.  
  170.     -f    Print order form form to printer (PRT:) device.
  171.         This is only 1 page long so don't get too anxious.
  172.         (Make sure printer is online and ready though!)
  173.     
  174.     Donate however much you feel, but donations $20 or more will
  175.     receive the latest revision of MonoHAM.  (Most likely with
  176.     some of the features I'm either working on or considering below) 
  177.  
  178.  
  179. EXAMPLES OF USE:
  180.  
  181. 1> monoham barb.iff barb.mham
  182.     This will convert and display "barb.iff" onscreen, and then
  183.     save it as an IFF-HAM image "barb.mham".
  184.  
  185. 1> monoham -l raytrace.24
  186.     This will convert and display "raytrace.24" with a
  187.     lightend effect.  Since no save name was given, the picture will
  188.     be displayed until you press [ESC].   This is useful for doing
  189.     a screen dump to printer (using WorkBench GraphicDump).
  190.  
  191. 1> monoham -a fred.iff fred.mham
  192.     This will convert and display "fred.iff", using the antialias/
  193.     smoothen feature, and then save it as IFF-HAM image "fred.mham".
  194.  
  195. 1> monoham -r -a objects things.mham
  196.     This will convert the 320x200 RAW file "objects", utilizing
  197.     antialias/smoothing- and then save it as "things.mham".
  198.     
  199. 1> monoham -p
  200.     This will print out your donation form.
  201.     It's only 1 page -- Make sure your printer is ready!
  202.  
  203. USE LIMITS:  version 0.85
  204.     LOADS FROM:
  205.         IFF, IFF-24, IFF-HAM, and IFF-EHB:
  206.         (Note that Digi-View 4.0 saves RAW as IFF-24)
  207.         Lo-res images up to 368x480
  208.         Hi-res images up to 738x480 (MonoHAM converts them to lo-res);
  209.     SAVES AS:
  210.         IFF-HAM (uncompressed)
  211.     
  212.  
  213. FOR BEST RESULTS WITH DIGI-VIEW GOLD 4.0
  214.  
  215. Have Digi-View digitize with no color.  Set the Camera scan rate option
  216. to "Slow/Color Camera", and turn off dithering.  Digitize your picture.
  217. Save picture using "Save RAW" (which is actually save IFF-24 for DV Gold 4.0).
  218.  
  219. View/Convert your saved picture using MonoHAM;  That's it!
  220. Note that DV tends to save RAW IFF-24 a little dark; see below
  221.  
  222. THE MORE REASONS TO DONATE 20 BUCKS DEPARTMENT:
  223.  
  224. WHAT'S IN STORE FOR THE FUTURE: (in most to least order of possibility)
  225.  
  226.     * Faster, more accurate conversion algorithm.  I'm already 
  227.       working on this one.
  228.  
  229.     * Shade-corrected Digi-View 4.0 RAW IFF support.
  230.       DV4 seems to save RAW IFF's in a lower scale then IFF-24;
  231.       (like 0-192 shade values instead of 0-255)...    This
  232.       makes the pictures a little darker then how they should appear.
  233.       A little experimentation and I'll fix this easy..
  234.  
  235.     * Saving Compressed HAM pics.  I had a little trouble with my
  236.       ILBM compression routine, so I had it disabled-- No problem to
  237.       re-enable after I fix it.
  238.  
  239.     * Conversion that doesn't use a custom screen, thus
  240.       freeing up CHIP RAM and utilizing FAST RAM only.  This is easy.
  241.  
  242.     * Direct-read of other formats; GIF, RAW RGB (Sculpt) files.
  243.  
  244.     * Direct-write of IFF-8 Greyscale (256 grey); maybe GIF.
  245.  
  246.     * A better printer dump program.  Although the -l option lightens
  247.       the picture enough to produce an decent printout, the system
  248.       Preferences driver does a horrible job with MonoHAM pics.
  249.       It seems that PrefDriver only sees 16 shades of grey-- not the
  250.       150 shades you'll see onscreen.  The only way I could fix this
  251.       is to make my own custom print-dump program.  Of course, since
  252.       the Amiga OS is catered to device-independance, my print dump
  253.       program would work with any graphics-capable Preferance printer.
  254.         
  255.     * A gadget freaked moused out Intuition Based user interface. 
  256.       This is a good and bad; while an Intuition based program offers
  257.       ease of use, CLI-based programs offers flexability and low memory
  258.       consumption.  Actually the best way would be to use ARexx- but
  259.       I don't have ARexx, and most everybody I know dosn't have it either.
  260.  
  261.     * Depending on how much intrest this program creates,
  262.       possibly a Paint program based on it (Mono-Paint?). 
  263.       I can't imagine this being a really special project as far
  264.       paint programs go, but the features I would make would be
  265.       concentrated on real-world monochomatic drawing effects such 
  266.       as charcoal, pencil, lead, eraser blurs, ink blots, paper burns ect.
  267.       This is undoubtedly the heaviest project to consider, so don't
  268.       count on me doing it.
  269.  
  270.