1 files changed, 187 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/sldtoppm.1 b/upstream/debian-unstable/man1/sldtoppm.1
new file mode 100644
index 00000000..560dfc21
--- /dev/null
+++ b/upstream/debian-unstable/man1/sldtoppm.1
@@ -0,0 +1,187 @@
+\
+.\" 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 "Sldtoppm User Manual" 1 "10 October 1991" "netpbm documentation"
+
+.SH NAME
+
+sldtoppm - convert an AutoCAD slide file to a PPM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBsldtoppm\fP
+[\fB-adjust\fP]
+[\fB-dir\fP]
+[{\fB-height\fP|\fB-ysize\fP} \fIs\fP]
+[\fB-info\fP]
+[{\fB-lib\fP|\fB-Lib\fP} \fIname\fP]
+[\fB-scale\fP \fIs\fP]
+[\fB-verbose\fP]
+[{\fB-width\fP|\fB-xsize\fP} \fIs\fP]
+[\fIslidefile\fP]
+.PP
+All options can be abbreviated to their shortest unique prefix.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBsldtoppm\fP reads an AutoCAD\*R slide file and outputs a PPM
+image.  If you don't specify \fIslidefile\fP, \fBsldtoppm\fP reads
+input from Standard Input.  \fBsldtoppm\fP uses the \fBppmdraw\fP
+library to convert the vector and polygon information in the slide
+file to a raster; see the file \fBppmdraw.h\fP for details on this
+package.
+
+.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
+\&), \fBsldtoppm\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-adjust\fP
+If the display on which the slide file was created had non-square
+pixels, when you process the slide with \fBsldtoppm\fP and don't
+specify \fB-adjust\fP, \fBsldtoppm\fP issues the following warning;
+
+.RS
+Warning - pixels on source screen were non-square.
+.RE
+.sp
+Specifying \fB-adjust\fP will correct the image width to
+compensate.  Specifying the \fB-adjust\fP option causes
+\fBsldtoppm\fP to scale the width of the image so that pixels in the
+resulting PPM image are square (and hence circles appear as true
+circles, not ellipses).  The scaling is performed in the vector
+domain, before scan converting the objects.  The results are,
+therefore, superior in appearance to what you'd obtain were you to
+perform the equivalent scaling with \fBpamscale\fP after the bitmap
+had been created.
+
+.TP
+\fB-dir\fP
+The input is assumed to be an AutoCAD slide library file.  A
+directory listing each slide in the library is printed on standard
+error.
+
+.TP
+\fB-height\fP \fIsize\fP
+Scales the image in the vector domain so it is \fIsize\fP pixels
+in height.  If you don't specify \fB-width\fP or \fB-xsize\fP,
+\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio.
+
+.TP
+\fB-info\fP
+Dump the slide file header on standard error, displaying the original
+screen size and aspect ratio among other information.
+
+.TP
+\fB-lib\fP \fIname\fP
+Extracts the slide with the given \fIname\fP from the slide
+library given as input.  \fBsldtoppm\fP converts the specified
+\fIname\fP to upper case.
+
+.TP
+\fB-Lib\fP\fI name\fP
+Extracts the slide with the given \fIname\fP from the slide
+library given as input.  \fBsldtoppm\fP uses \fIname\fP in the case
+specified; it does not convert it to upper case.
+
+.TP
+\fB-scale\fP \fIs\fP
+Scales the image by factor \fIs\fP, which may be any floating
+point value greater than zero.  \fBsldtoppm\fP does the scaling after
+aspect ratio adjustment, if any.  Since it does the scaling in the
+vector domain, before rasterisation, the results look much better than
+running the output of \fBsldtoppm\fP through \fBpamscale\fP.
+
+.TP
+\fB-verbose\fP
+Dumps the slide file header and lists every vector and polygon 
+to Standard Error.
+
+.TP
+\fB-width\fP \fIsize\fP
+Scales the image in the vector domain so it is \fIsize\fP pixels
+wide.  If you don't specify \fB-height\fP or \fB-ysize\fP,
+\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio.
+
+.TP
+\fB-xsize\fP \fIsize\fP
+Scales the image in the vector domain so it is \fIsize\fP pixels
+wide.  If you don't specify \fB-height\fP or \fB-ysize\fP,
+\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio.
+
+.TP
+\fB-ysize\fP \fIsize\fP
+Scales the image in the vector domain so it is \fIsize\fP pixels
+in height.  If you don't specify \fB-width\fP or \fB-xsize\fP,
+\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio.
+
+
+
+.UN limitations
+.SH LIMITATIONS
+.PP
+\fBsldtoppm\fP can convert only Level 2 slides.  Level 1 format
+has been obsolete since the advent of AutoCAD Release 9 in 1987, and
+was not portable across machine architectures.
+.PP
+Slide library items with names containing 8 bit (such as ISO) or 16
+bit (Kanji, for example) characters may not be found when chosen with
+the \fB-lib\fP option unless \fBsldtoppm\fP was built with character
+set conversion functions appropriate to the locale.  You can always
+retrieve slides from libraries regardless of the character set by
+using the \fB-Lib\fP option and specifying the precise name of
+library member.  Use the \fB-dir\fP option to list the slides in a
+library if you're unsure of the exact name.
+
+.UN seealso
+.SH SEE ALSO
+
+AutoCAD Reference Manual: \fISlide File Format\fP,
+.BR "pamscale" (1)\c
+\&,
+.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/sldtoppm.html
+.PP
+\ No newline at end of file