ppmtopcx

NAME

SYNOPSIS

DESCRIPTION

ppmtopcx reads a PPM image as input abd produces a PCX file as output. The type of the PCX file depends on the number of colors in the pixmap:

16 colors or less:

1 bit/pixel, 1-4 planes.

256 colors or less:

8 bits/pixel, 1 plane, colormap at the end of the file.

More than 256 colors:

24bit truecolor file (8 bits/pixel, 3 planes).

You can override some of that and explicitly choose the format with the options below.  

OPTIONS

-24bit

Produce a 24bit truecolor PCX file, even if the image has 256 colors or fewer.

-8bit

Produce an 8bit (256 colors) PCX file, even if the image has 16 colors or fewer.

This option was added in Netpbm 10.18 (August 2003).

-packed

Use "packed pixel" format for files with 16 colors or fewer: 1, 2, or 4 bits/pixel, 1 plane.

-stdpalette

Instead of computing a palette from the colors in the image, use a standard, built-in 16 color palette. If the image contains a color that is not in the standard palette, ppmtopcx fails.

You can use pnmremap with a suitable PPM image of the standard palette to adapt your image to use exactly those colors in the palette so that ppmtopcx -stdpalette will work on it.

The file pcxstd.ppm, part of Netpbm, contains the standard palette.

Although the PCX header tells exactly what palette is used in the file, some older PCX interpreters do not use that information. They instead assume the standard palette. If you don't use the -stdpalette option, ppmtopcx, ppmtopcx may create an image that uses a different palette (possibly just a rearrangement of the same colors) and then one of these older interpreters would interpret the colors in the image wrong.

This option was new in Netpbm 10.22 (April 2004).

-planes=planes

Generate a PCX file with planes planes, even though the number of colors in the image could be represented in fewer. This makes the file larger, but some PCX interpreters are capable of processing only certain numbers of planes.

This is meaningful only when ppmtopcx generates an image in the 16 color palette format without packed pixels. Consequently, you cannot specify this option together with -24bit or -8bit or -packed.

The valid values for planes are 1, 2, 3, and 4. By default, ppmtopcx chooses the smallest number of planes that can represent the colors in the image. E.g. if there are 5 colors, ppmtopcx chooses 3 planes.

This option was new in Netpbm 10.21 (March 2004).

-xpos=cols

-ypos=rows

These options set the position of the image in some field (e.g. on a screen) in columns to the right of the left edge and rows below the top edge. The PCX format contains image position information. Don't confuse this with the position of an area of interest within the image. For example, using pnmpad to add a 10 pixel left border to an image and then converting that image to PCX with xpos = 0 is not the same as converting the original image to PCX and setting xpos = 10.

The values may be from -32767 to 32768.

The default for each is zero.

SEE ALSO

AUTHORS

Based on previous work by Michael Davidson.

Table Of Contents

• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• SEE ALSO
• AUTHORS