diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/sldtoppm.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/sldtoppm.1 | 179 |
1 files changed, 179 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/sldtoppm.1 b/upstream/opensuse-leap-15-6/man1/sldtoppm.1 new file mode 100644 index 00000000..e18fbcf8 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/sldtoppm.1 @@ -0,0 +1,179 @@ +\ +.\" 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 "Sldtoppm User Manual" 0 "10 October 1991" "netpbm documentation" + +.UN lbAB +.SH NAME + +sldtoppm - convert an AutoCAD slide file to a PPM image + +.UN lbAC +.SH SYNOPSIS + +\fBsldtoppm\fP +[\fB-adjust\fP] +[\fB-dir\fP] +[{\fB-height\fP|\fB-ysize\fP} \fIs\fP] +[\fB-info\fP] +[{\fB-lib\fP|\fB-Lib\fP} \fIname\fP] +[\fB-scale\fP \fIs\fP] +[\fB-verbose\fP] +[{\fB-width\fP|\fB-xsize\fP} \fIs\fP] +[\fIslidefile\fP] +.PP +All options can be abbreviated to their shortest unique prefix. + +.UN lbAD +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBsldtoppm\fP reads an AutoCAD\*R slide file and outputs a PPM +image. If you don't specify \fIslidefile\fP, \fBsldtoppm\fP reads +input from Standard Input. \fBsldtoppm\fP uses the \fBppmdraw\fP +library to convert the vector and polygon information in the slide +file to a raster; see the file \fBppmdraw.h\fP for details on this +package. + +.UN lbAE +.SH OPTIONS + + +.TP +\fB-adjust\fP +If the display on which the slide file was created had non-square +pixels, when you process the slide with \fBsldtoppm\fP and don't +specify \fB-adjust\fP, \fBsldtoppm\fP issues the following warning; + +.RS +Warning - pixels on source screen were non-square. +.RE +.sp +Specifying \fB-adjust\fP will correct the image width to +compensate. Specifying the \fB-adjust\fP option causes +\fBsldtoppm\fP to scale the width of the image so that pixels in the +resulting PPM image are square (and hence circles appear as true +circles, not ellipses). The scaling is performed in the vector +domain, before scan converting the objects. The results are, +therefore, superior in appearance to what you'd obtain were you to +perform the equivalent scaling with \fBpamscale\fP after the bitmap +had been created. + +.TP +\fB-dir\fP +The input is assumed to be an AutoCAD slide library file. A +directory listing each slide in the library is printed on standard +error. + +.TP +\fB-height\fP \fIsize\fP +Scales the image in the vector domain so it is \fIsize\fP pixels +in height. If you don't specify \fB-width\fP or \fB-xsize\fP, +\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio. + +.TP +\fB-info\fP +Dump the slide file header on standard error, displaying the original +screen size and aspect ratio among other information. + +.TP +\fB-lib\fP \fIname\fP +Extracts the slide with the given \fIname\fP from the slide +library given as input. \fBsldtoppm\fP converts the specified +\fIname\fP to upper case. + +.TP +\fB-Lib\fP\fI name\fP +Extracts the slide with the given \fIname\fP from the slide +library given as input. \fBsldtoppm\fP uses \fIname\fP in the case +specified; it does not convert it to upper case. + +.TP +\fB-scale\fP \fIs\fP +Scales the image by factor \fIs\fP, which may be any floating +point value greater than zero. \fBsldtoppm\fP does the scaling after +aspect ratio adjustment, if any. Since it does the scaling in the +vector domain, before rasterisation, the results look much better than +running the output of \fBsldtoppm\fP through \fBpamscale\fP. + +.TP +\fB-verbose\fP +Dumps the slide file header and lists every vector and polygon +to Standard Error. + +.TP +\fB-width\fP \fIsize\fP +Scales the image in the vector domain so it is \fIsize\fP pixels +wide. If you don't specify \fB-height\fP or \fB-ysize\fP, +\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio. + +.TP +\fB-xsize\fP \fIsize\fP +Scales the image in the vector domain so it is \fIsize\fP pixels +wide. If you don't specify \fB-height\fP or \fB-ysize\fP, +\fBsldtoppm\fP adjusts the height to preserve the pixel aspect ratio. + +.TP +\fB-ysize\fP \fIsize\fP +Scales the image in the vector domain so it is \fIsize\fP pixels +in height. If you don't specify \fB-width\fP or \fB-xsize\fP, +\fBsldtoppm\fP adjusts the width to preserve the pixel aspect ratio. + + + +.UN lbAF +.SH LIMITATIONS +.PP +\fBsldtoppm\fP can convert only Level 2 slides. Level 1 format +has been obsolete since the advent of AutoCAD Release 9 in 1987, and +was not portable across machine architectures. +.PP +Slide library items with names containing 8 bit (such as ISO) or 16 +bit (Kanji, for example) characters may not be found when chosen with +the \fB-lib\fP option unless \fBsldtoppm\fP was built with character +set conversion functions appropriate to the locale. You can always +retrieve slides from libraries regardless of the character set by +using the \fB-Lib\fP option and specifying the precise name of +library member. Use the \fB-dir\fP option to list the slides in a +library if you're unsure of the exact name. + +.UN lbAG +.SH SEE ALSO + +AutoCAD Reference Manual: \fISlide File Format\fP, +.BR "pamscale" (1)\c +\&, +.BR "ppm" (5)\c +\& + +.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. +.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/sldtoppm.html +.PP
\ No newline at end of file |