home *** CD-ROM | disk | FTP | other *** search
/ Box' of X 3 / Box' of X 3.iso / x-viewer / amiga / glanmvwr / gl.man < prev    next >
Encoding:
Text File  |  1991-03-30  |  8.3 KB  |  206 lines
  1.                              GL Documentation 
  2.  
  3. Program:
  4.     GL
  5.     GLSplit
  6.     Pictor
  7.  
  8. Purpose:
  9.     To fiddle with GRASP animation files. These are found on PClones,
  10.     with the extension ".GL".
  11.  
  12.     GRASP is a product of Microtex Industries, Inc.
  13.  
  14. Author:
  15.     John Bickers (JJB Templar)  - jbickers@templar.actrix.gen.nz
  16.  
  17. Credits:
  18.     This was written using SAS C 5.10a.
  19.  
  20.     The digital dissolve effect (fade 20) is from "A Digital 'Dissolve'
  21.     Effect", by Mike Morton, pg 221 of "Graphics Gems".
  22.  
  23.     The format of a .GL file was obtained from the documentation file
  24.     for xgrasp, a Sun .GL player written by Patrick J. Naughton
  25.     (naughton@sun.com). This file included what appears to be documentation
  26.     from an early (Useware) version of GRASP.
  27.  
  28.     The formula to convert from an RGB triple to a grayscale level is
  29.     from Usenet's comp.graphics FAQ.
  30.  
  31.     Motivation is from MANDY-2.GL, which I saw running on a PS/2, and
  32.     which convinced me that perhaps PClone animations are worth
  33.     noticing.
  34.  
  35. Using GL:
  36.     This program is the .GL player. It has a number of limitations, which
  37.     include no font or text support, only two fades (0 and 20), etc.
  38.     However, it plays MANDY-2.GL ok, which is all I ask.
  39.  
  40.     The CLI usage is:
  41.  
  42.         WSH 3> gl [-g] filename
  43.  
  44.     The optional "-g" parameter tells GL to use a grayscale colormap for
  45.     the data. This is usually necessary for VGA animations, which have
  46.     256-color palettes. The original 256 colors are then mapped onto
  47.     16 gray levels. Note that this makes a number of GRASP color commands
  48.     and tricks useless, since the source data is converted into 4 bits
  49.     per pixel during the "cload" or "pload" commands, and cannot be
  50.     remapped to a new palette.
  51.  
  52.     GL can only handle two of the many video modes a .GL may have. These
  53.     are CGA 640x200/1 ('C'), and VGA 320x200/8 ('L'). These happen to
  54.     be the only sample files available to me. I'd be happy to add more,
  55.     should the opportunity arise.
  56.  
  57.     While GL is running, there are a few keystrokes available to the
  58.     user. These only take action when the animation pauses for input,
  59.     so don't be surprised if it takes a while for a keystroke to have
  60.     an affect.
  61.  
  62.     Esc terminates the animation.
  63.  
  64.     Space puts the animation into "command mode". In this mode, pressing
  65.     'S' will save the screen as an IFF ILBM, pressing Space will advance
  66.     the animation to the next input position, then go straight to command
  67.     mode, and any other reasonable key should resume the animation.
  68.  
  69.     GL was written on an A2630. I've tried it on the 68000, and it is
  70.     quite slow, sorry. There are no waves when updating clips on the
  71.     68030.
  72.  
  73.     In my opinion, converting a .GL to something nice for the Amiga is
  74.     too much hassle to write a free program for (I don't know any
  75.     convenient Amiga formats, for example. ANIM option 5 is out). The
  76.     easiest approach is probably to extract the elements of the
  77.     animation, convert them to HAM if necessary, then put them back
  78.     together using an Amiga animation program.
  79.  
  80. Using GLSplit:
  81.     This is like GRASP's "GLIB" program, but with extraction and listing
  82.     capabilities only. A .GL file is similar to an archive, and GLSplit
  83.     will allow one to extract any file one wishes.
  84.  
  85.     The CLI usage is:
  86.  
  87.         WSH 3> glsplit [-l] [-oprefix] [-xname] filename
  88.  
  89.     If no options are specified, glsplit will extract all files from
  90.     "filename" into the current directory.
  91.  
  92.     The optional "-l" parameter will produce a list of the files
  93.     within the .GL.
  94.  
  95.     The optional "-o" parameter specifies a prefix for the output files.
  96.     For example, if one wanted to extract all files to ram:, one would
  97.     use:
  98.         WSH 3> glsplit -oram: filename
  99.  
  100.     The optional "-x" parameter specifies that a particular file should
  101.     be extracted. For example, if one of the files in the .GL file happened
  102.     to be "main.txt", you could extract just that file with:
  103.         WSH 3> glsplit -xmain.txt filename
  104.  
  105. Using Pictor:
  106.     This program is intended to either display or convert PCPaint
  107.     picture files. These include the .PIC and .CLP files found in .GLs.
  108.     The same video modes are recognised as with GL - that is, Pictor
  109.     only knows how to handle CGA ('C') and VGA ('L') pictures. Again
  110.     similar to GL, Pictor displays 'L' mode pictures into a 4-bitplane
  111.     LORES screen.
  112.  
  113.     The CLI usage is:
  114.  
  115.         WSH 3> pictor [-vo] [-g] [-sname] [-lname] [-wname] filename
  116.  
  117.     The optional "-v" parameter generates information from the header
  118.     of the picture. If an 'o' follows the 'v', then this is all the
  119.     processing that occurs (ie: [v]erbose [o]nly).
  120.  
  121.     The optional "-g" parameter uses a grayscale colormap. HAM etc
  122.     conversion is better done with other tools, like HamLab(*).
  123.  
  124.     The optional "-s" parameter tells Pictor to save the colormap of
  125.     the picture as a seperate file. The default name is "ram:savecolor",
  126.     and can be overridden by placing a filename directly after the "-s".
  127.     The purpose of this parameter is to provide .CLP (clip) pictures with
  128.     a colormap, since they do not usually have one. For example, if you
  129.     had two files "palette.pic" and "clip1.clp", you could display the
  130.     .clp file with:
  131.         WSH 3> pictor -s palette.pic
  132.         WSH 3> pictor -l -g clip1.clp       ;or pictor -l -w clip1.clp
  133.  
  134.     The optional "-l" parameter tells Pictor to load the colormap
  135.     for the picture from a file. The default name is the same as for
  136.     the "-s" parameter. This colormap can be used along with the
  137.     "-g" and "-w" options, either to display correct grayscales, or
  138.     to write out the correct colormap to the FIG workfile.
  139.  
  140.     The optional "-w" parameter tells Pictor to write out the picture
  141.     as a workfile for my FIG(**) programs. The default name is
  142.     "ram:pictor.wrk". Older versions of the FIG software will not work
  143.     with these files, since I've added a two-byte identifier to the
  144.     workfile header in order to identify them to HamLab. I either use
  145.     FIG, or a filter that reads a workfile into HamLab, to process these
  146.     files.
  147.  
  148.     (*) HamLab is an image conversion package written by Ed Hanway. The
  149.     package is shareware, though freely redistributable versions are
  150.     available. As of this writing, the version number is 1.1, and
  151.     Ed's email address is "jeh@sisd.kodak.com".
  152.  
  153.     (**) FIG is an image conversion package written by me, before I
  154.     got HamLab. I still find it useful, since it only fiddles with 8-bit
  155.     data (therefore requires less space) and is script-driven.
  156.  
  157. To do:
  158.     Implement GRASP commands/video modes as required, I guess. No big
  159.     deal.
  160.  
  161.     Use the Blitter for updating clips etc? Would be faster (and easier
  162.     than using assembler), but display updates would flicker a lot, and
  163.     it would require more CHIP RAM than it currently does.
  164.  
  165.     Assembler optimizations of some of the drawing stuff?
  166.  
  167.     Dithering in the grayscale mode?
  168.  
  169. Personal stuff:
  170.     Suggestions are welcome, and may even be implemented. I can be
  171.     contacted at the following:
  172.  
  173.     Snail:  John Bickers,
  174.             214 Rata St,
  175.             Naenae 6301,
  176.             New Zealand.
  177.  
  178.     Email:  jbickers@templar.actrix.gen.nz
  179.  
  180.     Phone:  677-334, 672-085, or 746-625.
  181.  
  182.     People who use this program are also invited to send some notification
  183.     of their existence to any of the above points. Feel free to pay
  184.     something (esp. if you want to request that something be added :) too,
  185.     but payment is not a requirement. I'd be more interested in X-rated
  186.     animations, actually (NOT NOT NOT via email! I have to pay $$ for
  187.     that!). Either Amiga disks, or MS-DOS disks up to 1.4M, are ok.
  188.  
  189.     This program may be redistributed freely, but not for commercial gain
  190.     (ie: Fred Fish type costs are ok). Note that you should include the
  191.     documentation.
  192.  
  193.     GL, GLSplit and Pictor are Copyright ⌐ 1991 by John Bickers. Heh.
  194.  
  195. History:
  196.     19-Mar-91 GLSplit 1.0   Begun.
  197.     20-Mar-91 Pictor 1.0    Begun.
  198.     23-Mar-91 GL 1.0        Begun.
  199.     24-Mar-91 Pictor 1.1    Allow -w for CGA mode.
  200.     26-Mar-91 GL 1.1        Now unpacking VGA pixels at [cp]load time.
  201.                             Fixed box, cfade and fly y coordinates.
  202.     30-Mar-91 GL 1.1        Fixed non-byte-aligned clips.
  203.  
  204. Disclaimer:
  205.     "It works on my machine" (so far :).
  206.