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 / pnmtops.1 < prev    next >
Text File  |  1996-11-18  |  3KB  |  113 lines
  1. .TH pnmtops 1 "26 October 1991"
  2. .IX pnmtops
  3. .SH NAME
  4. pnmtops - convert portable anymap to PostScript
  5. .SH SYNOPSIS
  6. .B pnmtops
  7. .RB [ -scale
  8. .IR s ]
  9. .RB [ -dpi
  10. .IR n ]
  11. .RB [ -width
  12. .IR n ]
  13. .RB [ -height
  14. .IR n ]
  15. .RB [ -turn | -noturn ]
  16. .RB [ -rle | -runlength ]
  17. .RB [ -center | -nocenter ]
  18. .RI [ pnmfile ]
  19. .SH DESCRIPTION
  20. Reads a portable anymap as input.
  21. Produces Encapsulated PostScript as output.
  22. .IX PostScript
  23. .PP
  24. If the input file is in color (PPM), a color PostScript file gets
  25. written.
  26. Some PostScript interpreters can't handle color PostScript.
  27. If you have one of these you will need to run your image through
  28. .I ppmtopgm
  29. first.
  30. .PP
  31. Note that there is no pstopnm
  32. tool - this transformation is one-way, because a pstopnm tool would
  33. be a full-fledged PostScript interpreter, which is beyond the scope
  34. of this package.
  35. However, see the
  36. .I psidtopgm
  37. tool, which can read grayscale non-runlength PostScript image data.
  38. Also, if you're willing to install the fairly large GhostScript package,
  39. it comes with a pstoppm script.
  40. .SH OPTIONS
  41. .PP
  42. The
  43. .B -scale
  44. flag controls the scale of the result.  The default scale is 1,
  45. which on a 300 dpi printer such as the Apple LaserWriter makes
  46. the output look about the same size as the input would if it was displayed
  47. on a typical 72 dpi screen.
  48. To get one PNM pixel per 300 dpi printer pixel, use "-scale 0.25".
  49. .PP
  50. The
  51. .B -dpi
  52. flag lets you specify the dots per inch of your output device.
  53. The default is 300 dpi.
  54. In theory PostScript is device-independent and you don't have to
  55. worry about this, but in practice its raster rendering can have
  56. unsightly bands if the device pixels and the image pixels aren't
  57. in sync.
  58. .PP
  59. The
  60. .B -width
  61. and
  62. .B -height
  63. flags let you specify the size of the page.
  64. The default is 8.5 inches by 11 inches.
  65. .PP
  66. The
  67. .B -turn
  68. and
  69. .B -noturn
  70. flags control whether the image gets turned 90 degrees.
  71. Normally, if an image is wider than it is tall, it gets turned
  72. automatically to better fit the page.
  73. If the
  74. .B -turn
  75. flag is specified, it will be turned no matter what its shape; and if the
  76. .B -noturn
  77. flag is specified, it will
  78. .I not
  79. be turned no matter what its shape.
  80. .PP
  81. The
  82. .B -rle
  83. or
  84. .B -runlength
  85. flag specifies run-length compression.  This may save
  86. time if the host-to-printer link is slow; but normally the printer's processing
  87. time dominates, so
  88. .B -rle
  89. makes things slower.
  90. .PP
  91. With the
  92. .B -nocenter
  93. flag, the output is not centered on the page, i.e. it appears
  94. in the upper left corner. This is useful for programs which can
  95. include PostScript files, but can't cope with pictures which are
  96. not positioned in the upper left corner. The default is
  97. .B -center
  98. i.e. the image is centered on the page.
  99. .PP
  100. All flags can be abbreviated to their shortest unique prefix.
  101. .SH "SEE ALSO"
  102. pnm(5), psidtopgm(1)
  103. .SH AUTHOR
  104. Copyright (C) 1989, 1991 by Jef Poskanzer.
  105. .br
  106. Modified November 1993 by Wolfgang Stuerzlinger, wrzl@gup.uni-linz.ac.at
  107. .\" Permission to use, copy, modify, and distribute this software and its
  108. .\" documentation for any purpose and without fee is hereby granted, provided
  109. .\" that the above copyright notice appear in all copies and that both that
  110. .\" copyright notice and this permission notice appear in supporting
  111. .\" documentation.  This software is provided "as is" without express or
  112. .\" implied warranty.
  113.