home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / graphic / qrt / qrt2gif.doc < prev    next >
Text File  |  1989-03-30  |  6KB  |  149 lines
  1. Quick Ray Trace to GIF file conversion program version 1.1
  2. 3-15-89  By Ron Harold
  3. CIS [73657,2746] (in the PICS forum please)
  4. Prodigy HMDG29A
  5.  
  6. What is it:
  7.         This program is used to convert the output of the
  8.         Quick Ray Trace (QRT) program and convert it to a file
  9.         meeting the Graphics Interchange Format (GIF)
  10.         standard.
  11.  
  12.         This program is intended to run on IBM compatible
  13.         computers.
  14.  
  15. How to use it:
  16.         After getting an output from QRT simply type:
  17.         QRT2GIF inputfile outputfile [options]
  18.  
  19.         inputfile is the COMPLETE name (with path and
  20.         extention) of the file created by QRT.
  21.  
  22.         outputfile is the COMPLETE name (with path and
  23.         extention) for the GIF file output
  24.  
  25.         options are switches that are explained in the
  26.         advanced section below.
  27.  
  28.         An example: QRT2GIF FILE.RAW FILE.GIF
  29.  
  30.         The GIF created will be up to 256 colors and the
  31.         same resolution as that created by QRT.
  32.  
  33. Advanced options:
  34.         The default method of operating is for the program
  35.         to find the most colors it can (up to 256) and then
  36.         attempt to "brighten" the picture up as much as
  37.         possible.  Two switches allow you to alter these
  38.         defaults.
  39.  
  40.         -cNNN  is the maximum number of colors to try for
  41.         you can specify any number you wish here and the
  42.         program will create a picture with no more than that
  43.         number of colors (it will go lower if the picture
  44.         does not have that many colors in it).  The GIF
  45.         standard requires the number of colors be a binary
  46.         value but this program will only fill in the number
  47.         of places you specify and will then create a GIF
  48.         with the other places blank.
  49.  
  50.         Example: QRT2GIF FILE.RAW FILE.GIF -C129
  51.                 Creates a GIF w/256 palette options but only
  52.                 the first 129 will be filled in.
  53.  
  54.         -sN is the maximum amount to brighten the picture by
  55.         on post processing (in bits).
  56.  
  57.         The file that is created by QRT contains values for
  58.         24 bits of color.  When we convert this to the 18
  59.         bits of VGA data it tends to be a little dim.  To
  60.         brighten things up QRT2GIF shifts all the values as
  61.         much as possible to their brightest values. If you
  62.         wish to limit this increase then you can lower the
  63.         amount of the shift by adding the -s command.
  64.         -s8  (default) causes the value to be shifted to its
  65.         brightest value possible. -s0 causes it not be be
  66.         shifted at all.  Usually the value is only shifted
  67.         by 2 or 3 in operation.
  68.  
  69.         QRT2GIF FILE.RAW FILE.GIF -S0
  70.                 Causes the picture to be created without any
  71.                 color brightening.
  72.  
  73.         - mNNNN adjust maximum table size for the GIF.  This
  74.         is used as a speed up for the GIF the lower the
  75.         value the faster the GIF conversion will be but less
  76.         compression that will occur.
  77.  
  78.         - qNNNN alternate adjustment of the table size of
  79.         the GIF. This method is similar to the -m but it
  80.         will work a LOT faster. The problems are documented
  81.         below under caveats.
  82.  
  83. What it is doing:
  84.          QRT2GIF uses two passes over the data.  The first
  85.          pass creates a Palette table for the GIF.  It
  86.          attempts to create the maximum number of colors
  87.          possible but if too many colors exist then the
  88.          resolution of the table is lowered until the entire
  89.          picture is calculated.
  90.  
  91.         The second pass creates the actual GIF by doing the
  92.         compression.
  93.  
  94.         On a 10MHZ 1 wait state machine it will require
  95.         about 8-10 min. to create a GIF (This is of course is
  96.         based upon the resolution of the input file). If you
  97.         use the -q option (try -q1000) it will reduce to 2-4
  98.         min. range.
  99.  
  100. Some Caveats:
  101.         The GIF standard does not say that the method I use
  102.         for the -Q is legal (it also does not exactly
  103.         prohibit it) and I have not had any problems with
  104.         any GIF viewer program I have tried.  But if you get
  105.         some strange results you might not want to use the
  106.         -Q option instead use the -M option for speed ups.
  107.  
  108.         As I feel sorry for some sysops, if you make a great
  109.         GIF with this program please DO NOT use the -q or -m
  110.         options (give them as small a GIF as possible).
  111.                                                        
  112.  
  113. Some Credits:
  114.             GIF is tm of Compuserve and Compuserve is an H&R
  115.             Block Company.
  116.  
  117.  
  118. The Bottom Line:
  119.             As this is a limited use program all I ask for in
  120.             support is that you don't distribute or sell it
  121.             without my permission.  If you have any bug
  122.             reports or problems or suggestions you can
  123.             contact me on the above accounts. The preferred
  124.             contact is via Prodigy since I can check in more
  125.             frequently there without charge.
  126.  
  127.  
  128. History:
  129.  
  130. V1.0
  131.         Initial release
  132.  
  133. V1.1
  134.         Fixed problems with some viewer programs (now
  135.         creates completely normal GIFs.  (Note for other
  136.         developers some programs get real picky about having
  137.         an EOI on the end of the GIF).
  138.  
  139.         Enhanced palette table calculation (now creates more
  140.         accurate color rendention)
  141.  
  142.         Updated encoder routine to use maximum string table
  143.         for maximum compressed GIFs
  144.  
  145.         added -m and -q options to compensate for slowness
  146.         of GIF encoder algorithm (I guess I will have to
  147.         code it in assembly for more speed next time).
  148.  
  149.