Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 173 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/ppmtoacad.1 b/upstream/mageia-cauldron/man1/ppmtoacad.1
new file mode 100644
index 00000000..7b2c6202
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/ppmtoacad.1
@@ -0,0 +1,173 @@
+\
+.\" 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 "Ppmtoacad User Manual" 0 "10 October 1991" "netpbm documentation"
+
+.SH NAME
+
+ppmtoacad - convert PPM to Autocad database or slide
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmtoacad\fP
+
+[\fB-dxb\fP]
+
+[\fB-poly\fP]
+
+[\fB-background\fP \fIcolor\fP]
+
+[\fB-white\fP]
+
+[\fB-aspect\fP \fIratio\fP]
+
+[\fB-8\fP]
+
+[\fIppmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmtoacad\fP reads a PPM image as input and produces an
+Autocad\*R slide file or binary database import (.dxb) file as
+output.  If you don't specify \fIppmfile\fP,
+\fBppmtoacad\fP takes the input from Standard Input.
+.PP
+(Typographical note: the name of Autocad is often rendered as
+AutoCAD.  Netpbm documentation uses standard American typography, wherein
+that is not a valid form of capitalization).
+
+.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
+\&), \fBppmtoacad\fP recognizes the following
+command line options:
+.PP
+You may abbreviate any option to its shortest unique prefix.
+
+
+.TP
+\fB-dxb\fP
+\fBppmtoacad\fP writes an Autocad binary database import (.dxb)
+file.  You read this file with the DXBIN command and, once loaded, it
+becomes part of the Autocad geometrical database, so you can view and
+edit it like any other object.  Each sequence of identical pixels
+becomes a separate object in the database; this can result in very
+large Autocad drawing files.  However, if you want to trace over a
+bitmap, it lets you zoom and pan around the bitmap as you wish.
+
+.TP
+\fB-poly\fP
+If you don't specify the \fB-dxb\fP option, \fBppmtoacad\fP
+generates an Autocad slide file.  Normally each row of pixels is
+represented by an Autocad line entity.  If you specify \fB-poly\fP,
+\fBppmtoacad\fP renders the pixels as filled polygons.  If you view
+the slide on a display with higher resolution than the source image,
+this will cause the pixels to expand instead of appearing as discrete
+lines against the screen background color.  Regrettably, this
+representation yields slide files which occupy more storage space and
+take longer to display.
+
+.TP
+\fB-background\fP \fIcolor\fP
+Most Autocad display drivers can be configured to use any
+available color as the screen background.  Some users prefer a black
+screen background, others white, while splinter groups advocate burnt
+ocher, tawny puce, and shocking gray.  Discarding pixels whose closest
+Autocad color representation is equal to the background color can
+substantially reduce the size of the Autocad database or slide file
+needed to represent a bitmap.  If you don't specify
+\fB-background\fP, \fBppmtoacad\fP assumes the screen background
+color to be black.  You may specify any Autocad color number as the
+screen background; \fBppmtoacad\fP assumes color numbers to specify
+the hues defined in the standard Autocad 256 color palette.
+
+.TP
+\fB-white\fP
+Since many Autocad users choose a white screen background, this
+option is provided as a short-cut.  Specifying \fB-white\fP is
+identical in effect to \fB-background 7\fP.
+
+.TP
+\fB-aspect\fP \fIratio\fP
+If the source image had non-square pixels (which means it is not
+standard PPM), specify the ratio of the pixel width to pixel height as
+\fIratio\fP.  \fBppmtoacad\fP will correct the resulting slide or
+\&.dxb file so that pixels on the Autocad screen will be square.  For
+example, to correct an image made for a 320x200 VGA/MCGA screen,
+specify \fB-aspect 0.8333\fP.
+
+.TP
+\fB-8\fP
+Restricts the colors in the output file to the 8 RGB shades.
+
+
+.UN restrictions
+.SH RESTRICTIONS
+.PP
+Autocad has a fixed palette of 256 colors, distributed along the
+hue, lightness, and saturation axes.  So it may poorly render images
+which contain many nearly-identical colors, or colors not closely
+approximated by Autocad's palette.
+.PP
+\fBppmtoacad\fP works best if the system displaying its output can
+display the full 256 color Autocad palette.  Monochrome, 8 color, and
+16 color configurations will produce less than optimal results.
+.PP
+When creating a .dxb file or a slide file with the \fB-poly\fP
+option, \fBppmtoacad\fP finds both vertical and horizontal runs of
+identical pixels and consolidates them into rectangular regions to
+reduce the size of the output file.  This is effective for images with
+large areas of constant color but it's no substitute for true raster
+to vector conversion.  In particular, this process does not optimize
+thin diagonal lines at all.
+.PP
+Output files can be huge.
+
+.UN seealso
+.SH SEE ALSO
+.PP
+Autocad Reference Manual: \fISlide File Format\fP and \fIBinary
+Drawing Interchange (DXB) Files\fP,
+.BR "ppm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+.nf
+John Walker
+Autodesk SA
+Avenue des Champs-Montants 14b
+CH-2074 MARIN
+Suisse/Schweiz/Svizzera/Svizra/Switzerland
+    \fBUsenet:\fP\fIkelvin@Autodesk.com\fP
+    \fBFax:\fP038/33 88 15
+    \fBVoice:\fP038/33 76 33
+
+.fi
+.PP
+Permission to use, copy, modify, and distribute this software and
+its documentation for any purpose and without fee is hereby granted,
+without any conditions or restrictions.  This software is provided
+"as is" without express or implied warranty.
+.PP
+Autocad and Autodesk are registered trademarks of Autodesk, Inc.
+.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/ppmtoacad.html
+.PP
\ No newline at end of file