sldtoppm(1) - man - phpMan

sldtoppm(1)                            General Commands Manual                           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® 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  Au‐
       toCAD 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 AT 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)