228 lines
5.6 KiB
HTML
228 lines
5.6 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of ppmtoilbm</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>ppmtoilbm</H1>
|
|
Section: User Commands (1)<BR>Updated: 31 October 1993<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ppmtoilbm - convert a portable pixmap into an ILBM file
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ppmtoilbm</B>
|
|
|
|
[<B>-maxplanes</B>|<B>-mp</B>
|
|
|
|
<I>N</I>]
|
|
|
|
[<B>-fixplanes</B>|<B>-fp</B>
|
|
|
|
<I>N</I>]
|
|
|
|
[<B>-ham6</B>|<B>-ham8</B>]
|
|
|
|
[<B>-dcbits</B>|<B>-dcplanes</B>r<B>g</B>b<B>]</B>
|
|
|
|
[<B>-normal</B>|<B>-hamif</B>|<B>-hamforce</B>|<B>-24if</B>|<B>-24force</B>|
|
|
|
|
-dcif<B>|</B>-dcforce<B>|</B>-cmaponly<B>]</B>
|
|
|
|
[<B>-ecs</B>|<B>-aga</B>]
|
|
|
|
[<B>-compress</B>|<B>-nocompress</B>]
|
|
|
|
[<B>-cmethod</B>
|
|
|
|
<I>type</I>]
|
|
|
|
[<B>-map</B>ppmfile<B>]</B>
|
|
|
|
[<B>-savemem</B>]
|
|
|
|
[<B>ppmfile</B>]
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Reads a portable pixmap as input.
|
|
Produces an ILBM file as output.
|
|
<A NAME="ixAAC"></A>
|
|
Supported ILBM types are:
|
|
<DL COMPACT>
|
|
<DT id="1">Normal ILBMs with 1-16 planes.<DD>
|
|
<DT id="2">Amiga HAM with 3-16 planes.<DD>
|
|
<A NAME="ixAAD"></A>
|
|
<A NAME="ixAAE"></A>
|
|
<DT id="3">24 bit.<DD>
|
|
<DT id="4">Color map (BMHD + CMAP chunk only, nPlanes = 0).<DD>
|
|
<DT id="5">Unofficial direct color.<DD>
|
|
1-16 planes for each color component.
|
|
<DT id="6">Chunks written:<DD>
|
|
BMHD, CMAP, CAMG (only for HAM), BODY (not for colormap files)
|
|
unofficial DCOL chunk for direct color ILBM
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
Options marked with (*) can be prefixed with a "no",
|
|
e.g. "-nohamif". All options can be abbreviated to
|
|
their shortest unique prefix.
|
|
<DL COMPACT>
|
|
<DT id="7"><B>-maxplanes | -mp n</B>
|
|
|
|
<DD>
|
|
(default 5, minimum 1, maximum 16)
|
|
Maximum planes to write in a normal ILBM. If the pixmap
|
|
does not fit into <n> planes, ppmtoilbm writes a HAM file
|
|
(if -hamif is used), a 24bit file (if -24if is used) or a
|
|
direct color file (if -dcif is used) or aborts with an error.
|
|
<DT id="8"><B>-fixplanes | -fp n</B>
|
|
|
|
<DD>
|
|
(min 1, max 16)
|
|
If a normal ILBM is written, it will have exactly <n> planes.
|
|
<DT id="9"><B>-hambits | -hamplanes n</B>
|
|
|
|
<DD>
|
|
(default 6, min 3, max 16)
|
|
Select number of planes for HAM picture. The current Amiga
|
|
hardware supports 6 and 8 planes, so for now you should
|
|
only use this values.
|
|
<DT id="10"><B>-normal (default)</B>
|
|
|
|
<DD>
|
|
Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and
|
|
-cmaponly. Also sets compression type to byterun1.
|
|
<DT id="11"><B>-hamif (*)</B>
|
|
|
|
<DD>
|
|
<DT id="12"><B>-24if (*)</B>
|
|
|
|
<DD>
|
|
<DT id="13"><B>-dcif (*)</B>
|
|
|
|
<DD>
|
|
Write a HAM/24bit/direct color file if the pixmap does not
|
|
fit into <maxplanes> planes.
|
|
<DT id="14"><B>-hamforce (*)</B>
|
|
|
|
<DD>
|
|
<DT id="15"><B>-24force (*)</B>
|
|
|
|
<DD>
|
|
<DT id="16"><B>-dcforce (*)</B>
|
|
|
|
<DD>
|
|
Write a HAM/24bit/direct color file.
|
|
<DT id="17"><B>-dcbits | -dcplanes r g b</B>
|
|
|
|
<DD>
|
|
(default 5, min 1, max 16).
|
|
Select number of bits for red, green & blue in a direct
|
|
color ILBM.
|
|
<DT id="18"><B>-ecs (default)</B>
|
|
|
|
<DD>
|
|
Shortcut for: -hamplanes 6 -maxplanes 5
|
|
<DT id="19"><B>-aga</B>
|
|
|
|
<DD>
|
|
<DT id="20"><B>Shortcut for: -hamplanes 8 -maxplanes 8</B>
|
|
|
|
<DD>
|
|
<DT id="21"><B>-ham6</B>
|
|
|
|
<DD>
|
|
<DT id="22"><B>Shortcut for: -hamplanes 6 -hamforce</B>
|
|
|
|
<DD>
|
|
<DT id="23"><B>-ham8</B>
|
|
|
|
<DD>
|
|
Shortcut for: -hamplanes 8 -hamforce
|
|
<DT id="24"><B>-compress (*) (default)</B>
|
|
|
|
<DD>
|
|
<DT id="25"><B>-cmethod none|byterun1</B>
|
|
|
|
<DD>
|
|
Compress the BODY chunk. The default compression method is byterun1.
|
|
Compression requires building the ILBM image in memory; turning compression
|
|
off allows stream-writing of the image, but the resulting file will usually
|
|
be 30% to 50% larger. Another alternative is the -savemem option, this will
|
|
keep memory requirements for compression at a minimum, but is very slow.
|
|
<DT id="26"><B>-map ppmfile</B>
|
|
|
|
<DD>
|
|
Write a normal ILBM using the colors in <ppmfile> as the
|
|
colormap. The colormap file also determines the number of
|
|
planes, a -maxplanes or -fixplanes option is ignored.
|
|
<DT id="27"><B>-cmaponly</B>
|
|
|
|
<DD>
|
|
Write a colormap file: only BMHD and CMAP chunks, no BODY
|
|
chunk, nPlanes = 0.
|
|
<DT id="28"><B>-savemem</B>
|
|
|
|
<DD>
|
|
See the -compress option.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
HAM pictures will always get a grayscale colormap; a real color selection
|
|
algorithm might give better results. On the other hand, this allows row-by-row
|
|
operation on HAM images, and all HAM images of the same depth (no. of planes)
|
|
share a common colormap, which is useful for building HAM animations.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>REFERENCES</H2>
|
|
|
|
Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
|
|
<BR>
|
|
|
|
Addison Wesley, ISBN 0-201-56775-X
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A>(5), <A HREF="/cgi-bin/man/man2html?1+ilbmtoppm">ilbmtoppm</A>(1)
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Copyright (C) 1989 by Jef Poskanzer.
|
|
<BR>
|
|
|
|
Modified October 1993 by Ingo Wilken (<A HREF="mailto:Ingo.Wilken@informatik.uni-oldenburg.de">Ingo.Wilken@informatik.uni-oldenburg.de</A>)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="29"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="30"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="31"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="32"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="33"><A HREF="#lbAF">BUGS</A><DD>
|
|
<DT id="34"><A HREF="#lbAG">REFERENCES</A><DD>
|
|
<DT id="35"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="36"><A HREF="#lbAI">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:25 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|