home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Graphics / ViewILBM / ViewILBM.doc < prev    next >
Text File  |  1999-10-08  |  9KB  |  204 lines
  1. About ViewILBM 1.9
  2. ==================
  3. This is (yet another?) viewer program for picture files. But this one is
  4. special, for a number of reasons:
  5.  
  6.    * It shows only IFF-ILBM format picture files. And it can handle all
  7.      popular variants and formats.
  8.  
  9.    * Unlike many other IFF-ILBM viewer programs, this one was specifically
  10.      written for graphics cards, using the CyberGraphX API (which is also
  11.      supported by the Picasso96 software); it does not run on a plain Amiga.
  12.      While this sounds like a disadvantage, it allows you to view HAM8
  13.      pictures on an ECS Amiga.
  14.  
  15.    * This program supports colour cycling.
  16.  
  17.    * Unlike other picture viewers, this program will try to display all
  18.      pictures in the correct aspect ratio. On a graphics card, every
  19.      pixel is square, yet there are IFF-ILBM pictures which require
  20.      pixels that are twice as wide as they are tall (or twice as tall
  21.      as they are wide).
  22.  
  23. And of course, there are the control options this program offers and the
  24. source code is included, too.
  25.  
  26. How to use it?
  27. ==============
  28. ViewILBM runs both from Shell and from Workbench. In both cases it responds
  29. to the same set of options, only that with the Shell version you enter
  30. them on the command line and with the Workbench you put the options into
  31. icon tool types.
  32.  
  33. To view an IFF-ILBM file, just enter "viewilbm" and the name of the file to view,
  34. then hit the [Return] key and watch how the picture comes to the screen.
  35. The options and command line parameters are as follows:
  36.  
  37. FILES/M/A
  38.  
  39.    The names of the files to show; instead of a files you can also specify
  40.    the names of a drawers to scan for IFF-ILBM files. And furthermore, you can
  41.    also use wild cards in place of the full file names.
  42.  
  43. CENTER/S
  44.  
  45.    This will centre the picture(s) to load inside the screen's dimensions.
  46.    This is particularly useful if you want to view several pictures without
  47.    having the screen reopened every time. Note that it is sometimes
  48.    inevitable to reopen the screen in a new resolution.
  49.  
  50. WAIT/K/N
  51.  
  52.    For a quick slide show feature, you can specify the number of seconds to
  53.    wait before the next picture is loaded.
  54.  
  55. QUIET/S
  56.  
  57.    This option will suppress any program output except for error
  58.    messages.
  59.  
  60. ALL/S
  61.  
  62.    This works like the "ALL" switch on the Shell "List" command. Just
  63.    point ViewILBM to a drawer and use the ALL option and it will descend
  64.    the entire filing system tree, displaying all IFF-ILBM files it finds
  65.    (and complain about every file it doesn't grok).
  66.  
  67. WAITAFTEROPEN/S
  68.  
  69.    Apparently, all modern multiscan monitors take a second or two to
  70.    resync after the display is reopened for a new IFF-ILBM picture. This
  71.    is your chance to introduce a small delay (in seconds) to wait
  72.    before picture decoding starts.
  73.  
  74. CYCLE/S
  75.  
  76.    Many pictures support a technique called "colour cycling" which is
  77.    often used for animation. ViewILBM supports both Deluxe Paint's
  78.    CRNG and GraphiCraft's CCRT colour cycling chunks. With this option
  79.    enabled, colour cycle will start immediately after the picture has
  80.    loaded (provided, of course, that the picture was stored with
  81.    colour cycling information attached). You can stop and restart
  82.    colour cycling at any time by hitting the [Tab] key.
  83.  
  84. HAM/S
  85. EHB/S
  86.  
  87.    These two switches work together and concern a feature (or rather,
  88.    the lack thereof) of "older" IFF-ILBM files. The original format
  89.    specification said nothing about the display mode to use for a
  90.    picture. That information was induced by the size and the number
  91.    of bit planes in a picture file. In this context, a picture with
  92.    six bit planes was expected to use the Hold-And-Modify format.
  93.    Still, some pictures exist which would use the Extra Halfbrite
  94.    format, giving no such indication. Once you saw the picture, you
  95.    would notice that something was wrong. By using the HAM and EHB
  96.    switches, you can tell ViewILBM to treat a picture with six
  97.    bit planes either as Hold-And-Modify format (HAM) or as
  98.    Extra Halfbrite format (EHB).
  99.  
  100. As said before, the program also works from Workbench: hold down any
  101. [Shift] key, single-click on every IFF-ILBM file icon to display, then
  102. double-click on the ViewILBM icon. You may put the tool types described
  103. above into either the ViewILBM icon or the ILBM file icons. Note that
  104. for the switches like CYCLE and CENTER you need to specify the option
  105. as ON or OFF, as in CYCLE=ON or CENTER=ON.
  106.  
  107. Unsupported IFF-ILBM features
  108. =============================
  109. The IFF-ILBM container format saw several enhancements during its career.
  110. New chunks were added, and not all of these are supported by this program.
  111. Unsupported are the PCHG, DRNG, DYCP/CTBL chunks and many others. I'm
  112. quoting these few since it could have made sense to support these, but due
  113. to lack of documentation and/or sample files I didn't choose to implement
  114. support for them. Not supported either are the GSPT and GSCC chunks as read
  115. and written by Accolade's "The Graphics Studio" since no public
  116. documentation exists which describes their format.
  117.  
  118. Requirements
  119. ============
  120. Any Amiga with OS 3.x, an '020 CPU and CyberGraphX/Picasso96 installed will
  121. do, but ViewILBM will refuse to display IFF-ILBM pictures if it cannot find a
  122. screen display mode to match it.
  123.  
  124. Historic notes
  125. ==============
  126. Listen up kids, here's something you probably didn't learn at school!
  127.    This program concerns itself with the perhaps oldest picture file format
  128. used on the Amiga, the so-called IFF-ILBM format. The IFF format itself is
  129. just a container for data, so there exist several variants which contain
  130. different data, such as the IFF-AIFF format which contains sound data
  131. instead of pictures. The IFF format specification was created back in 1985,
  132. so when the Amiga finally hit the market, it had a solid backing of
  133. standardized file formats used by the application software that existed back
  134. then. You simply couldn't find a program to paint and process pictures with
  135. that didn't support the IFF-ILBM format. Funny as it may sound today, the
  136. "professional" IBM-PC computing market of these days had to deal with a
  137. multitude of different file formats, each from a different vendor. Problems
  138. which the Amiga did not have.
  139.    Today the GIF, JPEG and TIFF file format fill the niches the IFF-ILBM
  140. format used to occupy. Up until the early 1990'ies the IFF-ILBM format was
  141. very popular on the Amiga and plenty of images exist which "modern" software
  142. cannot display properly. There's the problem of the pixel aspect ratio, for
  143. example. On the Amiga we have display modes in which a pixel is not exactly
  144. square; it can be twice as wide as tall (the so-called "low resolution
  145. interlaced mode") or twice as tall as wide (the so-called "high resolution
  146. mode"). The only display modes to offer square pixels are the so-called "low
  147. resolution mode" and the "high resolution interlaced mode". And even in
  148. these modes pixels are not exactly square, at least on NTSC machines, on
  149. which each "square" pixel is about 10% taller than wide. Only on PAL
  150. machines are pixels exactly square. If you show pictures with a non-square
  151. pixel aspect ratio on displays with a square pixel aspect ratio, the result
  152. may not look to pretty.
  153.    As a container format, IFF-ILBM has a few unique features with regard to
  154. how the picture is stored. For example, no other picture file format
  155. supports the Amiga typical Hold-And-Modify and Extra Halfbrite formats.
  156. These two were attempts to squeeze more colour out of the chip set, with
  157. Hold-And-Modify allowing 4,096 colours (262,144 on machines with the AGA
  158. chip set) to be displayed simultaneously which would have only allowed a
  159. maximum of 32 (256 on machines with the AGA chip set). Extra Halfbrite would
  160. have allowed 64 colours to be shown on a display that would have allowed
  161. only 32 (actually, only 32 colours could be used freely, the other 32
  162. colours were half as bright as the ones that could be freely used). This
  163. sure sounds strange today when every graphics card offers 256 or 16 millions
  164. of colours.
  165.    Another unique feature of the IFF-ILBM format is the use of a simple
  166. animation technique known as "colour cycling". With programs such as Deluxe
  167. Paint, GraphiCraft, Aegis Images, etc. artists could define ranges of the
  168. picture's colour palette which when cycled through would reveal otherwise
  169. hidden parts of the picture.
  170.    That concludes our brief tour of the IFF-ILBM format.
  171.  
  172. Sample files
  173. ============
  174. To make a point on how pictures are displayed by other programs and how
  175. they are displayed with this one I have included a small selection of sample
  176. images. These images were obtained from public sources, such as Fred Fish's
  177. Amiga Library disks or the NewTek Demo Reel #1. The images are:
  178.  
  179.    * ArtificialHeart
  180.  
  181.      Created by artist Jack Haeger using GraphiCraft. This picture is
  182.      stored in uncompressed format and supports colour cycling.
  183.  
  184.    * Knight1
  185.  
  186.      Created by artist Jim Sachs using Deluxe Paint (apparently, using
  187.      Deluxe Paint II). This picture uses a non-square pixel aspect
  188.      ratio (high resolution mode).
  189.  
  190.    * Clipper
  191.  
  192.      Created by the late artist Rick Parks. This picture uses a non-square
  193.      pixel aspect ratio (low resolution interlaced mode).
  194.  
  195.    * fashion
  196.  
  197.      One of the very early Hold-And-Modify format pictures, created using
  198.      NewTek's DigiView product.
  199.  
  200. Author
  201. ======
  202. This program was written by Olaf `Olsen' Barthel <olsen@sourcery.han.de>.
  203. Comments and bug reports are welcome. Use at your own risk.
  204.