home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / graphvew / gif3210a.arj / README.TXT < prev   
Text File  |  1993-04-04  |  7KB  |  187 lines
  1.                   ********************************
  2.                   GIF32 Version 1.00a (1993/04/05)
  3.                   ********************************
  4.  
  5.                        (c) 1993 Joel Armengaud
  6.                          All rights reserved
  7.                                    
  8.                                    
  9.                                    
  10.                                    
  11. ************
  12. Introduction
  13. ************
  14.                                    
  15.      This package is a 32bit GIF viewer, for OS/2 2.x. The user
  16. interface is a Presentation Manager program, but the viewer itself is
  17. a full-screen program, using the Base Video Handler services
  18. (BHVxxx.DLL). It supports all SVGA adapters correctly detected by the
  19. OS/2 SVGA.EXE program. On other adapters, only the 320x200x256 mode
  20. will be available.
  21.                                    
  22.      Files in this package:
  23.  
  24.                          gif32.exe
  25.                          giffs.exe
  26.                          readme.txt
  27.  
  28.      
  29.      I am distributing this program as FREEWARE. However I will
  30. greatly appreciate any donation.
  31.  
  32.  
  33. *******
  34. Author:
  35. *******
  36.  
  37.      Joel Armengaud
  38.  
  39. E-Mail:    joe2@vnet.ibm.com     (Not valid after 1993/05/31)
  40.            joe@cti.ecp.fr        (Not valid after ????)
  41.            100030.152@compuserve.com (Checked infrequently)
  42.  
  43. Mail:      Joel Armengaud
  44.            Le Grand Lot
  45.            13720 Belcodene
  46.            FRANCE
  47.      
  48.      
  49.      
  50.      
  51. **********
  52. Disclaimer
  53. **********
  54.  
  55.      BY INSTALLING THIS PROGRAM ON YOUR SYSTEM YOU INDICATE YOUR
  56. AGREEMENT TO THE FOLLOWING TERMS AND CONDITIONS. IF YOU DO NOT AGREE
  57. TO THEM YOU ARE NOT ALLOWED TO USE THIS PROGRAM.
  58.      THIS PROGRAM AND DOCUMENTATION ARE DISTRIBUTED AS IS. JOEL
  59. ARMENGAUD (THE AUTHOR) MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR
  60. IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY OR
  61. FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THIS SOFTWARE AND
  62. DOCUMENTATION. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES,
  63. INCLUDING LOST PROFITS, LOST SAVINGS, OR ANY OTHER INCIDENTAL OR
  64. CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR THE INABILITY TO
  65. USE THIS PROGRAM, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
  66. POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  67.  
  68.  
  69.  
  70.  
  71. ************
  72. Installation
  73. ************
  74.  
  75.      Quite easy! Just put the 2 .EXE files in the same directory, not
  76. necessarily in your PATH. The program to launch is GIF32.EXE.
  77.  
  78.  
  79.  
  80. ***********
  81. Using GIF32
  82. ***********
  83.  
  84.      When you start GIF32.EXE, a PM window will show all *.GIF files
  85. found in the current directory. One GIF file per line. If you want to
  86. see a GIF file, double-click on the filename, or put the cursor on the
  87. line and press Enter.
  88.      The file will be decompressed by another thread into main memory.
  89. When completed, this memory bitmap will be sent to the full-screen
  90. viewer, GIFFS.EXE (which is automatically started by GIF32.EXE). The
  91. full-screen session is then put into the foreground.
  92.      
  93.      Keystrokes available in the full-screen session:
  94.      
  95.      F9/F10    Decrease/Increase video resolution.
  96.      
  97.      Except for the 320x200x256 mode, available resolutions are read
  98. from the \os2\svgadata.pmi file, created by SVGA.EXE. Please be sure
  99. that SVGA support is installed on your system (refer to the OS/2
  100. documentation). The svgadata.pmi file is searched in your DPATH. Note
  101. that only 256-color modes will be used to display pictures, even for
  102. 16-color GIF files. When you first select a picture, the full-screen
  103. viewer will choose the lowest resolution large enough to display the
  104. whole picture.
  105.      
  106.      ESC       Return to the PM interface.
  107.      
  108.      Arrows              To scroll the picture if resolution and
  109.      PageUp/PageDown     image size do not match.
  110.      Home/End
  111.      
  112.      F11/F12   Display previous/next GIF file, without having to
  113. switch to the PM interface. For keyboards without F11/F12, you can
  114. also use 'P' and 'N' keys.
  115.      
  116.      About the PM interface:
  117.      
  118.      In the main PM window, each line is associated to a GIF file. A
  119. '*' in the first column indicates that the GIF file has already been
  120. decompressed into memory. A red '*' means that it is currently being
  121. decompressed.
  122.      GIF32 uses a multi-thread design, to save you time by reading and
  123. decompressing the file ahead of time. By default, it always tries to
  124. have 2 GIF files decompressed, the current one and the next one. This
  125. look-ahead value can be modified using the "Look-ahead.." choice of
  126. the "Options" menu. Before increasing the value, be aware that picture
  127. buffers consume system memory. For instance 8 800x600x256 GIF files
  128. will use as far as 3750Kb of main memory!
  129.      The "Loop" option will allow you, when selected, to consider the
  130. list of GIF files as a circular list, when moving with F11/F12 in the
  131. full-screen session.
  132.      By default the main client window will use system colors for
  133. listboxes. Due to a bug in some early OS/2 versions, background and
  134. foreground text colors may both be black! Should this happen, de-
  135. select the "System colors" choice in the "Options" menu.
  136.      The "Video modes" sub-menu will allow you to see the 256-color
  137. modes found in the SVGADATA.PMI file, and to disable some of them if
  138. they do not work.
  139.      To change the current directory, choose the "Open..." menu, and
  140. select a new GIF file in another directory. Warning! Due to a bug in
  141. the WinFileDlg API, each time you change the current directory, memory
  142. will be allocated and only released when you close GIF32. This bug is
  143. in 2.0, 2.0+ServicePack and 2.1beta 6.479 and 6.498. I hope I have
  144. reported it soon enough to have it fixed in the 2.1 GA version.
  145. Meanwhile, avoid using "Open..." too often without closing GIF32.
  146.      
  147.      
  148.      Note: depending of the version of OS/2 you are using (2.0,
  149. 2.0+ServicePack, 2.1,...) you may have problems with the library
  150. containing the low level screen routines (BVHSVGA.DLL), if you leave
  151. the full-screen session using Ctrl-Esc or Alt-Esc. To avoid this,
  152. always leave the full-screen session using the ESCape key. When you do
  153. so, GIFFS.EXE will go back to text mode before leaving the session.
  154. Besides, it will save memory, since BVHSVGA.DLL will not have to
  155. allocate a full video buffer to save the picture.
  156.      
  157.      
  158.      Note: the module GIFFS.EXE needs I/O priviledge. So please check
  159. that you have IOPL=YES in your CONFIG.SYS (or if you choose to list
  160. all the IOPL modules, add GIFFS to the list).
  161.  
  162. *******
  163. History
  164. *******
  165.  
  166. v1.0   1993/02/15 First release
  167.  
  168. v1.0a  1993/04/05
  169.  
  170.      New method to parse SVGADATA.PMI, to support the new format of
  171.      the OS/2 2.1 March beta.
  172.      
  173.      Added support of Cirrus chips GD5422, GD5424 and GD5426 (not
  174.      tested, because of the lack of Cirrus adapter!).
  175.      
  176.      Fix a problem with the name of the GIFFS.EXE module (was 'MAIN'
  177.      instead of 'GIFFS'). This was a problem with the IOPL statement
  178.      of the CONFIG.SYS.
  179.      
  180.      The Home/End/Pageup/Pagedown keys should now work on all
  181.      keyboards. Added 'P' and 'N' keys for keyboards without F11/F12.
  182.      
  183.      Added the 'Video modes' sub-menu, to disable selected modes.
  184.  
  185.  
  186. End of README.TXT file.
  187.