home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / graphics / viewers / grasp / pic2hl.man < prev    next >
Text File  |  1992-09-09  |  4KB  |  119 lines
  1.  
  2.  
  3.  
  4.     PIC2HL 1.2                                                01.09.92
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     PIC2HL is a HamLab filter for GRASP .PIC and .CLP files, types C,
  11.     J, L and M.
  12.  
  13.     These .PIC and .CLP files can be extracted from MS-DOS GRASP (aka
  14.     GL) files using my GLIB program, or something similar.
  15.  
  16.     PIC2HL can also be used to provide input data for the Wasp image
  17.     conversion program.
  18.  
  19.  
  20.     INSTALLING
  21.  
  22.     Add the following line to your HamLab configuration file:
  23.  
  24.     Format "\064\022" "pic2hl"  # GRASP .PIC or .CLP: [CJLM]
  25.  
  26.     And copy the PIC2HL binary to your HamLab filters directory.
  27.  
  28.  
  29.     OPERATIONAL NOTES/PROBLEMS
  30.  
  31.     *   Some pictures, usually those ending with .CLP, do not contain
  32.         a color palette. GRASP animations normally contain a dummy
  33.         picture which is used to set the palette for these .CLP
  34.         files.
  35.  
  36.         In order to provide a color map for these files, PIC2HL
  37.         writes out a file called "t:picpal" whenever it processes a
  38.         picture that has a palette. Then, if a picture does not have
  39.         a palette, this file is loaded and used.
  40.  
  41.     *   In some cases, the t:picpal file is not enough. A picture
  42.         will have a palette that it is not supposed to have. By
  43.         renaming a correct picpal file to "t:picpal!", you can
  44.         override the palette within the picture. In this case, a
  45.         t:picpal file will not be created afterwards.
  46.  
  47.         The format of these files is just a raw dump of RGB triples.
  48.         All display mode-specific processing is done _before_ the
  49.         picpal file is written out.
  50.  
  51.     *   .PIC and .CLP pictures start with the bottom of the picture
  52.         at the start of the file. So PIC2HL must buffer the entire
  53.         picture before sending it out to HamLab.
  54.  
  55.     *   I don't have many type J or M pictures, and I'm not sure how
  56.         to treat palette type 2s, so the EGA pictures may come out
  57.         wrong. Let me know.
  58.  
  59.         A palette type 2 is a "pcjr or non ECD 16 color registers
  60.         (0-15)".
  61.  
  62.     *   A small number of pictures I've come across do not have a
  63.         valid video mode byte. In some cases, I have been able to
  64.         convert these pictures successfully by placing an 'L' (for
  65.         GLs that use 'L' pictures) in byte 12, counting from zero.
  66.  
  67.     *   To use PIC2HL with Wasp, use the command line option "-wasp".
  68.         For example, to convert the file goofy.pic to a LORES ILBM
  69.         picture, you would use:
  70.  
  71.             3> pic2hl -wasp < goofy.pic > ram:temp.raw
  72.             3> waspa -lores -zap ram:temp.raw goofy.pic
  73.  
  74.         The ram:temp.raw file will be in Wasp's own SRGR format. I
  75.         used the source for Wasp 1.23 to determine this format.
  76.  
  77.  
  78.     CREDITS
  79.  
  80.     Written by John Bickers using SAS C 5.10a.
  81.  
  82.     Sample data provided by Scott Corley.
  83.  
  84.     HamLab is a program by Ed Hanway that takes a picture file and
  85.     passes it through a filter to get 24-bit data. HamLab then
  86.     processes the 24-bit file to produce a HAM picture.
  87.  
  88.     EGA palette information is sourced from XGRASP, an X-Windows GL
  89.     player by Patrick J. Naughton.
  90.  
  91.     Some type information was also sourced from the 1988 document
  92.     "PCPAINT/Pictor Page Format Description", by John Bridges.
  93.  
  94.     GRASP is a product of Microtex Industries, Inc. It's a sort of
  95.     slideshow animation program.
  96.  
  97.     Wasp is an image conversion program written by Steven Reiz.
  98.  
  99.  
  100.     DISTRIBUTION
  101.  
  102.     PIC2HL is Copyright © 1992 by John Bickers.
  103.  
  104.     This program may be distributed freely, as long as no more than
  105.     Fred Fish type costs are asked for it, with the sole exception of
  106.     Ed Hanway, who may distribute this program with no restriction.
  107.  
  108.  
  109.     CONTACT INFO
  110.  
  111.     If you have suggestions or problems, I can be reached at:
  112.  
  113.         John Bickers
  114.         214 Rata St
  115.         Naenae 6301
  116.         New Zealand
  117.  
  118.     Or: jbickers@templar.actrix.gen.nz
  119.