\
.\" 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