Debian Codegraph @

upstream/debian-unstable/man1/sldtoppm.1

raw
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