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 / picttoppm.1 < prev    next >
Text File  |  1996-11-18  |  4KB  |  126 lines
  1. .TH picttoppm 1 "29 November 1991"
  2. .IX picttoppm
  3. .SH NAME
  4. picttoppm - convert a Macintosh PICT file into a portable pixmap
  5. .SH SYNOPSIS
  6. .B picttoppm
  7. .RB [ -verbose ]
  8. .RB [ -fullres ]
  9. .RB [ -noheader ]
  10. .RB [ -quickdraw ]
  11. .RB [ -fontdir file ]
  12. .RI [ pictfile ]
  13. .SH DESCRIPTION
  14. Reads a PICT file (version 1 or 2) and outputs a portable pixmap.
  15. .IX PICT
  16. .IX Macintosh
  17. Useful as the first step in converting a scanned image to something
  18. that can be displayed on Unix.
  19. .SH OPTIONS
  20. .TP
  21. .B \-fontdir \fIfile\fP
  22. Make the list of BDF fonts in ``file'' available for use by
  23. .IR picttoppm
  24. when drawing text.
  25. See below for the format of the fontdir file.
  26. .TP
  27. .B \-fullres
  28. Force any images in the PICT file to be output with at least their
  29. full resolution.  A PICT file may indicate that a contained
  30. image is to be scaled down before output.  This option forces images
  31. to retain their sizes and prevent information loss.
  32. Use of this option disables all PICT operations except images.
  33. .TP
  34. .B \-noheader
  35. Do not skip the 512 byte header that is present on all PICT files.
  36. This is useful when you have PICT data that was not stored in
  37. the data fork of a PICT file.
  38. .TP
  39. .B \-quickdraw
  40. Execute only pure quickdraw operations.  In particular, turn off
  41. the interpretation of special PostScript printer operations.
  42. .TP
  43. .B \-verbose
  44. Turns on verbose mode which prints a 
  45. a whole bunch of information that only
  46. .I picttoppm
  47. hackers really care about.
  48. .SH BUGS
  49. The PICT file format is a general drawing format.
  50. .I picttoppm
  51. does not support all the drawing commands, but it does have full
  52. support for any image commands and reasonable support for line,
  53. rectangle, polgon and text drawing.
  54. It is useful for converting scanned images and some drawing
  55. conversion.
  56. .PP
  57. Memory is used very liberally with at least 6 bytes needed for every
  58. pixel.  Large bitmap PICT files will likely run your computer out
  59. of memory.
  60. .SH "FONT DIR FILE FORMAT"
  61. .I picttoppm
  62. has a built in default font and your local installer probably provided
  63. adequate extra fonts.  You can point
  64. .I picttoppm
  65. at more fonts which you specify in a font directory file.  Each line
  66. in the file is either a comment line which must begin with ``#'' or
  67. font information.  The font information consists of 4 whitespace
  68. spearated fields.  The first is the font number, the second is the
  69. font size in pixels, the third is the font style and the fourth
  70. is the name of a BDF file containing the font.  The BDF format is
  71. defined by the X window system and is not described here.
  72. .PP
  73. The font number indicates the type face.  Here is a list of known font
  74. numbers and their faces.
  75. .PP
  76. .nf
  77. 0    Chicago
  78. 1    application font
  79. 2    New York
  80. 3    Geneva
  81. 4    Monaco
  82. 5    Venice
  83. 6    London
  84. 7    Athens
  85. 8    San Franciso
  86. 9    Toronto
  87. 11    Cairo
  88. 12    Los Angeles
  89. 20    Times Roman
  90. 21    Helvetica
  91. 22    Courier
  92. 23    Symbol
  93. 24    Taliesin
  94. .fi
  95. .PP
  96. The font style indicates a variation on the font.  Multiple variations
  97. may apply to a font and the font style is the sum of the variation numbers
  98. which are:
  99. .PP
  100. .nf
  101. 1    Boldface
  102. 2    Italic
  103. 4    Underlined
  104. 8    Outlined
  105. 16    Shadow
  106. 32    Condensed
  107. 64    Extended
  108. .fi
  109. .PP
  110. Obviously the font defintions are strongly related to the Macintosh.
  111. More font numbers and information about fonts can be found in Macintosh
  112. documentation.
  113. .SH SEE ALSO
  114. Inside Macintosh volumes 1 and 5,
  115. ppmtopict(1),
  116. ppm(5)
  117. .SH AUTHOR
  118. Copyright 1993 George Phillips
  119. .\" Permission is granted to freely distribute this program in whole or in
  120. .\" part provided you don't make money off it, you don't pretend that you
  121. .\" wrote it and that this notice accompanies the code.
  122. .\"
  123. .\" George Phillips <phillips@cs.ubc.ca>
  124. .\" Department of Computer Science
  125. .\" University of British Columbia
  126.