Provided by: netpbm_10.0-12_i386 bug

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® slide file and outputs  a  portable  pixmap.   If  no
       slidefile is specified, input is read from standard input.  The ppmdraw
       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
              converting 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 converted 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
              adjustment,  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)