sldtoppm(1)                                           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  pack-
       age.

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 pre-
              sent, 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, dis-
              playing 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 pre-
       fix.

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 appro-
       priate 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 soft-
       ware 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                        1