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