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 / pstopnm.1 < prev    next >
Text File  |  1996-11-18  |  6KB  |  242 lines
  1. .TH pstopnm 1 "28 December 92"
  2. .IX pstopnm
  3. .SH NAME
  4. pstopnm - convert a PostScript file into a portable anymap
  5. .SH SYNOPSIS
  6. .B pstopnm
  7. .RB [ \-forceplain ]
  8. .RB [ \-help ]
  9. .RB [ \-llx 
  10. .IR s ] 
  11. .RB [ \-lly 
  12. .IR s ] 
  13. .RB [ \-landscape ]
  14. .RB [ \-portrait ]
  15. .RB [ \-nocrop ]
  16. .RB [ \-pbm 
  17. .RB | \-pgm 
  18. .RB | \-ppm ]
  19. .RB [ \-urx 
  20. .IR s ] 
  21. .RB [ \-ury 
  22. .IR s ] 
  23. .RB [ \-verbose ]
  24. .RB [ \-xborder
  25. .IR n ]
  26. .RB [ \-xmax
  27. .IR n ]
  28. .RB [ \-xsize
  29. .IR f ]
  30. .RB [ \-yborder
  31. .IR f ]
  32. .RB [ \-ymax
  33. .IR n ]
  34. .RB [ \-ysize
  35. .IR n ]
  36. psfile[.ps]
  37. .SH DESCRIPTION
  38. Reads a PostScript file as input.
  39. .IX PostScript
  40. Produces portable anymap files as output.
  41. This program is just a useful shell script that runs 
  42. .I GhostScript
  43. to render a PostScript into one or more pnm files.
  44. .I Pstopnm 
  45. will create as many files as the number of pages in
  46. the Postscript document.  If the input file is named
  47. .IR psfile.ps ,
  48. the name of the files will be
  49. .IR psfile001.ppm , 
  50. .IR psfile002.ppm , 
  51. etc.
  52. .PP
  53. The program maps a rectangular portion of the PostScript document into
  54. an image file according to the command line options.  The selected area will
  55. always be centered in the output file, and may have borders around it.
  56. The image area to be extracted from the PostScript file and rendered
  57. into a portable anymap is defined by four numbers, the lower left
  58. corner  and the upper right corner x and y coordinates.
  59. These coordinates are usually specified by the BoundingBox comment
  60. in the PostScript file header, but they can be overridden by the user by 
  61. specifying one or more of the following flags:
  62. .BR \-llx ,
  63. .BR \-lly ,
  64. .BR \-urx ,
  65. and
  66. .BR \-ury .
  67. The presence and thickness of a border to be left around the image
  68. area is controlled by the use of the flags
  69. .B \-xborder
  70. and
  71. .BR \-yborder .
  72. If BoundingBox parameters are not found, and image area coordinates
  73. are not specified on the command line, default values are used.
  74. Unless both output file width and height are specified via the 
  75. .B \-xsize 
  76. and
  77. .B \-ysize 
  78. flags, the program will map the document into the output image
  79. by preserving its aspect ratio.
  80. .SH OPTIONS
  81. .PP
  82. .B \-forceplain
  83. .RS
  84. forces the output file to be a plain (i.e. not "raw") portable anymap.
  85. .RE
  86. .PP
  87. .B \-help
  88. .RS
  89. prints the command syntax.
  90. .RE
  91. .PP
  92. .B \-llx
  93. .I bx
  94. .RS
  95. selects 
  96. .I bx
  97. as the lower left corner x coordinate (in inches).
  98. .RE
  99. .PP
  100. .B \-lly
  101. .I by
  102. .RS
  103. selects 
  104. .I by
  105. as the lower left corner y coordinate (in inches).
  106. .RE
  107. .PP
  108. .B \-landscape
  109. .RS
  110. renders the image in landscape mode.
  111. .RE
  112. .PP
  113. .B \-portrait
  114. .RS
  115. renders the image in portrait mode.
  116. .RE
  117. .PP
  118. .B \-nocrop
  119. .RS
  120. does not crop the output image dimensions to match the PostScript
  121. image area dimensions.
  122. .RE
  123. .PP
  124. .B \-pbm \-pgm \-ppm
  125. .RS 
  126. selects the format of the output file.  By default, all files are
  127. rendered as portable pixmaps (ppm format).
  128. .RE
  129. .PP
  130. .B \-urx
  131. .I tx
  132. .RS
  133. selects 
  134. .I tx
  135. as the upper right corner x coordinate (in inches).
  136. .RE
  137. .PP
  138. .B \-ury
  139. .I ty
  140. .RS
  141. selects 
  142. .I ty
  143. as the upper right corner y coordinate (in inches).
  144. .RE
  145. .PP
  146. .B \-verbose
  147. .RS
  148. prints processing information to stdout.
  149. .RE
  150. .PP
  151. .B \-xborder
  152. .I frac
  153. .RS
  154. specifies that the border width along the Y axis should be 
  155. .I frac
  156. times the document width as specified by the bounding box comment in
  157. the PostScript file header.  The default value is 0.1.
  158. .RE
  159. .PP
  160. .B \-xmax
  161. .I xs
  162. .RS
  163. specifies that the maximum output image width should have a size less
  164. or equal to
  165. .IR xs 
  166. pixels (default: 612).   
  167. .RE
  168. .PP
  169. .B \-xsize
  170. .I xs
  171. .RS
  172. specifies that the output image width must be exactly
  173. .I xs
  174. pixels.
  175. .RE
  176. .PP
  177. .B \-yborder
  178. .I frac
  179. .RS
  180. specifies that the border width along the X axis should be 
  181. .I frac
  182. times the document width as specified by the bounding box comment in
  183. the PostScript file header.  The default value is 0.1.
  184. .RE
  185. .PP
  186. .B \-ymax
  187. .I ys
  188. .RS
  189. specifies that the maximum output image height should have a size less
  190. or equal to
  191. .IR ys 
  192. pixels (default: 792).   
  193. .RE
  194. .PP
  195. .B \-ysize
  196. .I ys
  197. .RS
  198. specifies that the output image height must be exactly
  199. .I ys
  200. pixels.
  201. .RE
  202. .SH BUGS
  203. The program will produce incorrect results with PostScript files that
  204. initialize the current transformation matrix.  In these cases, page
  205. translation and rotation will not have any effect.  To render these
  206. files, probably the best bet is to use the following flags:
  207. .PP
  208. \ \ \ pstopnm -xborder 0 -yborder 0 -portrait -nocrop file.ps
  209. .PP
  210. Additional flags may be needed if the document is supposed to be
  211. rendered on a medium different from letter-size paper.
  212. .SH SEE ALSO
  213. gs(l), pstofits(l)
  214. .SH COPYRIGHT
  215. Copyright (c) 1992 Smithsonian Astrophysical Observatory
  216. .br
  217. PostScript is a Trademark of Adobe Systems Incorporated.
  218. .\" Permission to use, copy, modify, distribute, and  sell  this
  219. .\" software  and  its  documentation  for any purpose is hereby
  220. .\" granted without  fee,  provided  that  the  above  copyright
  221. .\" notice  appear  in  all  copies and that both that copyright
  222. .\" notice and this permission notice appear in supporting documentation,
  223. .\" and  that  the  name  of the  Smithsonian Astrophysical
  224. .\" Observatory not be used in advertising or publicity
  225. .\" pertaining to distribution of the software without specific,
  226. .\" written  prior  permission.   The Smithsonian  Astrophysical
  227. .\" Observatory makes no representations about  the  suitability
  228. .\" of  this  software for any purpose.  It is provided  "as is"
  229. .\" without express or implied warranty.
  230. .\" THE  SMITHSONIAN  ASTROPHYSICAL  OBSERVATORY  DISCLAIMS  ALL
  231. .\" WARRANTIES  WITH  REGARD  TO  THIS  SOFTWARE,  INCLUDING ALL
  232. .\" IMPLIED  WARRANTIES  OF  MERCHANTABILITY AND FITNESS, IN  NO
  233. .\" EVENT SHALL THE  SMITHSONIAN  ASTROPHYSICAL  OBSERVATORY  BE
  234. .\" LIABLE FOR  ANY SPECIAL, INDIRECT  OR  CONSEQUENTIAL DAMAGES
  235. .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS  OF USE,  DATA
  236. .\" OR  PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
  237. .\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION  WITH
  238. .\" THE  USE OR PERFORMANCE OF THIS SOFTWARE.
  239. .SH AUTHOR
  240. Alberto Accomazzi, WIPL, Center for Astrophysics.
  241.  
  242.