home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #7 / amigamamagazinepolishissue1998.iso / varia / povray3 / povray3_fpu / utils / ppmtoilbm.man < prev    next >
Text File  |  1997-12-12  |  5KB  |  191 lines
  1.  
  2.      NAME
  3.           ppmtoilbm - convert a portable pixmap into an ILBM file
  4.  
  5.      SYNOPSIS
  6.           ppmtoilbm [-maxplanes|-mp N] [-fixplanes|-fp N] [-ham6|-
  7.           ham8] [-dcbits|-dcplanesrg [-normal|-hamif|-hamforce -
  8.           dcif|-dcforce|-cmaponly] [-ecs|-aga] [-compress|-nocompress]
  9.           [-cmethod type] [-mapppmfile] [-savemem] [ppmfile]
  10.  
  11.      DESCRIPTION
  12.           Reads a portable pixmap as input.  Produces an ILBM file as
  13.           output.  Supported ILBM types are:
  14.  
  15.           Normal ILBMs with 1-16 planes.
  16.  
  17.           Amiga HAM with 3-16 planes.
  18.  
  19.           24 bit.
  20.  
  21.           Color map (BMHD + CMAP chunk only, nPlanes = 0).
  22.  
  23.           Unofficial direct color.
  24.                1-16 planes for each color component.
  25.  
  26.           Chunks written:
  27.                BMHD, CMAP, CAMG (only for HAM), BODY (not for colormap
  28.                files) unofficial DCOL chunk for direct color ILBM
  29.  
  30.      OPTIONS
  31.           Options marked with (*) can be prefixed with a "no", e.g.
  32.           "-nohamif". All options can be abbreviated to their shortest
  33.           unique prefix.
  34.  
  35.           -maxplanes | -mp n
  36.                (default 5, minimum 1, maximum 16) Maximum planes to
  37.                write in a normal ILBM.  If the pixmap does not fit
  38.                into <n> planes, ppmtoilbm writes a HAM file (if -hamif
  39.                is used), a 24bit file (if -24if is used) or a direct
  40.                color file (if -dcif is used) or aborts with an error.
  41.  
  42.           -fixplanes | -fp n
  43.                (min 1, max 16) If a normal ILBM is written, it will
  44.                have exactly <n> planes.
  45.  
  46.           -hambits | -hamplanes n
  47.                (default 6, min 3, max 16) Select number of planes for
  48.                HAM picture.  The current Amiga hardware supports 6 and
  49.                8 planes, so for now you should only use this values.
  50.  
  51.           -normal (default)
  52.                Turns off -hamif/-24if/-dcif, -hamforce/-24force/-
  53.                dcforce and -cmaponly.  Also sets compression type to
  54.  
  55.  
  56.  
  57.      Page 1                                           (printed 3/1/94)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      ppmtoilbm(1)         AMIGA (31 October 1993)         ppmtoilbm(1)
  65.  
  66.  
  67.  
  68.                byterun1.
  69.  
  70.           -hamif (*)
  71.  
  72.           -24if (*)
  73.  
  74.           -dcif (*)
  75.                Write a HAM/24bit/direct color file if the pixmap does
  76.                not fit into <maxplanes> planes.
  77.  
  78.           -hamforce (*)
  79.  
  80.           -24force (*)
  81.  
  82.           -dcforce (*)
  83.                Write a HAM/24bit/direct color file.
  84.  
  85.           -dcbits | -dcplanes r g b
  86.                (default 5, min 1, max 16).  Select number of bits for
  87.                red, green & blue in a direct color ILBM.
  88.  
  89.           -ecs (default)
  90.                Shortcut for: -hamplanes 6 -maxplanes 5
  91.  
  92.           -aga
  93.  
  94.           Shortcut for: -hamplanes 8 -maxplanes 8
  95.  
  96.           -ham6
  97.  
  98.           Shortcut for: -hamplanes 6 -hamforce
  99.  
  100.           -ham8
  101.                Shortcut for: -hamplanes 8 -hamforce
  102.  
  103.           -compress (*) (default)
  104.  
  105.           -cmethod none|byterun1
  106.                Compress the BODY chunk.  The default compression
  107.                method is byterun1.  Compression requires building the
  108.                ILBM image in memory; turning compression off allows
  109.                stream-writing of the image, but the resulting file
  110.                will usually be 30% to 50% larger.  Another alternative
  111.                is the -savemem option, this will keep memory
  112.                requirements for compression at a minimum, but is very
  113.                slow.
  114.  
  115.           -map ppmfile
  116.                Write a normal ILBM using the colors in <ppmfile> as
  117.                the colormap. The colormap file also determines the
  118.                number of planes, a -maxplanes or -fixplanes option is
  119.                ignored.
  120.  
  121.  
  122.  
  123.      Page 2                                           (printed 3/1/94)
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      ppmtoilbm(1)         AMIGA (31 October 1993)         ppmtoilbm(1)
  131.  
  132.  
  133.  
  134.           -cmaponly
  135.                Write a colormap file: only BMHD and CMAP chunks, no
  136.                BODY chunk, nPlanes = 0.
  137.  
  138.           -savemem
  139.                See the -compress option.
  140.  
  141.      BUGS
  142.           HAM pictures will always get a grayscale colormap; a real
  143.           color selection algorithm might give better results.  On the
  144.           other hand, this allows row-by-row operation on HAM images,
  145.           and all HAM images of the same depth (no. of planes) share a
  146.           common colormap, which is useful for building HAM
  147.           animations.
  148.  
  149.      REFERENCES
  150.           Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
  151.           Addison Wesley, ISBN 0-201-56775-X
  152.  
  153.      SEE ALSO
  154.           ppm(5), ilbmtoppm(1)
  155.  
  156.      AUTHORS
  157.           Copyright (C) 1989 by Jef Poskanzer.
  158.           Modified October 1993 by Ingo Wilken
  159.           (Ingo.Wilken@informatik.uni-oldenburg.de)
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.      Page 3                                           (printed 3/1/94)
  190.  
  191.