| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Sldtoppm User Manual" 1 "10 October 1991" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
|
| 10 |
sldtoppm - convert an AutoCAD slide file to a PPM image |
| 11 |
|
| 12 |
.UN synopsis |
| 13 |
.SH SYNOPSIS |
| 14 |
|
| 15 |
\fBsldtoppm\fP |
| 16 |
[\fB-adjust\fP] |
| 17 |
[\fB-dir\fP] |
| 18 |
[{\fB-height\fP|\fB-ysize\fP} \fIs\fP] |
| 19 |
[\fB-info\fP] |
| 20 |
[{\fB-lib\fP|\fB-Lib\fP} \fIname\fP] |
| 21 |
[\fB-scale\fP \fIs\fP] |
| 22 |
[\fB-verbose\fP] |
| 23 |
[{\fB-width\fP|\fB-xsize\fP} \fIs\fP] |
| 24 |
[\fIslidefile\fP] |
| 25 |
.PP |
| 26 |
All options can be abbreviated to their shortest unique prefix. |
| 27 |
|
| 28 |
.UN description |
| 29 |
.SH DESCRIPTION |
| 30 |
.PP |
| 31 |
This program is part of |
| 32 |
.BR "Netpbm" (1)\c |
| 33 |
\&. |
| 34 |
.PP |
| 35 |
\fBsldtoppm\fP reads an AutoCAD\*R slide file and outputs a PPM |
| 36 |
image. If you don't specify \fIslidefile\fP, \fBsldtoppm\fP reads |
| 37 |
input from Standard Input. \fBsldtoppm\fP uses the \fBppmdraw\fP |
| 38 |
library to convert the vector and polygon information in the slide |
| 39 |
file to a raster; see the file \fBppmdraw.h\fP for details on this |
| 40 |
package. |
| 41 |
|
| 42 |
.UN options |
| 43 |
.SH OPTIONS |
| 44 |
.PP |
| 45 |
In addition to the options common to all programs based on libnetpbm |
| 46 |
(most notably \fB-quiet\fP, see |
| 47 |
.UR index.html#commonoptions |
| 48 |
Common Options |
| 49 |
.UE |
| 50 |
\&), \fBsldtoppm\fP recognizes the following |
| 51 |
command line options: |
| 52 |
|
| 53 |
|
| 54 |
.TP |
| 55 |
\fB-adjust\fP |
| 56 |
If the display on which the slide file was created had non-square |
| 57 |
pixels, when you process the slide with \fBsldtoppm\fP and don't |
| 58 |
specify \fB-adjust\fP, \fBsldtoppm\fP issues the following warning; |
| 59 |
|
| 60 |
.RS |
| 61 |
Warning - pixels on source screen were non-square. |
| 62 |
.RE |
| 63 |
.sp |
| 64 |
Specifying \fB-adjust\fP will correct the image width to |
| 65 |
compensate. Specifying the \fB-adjust\fP option causes |
| 66 |
\fBsldtoppm\fP to scale the width of the image so that pixels in the |
| 67 |
resulting PPM image are square (and hence circles appear as true |
| 68 |
circles, not ellipses). The scaling is performed in the vector |
| 69 |
domain, before scan converting the objects. The results are, |
| 70 |
therefore, superior in appearance to what you'd obtain were you to |
| 71 |
perform the equivalent scaling with \fBpamscale\fP after the bitmap |
| 72 |
had been created. |
| 73 |
|
| 74 |
.TP |
| 75 |
\fB-dir\fP |
| 76 |
The input is assumed to be an AutoCAD slide library file. A |
| 77 |
directory listing each slide in the library is printed on standard |
| 78 |
error. |
| 79 |
|
| 80 |
.TP |
| 81 |
\fB-height\fP \fIsize\fP |
| 82 |
Scales the image in the vector domain so it is \fIsize\fP pixels |
| 83 |
in height. If you don't specify \fB-width\fP or \fB-xsize\fP, |
| 84 |
\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio. |
| 85 |
|
| 86 |
.TP |
| 87 |
\fB-info\fP |
| 88 |
Dump the slide file header on standard error, displaying the original |
| 89 |
screen size and aspect ratio among other information. |
| 90 |
|
| 91 |
.TP |
| 92 |
\fB-lib\fP \fIname\fP |
| 93 |
Extracts the slide with the given \fIname\fP from the slide |
| 94 |
library given as input. \fBsldtoppm\fP converts the specified |
| 95 |
\fIname\fP to upper case. |
| 96 |
|
| 97 |
.TP |
| 98 |
\fB-Lib\fP\fI name\fP |
| 99 |
Extracts the slide with the given \fIname\fP from the slide |
| 100 |
library given as input. \fBsldtoppm\fP uses \fIname\fP in the case |
| 101 |
specified; it does not convert it to upper case. |
| 102 |
|
| 103 |
.TP |
| 104 |
\fB-scale\fP \fIs\fP |
| 105 |
Scales the image by factor \fIs\fP, which may be any floating |
| 106 |
point value greater than zero. \fBsldtoppm\fP does the scaling after |
| 107 |
aspect ratio adjustment, if any. Since it does the scaling in the |
| 108 |
vector domain, before rasterisation, the results look much better than |
| 109 |
running the output of \fBsldtoppm\fP through \fBpamscale\fP. |
| 110 |
|
| 111 |
.TP |
| 112 |
\fB-verbose\fP |
| 113 |
Dumps the slide file header and lists every vector and polygon |
| 114 |
to Standard Error. |
| 115 |
|
| 116 |
.TP |
| 117 |
\fB-width\fP \fIsize\fP |
| 118 |
Scales the image in the vector domain so it is \fIsize\fP pixels |
| 119 |
wide. If you don't specify \fB-height\fP or \fB-ysize\fP, |
| 120 |
\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio. |
| 121 |
|
| 122 |
.TP |
| 123 |
\fB-xsize\fP \fIsize\fP |
| 124 |
Scales the image in the vector domain so it is \fIsize\fP pixels |
| 125 |
wide. If you don't specify \fB-height\fP or \fB-ysize\fP, |
| 126 |
\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio. |
| 127 |
|
| 128 |
.TP |
| 129 |
\fB-ysize\fP \fIsize\fP |
| 130 |
Scales the image in the vector domain so it is \fIsize\fP pixels |
| 131 |
in height. If you don't specify \fB-width\fP or \fB-xsize\fP, |
| 132 |
\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio. |
| 133 |
|
| 134 |
|
| 135 |
|
| 136 |
.UN limitations |
| 137 |
.SH LIMITATIONS |
| 138 |
.PP |
| 139 |
\fBsldtoppm\fP can convert only Level 2 slides. Level 1 format |
| 140 |
has been obsolete since the advent of AutoCAD Release 9 in 1987, and |
| 141 |
was not portable across machine architectures. |
| 142 |
.PP |
| 143 |
Slide library items with names containing 8 bit (such as ISO) or 16 |
| 144 |
bit (Kanji, for example) characters may not be found when chosen with |
| 145 |
the \fB-lib\fP option unless \fBsldtoppm\fP was built with character |
| 146 |
set conversion functions appropriate to the locale. You can always |
| 147 |
retrieve slides from libraries regardless of the character set by |
| 148 |
using the \fB-Lib\fP option and specifying the precise name of |
| 149 |
library member. Use the \fB-dir\fP option to list the slides in a |
| 150 |
library if you're unsure of the exact name. |
| 151 |
|
| 152 |
.UN seealso |
| 153 |
.SH SEE ALSO |
| 154 |
|
| 155 |
AutoCAD Reference Manual: \fISlide File Format\fP, |
| 156 |
.BR "pamscale" (1)\c |
| 157 |
\&, |
| 158 |
.BR "ppm" (1)\c |
| 159 |
\& |
| 160 |
|
| 161 |
.UN author |
| 162 |
.SH AUTHOR |
| 163 |
|
| 164 |
.nf |
| 165 |
John Walker |
| 166 |
Autodesk SA |
| 167 |
Avenue des Champs-Montants 14b |
| 168 |
CH-2074 MARIN |
| 169 |
Suisse/Schweiz/Svizzera/Svizra/Switzerland |
| 170 |
\fBUsenet:\fP\[email protected]\fP |
| 171 |
\fBFax:\fP038/33 88 15 |
| 172 |
\fBVoice:\fP038/33 76 33 |
| 173 |
|
| 174 |
.fi |
| 175 |
.PP |
| 176 |
Permission to use, copy, modify, and distribute this software and its |
| 177 |
documentation for any purpose and without fee is hereby granted, |
| 178 |
without any conditions or restrictions. This software is provided |
| 179 |
"as is" without express or implied warranty. |
| 180 |
.PP |
| 181 |
AutoCAD and Autodesk are registered trademarks of Autodesk, Inc. |
| 182 |
.SH DOCUMENT SOURCE |
| 183 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 184 |
source. The master documentation is at |
| 185 |
.IP |
| 186 |
.B http://netpbm.sourceforge.net/doc/sldtoppm.html |
| 187 |
.PP |