sldtoppm(1)             UNIX System V(10 October 1991)              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(Reg.) 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.





10/89                                                                    Page 1

sldtoppm(1)             UNIX System V(10 October 1991)              sldtoppm(1)


      -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




Page 2                                                                    10/89

sldtoppm(1)             UNIX System V(10 October 1991)              sldtoppm(1)


           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/89                                                                    Page 3