\
.\" 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 "Ppmtoacad User Manual" 0 "10 October 1991" "netpbm documentation"

.UN lbAB
.SH NAME

ppmtoacad - convert PPM to Autocad database or slide

.UN lbAC
.SH SYNOPSIS


\fBppmtoacad\fP

[\fB-dxb\fP]

[\fB-poly\fP]

[\fB-background\fP \fIcolor\fP]

[\fB-white\fP]

[\fB-aspect\fP \fIratio\fP]

[\fB-8\fP]

[\fIppmfile\fP]


.UN lbAD
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBppmtoacad\fP reads a PPM image as input and produces an
Autocad\*R slide file or binary database import (.dxb) file as
output.  If you don't specify \fIppmfile\fP,
\fBppmtoacad\fP takes the input from Standard Input.
.PP
(Typographical note: the name of Autocad is often rendered as
AutoCAD.  Netpbm documentation uses standard American typography, wherein
that is not a valid form of capitalization).

.UN lbAE
.SH OPTIONS
.PP
You may abbreviate any option to its shortest unique prefix.


.TP
\fB-dxb\fP
\fBppmtoacad\fP writes an Autocad binary database import (.dxb)
file.  You read this file with the DXBIN command and, once loaded, it
becomes part of the Autocad geometrical database, so you can view and
edit it like any other object.  Each sequence of identical pixels
becomes a separate object in the database; this can result in very
large Autocad drawing files.  However, if you want to trace over a
bitmap, it lets you zoom and pan around the bitmap as you wish.

.TP
\fB-poly\fP
If you don't specify the \fB-dxb\fP option, \fBppmtoacad\fP
generates an Autocad slide file.  Normally each row of pixels is
represented by an Autocad line entity.  If you specify \fB-poly\fP,
\fBppmtoacad\fP renders the pixels as filled polygons.  If you view
the slide on a display with higher resolution than the source image,
this will cause the pixels to expand instead of appearing as discrete
lines against the screen background color.  Regrettably, this
representation yields slide files which occupy more storage space and
take longer to display.

.TP
\fB-background\fP \fIcolor\fP
Most Autocad display drivers can be configured to use any
available color as the screen background.  Some users prefer a black
screen background, others white, while splinter groups advocate burnt
ocher, tawny puce, and shocking gray.  Discarding pixels whose closest
Autocad color representation is equal to the background color can
substantially reduce the size of the Autocad database or slide file
needed to represent a bitmap.  If you don't specify
\fB-background\fP, \fBppmtoacad\fP assumes the screen background
color to be black.  You may specify any Autocad color number as the
screen background; \fBppmtoacad\fP assumes color numbers to specify
the hues defined in the standard Autocad 256 color palette.

.TP
\fB-white\fP
Since many Autocad users choose a white screen background, this
option is provided as a short-cut.  Specifying \fB-white\fP is
identical in effect to \fB-background 7\fP.

.TP
\fB-aspect\fP \fIratio\fP
If the source image had non-square pixels (which means it is not
standard PPM), specify the ratio of the pixel width to pixel height as
\fIratio\fP.  \fBppmtoacad\fP will correct the resulting slide or
\&.dxb file so that pixels on the Autocad screen will be square.  For
example, to correct an image made for a 320x200 VGA/MCGA screen,
specify \fB-aspect 0.8333\fP.

.TP
\fB-8\fP
Restricts the colors in the output file to the 8 RGB shades.


.UN lbAF
.SH RESTRICTIONS
.PP
Autocad has a fixed palette of 256 colors, distributed along the
hue, lightness, and saturation axes.  So it may poorly render images
which contain many nearly-identical colors, or colors not closely
approximated by Autocad's palette.
.PP
\fBppmtoacad\fP works best if the system displaying its output can
display the full 256 color Autocad palette.  Monochrome, 8 color, and
16 color configurations will produce less than optimal results.
.PP
When creating a .dxb file or a slide file with the \fB-poly\fP
option, \fBppmtoacad\fP finds both vertical and horizontal runs of
identical pixels and consolidates them into rectangular regions to
reduce the size of the output file.  This is effective for images with
large areas of constant color but it's no substitute for true raster
to vector conversion.  In particular, this process does not optimize
thin diagonal lines at all.
.PP
Output files can be huge.

.UN lbAG
.SH SEE ALSO
.PP
Autocad Reference Manual: \fISlide File Format\fP and \fIBinary
Drawing Interchange (DXB) Files\fP,
.BR ppm (5)


.UN lbAH
.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.