Provided by: netpbm_10.0-15ubuntu2_amd64 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)