Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 204 insertions, 0 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/ppmtopcx.1 b/upstream/opensuse-tumbleweed/man1/ppmtopcx.1
new file mode 100644
index 00000000..8df16087
--- /dev/null
+++ b/upstream/opensuse-tumbleweed/man1/ppmtopcx.1
@@ -0,0 +1,204 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Ppmtopcx User Manual" 0 "26 September 2020" "netpbm documentation"
+
+.SH NAME
+
+ppmtopcx - convert a PPM image to a PCX file
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmtopcx\fP
+
+[\fB-24bit\fP]
+
+[\fB-8bit\fP]
+
+[\fB-packed\fP]
+
+[\fB-stdpalette\fP]
+
+[\fB-palette=\fP\fIpalettefile\fP]
+
+[\fB-planes=\fP\fIplanes\fP]
+
+[\fB-xpos=\fP\fIcols\fP]
+
+[\fB-ypos=\fP\fIrows\fP]
+
+[\fIppmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmtopcx\fP reads a PPM image as input and produces a PCX file
+as output.  The type of the PCX file depends on the number of colors
+in the input image:
+
+
+.TP
+16 colors or fewer:
+1 bit/pixel, 1-4 planes, colormap in header
+
+.TP
+more than 16 colors, but no more than 256:
+8 bits/pixel, 1 plane, colormap at the end of the file.
+
+.TP
+More than 256 colors:
+24bit truecolor file (8 bits/pixel, 3 planes).
+
+
+.PP
+You can override some of that and explicitly choose the format with
+the options below.
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBppmtopcx\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-24bit\fP
+Produce a 24bit truecolor PCX file, even if the image has 256
+colors or fewer.
+
+.TP
+\fB-8bit\fP
+Produce an 8bit (256 colors) PCX file, even if the image has 16
+colors or fewer.
+.sp
+This option was added in Netpbm 10.18 (August 2003).
+
+.TP
+\fB-packed\fP
+Use "packed pixel" format for files with 16 colors or
+fewer: 1, 2, or 4 bits/pixel, 1 plane.
+
+.TP
+\fB-stdpalette\fP
+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, \fBppmtopcx\fP fails.
+.sp
+The standard palette is not only a set of colors, but a specific
+mapping of palette indexes to colors.  E.g. red is 4.
+.sp
+You can use \fBpnmremap\fP with a suitable PPM image of the standard
+palette to adapt your image to use exactly those colors in the palette
+so that \fBppmtopcx -stdpalette\fP will work on it.
+.sp
+The file \fBpcxstd.ppm\fP, part of Netpbm, contains the standard
+palette.
+.sp
+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
+\fB-stdpalette\fP option, \fBppmtopcx\fP, \fBppmtopcx\fP may create
+an image that uses a different palette (a rearrangement of the same
+colors) and then one of these older interpreters would interpret the
+colors in the image wrong.
+.sp
+You cannot specify this option along with \fB-palette\fP.
+.sp
+This option was new in Netpbm 10.22 (April 2004).
+
+.TP
+\fB-palette=\fP\fIpalettefile\fP
+Instead of computing the palette from the colors in the image, use
+the palette from the file \fIpalettefile\fP.  If the palette contains
+a color that is not in that palette, \fBppmtopcx\fP fails.
+.sp
+The palette file must be a PPM image that contains one pixel for
+each color in the palette.  It doesn't matter what the aspect ratio
+of the palette image is.  The order of the colors in the PCX palette
+is the order of the pixels in the PPM image in standard western
+reading order (left to right, top to bottom).  If there is a duplicate
+color in the palette, \fBppmtopcx\fP chooses between them arbitrarily
+in building the PCX raster.
+.sp
+You would need this only if you have a PCX reader that can't read
+the palette that is in the PCX file and instead assumes some particular
+palette.  See also the \fB-stdpalette\fP option.
+.sp
+If your input image might contain colors other than those in your
+palette, you can convert the input image to one that contains only
+those colors in your palette with \fBpnmremap\fP.
+.sp
+You cannot specify this along with \fB-stdpalette\fP.
+.sp
+This option was new in Netpbhm 10.25 (October 2004).
+
+.TP
+\fB-planes=\fP\fIplanes\fP
+Generate a PCX file with \fIplanes\fP 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.
+.sp
+This is meaningful only when \fBppmtopcx\fP generates an image in
+the 16 color palette format without packed pixels.  Consequently, you
+cannot specify this option together with \fB-24bit\fP or
+\fB-8bit\fP or \fB-packed\fP.
+.sp
+The valid values for \fIplanes\fP are 1, 2, 3, and 4.  By default,
+\fBppmtopcx\fP chooses the smallest number of planes that can represent
+the colors in the image.  E.g. if there are 5 colors, \fBppmtopcx\fP 
+chooses 3 planes.
+.sp
+This option was new in Netpbm 10.21 (March 2004).
+     
+.TP
+\fB-xpos=\fP\fIcols\fP
+
+.TP
+\fB-ypos=\fP\fIrows\fP
+ 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 \fBpnmpad\fP 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.
+.sp
+The values may be from -32767 to 32768.
+.sp
+The default for each is zero.
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pcxtoppm" (1)\c
+\&,
+.BR "ppm" (5)\c
+\&
+
+.UN authors
+.SH AUTHORS
+
+Copyright (C) 1994 by Ingo Wilken (\fIIngo.Wilken@informatik.uni-oldenburg.de\fP)
+.PP
+Based on previous work by Michael Davidson.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source.  The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/ppmtopcx.html
+.PP
\ No newline at end of file