home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro194 / giffie.doc < prev    next >
Encoding:
Text File  |  1992-10-15  |  7.0 KB  |  207 lines
  1.  
  2.  
  3. The complete GIFFIE package contains the following files. 
  4.  
  5. GIFFIE.EXE 
  6. GIFFIE.DOC 
  7. GIFFIE.DVR 
  8. HPGL.EXE   
  9.  
  10.  
  11. GIFFIE may be distributed freely, as long as it is distributed for 
  12. free. If you find GIFFIE useful, please send a contibution ($5.00 
  13. would be nice) to: 
  14.  
  15.                     Pat Klepper 
  16.                     60 Luster Dr. 
  17.                     Batesville, Ar 72501 
  18.  
  19. If you don't find GIFFIE useful, by all means delete it from your 
  20. machine, and don't waste your valuable disk space. 
  21.  
  22.  
  23.  
  24. GIFFIE.DOC 
  25. PAGE 1 
  26.  
  27.  
  28. Thanks for using GIFFIE, and for the $5 contribution you have surely 
  29. sent by now. GIFFIE was written to support the hardware I have, or 
  30. in reality, the hardware I use (It belongs to the company I work 
  31. for). It supports GIF viewing on plain vanilla VGA's, which most users 
  32. probably have, and printing on a HP PaintJet, which some are lucky 
  33. enough to have. You can print GIF's even if you don't have VGA.
  34.  
  35. Since GIFFIE is for this specific hardware, I think you will find it 
  36. quite easy to use. Hopefully, the user interface is intuitive enough, 
  37. that it will require only a little documentation. I like programming, 
  38. but documentation isn't nearly as much fun. 
  39.  
  40.  
  41.  
  42. USING GIFFIE 
  43.  
  44. To run GIFFIE simply type GIFFIE. It will find all of the *.GIF files 
  45. in the current directory, create/update a file GIF.DTA, and then 
  46. display the following menu. GIFFIE is limitted to 254 files per 
  47. directory, and will stop searching at this limit.
  48.  
  49. Show  Print  Directory  Info  Options  Mode  Quit 
  50.  
  51. Make your choice by highlighting a selection and pressing enter, or 
  52. pressing the first character, or by moving your mouse and pressing 
  53. the left button (in general left button=enter, right=escape). 
  54.  
  55.  
  56. SHOW 
  57.  
  58. This will provide a list of all the GIF's found, and will show 
  59. additional information about the selected GIF on the top line. To 
  60. view a single GIF simply select it and press enter. For a slide 
  61. show mark selection with the space bar, and then press enter to 
  62. start the show. The plus(+) key selects all, and the minus key(-) 
  63. deselects all. 
  64.  
  65.  
  66. PRINT 
  67.  
  68. This provides the same information as SHOW. The selected GIF will 
  69. be decoded into memory, and then printed to a HP PaintJet via LPT1. 
  70. I have also provided a driver for HPGL plotters. This function is 
  71. provided by an external program HPGL.EXE which must exist in the 
  72. same directory as GIFFIE. This is the same driver used by PLOTGIF, 
  73. so for more information, consult the PLOTGIF document. For info on 
  74. writing your own device driver keep reading. 
  75.  
  76. GIFFIE.DOC 
  77. PAGE 2 
  78.  
  79.  
  80. DIRECTORY 
  81.  
  82. This allows you to change to a new drive or directory. 
  83.  
  84.  
  85. INFO 
  86.  
  87. As far as I know, this very nice feature is unique to GIFFIE. This 
  88. allows you to enter a short description for each GIF. This description 
  89. along with the width, height, and number of colors for each GIF is 
  90. maintained in the file GIF.DTA. I find this very helpful when looking 
  91. for a specific GIF. 
  92.  
  93.  
  94. MODE  (SMART  MCGA  VGA) 
  95.  
  96. The SMART mode selects the screen mode based upon the resolution of 
  97. the GIF. This is the default mode. 
  98.  
  99. The MCGA mode always uses the 320 x 200 x 256 color mode. Great for 
  100. viewing 256 color gifs of ANY resolution. 
  101.  
  102. The VGA mode always uses a 640 x variable x 16 color mode. Not that 
  103. useful, but it was easy to program. 
  104.  
  105.  
  106. OPTIONS (REPLACE  ZIP (UP or DOWN)  FADE) 
  107.  
  108. The REPLACE mode simply moves the GIF to the screen as quickly as 
  109. possible. 
  110.  
  111. The other "fun" modes work only in MCGA mode. 
  112.  
  113.  
  114. QUIT 
  115.  
  116. Selecting QUIT forces you to view the ShareWare notice for a few 
  117. seconds, until you press escape. If this makes you feel guilty, then 
  118. send $5 to me, otherwise just close your eyes. 
  119.  
  120.  
  121. GIFFIE.DOC 
  122. PAGE 3 
  123.  
  124.  
  125. WHILE THE GIF IS DISPLAYED 
  126.  
  127. PICTURE ADJUSTMENTS 
  128.  
  129. Lighten the picture with the PLUS(+) key. 
  130. Darken the picture with the MINUS(-) key. 
  131. Correct the picture with the C key. 
  132. Preview the picture with the HP PainJet palette P key (toggle). 
  133.  
  134.  
  135. SCROLLING 
  136.  
  137. Pictures displayed in the MCGA screen mode can be scrolled around 
  138. by using the arrow keys, or with the mouse. To scroll with the mouse 
  139. press and hold the left button, and nudge the mouse in the direction 
  140. you want to scroll. Release the button to stop scrolling. 
  141.  
  142. Pictures displayed in VGA mode that have more than 480 lines can be 
  143. scrolled up and down with the arrow keys. 
  144.  
  145.  
  146.  
  147. GIFFIE was written in TURBO PASCAL, with some procedures written in 
  148. assembly with the TURBO ASSEMBLER - TASM. 
  149.  
  150. If you want to write a new device driver for GIFFIE, you will need to 
  151. read the following... 
  152.  
  153.  
  154. Program your driver in the language of your choice, but don't try to 
  155. hog too much memory. Add the name of your driver to the file 
  156. GIFFIE.DVR. Your driver must exist in the same directory as GIFFIE. 
  157.  
  158. GIFFIE will call your driver and pass the following via command line 
  159. parameters. 
  160.  
  161. NAME WIDTH HEIGHT COLORS SEG(PALETTE) OFS(PALETTE) SEG(IMAGE) OFS(IMAGE) 
  162.  
  163.  
  164. ----------------------------------------------------------------------- 
  165. Type 
  166.   palette:array[0..255][1..3] Of byte;  { R,G,B } 
  167.   { range of R,G,B is 0..63 }
  168. GIFFIE.DOC 
  169. PAGE 4 
  170.  
  171.  
  172. The IMAGE is found at the passed address in MCGA format, that's one 
  173. byte per pixel, either 320 or 640 bytes wide ... 
  174.  
  175. line0  byte1,byte2,byte3..(byte320) OR (byte640) depends on width. 
  176. line1    "     "     "        "           " 
  177.  
  178. ----------------------------------------------------------------------- 
  179. The HPGL driver, TURBO PASCAL, included with giffer accesses these 
  180. as follows. 
  181.  
  182.                                       { command line parms } 
  183.   giffilename:=paramstr(1);           { gif file name - no extension } 
  184.   val(paramstr(2),imagewidth,code);   { image width } 
  185.   val(paramstr(3),imageheight,code);  { image height } 
  186.   val(paramstr(4),colors,code);       { number of colors } 
  187.   val(paramstr(5),segment,code);      { pointer to the palette table } 
  188.   val(paramstr(6),offset,code);       { segment offset} 
  189.   paletteAddress:=ptr(segment,offset); 
  190.   val(paramstr(7),segment,code);      { pointer to the image } 
  191.   val(paramstr(8),offset,code);       { segment offset } 
  192.   imageAddress:=ptr(segment,offset); 
  193.                                       { move palette to local area } 
  194.   move(paletteAddress^,PaletteTable,SizeOf(PaletteTable)); 
  195.  
  196. ----------------------------------------------------------------------- 
  197. GIFFIE will decode images of up to 640 x 600, this takes a lot of 
  198. memory. If your driver doesn't have enough memory, remove any 
  199. memory resident programs and try again.
  200.  
  201.  
  202. UPDATES
  203.  
  204. 19-September-1989   Fixed GIF.DTA bug where GIF's deleted/added from the
  205.                     end of the list didn't update correctly.
  206.  
  207.