dwww Home | Manual pages | Find package

Sldtoppm User Manual(1)     General Commands Manual    Sldtoppm User Manual(1)

NAME
       sldtoppm - convert an AutoCAD slide file to a PPM image

SYNOPSIS
       sldtoppm  [-adjust]  [-dir]  [{-height|-ysize}  s] [-info] [{-lib|-Lib}
       name] [-scale s] [-verbose] [{-width|-xsize} s] [slidefile]

       All options can be abbreviated to their shortest unique prefix.

DESCRIPTION
       This program is part of Netpbm(1).

       sldtoppm reads an AutoCAD® slide file and outputs a PPM image.  If  you
       don't  specify  slidefile,  sldtoppm  reads  input from Standard Input.
       sldtoppm uses the ppmdraw library to convert the vector and polygon in-
       formation in the slide file to a raster; see the file ppmdraw.h for de-
       tails on this package.

OPTIONS
       In addition to the options common to all programs  based  on  libnetpbm
       (most notably -quiet, see
        Common  Options  ⟨index.html#commonoptions⟩ ), sldtoppm recognizes the
       following command line options:

       -adjust
              If the display on which the slide  file  was  created  had  non-
              square  pixels,  when  you  process  the slide with sldtoppm and
              don't specify -adjust, sldtoppm issues the following warning;

              Warning - pixels on source screen were non-square.

       Specifying -adjust will correct the image width to compensate.   Speci-
       fying  the -adjust option causes sldtoppm to scale the width of the im-
       age so that pixels in the resulting PPM image  are  square  (and  hence
       circles  appear  as  true  circles, not ellipses).  The scaling is per-
       formed 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 pamscale after the bit-
       map had been created.

       -dir   The input is assumed to be an AutoCAD slide library file.  A di-
              rectory 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 you don't specify -width or -xsize, sldtoppm adjusts
              the width 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.  sldtoppm converts the specified name to upper
              case.

       -Lib name
              Extracts the slide with the given name from  the  slide  library
              given  as  input.   sldtoppm uses name in the case specified; it
              does not convert it to upper case.

       -scale s
              Scales the image by factor s, which may be  any  floating  point
              value greater than zero.  sldtoppm does the scaling after aspect
              ratio adjustment, if any.  Since it does the scaling in the vec-
              tor  domain,  before rasterisation, the results look much better
              than running the output of sldtoppm through pamscale.

       -verbose
              Dumps the slide file header and lists every vector  and  polygon
              to Standard Error.

       -width size
              Scales the image in the vector domain so it is size pixels wide.
              If you don't specify -height or  -ysize,  sldtoppm  adjusts  the
              height to preserve the pixel aspect ratio.

       -xsize size
              Scales the image in the vector domain so it is size pixels wide.
              If you don't specify -height or  -ysize,  sldtoppm  adjusts  the
              height to preserve the pixel aspect ratio.

       -ysize size
              Scales  the  image  in the vector domain so it is size pixels in
              height.  If you don't specify -width or -xsize, sldtoppm adjusts
              the width to preserve the pixel aspect ratio.

LIMITATIONS
       sldtoppm  can convert only Level 2 slides.  Level 1 format has been ob-
       solete since the advent of AutoCAD Release 9 in 1987, and was not  por-
       table 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  was 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, pamscale(1), ppm(1)

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.

DOCUMENT SOURCE
       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
       source.  The master documentation is at

              http://netpbm.sourceforge.net/doc/sldtoppm.html

netpbm documentation            10 October 1991        Sldtoppm User Manual(1)

Generated by dwww version 1.15 on Sat Jun 29 02:37:44 CEST 2024.