sldtoppm(1)						      General Commands Manual						       sldtoppm(1)

NAME

       sldtoppm - convert an AutoCAD slide file into a portable pixmap

SYNOPSIS

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

DESCRIPTION

       Reads  an  AutoCAD(R) slide file and outputs a portable pixmap.	If no slidefile is specified, input is read from standard input.  The ppm-
       draw library is used to convert the vector and polygon information in the slide file to a pixmap; see the file  ppmdraw.h  for  details	on
       this package.

OPTIONS

       -adjust
	      If  the display on which the slide file was created had non-square pixels, when the slide is processed with sldtoppm and the -adjust
	      option is not present, the following warning will appear:
		Warning - pixels on source screen were non-square.
		Specifying -adjust will correct image width to compensate.
	      Specifying the -adjust option causes sldtoppm to scale the width of the image so that pixels in the resulting  portable  pixmap  are
	      square  (and  hence  circles appear as true circles, not ellipses).  The scaling is performed in the vector domain, before scan con-
	      verting the objects.  The results are, therefore, superior in appearance to what you'd obtain were you  to  perform  the	equivalent
	      scaling with pnmscale 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 no -width or -xsize option is specified, the width will be
	      adjusted 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.  The specified name is converted to upper case.

       -Lib name
	      Extracts the slide with the given name from the slide library given as input.  The name is used exactly as specified; it is not con-
	      verted to upper case.

       -scale s
	      Scales the image by factor s, which may be any floating point value greater than zero.  Scaling is done after aspect  ratio  adjust-
	      ment,  if any.  Since scaling is performed in the vector domain, before rasterisation, the results look much better than running the
	      output of sldtoppm through pnmscale.

       -verbose
	      Dumps the slide file header and lists every vector and polygon in the file on standard error.

       -width size
	      Scales the image in the vector domain so it is size pixels wide.	If no -height or -ysize option is specified, the  height  will	be
	      adjusted to preserve the pixel aspect ratio.

       -xsize size
	      Scales  the  image  in the vector domain so it is size pixels wide.  If no -height or -ysize option is specified, the height will be
	      adjusted to preserve the pixel aspect ratio.

       -ysize size
	      Scales the image in the vector domain so it is size pixels in height.  If no -width or -xsize option is specified, the width will be
	      adjusted to preserve the pixel aspect ratio.

       All flags can be abbreviated to their shortest unique prefix.

BUGS

       Only  Level  2  slides are converted.  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 has been 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, pnmscale(1), ppm(5)

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.

								  10 October 1991						       sldtoppm(1)