home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / GRAPHICS / GIFTOOL / GIFLIB12.ZIP / DOC / GIF2HERC.DOC < prev    next >
Encoding:
Text File  |  1991-05-13  |  3.6 KB  |  83 lines
  1.             Gif2Herc
  2.             --------
  3.  
  4. Program to display images saved as GIF files on IBM PC Hercules graphic card.
  5.   The program has few stages as follows:
  6. 1. Reads GIF file header and determines size of it.
  7. 2. Dynamically allocate enough memory to hold all the image internally.
  8.    One byte per pixel is always allocated, so a little bit more than
  9.    width*height (of screen, not image) bytes are required.
  10. 3. Reads all the image in. Interlaced images are read correctly in, although
  11.    they are displayed sequentially.
  12. 4. Display first image using the defaults as set by the command line option.
  13. 5. Goes to interactive mode. For full description of the interactive mode
  14.    see below
  15.  
  16.  
  17. Usage:
  18. ------
  19.  
  20. Gif2Herc [-q] [-d DitherSize] [-z ZoomFactor] [-t BWThreshold] [-m Mapping]
  21.                             [-i] [-b] [-h] GifFile
  22.  
  23. If no GifFile is given, Gif2Herc will try to read stdin for GIF file.
  24.  
  25.  
  26. Memory required:
  27. ----------------
  28.  
  29. Screen.
  30.  
  31.  
  32. Options:
  33. --------
  34.  
  35. 1. [-q] : quite mode. Default off on MSDOS, on on unix. Controls printout
  36.    of running scan lines. Use -q- to turn off.
  37. 2. [-d DitherSize] : Sets size of dithering matrix, where DitherSize can be
  38.    2,3 or 4 only (for 2x2, 3x3 and 4x4 dithering matrices). Default is 2.
  39.    Note image will be displayed in this mode only if Mapping (see -m)
  40.    selected this mode.
  41. 3. [-z ZoomFactor] : Sets zoom factor of the image. Zoom factor should be
  42.    power of 2 up to 256. Default is 1 (no zoom).
  43. 4. [-t BWThreshold] : Sets threshold level for B&W mapping in percent.
  44.    This threshold level is used in the different mappings as selected via -m.
  45.    Default is 19%.
  46. 5. [-m mapping] : Select method to map colors to B&W. Mapping can be:
  47.    0 : Every none background color is considered foreground (white).
  48.    1 : 0.3 * RED + 0.59 * GREEN + 0.11 * YELLOW > BWThreshold is considered
  49.        white.
  50.    2 : Colors are mapped as in 1, and use dithering of size as defined using
  51.        -d option. BWthreshold is used here as scaler.
  52.    Default is option 0 which is much faster than the other two.
  53. 6. [-i] : Invert the image, i.e. black -> white, white -> black.
  54. 7. [-b] : Disable beeps. Every time image is complete, or wrong key was
  55.    presses, sound is generated. -b disables that.
  56. 8. [-h] : print one command line help, similar to Usage above.
  57.  
  58. Interactive mode:
  59. -----------------
  60.  
  61.   Once the image is displayed, the program goes into interactive mode
  62. which recognizes the following commands:
  63. 1. C - get Color and Position.
  64.      In this sub menu, a cursor appears, and the Color of the pixel the cursor
  65.    is on, with its position in GIF file screen are printed. The 4 arrows may
  66.    be used (shifted for faster movement) to move the cursor. Any other key will
  67.    abort this sub mode.
  68. 2. D - Zoom Down by factor of 2 unless current zoom factor is 1.
  69. 3. H - Increase dither matrix size, unless current size is maximum (4), were
  70.    size is set to minimum (2).
  71. 4. I - Invert the image, i.e. white -> black, black -> white.
  72. 5. M - increase Color -> BW mapping method, unless current method is maximum
  73.    (2), were method is set to minimum (0).
  74. 6. R - Redraw the image.
  75. 7. S - print Status of image and program.
  76. 8. U - Zoom Up by factor of 2 unless current zoom factor is 256.
  77. 9. 4 arrow keys can be used to pan to the desire direction, if the image
  78.    overflow to that direction. If, on the other hand, the image fit into the
  79.    Hercules device, arrow keys are ignored. The panning steps are 1/2 screen if
  80.    not on image end.
  81. 9. ' ' - Space bar may be used to abort current image drawing.
  82. 10. ESC - Escape key may be used to abort the program.
  83.