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 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  con-
              verting  the  objects.   The results are, therefore, superior in
              appearance to what you'd obtain were you to perform the  equiva-
              lent 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  stan-
              dard 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 conver-
       sion 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, with-
       out 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)