Debian Codegraph @

upstream/debian-unstable/man1/ppmtoacad.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 "Ppmtoacad User Manual" 1 "10 October 1991" "netpbm documentation"
7
8 .SH NAME
9
10 ppmtoacad - convert PPM to Autocad database or slide
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmtoacad\fP
16
17 [\fB-dxb\fP]
18
19 [\fB-poly\fP]
20
21 [\fB-background\fP \fIcolor\fP]
22
23 [\fB-white\fP]
24
25 [\fB-aspect\fP \fIratio\fP]
26
27 [\fB-8\fP]
28
29 [\fIppmfile\fP]
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 \fBppmtoacad\fP reads a PPM image as input and produces an
39 Autocad\*R slide file or binary database import (.dxb) file as
40 output. If you don't specify \fIppmfile\fP,
41 \fBppmtoacad\fP takes the input from Standard Input.
42 .PP
43 (Typographical note: the name of Autocad is often rendered as
44 AutoCAD. Netpbm documentation uses standard American typography, wherein
45 that is not a valid form of capitalization).
46
47 .UN options
48 .SH OPTIONS
49 .PP
50 In addition to the options common to all programs based on libnetpbm
51 (most notably \fB-quiet\fP, see
52 .UR index.html#commonoptions
53 Common Options
54 .UE
55 \&), \fBppmtoacad\fP recognizes the following
56 command line options:
57 .PP
58 You may abbreviate any option to its shortest unique prefix.
59
60
61 .TP
62 \fB-dxb\fP
63 \fBppmtoacad\fP writes an Autocad binary database import (.dxb)
64 file. You read this file with the DXBIN command and, once loaded, it
65 becomes part of the Autocad geometrical database, so you can view and
66 edit it like any other object. Each sequence of identical pixels
67 becomes a separate object in the database; this can result in very
68 large Autocad drawing files. However, if you want to trace over a
69 bitmap, it lets you zoom and pan around the bitmap as you wish.
70
71 .TP
72 \fB-poly\fP
73 If you don't specify the \fB-dxb\fP option, \fBppmtoacad\fP
74 generates an Autocad slide file. Normally each row of pixels is
75 represented by an Autocad line entity. If you specify \fB-poly\fP,
76 \fBppmtoacad\fP renders the pixels as filled polygons. If you view
77 the slide on a display with higher resolution than the source image,
78 this will cause the pixels to expand instead of appearing as discrete
79 lines against the screen background color. Regrettably, this
80 representation yields slide files which occupy more storage space and
81 take longer to display.
82
83 .TP
84 \fB-background\fP \fIcolor\fP
85 Most Autocad display drivers can be configured to use any
86 available color as the screen background. Some users prefer a black
87 screen background, others white, while splinter groups advocate burnt
88 ocher, tawny puce, and shocking gray. Discarding pixels whose closest
89 Autocad color representation is equal to the background color can
90 substantially reduce the size of the Autocad database or slide file
91 needed to represent a bitmap. If you don't specify
92 \fB-background\fP, \fBppmtoacad\fP assumes the screen background
93 color to be black. You may specify any Autocad color number as the
94 screen background; \fBppmtoacad\fP assumes color numbers to specify
95 the hues defined in the standard Autocad 256 color palette.
96
97 .TP
98 \fB-white\fP
99 Since many Autocad users choose a white screen background, this
100 option is provided as a short-cut. Specifying \fB-white\fP is
101 identical in effect to \fB-background 7\fP.
102
103 .TP
104 \fB-aspect\fP \fIratio\fP
105 If the source image had non-square pixels (which means it is not
106 standard PPM), specify the ratio of the pixel width to pixel height as
107 \fIratio\fP. \fBppmtoacad\fP will correct the resulting slide or
108 \&.dxb file so that pixels on the Autocad screen will be square. For
109 example, to correct an image made for a 320x200 VGA/MCGA screen,
110 specify \fB-aspect 0.8333\fP.
111
112 .TP
113 \fB-8\fP
114 Restricts the colors in the output file to the 8 RGB shades.
115
116
117 .UN restrictions
118 .SH RESTRICTIONS
119 .PP
120 Autocad has a fixed palette of 256 colors, distributed along the
121 hue, lightness, and saturation axes. So it may poorly render images
122 which contain many nearly-identical colors, or colors not closely
123 approximated by Autocad's palette.
124 .PP
125 \fBppmtoacad\fP works best if the system displaying its output can
126 display the full 256 color Autocad palette. Monochrome, 8 color, and
127 16 color configurations will produce less than optimal results.
128 .PP
129 When creating a .dxb file or a slide file with the \fB-poly\fP
130 option, \fBppmtoacad\fP finds both vertical and horizontal runs of
131 identical pixels and consolidates them into rectangular regions to
132 reduce the size of the output file. This is effective for images with
133 large areas of constant color but it's no substitute for true raster
134 to vector conversion. In particular, this process does not optimize
135 thin diagonal lines at all.
136 .PP
137 Output files can be huge.
138
139 .UN seealso
140 .SH SEE ALSO
141 .PP
142 Autocad Reference Manual: \fISlide File Format\fP and \fIBinary
143 Drawing Interchange (DXB) Files\fP,
144 .BR "ppm" (1)\c
145 \&
146
147 .UN author
148 .SH AUTHOR
149
150 .nf
151 John Walker
152 Autodesk SA
153 Avenue des Champs-Montants 14b
154 CH-2074 MARIN
155 Suisse/Schweiz/Svizzera/Svizra/Switzerland
156 \fBUsenet:\fP\[email protected]\fP
157 \fBFax:\fP038/33 88 15
158 \fBVoice:\fP038/33 76 33
159
160 .fi
161 .PP
162 Permission to use, copy, modify, and distribute this software and
163 its documentation for any purpose and without fee is hereby granted,
164 without any conditions or restrictions. This software is provided
165 "as is" without express or implied warranty.
166 .PP
167 Autocad and Autodesk are registered trademarks of Autodesk, Inc.
168 .SH DOCUMENT SOURCE
169 This manual page was generated by the Netpbm tool 'makeman' from HTML
170 source. The master documentation is at
171 .IP
172 .B http://netpbm.sourceforge.net/doc/ppmtoacad.html
173 .PP