Penguin
Recent Changes
Annotated edit history of sldtoppm(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 sldtoppm
2 !!!sldtoppm
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 BUGS
8 SEE ALSO
9 AUTHOR
10 ----
11 !!NAME
12
13
14 sldtoppm - convert an AutoCAD slide file into a portable pixmap
15 !!SYNOPSIS
16
17
18 __sldtoppm__ [[__-adjust__] [[__-dir__]
19 [[__-height__|__-ysize__ ''s''] [[__-info__]
20 [[__-lib__|__-Lib__ ''name''] [[__-scale__
21 ''s''] [[__-verbose__] [[__-width__|__-xsize__
22 ''s''] [[''slidefile'']
23 !!DESCRIPTION
24
25
26 Reads an AutoCAD slide file and outputs a portable pixmap.
27 If no ''slidefile'' is specified, input is read from
28 standard input. The ppmdraw library is used to convert the
29 vector and polygon information in the slide file to a
30 pixmap; see the file ppmdraw.h for details on this
31 package.
32 !!OPTIONS
33
34
35 __-adjust__
36
37
38 If the display on which the slide file was created had
39 non-square pixels, when the slide is processed with
40 __sldtoppm__ and the __-adjust__ option is not
41 present, the following warning will appear:
42
43
44 Warning - pixels on source screen were non-square.
45 Specifying __-adjust__ will correct image width to
46 compensate.
47
48
49 Specifying the __-adjust__ option causes __sldtoppm__
50 to scale the width of the image so that pixels in the
51 resulting portable pixmap are square (and hence circles
52 appear as true circles, not ellipses). The scaling is
53 performed in the vector domain, before scan converting the
54 objects. The results are, therefore, superior in appearance
55 to what you'd obtain were you to perform the equivalent
56 scaling with __pnmscale__ after the bitmap had been
57 created.
58
59
60 __-dir__
61
62
63 The input is assumed to be an AutoCAD slide library file. A
64 directory listing each slide in the library is printed on
65 standard error.
66
67
68 __-height__ ''size''
69
70
71 Scales the image in the vector domain so it is ''size''
72 pixels in height. If no __-width__ or __-xsize__
73 option is specified, the width will be adjusted to preserve
74 the pixel aspect ratio.
75
76
77 __-info__
78
79
80 Dump the slide file header on standard error, displaying the
81 original screen size and aspect ratio among other
82 information.
83
84
85 __-lib__ ''name''
86
87
88 Extracts the slide with the given ''name'' from the slide
89 library given as input. The specified ''name'' is
90 converted to upper case.
91
92
93 __-Lib__ ''name''
94
95
96 Extracts the slide with the given ''name'' from the slide
97 library given as input. The ''name'' is used exactly as
98 specified; it is not converted to upper case.
99
100
101 __-scale__ ''s''
102
103
104 Scales the image by factor ''s'', which may be any
105 floating point value greater than zero. Scaling is done
106 after aspect ratio adjustment, if any. Since scaling is
107 performed in the vector domain, before rasterisation, the
108 results look much better than running the output of
109 __sldtoppm__ through __pnmscale__.
110
111
112 __-verbose__
113
114
115 Dumps the slide file header and lists every vector and
116 polygon in the file on standard error.
117
118
119 __-width__ ''size''
120
121
122 Scales the image in the vector domain so it is ''size''
123 pixels wide. If no __-height__ or __-ysize__ option is
124 specified, the height will be adjusted to preserve the pixel
125 aspect ratio.
126
127
128 __-xsize__ ''size''
129
130
131 Scales the image in the vector domain so it is ''size''
132 pixels wide. If no __-height__ or __-ysize__ option is
133 specified, the height will be adjusted to preserve the pixel
134 aspect ratio.
135
136
137 __-ysize__ ''size''
138
139
140 Scales the image in the vector domain so it is ''size''
141 pixels in height. If no __-width__ or __-xsize__
142 option is specified, the width will be adjusted to preserve
143 the pixel aspect ratio.
144
145
146 All flags can be abbreviated to their shortest unique
147 prefix.
148 !!BUGS
149
150
151 Only Level 2 slides are converted. Level 1 format has been
152 obsolete since the advent of AutoCAD Release 9 in 1987, and
153 was not portable across machine architectures.
154
155
156 Slide library items with names containing 8 bit (such as
157 ISO) or 16 bit (Kanji, for example) characters may not be
158 found when chosen with the __-lib__ option unless
159 __sldtoppm__ has been built with character set conversion
160 functions appropriate to the locale. You can always retrieve
161 slides from libraries regardless of the character set by
162 using the __-Lib__ option and specifying the precise name
163 of library member. Use the __-dir__ option to list the
164 slides in a library if you're unsure of the exact
165 name.
166 !!SEE ALSO
167
168
169 AutoCAD Reference Manual: ''Slide File Format'',
170 pnmscale(1), ppm(5)
171 !!AUTHOR
172
173
174 John Walker
175 Autodesk SA
176 Avenue des Champs-Montants 14b
177 CH-2074 MARIN
178 Suisse/Schweiz/Svizzera/Svizra/Switzerland
179 Usenet:
180 kelvin@Autodesk.com
181 Fax:
182 038/33 88 15
183 Voice:
184 038/33 76 33
185
186
187 Permission to use, copy, modify, and distribute this
188 software and its documentation for any purpose and without
189 fee is hereby granted, without any conditions or
190 restrictions. This software is provided ``as is'' without
191 express or implied warranty.
192
193
194 AutoCAD and Autodesk are registered trademarks of Autodesk,
195 Inc.
196 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.