Manual: sldtoppm

Sldtoppm User Manual(1)				   General Commands Manual			     Sldtoppm User Manual(1)

NAME
       sldtoppm - convert an AutoCAD slide file to a PPM image

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 sld‐
	      toppm 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 re‐
       sults 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 raster‐
	      isation, 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, sld‐
	      toppm 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, sld‐
	      toppm 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 op‐
       tion 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	 im‐
       plied 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

netpbm documentation				       10 October 1991				     Sldtoppm User Manual(1)