diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/ppmtoacad.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/ppmtoacad.1 | 173 |
1 files changed, 173 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/ppmtoacad.1 b/upstream/debian-bookworm/man1/ppmtoacad.1 new file mode 100644 index 00000000..b123523f --- /dev/null +++ b/upstream/debian-bookworm/man1/ppmtoacad.1 @@ -0,0 +1,173 @@ +\ +.\" 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" 1 "10 October 1991" "netpbm documentation" + +.SH NAME + +ppmtoacad - convert PPM to Autocad database or slide + +.UN synopsis +.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 description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.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 options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBppmtoacad\fP recognizes the following +command line 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 restrictions +.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 seealso +.SH SEE ALSO +.PP +Autocad Reference Manual: \fISlide File Format\fP and \fIBinary +Drawing Interchange (DXB) Files\fP, +.BR "ppm" (1)\c +\& + +.UN author +.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. +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/ppmtoacad.html +.PP
\ No newline at end of file |