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

netpbm documentation                             10 October 1991                         Sldtoppm User Manual(1)