sldtoppm - Man Page

convert an AutoCAD slide file to a PPM image

Examples (TL;DR)

Synopsis

sldtoppm [-adjust] [-dir] [{-height|-ysize} s] [-info] [{-lib|-Lib} name] [-scale s] [-verbose] [{-width|-xsize} s] [slidefile]

All options can be abbreviated to their shortest unique prefix.

Description

This program is part of Netpbm(1).

sldtoppm reads an AutoCAD® slide file and outputs a PPM image.  If you don't specify slidefile, sldtoppm reads input from Standard Input.  sldtoppm uses the ppmdraw library to convert the vector and polygon information in the slide file to a raster; see the file ppmdraw.h for details on this package.

Options

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), sldtoppm recognizes the following command line options:

-adjust

If the display on which the slide file was created had non-square pixels, when you process the slide with sldtoppm and don't specify -adjust, sldtoppm issues the following warning;

Warning - pixels on source screen were non-square.

Specifying -adjust will correct the image width to compensate.  Specifying the -adjust option causes sldtoppm 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 pamscale after the bitmap had been created.

-dir

The input is assumed to be an AutoCAD slide library file.  A directory listing each slide in the library is printed on standard error.

-height size

Scales the image in the vector domain so it is size pixels in height.  If you don't specify -width or -xsize, sldtoppm adjusts the width to preserve the pixel aspect ratio.

-info

Dump the slide file header on standard error, displaying the original screen size and aspect ratio among other information.

-lib name

Extracts the slide with the given name from the slide library given as input.  sldtoppm converts the specified name to upper case.

-Lib name

Extracts the slide with the given name from the slide library given as input.  sldtoppm uses name in the case specified; it does not convert it to upper case.

-scale s

Scales the image by factor s, which may be any floating point value greater than zero.  sldtoppm 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 sldtoppm through pamscale.

-verbose

Dumps the slide file header and lists every vector and polygon  to Standard Error.

-width size

Scales the image in the vector domain so it is size pixels wide.  If you don't specify -height or -ysize, sldtoppm adjusts the height to preserve the pixel aspect ratio.

-xsize size

Scales the image in the vector domain so it is size pixels wide.  If you don't specify -height or -ysize, sldtoppm adjusts the height to preserve the pixel aspect ratio.

-ysize size

Scales the image in the vector domain so it is size pixels in height.  If you don't specify -width or -xsize, sldtoppm adjusts the width to preserve the pixel aspect ratio.

Limitations

sldtoppm 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.

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 -lib option unless sldtoppm 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 -Lib option and specifying the precise name of library member.  Use the -dir option to list the slides in a library if you're unsure of the exact name.

See Also

AutoCAD Reference Manual: Slide File Format, pamscale(1), ppm(1)

Author

John Walker
Autodesk SA
Avenue des Champs-Montants 14b
CH-2074 MARIN
Suisse/Schweiz/Svizzera/Svizra/Switzerland
    Usenet:kelvin@Autodesk.com
    Fax:038/33 88 15
    Voice:038/33 76 33

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.

AutoCAD and Autodesk are registered trademarks of Autodesk, Inc.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

http://netpbm.sourceforge.net/doc/sldtoppm.html

Info

10 October 1991 netpbm documentation