home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / sldtoppm.1 < prev    next >
Encoding:
Text File  |  1995-07-26  |  9.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      ssssllllddddttttooooppppppppmmmm((((1111))))     XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))      ssssllllddddttttooooppppppppmmmm((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           sldtoppm - convert an AutoCAD slide file into a portable
  10.           pixmap
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ssssllllddddttttooooppppppppmmmm [----aaaaddddjjjjuuuusssstttt] [----ddddiiiirrrr] [----hhhheeeeiiiigggghhhhtttt|----yyyyssssiiiizzzzeeee _s] [----iiiinnnnffffoooo] [----
  14.                    lllliiiibbbb|----LLLLiiiibbbb _n_a_m_e] [----ssssccccaaaalllleeee _s] [----vvvveeeerrrrbbbboooosssseeee] [----wwwwiiiiddddtttthhhh|----xxxxssssiiiizzzzeeee
  15.                    _s] [_s_l_i_d_e_f_i_l_e]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           Reads an AutoCAD(Reg.) slide file  and  outputs  a  portable
  19.           pixmap.   If  no  _s_l_i_d_e_f_i_l_e is specified, input is read from
  20.           standard input.  The ppmdraw library is used to convert  the
  21.           vector  and  polygon  information  in  the  slide  file to a
  22.           pixmap; see the file ppmdraw.h for details on this package.
  23.  
  24.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  25.           ----aaaaddddjjjjuuuusssstttt
  26.                If the display on which the slide file was created  had
  27.                non-square  pixels,  when  the  slide is processed with
  28.                ssssllllddddttttooooppppppppmmmm and the ----aaaaddddjjjjuuuusssstttt option  is  not  present,  the
  29.                following warning will appear:
  30.                  Warning - pixels on source screen were non-square.
  31.                  Specifying  ----aaaaddddjjjjuuuusssstttt  will  correct  image  width   to
  32.                  compensate.
  33.                Specifying the ----aaaaddddjjjjuuuusssstttt option causes ssssllllddddttttooooppppppppmmmm to  scale
  34.                the  width of the image so that pixels in the resulting
  35.                portable pixmap are square (and hence circles appear as
  36.                true  circles, not ellipses).  The scaling is performed
  37.                in  the  vector  domain,  before  scan  converting  the
  38.                objects.   The  results  are,  therefore,  superior  in
  39.                appearance to what you'd obtain were you to perform the
  40.                equivalent  scaling  with ppppnnnnmmmmssssccccaaaalllleeee after the bitmap had
  41.                been created.
  42.  
  43.           ----ddddiiiirrrr The input is assumed to be  an  AutoCAD  slide  library
  44.                file.  A directory listing each slide in the library is
  45.                printed on standard error.
  46.  
  47.           ----hhhheeeeiiiigggghhhhtttt _s_i_z_e
  48.                Scales the image in the vector domain  so  it  is  _s_i_z_e
  49.                pixels  in  height.   If  no ----wwwwiiiiddddtttthhhh or ----xxxxssssiiiizzzzeeee option is
  50.                specified, the width will be adjusted to  preserve  the
  51.                pixel aspect ratio.
  52.  
  53.           ----iiiinnnnffffoooo
  54.                Dump  the  slide  file  header   on   standard   error,
  55.                displaying  the  original  screen size and aspect ratio
  56.                among other information.
  57.  
  58.           ----lllliiiibbbb _n_a_m_e
  59.                Extracts the slide with the given _n_a_m_e from  the  slide
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 9/7/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ssssllllddddttttooooppppppppmmmm((((1111))))     XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))      ssssllllddddttttooooppppppppmmmm((((1111))))
  71.  
  72.  
  73.  
  74.                library   given   as  input.   The  specified  _n_a_m_e  is
  75.                converted to upper case.
  76.  
  77.           ----LLLLiiiibbbb _n_a_m_e
  78.                Extracts the slide with the given _n_a_m_e from  the  slide
  79.                library  given  as  input.  The _n_a_m_e is used exactly as
  80.                specified; it is not converted to upper case.
  81.  
  82.           ----ssssccccaaaalllleeee _s
  83.                Scales the image by factor _s, which may be any floating
  84.                point  value  greater than zero.  Scaling is done after
  85.                aspect ratio adjustment,  if  any.   Since  scaling  is
  86.                performed  in  the vector domain, before rasterisation,
  87.                the results look much better than running the output of
  88.                ssssllllddddttttooooppppppppmmmm through ppppnnnnmmmmssssccccaaaalllleeee.
  89.  
  90.           ----vvvveeeerrrrbbbboooosssseeee
  91.                Dumps the slide file header and lists every vector  and
  92.                polygon in the file on standard error.
  93.  
  94.           ----wwwwiiiiddddtttthhhh _s_i_z_e
  95.                Scales the image in the vector domain  so  it  is  _s_i_z_e
  96.                pixels  wide.   If  no  ----hhhheeeeiiiigggghhhhtttt  or  ----yyyyssssiiiizzzzeeee  option  is
  97.                specified, the height will be adjusted to preserve  the
  98.                pixel aspect ratio.
  99.  
  100.           ----xxxxssssiiiizzzzeeee _s_i_z_e
  101.                Scales the image in the vector domain  so  it  is  _s_i_z_e
  102.                pixels  wide.   If  no  ----hhhheeeeiiiigggghhhhtttt  or  ----yyyyssssiiiizzzzeeee  option  is
  103.                specified, the height will be adjusted to preserve  the
  104.                pixel aspect ratio.
  105.  
  106.           ----yyyyssssiiiizzzzeeee _s_i_z_e
  107.                Scales the image in the vector domain  so  it  is  _s_i_z_e
  108.                pixels  in  height.   If  no ----wwwwiiiiddddtttthhhh or ----xxxxssssiiiizzzzeeee option is
  109.                specified, the width will be adjusted to  preserve  the
  110.                pixel aspect ratio.
  111.  
  112.           All flags  can  be  abbreviated  to  their  shortest  unique
  113.           prefix.
  114.  
  115.      BBBBUUUUGGGGSSSS
  116.           Only Level 2 slides are converted.  Level 1 format has  been
  117.           obsolete  since the advent of AutoCAD Release 9 in 1987, and
  118.           was not portable across machine architectures.
  119.  
  120.           Slide library items with names containing  8  bit  (such  as
  121.           ISO)  or  16  bit (Kanji, for example) characters may not be
  122.           found when chosen with the ----lllliiiibbbb option unless  ssssllllddddttttooooppppppppmmmm  has
  123.           been   built   with   character   set  conversion  functions
  124.           appropriate to the locale.  You can always  retrieve  slides
  125.           from  libraries regardless of the character set by using the
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 9/7/93)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ssssllllddddttttooooppppppppmmmm((((1111))))     XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))      ssssllllddddttttooooppppppppmmmm((((1111))))
  137.  
  138.  
  139.  
  140.           ----LLLLiiiibbbb option and  specifying  the  precise  name  of  library
  141.           member.  Use the ----ddddiiiirrrr option to list the slides in a library
  142.           if you're unsure of the exact name.
  143.  
  144.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.           AutoCAD Reference Manual: _S_l_i_d_e  _F_i_l_e  _F_o_r_m_a_t,  ppppnnnnmmmmssssccccaaaalllleeee(1),
  146.           ppppppppmmmm(5)
  147.  
  148.      AAAAUUUUTTTTHHHHOOOORRRR
  149.                John Walker
  150.                Autodesk SA
  151.                Avenue des Champs-Montants 14b
  152.                CH-2074 MARIN
  153.                Suisse/Schweiz/Svizzera/Svizra/Switzerland
  154.                Usenet:  kelvin@Autodesk.com
  155.                Fax:     038/33 88 15
  156.                Voice:   038/33 76 33
  157.  
  158.           Permission  to  use,  copy,  modify,  and  distribute   this
  159.           software  and  its documentation for any purpose and without
  160.           fee  is  hereby   granted,   without   any   conditions   or
  161.           restrictions.   This  software is provided ``as is'' without
  162.           express or implied warranty.
  163.  
  164.           AutoCAD and Autodesk are registered trademarks of  Autodesk,
  165.           Inc.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 9/7/93)
  196.  
  197.  
  198.  
  199.