home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / viewgf12 / viewgf12.doc next >
Text File  |  1990-11-01  |  42KB  |  1,061 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             VIEWGIF (Version 1.2) 
  8.  
  9.                     Copyright 1990 by Craig S. Buchanan 
  10.          
  11.                                 SHAREWARE 
  12.  
  13. This program is copyrighted software. This program and its documentation may
  14. be freely copied and shared with others, as long as no charge is made, and the
  15. program and this document are unaltered. 
  16.  
  17. If you use this program please register by sending:
  18.     $20 U.S., check or money order OR
  19.     $20 Canadian, cheque or money order, OR
  20.     10 Pounds Sterling in Marks and Spencer's Gift Certificates,
  21. and any suggestions for improvements to the address listed below. Please
  22. specify the version number you are using (1.1). Your support will ensure that
  23. improvements are made. 
  24.  
  25.     4-319 Mackay St. 
  26.     Ottawa, Ont. 
  27.     K1M 2B7 
  28.  
  29.  
  30.                              First, a thank you.
  31.  
  32. This is a thank you to all of those users of VIEWGIF who have registered. Your
  33. support makes improvements like this release possible. Your feedback on
  34. VIEWGIF is invaluable. Without support VIEWGIF would still be at version 0.6.
  35. Note that if you are registered for a previous version of VIEWGIF you do not
  36. need to reregister for version 1.2. 
  37.  
  38.  
  39.                              Table of Contents: 
  40.     1.  WHAT'S NEW?                                                          1
  41.     2.  INTRODUCTION                                                         1
  42.     3.  FUNCTION OVERVIEW                                                    2
  43.         3.1 FILE - menu                                                      2
  44.         3.2 EDIT - menu                                                      3
  45.         3.3 MODE - menu                                                      5
  46.         3.4 Mouse Shapes                                                     7
  47.     4.  HOW TO USE VIEWGIF                                                   7
  48.         4.1 Guide to File Types                                              7
  49.         4.2 The COLOUR mode                                                  9
  50.         4.3 The GRAY mode                                                    9
  51.         4.4 The FL and CP8 formats                                          10
  52.         4.4 Use with SPECTRE 128/GCR                                        10
  53.         4.5 Overscan                                                        11
  54.     5.  KNOWN SHORTCOMINGS/BUGS                                             12
  55.     6.  ENHANCEMENTS UNDER CONSIDERATION                                    12
  56.     7.  PROGRAM HISTORY                                                     13
  57.     8.  REGISTRATION FORM                                                   17
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. 1.  WHAT'S NEW?
  65.  
  66.     1.  A Full Screen mode has been added.
  67.             The entire ST screen can now be used to display images. By simply
  68.             pressing the escape key the image in the top window will replace
  69.             the entire screen. This feature only works in Native ST
  70.             resolutions. (ie. Full Screen Mode does not work with Overscan or
  71.             large screen monitors.)
  72.  
  73.     2.  Degas and Neochrome save uses Full Screen Mode to preview.
  74.             The image being saved can be adjusted using the Full Screen Mode
  75.             controls. Selecting the final clipping of a large image is now
  76.             much easier. The save is unchanged when using non native ST video
  77.             modes.
  78.  
  79.     3.  Much improved IFF file loading.
  80.             Version 1.1 had trouble understanding many IFF files. Version 1.2
  81.             can read many more IFF files.
  82.  
  83.     4.  An Added Bonus. NeoDesk 3.0 Icons.
  84.             The included .NIC file contains icons for use with NeoDesk 3.0.
  85.             Icons are provided for most of the filetypes VIEWGIF uses. Note
  86.             that the NeoDesk 3.0 documentation claims that 3.0 icons cannot be
  87.             used with earlier versions of NeoDesk.
  88.  
  89.  
  90.  
  91. 2. INTRODUCTION 
  92.  
  93.     So what are GIF files and why should I be interested? GIF files are
  94. computer graphic images stored in a compressed, hardware independent manner.
  95. The hardware independent format makes it a standard for moving images between
  96. different computers. 
  97.  
  98.     VIEWGIF allows your ST to show graphics created on a PC, an Amiga, or
  99. whatever, even if the original image has more colours or pixels than the ST
  100. can display. It also allows you to convert your Atari ST images into GIF
  101. format for exchange with other systems.  
  102.  
  103.     VIEWGIF is GEM based and operates in all three resolutions. Images are
  104. displayed in scrollable windows. Once an image is loaded it can be saved in
  105. NEO, Degas , Macpaint (in Monochrome) or FL Format. The image can also be
  106. cropped and shrunk to fit the ST screen. VIEWGIF also allows a GIF image to be
  107. directly transformed into AIM (the Atari Image Manager) and Spectrum 512
  108. pictures. This allows the 512 colour Spectrum mode to be used to display 256
  109. colour VGA images. 
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                           1
  117.  
  118.  
  119.  
  120.  
  121.  
  122. 3. FUNCTION OVERVIEW 
  123.  
  124.     Most menu items have keyboard equivalents which are noted at the end of
  125. each menu item. A caret (^) denotes a control key while a small triangle
  126. denotes an alternate key. The equivalents are listed with their corresponding
  127. functions in the list below. 
  128.  
  129. 3.1  FILE - menu 
  130.  
  131.     GIF INFO: (ALT I) 
  132.         Given a GIF file it displays the image attributes including dimension,
  133.         number of colours, size of colour palette, etc. It also tries to
  134.         determine the image's original video format. 
  135.  
  136.     LOAD FILE... (ALT L)
  137.         Displays the file load form. Allows the following file types to be
  138.         loaded:
  139.             GIF (ALT G), IFF (ALT A), LBM (ALT B), MAC (ALT M),
  140.             NEO (ALT N), DEGAS (ALT D), FL (ALT F), CP8 (ALT P).
  141.  
  142.         The keyboard equivalents can be used to bypass the file type selection
  143.         form.
  144.  
  145.         The GIF, IFF and LBM  modes read in the file and then translate it to
  146.         the current ST format according to the options set in the MODE menu.
  147.         The two modes are COLOUR and GRAY. (See discussion of MODE.) 
  148.  
  149.         The DEGAS mode currently reads uncompressed (PI#) DEGAS only.
  150.  
  151.         The MAC mode will read and translate into the current resolution any
  152.         MacPaint or Mac StartUpScreen image. Determination of image type is
  153.         automatic.
  154.  
  155.         The CP8 mode always uses the dispersed dot dither to translate the
  156.         image into the current ST format regardless of the MODE options COLOUR
  157.         and GRAY. (See CP8 discussion in TRANSFORM.) The dispersed dot dither
  158.         MODE options HISTO and SCALED are used. (See MODE discussion.) If the
  159.         file contains more than one channel (image) the user will be prompted
  160.         for the channel to load. The channel number appears after the filename
  161.         in the window border enclosed in square parenthesis.
  162.  
  163.         Each image is displayed in its own window and each window has its own
  164.         colour palette. The top window's colour palette is always used. The
  165.         original image dimensions are maintained but the CLIP and SHRINK
  166.         functions can be used to reduce the image size. The title bar of each
  167.         window contains the image filename and the information bar contains a
  168.         description of the image colours along with the dimensions of the
  169.         image. If the image is in colour then the information bar contains
  170.         [a:b] where 'a' is the number of colours in the original image and 'b'
  171.         is the number of Atari ST colours. If the image is displayed in gray
  172.         scale then the information bar contains [a:b] where 'a' is the number
  173.         of colours in the original image and 'b' is the number of grays in the
  174.  
  175.                                           2
  176.  
  177.  
  178.  
  179.  
  180.  
  181.         image.
  182.  
  183.     SAVE FILE... (ALT S):
  184.         Displays the file save form. Allows the following file types to be
  185.         saved:
  186.             GIF (CTRL G), FL (CTRL F), NEO (CTRL N),
  187.             DEGAS (CTRL D), MacPaint, (CTRL M),
  188.             Mac StartupScreen (CTRL T).
  189.  
  190.         The current image (top window) is saved in the selected file type. The
  191.         keyboard equivalents can be used to bypass the file type selection
  192.         form.
  193.  
  194.         The DEGAS mode writes only uncompressed (PI#) DEGAS.  
  195.  
  196.         If a native ST video mode is being used the FULL SCREEN MODE is used
  197.         to preview and adjust the clipping of the image to be saved. (See
  198.         Section 3.3 - FULL SCREEN MODE). After adjusting the clipping (if
  199.         necessary) using the arrow keys press RETURN to save the image or
  200.         ESCAPE to cancel the save.
  201.  
  202.         When overscan or another non native ST video mode is used this full
  203.         screen view is not displayed. A window clipping function is provided.
  204.         (It is presumed that in these cases a full NEO or DEGAS picture will
  205.         fit inside a window making the preview unnecessary.)
  206.  
  207.         Save FL saves the entire image viewed in the current window regardless
  208.         of dimensions. The confirmation dialog allows an optional compression
  209.         routine to be used in saving the image. The use of the compression
  210.         routine adds only a small overhead to FL loading. The compression
  211.         routine used is a simple form of Run Length Encoding so only images
  212.         with large single colour areas will compress significantly. Dithered
  213.         images will usually not compress significantly.
  214.  
  215.     CLOSE: (ALT C) 
  216.         Closes the Top Window. 
  217.  
  218.     QUIT:  (ALT Q or CTRL C) 
  219.         Exits the program. 
  220.  
  221.  
  222. 3.2 EDIT - Menu.
  223.  
  224.     CLIP:  
  225.         Crops the current image at one of the four window boundaries. Simply
  226.         size and scroll the window to the correct place, select CLIP, and then
  227.         select the clipping corner. 
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                           3
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.     SHRINK: (ALT K) 
  242.         Halves the image size using one of three methods. LINEAR works best on
  243.         256 colour images while the two STAGGERED modes work best on 4 and 16
  244.         colour images where dithering/patterning has been used to simulate
  245.         more colours. Many EGA (an IBM graphic mode) images use a checkerboard
  246.         pattern to simulate more than 16 colours. A linear shrink of the image
  247.         will produce only one colour in the checkerboard, the staggered modes
  248.         are designed to preserve the colour dither.  
  249.  
  250.     COLOURS:  
  251.         Allows the Colour Palette of the Top Window to be edited. The modified
  252.         colours can be SAVED (stored with the window), USED (not stored with
  253.         the image but remain as the current colours), and CANCELLED. 
  254.  
  255.     DESKTOP: (Undo) 
  256.         Returns the colour palette to your desktop colours. To return to an
  257.         image's palette use COLOURS or make another picture the active (top)
  258.         window. 
  259.   
  260.     TRANSFORM ...: 
  261.         Allows a GIF image to be converted to either AIM, CP8[1], CP8[3] or
  262.         SPU (Spectrum uncompressed) without first being converted to screen
  263.         format. This allows the maximum of image data to be maintained. Colour
  264.         conversion is used to produce SPU and CP8[3] images, gray scale
  265.         conversion is used to produce the AIM and CP8[1] images.
  266.  
  267.         When converting an image to SPU that is larger than 320x199 the top
  268.         left hand corner of the image will be used.
  269.  
  270.         When converting to an AIM image both an .IM and a .HD file are
  271.         produced.
  272.  
  273.         When converting an image to CP8[1] a false gray routine will be used
  274.         if the image contains less than 256 colours. The false gray routine
  275.         tries to ensure that two colours with the same gray value are encoded
  276.         with slightly different gray values. The false gray routine is used to
  277.         prevent 16 colour images from becoming 4 gray level images.
  278.  
  279.         The translation to CP8[3] images is intended for 256 colour GIF images
  280.         but any GIF image will work. By default a CP8[3] image is interpreted
  281.         as containing the red image in channel 1, the green image in channel
  282.         2, and the blue image in channel 3. The multi channel CP8 format
  283.         allows up to 16 channels to be encoded.
  284.         NOTICE: GIF to CP8[3] conversion currently requires a great deal of
  285.                 memory and may result in a file three times as large as the
  286.                 original.
  287.  
  288.  
  289.         Why translate to CP8? The CP8 format is designed for 8 bit gray scale
  290.         images, 24 bit colour images and multi spectral images. It is a
  291.         hardware independent, compressed format like GIF but unlike GIF it can
  292.  
  293.                                           4
  294.  
  295.  
  296.  
  297.  
  298.  
  299.         be compressed in very little time and decompressed almost instantly.
  300.         The CP8 format trades a decrease in compression performance for a
  301.         large increase in decompression speed. The CP8 format also allows the
  302.         decompression routine to detect corrupted data while the GIF format
  303.         does not. (This is a small point as the picture will show any file
  304.         corruption dramatically.)
  305.  
  306.  
  307. 3.3 MODE - Menu.
  308.  
  309.     COLOUR:
  310.         When COLOUR is selected LOAD GIF, IFF and LBM translates the file into
  311.         a colour picture. This mode is obviously unavailable in monochrome
  312.         mode.
  313.  
  314.     GRAY:
  315.         When GRAY is selected LOAD GIF, IFF and LBM translates the  file into
  316.         a gray scale picture. This mode is preselected in monochrome mode.
  317.  
  318.     COLOUR OPTIONS...:
  319.         Displays the colour option form. The following selections are
  320.         available:
  321.             FREQUENCY, COLOUR SPACE, IGNORE NB.
  322.  
  323.         FREQUENCY:
  324.             When selected colours are chosen based on their frequency in the
  325.             image. This is the routine used in older versions of VIEWGIF.
  326.  
  327.         COLOUR SPACE:
  328.             When selected colours are chosen based on their frequency and
  329.             distribution in colour space.
  330.  
  331.         IGNORE NB:
  332.             Many monitors cannot display the darkest colours in the ATARI
  333.             colour palette. Selecting IGNORE NB prevents the darkest colours
  334.             from being used. This option is only used if COLOUR SPACE is
  335.             selected.
  336.  
  337.  
  338.     GRAY OPTIONS...:
  339.         Displays the gray option form. The following selections are available:
  340.             ORDERED, DISPERSED, HISTOGRAM, SCALED, ENHANCE.
  341.  
  342.         ORDERED:
  343.             Only available in monochrome mode. When selected an ordered dither
  344.             is used to convert the gray scale image into monochrome. (This
  345.             routine may be phased out in subsequent versions of VIEWGIF.)
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                                           5
  353.  
  354.  
  355.  
  356.  
  357.  
  358.         DISPERSED:
  359.             When selected a dispersed dot dither is used to convert the gray
  360.             scale image to 2, 4, or 8 shades of gray depending on the current
  361.             resolution. Takes longer than ORDERED but produces much better
  362.             results.
  363.  
  364.         HISTOGRAM:
  365.             When HISTOGRAM is selected all DISPERSED gray dithers use
  366.             histogram equalization to maximize the contrast of the resultant
  367.             picture. The HISTOGRAM alternative is SCALED. HISTOGRAM distorts
  368.             the gray scale linearity resulting in an artificial image.
  369.  
  370.         SCALED:
  371.             When SCALED is selected all DISPERSED gray dithers use scaling to
  372.             insure full gray scale coverage in the resultant picture. The
  373.             SCALED alternative is HISTOGRAM. SCALE preserves the gray scale
  374.             linearity resulting in a truer image than HISTO. Use SCALED if a
  375.             HISTOGRAM image appears "washed-out".
  376.  
  377.         ENHANCE:
  378.             When ENHANCE is selected an edge enhancement is applied to the
  379.             image before it is dithered. Use ENHANCE if the dithered image
  380.             appears blurry. The HISTO option should always be used with
  381.             ENHANCE to ensure good results. 
  382.  
  383.  
  384.     FULL SCREEN MODE:
  385.         The image in the top window replaces the entire screen. A set of
  386.         keypresses are then used instead of the GEM interface. The keypresses
  387.         are summarized in an instruction list which appears when the full
  388.         screen mode is entered. The supported keypresses of the entire screen
  389.         mode are:
  390.             Arrows:     Scroll Left, Right, Up or Down.
  391.             Shift Left Arrow:   Left Side.
  392.             Shift Right Arrow:  Right Side.
  393.             Shift Up Arrow:     Top.
  394.             Shift Down Arrow:   Bottom.
  395.             Esc:                Back to GEM!
  396.  
  397.         The full screen mode is only available when the ST is using a native
  398.         video mode. It is not available when using OVERSCAN or a large screen
  399.         monitor.
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                                           6
  412.  
  413.  
  414.  
  415.  
  416.  
  417. 3.4 MOUSE SHAPES
  418.  
  419.     A variety of mouse shapes are used to keep the user informed about system
  420.     progress. The mouse shapes translate as follows:
  421.         Diskette:           Reading or writing from disk,
  422.         Magnifying Glass:   Examining image,
  423.         Bench Vise:         Compressing or decompressing image,
  424.         Paint Brush:        Painting Screen Image,
  425.         Star:               Edge Enhancement.
  426.     The shapes correspond roughly to the programs current action. A large
  427.     exception is the GIF, IFF and LBM reads and writes which read/write,
  428.     decompress/compress, and sometimes paint all at the same time and is
  429.     represented only by the Diskette mouse shape.
  430.  
  431.  
  432. 4.  HOW TO USE VIEWGIF
  433.  
  434.     This section is intended to help you get the most from VIEWGIF.
  435.  
  436. 4.1 Guide to File Types
  437.  
  438.     The following file types are used by VIEWGIF:
  439.  
  440.     GIF: 'Graphic Interchange Format'.
  441.         A machine independent compressed graphic format.
  442.         Designed for Compuserve.
  443.         Max Colour Planes: 8 Bits (256 Colours)
  444.         Max Palette Size: 24 Bits (16777216 Colour choices)
  445.         Max size: 65536 x 65536.
  446.         May contain several images.
  447.         Typically: 320x200 or 640x480 in 16 or 256 colours.
  448.  
  449.     IFF: 'Image File Format?'.
  450.         Used on the Commodore Amiga.
  451.         Max Colour Planes: 8 Bits (256 Colours)
  452.         Max Palette Size: 24 Bits (16777216 Colour choices)
  453.         Max size: 65536 x 65536.
  454.         Typically: 320 x 200 in 32 colours.
  455.  
  456.     LBM: 'InterLaced BitMap?'.
  457.         Used by Deluxe Paint on the PC and Amiga.
  458.         Max Colour Planes: 8 Bits (256 Colours)
  459.         Max Palette Size: 24 Bits (16777216 Colour choices)
  460.         Max size: 65536 x 65536.
  461.         Typically: 320x200 or 640x480 in 16 or 256 colours.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.                                           7
  471.  
  472.  
  473.  
  474.  
  475.  
  476.     MAC: 'MACintosh file'.
  477.         Contains either a Macpaint picture (MPNT) or a Macintosh StartupScreen
  478.         (SCRN).
  479.  
  480.         MPNT: 'MacPaiNT'.
  481.             A compressed monochrome format used on the Macintosh.
  482.             Planes: 1 Bit (Monochrome)
  483.             Size: 576 x 720
  484.  
  485.         SCRN: 'startupSCReeN'
  486.             An uncompressed Macintosh screen image.
  487.             Planes: 1 Bit (Monochrome)
  488.             Size: 512 x 342
  489.  
  490.     FL: 'Fast Load'
  491.         An Atari format for arbitrary sized raster images.
  492.         Planes: 1, 2, or 4. (Monochrome, 4 Colour, 16 Colour)
  493.         Max Palette Size: 12 Bits (4096 Colours)
  494.         Max Size: 65536 x 65536.
  495.  
  496.     CP8: 'ComPressed 8 bit image'
  497.         A hardware independent format for arbitrary sized gray scale images
  498.         (CP8[1]),
  499.         24 bit colour images (CP8[3]) and multispectral images (CP8[n]).
  500.         Max Planes: 8 bit (256 gray levels)
  501.         Max channels (images): 16
  502.         Max Size: 65536 x 65536.
  503.  
  504.     NEO: 'NEOchrome'
  505.         Contains an Atari low-resolution, 16 colour screen.
  506.         Used by NEOchrome and countless other Atari paint programs.
  507.         Colour Planes: 4 (16 Colour)
  508.         Colour Palette: 9 Bits (512 Colours)
  509.         Size: 320 x 200.
  510.  
  511.     PI?: 'degas PIcture'
  512.         Contains an Atari screen in high, medium or low resolution.
  513.         Used by Degas, Degas Elite and countless other paint programs.
  514.         Colour Planes: 1, 2, or 4. (Monochrome, 4 Colour, or 16 Colour)
  515.         Colour Palette: 9 Bits (512 Colours)
  516.         Size: 640 x 400, 640 x 200, 320 x 200.
  517.  
  518.     SPU: 'SPectrUm picture'
  519.         Contains a Spectrum 512 uncompressed image.
  520.         Spectrum 512 allows the Atari ST to display 512 colours on screen at
  521.         once.
  522.         Colour Planes: 4 (16 Colours per Palette)
  523.         Colour Palette: 9 Bits (512 Colours)
  524.         Number of Palettes: 597 (3 Palettes per line)
  525.         Size: 320 x 199
  526.  
  527.  
  528.  
  529.                                           8
  530.  
  531.  
  532.  
  533.  
  534.  
  535.     IM and HD: 'Atari Image Manager and HeaDer files'
  536.         Contains a gray scale image in a hardware independent format.
  537.         The 'Atari Image Manager' allows the ST to be used for image
  538.         processing. Highly recommended. The colour AIM format is not
  539.         supported.
  540.         Planes: 8 (256 gray levels)
  541.         Max Size: 65536 x 65536
  542.         Typically 512 x 512 in 256 Gray Levels.
  543.  
  544.  
  545.  
  546. 4.2 The COLOUR Mode
  547.  
  548.     When loading an image in colour mode two situations can occur:
  549.         1.  the image can be displayed at the current resolution and
  550.         2.  the image contains more colours than can be displayed at the
  551.             current resolution.
  552.     In case 1 the image is simply loaded and displayed. In case 2 VIEWGIF must
  553.     choose colours with which to represent the image. VIEWGIF has two colour
  554.     choosing routines; FREQUENCY and COLOUR SPACE. If the image is
  555.     unsatisfactory with one routine try the other routine. A special mode of
  556.     COLOUR SPACE is IGNORE NB. Select IGNORE NB if your monitor cannot display
  557.     the darkest colours in the Atari Colour Palette. If IGNORE NB is selected
  558.     the COLOUR SPACE will not allocate valuable colour palette entries to
  559.     colours your monitor cannot display. You can tell an image has undergone
  560.     colour choosing when the number of colours in the information line are not
  561.     equal. (ie. [256,47] which stands for 256 original colours, 47 Atari ST
  562.     colours.)
  563.  
  564.     If an image has more colours than can be displayed try the 'GRAY' mode.
  565.  
  566. 4.3 The GRAY mode.
  567.  
  568.     When the GRAY mode is selected GIF, IFF and LBM images are converted to
  569.     gray scale images and then dithered. The gray mode is intended to be used
  570.     when the image cannot be accurately represented at the current ST
  571.     resolution. The gray scale dither allows much more image detail to be
  572.     preserved than when using the COLOUR mode.
  573.  
  574.     Monochrome users have a choice of two dithering routines:
  575.         ORDERED and DISPERSED.
  576.     The ORDERED dither uses fixed patterns to produce the artificial gray
  577.     levels. It is fast but produces relatively low quality images. The
  578.     DISPERSED dither uses error propagation to produce the artificial gray
  579.     levels. It takes much longer but produces much better images. The
  580.     dithering routine should normally be left on DISPERSED.
  581.  
  582.     The distribution of gray levels is adjusted to prevent images from being
  583.     too dark or too light. (ie. all black or all white). VIEWGIF supports two
  584.     methods for distributing the Gray Levels:
  585.         HISTOGRAM and SCALED.
  586.     The SCALED method distributes the gray levels evenly between black and
  587.  
  588.                                           9
  589.  
  590.  
  591.  
  592.  
  593.  
  594.     white ensuring full coverage of the artificial grays. The HISTOGRAM method
  595.     distributes the gray levels according to their image frequency ensuring
  596.     maximum contrast in the image. The HISTOGRAM method should always be tried
  597.     first. If the resulting image appears 'washed out' then the SCALED method
  598.     should be tried. (Images with large coloured borders often appear 'washed
  599.     out'.)
  600.  
  601.     VIEWGIF also allows edge enhancement to be performed on the image prior to
  602.     dithering. A natural result of dithering is a loss in image sharpness,
  603.     this loss can be alleviated by first enhancing the image. If the resulting
  604.     image is blurry try ENHANCE. The ENHANCE mode should normally be off as a
  605.     by product of edge enhancement is increased image noise. The distribution
  606.     method HISTOGRAM should always be used with ENHANCE to ensure adequate
  607.     gray coverage.
  608.  
  609. 4.4 The FL and CP8 formats
  610.  
  611.     Loading and translating large GIF images can take a long time. The
  612.     resulting picture often cannot be saved in NEO or DEGAS format without
  613.     losing much of the picture. The FL format was added to allow arbitrary
  614.     sized Atari format images to be loaded and saved quickly. The CP8 format
  615.     allows the gray scale equivalent of a GIF image to be loaded quickly.
  616.  
  617.     The FL format is perfect for large screen or overscan demos. Simply load
  618.     the GIF image once and save it as FL. The down side of these images is
  619.     that they can be quite large.
  620.  
  621.     The CP8 format is hardware independent and allows VIEWGIF to load a CP8
  622.     file at any resolution just like a GIF file. Unlike a GIF file a CP8 file
  623.     contains a gray scale image. Use the TRANSFORM... option GIF => CP8[1] to
  624.     convert a GIF image to a CP8 image. Once converted the image can be loaded
  625.     and dithered much more quickly than the original GIF image.
  626.  
  627.  
  628. 4.5 Use with SPECTRE 128/GCR
  629.  
  630.     Now that VIEWGIF reads and writes MacPaint images it is a natural for
  631.     moving monochrome pictures between your ST and your MAC. Degas images can
  632.     be saved as MacPaint and then loaded with any Macintosh paint program.
  633.     Likewise Macintosh Clip Art can be loaded and saved as Degas for use with
  634.     any Atari paint program.
  635.  
  636.     The MAC files produced by VIEWGIF are true MacBinaries. When moved to a
  637.     Macintosh using TRANSVERTER or a Terminal Program they will be recognized
  638.     and stored as true Macintosh files. (TRANSVERTER is the TRNSV452.PRG
  639.     program that comes bundled with SPECTRE.)
  640.  
  641.     TRANSVERTing a file requires an MFS diskette or hard drive partition.
  642.  
  643.  
  644.  
  645.  
  646.  
  647.                                          10
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.     To move your .MAC file to a Spectre/MAC disk with TRANSVERTER.
  655.         1. Run TRANSVER.PRG
  656.         2. Use 'Assign Drives' to point to source and destination drives.
  657.         3. Select 'ST->MAC'
  658.         4. Select the .MAC file
  659.             (TRANSVERTER will not ask for the Macintosh file type, it's in the
  660.             Macbinary.)
  661.         5. Answer 'Spectre or Mac' format if required.
  662.  
  663.     To move your MacPaint file to the ST with TRANSVERTER.
  664.         1. Run TRANSVER.PRG
  665.         2. Use 'Assign Drives to point to source and destination drives.
  666.         3. Select 'MAC->ST'
  667.         4. Select the Macpaint or StartupScreen file
  668.         5. Answer 'Spectre or Mac' format if required.
  669.  
  670.  
  671. 4.6 OVERSCAN
  672.  
  673.     VIEWGIF works with native STs as well as large screen monitors. In the
  674.     documentation for VIEWGIF 0.8 I noted that OVERSCAN could be used to
  675.     increase screen resolution. Several registered users asked what OVERSCAN
  676.     was so here is an explanation.
  677.  
  678.     OVERSCAN is a technique whereby the screen borders can be used for
  679.     ordinary screen display. This allows many more lines and rows to be
  680.     displayed on your existing monitor. To further increase the displayed
  681.     resolution the vertical and horizontal size or your monitor can be
  682.     adjusted. The largest increase in resolution comes when a multi-sync
  683.     monitor is used with the ST. The resolution is set with a simple program
  684.     called OVERSCAN.PRG in the AUTO FOLDER.
  685.  
  686.     My Atari Monitors display the following resolutions with OVERSCAN:
  687.         Low Resolution:     (320 x 200) Now 400 x 280
  688.         High Resolution:    (640 x 400) Now 672 x 480
  689.  
  690.     The increased resolution is compatible with the GEM desktop and any
  691.     properly written GEM applications.
  692.  
  693.     OVERSCAN requires TOS version 1.2 (MegaTOS) or version 1.4 and a simple
  694.     hardware patch. On a mega ST the patch is simply a switch
  695.     disabling/enabling a video line. The switch allows OVERSCAN to be
  696.     disabled/enabled at boot up. Older STs require an additional transistor.
  697.     Total cost in parts is less than $10.
  698.  
  699.     The complete procedure along with digitized images of the trace cuts to be
  700.     made (for several board versions) is contained in the file OVERSCAN.ARC
  701.     which is available on many BBSes. If you are thinking of installing
  702.     OVERSCAN please have a competent technician do the work. It involves
  703.     cutting a pair of traces on the ST motherboard. I had a local Atari store
  704.     service technician install mine.
  705.  
  706.                                          11
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.     The modification will void your warranty if you still have one. I take no
  714.     responsibility for OVERSCAN or its use. I have no connection with the
  715.     developers of OVERSCAN.
  716.  
  717.  
  718. 5. KNOWN SHORTCOMINGS/BUGS 
  719.  
  720.     A.  Window colours can still go to black on black on some images. This is
  721.         best fixed by remembering the DESKTOP colour menu key equivalent
  722.         (UNDO). 
  723.     B.  GIF decryption is slow, even in 'C'. Decrypting a GIF image is a
  724.         painful, bit-twiddling, CPU intensive process. The speed of this code
  725.         could be increased by using hand optimized assembler routines. Such
  726.         routines could be developed if user support warrants it. Alternatively
  727.         a "Fast VIEWGIF" may be offered to registered users.
  728.  
  729.  
  730. 6. ENHANCEMENTS UNDER CONSIDERATION 
  731.  
  732.     A.  Support 4096 Colour Mode of STE, TT and Modified ST. 
  733.         I am very interested in supporting the STEs colour palette but no one
  734.         has requested it!
  735.     B.  Load any NEO or Degas picture in any resolution.
  736.     C.  Add more support for AIM. (Atari Image Manager).
  737.             Add load AIM.
  738.     D.  Add any of the following GIF and non-GIF "TRANSLATE..." options:
  739.             translate IFF to GIF,
  740.             translate LBM to GIF,
  741.             translate CP8 to AIM,
  742.             translate AIM to CP8,
  743.             translate GIF to Colour AIM,
  744.             translate CP8 to GIF.
  745.         (Alternatively the program 'GRAY.PRG' which already includes many of
  746.         these features along with full gray-scale editing capability could be
  747.         released as SHAREWARE. (Before VIEWGIF gets too big.))
  748.     E.  Add load/save and translate support for TIFF images.
  749.     F.  Add load/save and translate support for IMG images.
  750.     G.  Load entire GIF images before decompressing them.
  751.             This would speed up the GIF load but it would also require as much
  752.             as twice the memory to work. 
  753.     H.  Add additional support for 24-bit colour CP8 images.
  754.             This would be in the form of two translate option:
  755.                 Translate 3 CP8 images into a 24-bit CP8 image.
  756.                 Translate a 24 bit CP8[3] to GIF.
  757.     I.  Add elementary paint functions.
  758.             This would turn VIEWGIF into a virtual screen paint program. (I
  759.             think VIEWGIF is big enough already but I think a separate virtual
  760.             paint program has merit.)
  761.     J.  Make the SHRINK size variable.
  762.             Allow the user to enter an arbitrary shrink ratio. ie. Shrink by
  763.             1/5, 2/3 etc. (Already available in 'GRAY.PRG'.)
  764.  
  765.                                          12
  766.  
  767.  
  768.  
  769.  
  770.  
  771.     K.  Add Compressed Degas format load/save. 
  772.     L.  Add Memory Lean GIF read option.
  773.             The Lean option would trade reduced memory requirements for a
  774.             reduction in image quality. 
  775.     L.  Add TT video mode support. (640x480x16, 1280x960x2, 320x400x256) 
  776.             I saw the TT for the first time yesterday (Oct. 31, 1990). I am
  777.             very interested in supporting the 256 colour mode but will wait
  778.             until it is requested.
  779.     M.  Add an AVERAGE option to the SHRINK routines.
  780.             An average routine would allow gray dithered images to be shrunk.
  781.             It would return an error message when given a colour image.
  782.     N.  Supply a separate GIFCLIP program with VIEWGIF.
  783.             GIFCLIP would allow a GIF image to be clipped or cropped and
  784.             possibly scaled and then saved without a loss in colour
  785.             resolution. 
  786.  
  787.     If you want to see any of these enhancements (or any of your own) simply
  788.     register and make a request. What would you find useful? Many of the
  789.     features added with each release came from requests.
  790.  
  791.  
  792. 7. PROGRAM HISTORY 
  793.  
  794.     0.6 First SHAREWARE release of VIEWGIF. 
  795.  
  796.     0.7 Fixed bugs due to differences between TOS 1.2 and TOS 1.1 [(c) 1985]. 
  797.         Low Res now works under TOS 1.1 [(c) 1985]. 
  798.         Neo/Degas save now works under TOS 1.1 [(c) 1985]. 
  799.         NOTE: VIEWGIF 0.6 worked under TOS 1.1 [(c) 1985] if key commands 
  800.               were used instead of menu items. 
  801.         WHAT'S NEW? - Changes in VIEWGIF 0.7. 
  802.         1. Low Res now works under TOS 1.1. [(c) 1985]. 
  803.         2. Neo/Degas save now works under TOS 1.1 [(c) 1985]. 
  804.         3. Slight rearrangement of menu items. 
  805.         4. Control, Alternate abbreviations changed in menu items. 
  806.  
  807.     0.8 Released February 25, 1990. 
  808.         1.  All "translate..." conversions now work. 
  809.             This includes CP8, AIM, and SPU. 256 colour GIF images can now be
  810.             converted to 256 gray scale AIM images for image processing using
  811.             the "Atari Image Manager". These gray scale images can also be
  812.             stored and viewed using the compressed CP8 format.
  813.         2.  Load CP8 option added. 
  814.         3.  Improved monochrome support.
  815.             A dispersed dot dither mode has been added. While the dispersed
  816.             dot dither is much slower than the ordered dither the results are
  817.             much better. The dispersed dot dither has two modes, scaled and
  818.             histogram equalization.
  819.         4.  Now supports OVERSCAN fully.
  820.             The OVERSCAN modification allows an ordinary Atari ST to display
  821.             an increased resolution screen in all three ST modes. When
  822.             activated OVERSCAN allows an entire Degas picture to be displayed
  823.  
  824.                                          13
  825.  
  826.  
  827.  
  828.  
  829.  
  830.             INSIDE A WINDOW. VIEWGIF looks great with OVERSCAN displaying full
  831.             320x200, 640x200 and 640x400 images inside GEM windows. Overscan
  832.             requires a very simple and inexpensive modification to your ST.  
  833.         5.  LOW and MED resolution option to display GIF colour images as GRAY
  834.             scale images.
  835.             Displaying a 256 colour GIF image on the ST's 16 or 4 colour
  836.             display involves a lot of compromise in the image quality.
  837.             Converting the image to a gray scale image and using an
  838.             intelligent dithering routine often results in much more image
  839.             detail being preserved. This can be most clearly seen in Medium
  840.             Resolution where the gray scale images are clearly superior to the
  841.             colour images.
  842.  
  843.     0.9 Released April 3, 1990.
  844.         1.  Support for multi-channel CP8 images added.
  845.             Multi channel CP8 allows 24-bit colour images as well as multi
  846.             spectral images (such as LANDSAT) to be encoded. The support is in
  847.             the form of an improved LOAD-CP8 facility and a new translate
  848.             option: GIF to CP8[3]. 
  849.  
  850.         2.  Dispersed dot dither is now nearly twice as fast.
  851.             The dispersed dot dither is compute intensive. It has been
  852.             rewritten for vastly increased speed.
  853.  
  854.         3.  Histogram Equalization has been repaired and improved.
  855.             Previous routine would occasionally display white regions as
  856.             black.
  857.  
  858.         4.  Load CP8 bug fixed.
  859.             CP8 files larger than 64K did not load properly.
  860.             (A user alerted me to this bug only a few days after the release
  861.             of version 0.8.)
  862.  
  863.         5.  Minor changes and improvements.
  864.             (In response to suggestions made by registered users.)
  865.             Image windows are opened full size. Almost all "ACTION CANCELLED"
  866.             dialogs have been removed. The full size window button now works
  867.             properly. More mouse shapes have been added.
  868.  
  869.     1.0 Released June 10, 1990.
  870.         1.  GIF read now nearly twice as fast as in previous versions.
  871.             The GIF read routine has been optimized for speed and is also more
  872.             robust than in previous versions. The GIF write is also faster.
  873.  
  874.         2.  "Fast Load" raster file format added.
  875.             Arbitrary size raster images can now be saved/loaded directly.
  876.             This file format allows a large GIF image to be converted once and
  877.             then saved in a form which loads very fast. Perfect for large
  878.             screen demos. The "FL" format includes a very fast, optional
  879.             compression routine to save disk space.
  880.  
  881.         3.  GIF binary read/write repaired.
  882.  
  883.                                          14
  884.  
  885.  
  886.  
  887.  
  888.  
  889.             The binary (monochrome) GIF read/write used in previous versions
  890.             of VIEWGIF did not conform to the GIF standard. (Only VIEWGIF
  891.             could read a binary GIF file created with VIEWGIF.) Binary GIF
  892.             files now load and save properly. 
  893.  
  894.         4.  Scaled Equalization has been repaired.
  895.             Previous routine would occasionally display white regions as
  896.             black.
  897.  
  898.         5.  Minor changes and improvements.
  899.             The file menu has been modified. 'Load Degas' has been replaced by
  900.             'Load PI#', where # = 1, 2 or 3. GIF save confirmation dialog now
  901.             contains window number. GIF information now displays interlace
  902.             flag.
  903.  
  904.     1.1 Released August 25, 1990.
  905.         1.  New file formats .IFF and .LBM added.
  906.             VIEWGIF is not just for GIF anymore! IFF and LBM files can be
  907.             viewed in colour or grayscale just like GIF files.
  908.  
  909.         2.  Support for SPECTRE 128/GCR users, can now WRITE MacPaint.
  910.             Monochrome users can now save in MacPaint or Mac StartupScreen.
  911.             These files are in "MacBinary" format, simply run through
  912.             TRANSVERTER to move to a Spectre or MAC disk. 
  913.  
  914.         3.  Mac StartupScreens can now be loaded.
  915.             VIEWGIF automatically determines if a .MAC file is a MacPaint
  916.             picture or a Mac StartupScreen and loads the file in any
  917.             resolution. (Would anyone like to see this feature when loading
  918.             NEO and Degas pictures?)
  919.  
  920.         4.  Gray Scale Edge Enhancement option added.
  921.             If the dithered image is blurry select the enhancement option and
  922.             reload. 
  923.  
  924.         5.  New colour selection routine added.
  925.             A new colour option menu allows the user to choose between the
  926.             previous colour selection routine and a new 'colour space'
  927.             routine. This routine is still being refined. An additional option
  928.             of the 'colour space' routine is the 'ignore near black' option.
  929.             If your monitor (like many) cannot display the darkest colours of
  930.             the Atari palette selecting 'ignore near black' will prevent them
  931.             from being used.
  932.  
  933.         6.  New file load and file save forms added.
  934.             The file menu list had become too long. Two new forms are in place
  935.             for selecting the load and save file types.
  936.  
  937.         7.  Gray Scale and Colour options are now in forms.
  938.             The forms are intended to be more self explanatory than the
  939.             previous menu entries.
  940.  
  941.  
  942.                                          15
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.     1.2 Released October 31, 1990. (Happy Halloween!)
  950.  
  951. GIF is a trademark (tm) of Compuserve Inc, an H&R Block Company.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.                                          16
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008. 8.  REGISTRATION FORM
  1009.  
  1010.  
  1011.     Remit to:   Craig S. Buchanan
  1012.                 4-319 Mackay St.
  1013.                 Ottawa, Ont.
  1014.                 Canada
  1015.                 K1M 2B7
  1016.  
  1017.     ----------------------------------------------------------------------
  1018.  
  1019.     Payment:    $20 U.S., check or money order                   __
  1020.  
  1021.                 $20 Canadian, cheque or money order              __
  1022.  
  1023.                 10 Pounds Sterling in Marks and Spencer's
  1024.                 Gift Certificates                                __
  1025.  
  1026.     ----------------------------------------------------------------------
  1027.  
  1028.     Version:    1.2
  1029.  
  1030.     Name:       ________________________________________
  1031.  
  1032.     Company:    ________________________________________
  1033.  
  1034.     Address:    ________________________________________
  1035.  
  1036.                 ________________________________________
  1037.  
  1038.                 ________________________________________
  1039.  
  1040.  
  1041.     ----------------------------------------------------------------------
  1042.  
  1043.     Comments / Suggestions:
  1044.  
  1045.                 __________________________________________________
  1046.  
  1047.                 __________________________________________________
  1048.  
  1049.                 __________________________________________________
  1050.  
  1051.                 __________________________________________________
  1052.  
  1053.                 __________________________________________________
  1054.  
  1055.                 __________________________________________________
  1056.  
  1057.                 __________________________________________________
  1058.  
  1059.  
  1060.                                          17
  1061.