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.