diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/picttoppm.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/picttoppm.1 | 243 |
1 files changed, 243 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/picttoppm.1 b/upstream/opensuse-tumbleweed/man1/picttoppm.1 new file mode 100644 index 00000000..58f70be7 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/picttoppm.1 @@ -0,0 +1,243 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Picttoppm User Manual" 0 "17 June 2006" "netpbm documentation" + +.SH NAME +picttoppm - convert a Macintosh PICT file to a PPM + +.UN synopsis +.SH SYNOPSIS + +\fBpicttoppm\fP + +[\fB-verbose=\fP\fIn\fP] + +[\fB-fullres\fP] + +[\fB-noheader\fP] + +[\fB-quickdraw\fP] +[\fB-fontdir\fP \fIfile\fP] + +[\fIpictfile\fP] + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpicttoppm\fP reads a PICT file (version 1 or 2) and outputs a PPM +image. +.PP +PICT is an image format that was developed by Apple Computer in 1984 as the +native format for Macintosh graphics. A PICT image is encoded in QuickDraw +commands. The PICT format is a meta-format that can be used for both bitmap +images and vector images. PICT is also known as "Macintosh Picture" +format, or the QuickDraw Picture format. +.PP +PICT files are primarily used to exchange graphics between various +Macintosh applications. +.PP +In MacOS X, PDF replaces PICT as the main graphics format. + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBpicttoppm\fP recognizes the following +command line options: + + +.TP +\fB-fontdir \fP\fIfile\fP +Make the list of BDF fonts in \fIfile\fP available for use by +\fBpicttoppm\fP when drawing text. See below for the format of the +fontdir file. This is in addition to the built-in fonts and those in +the file \fBfontdir\fP. + +.TP +\fB-fullres\fP +Force any images in the PICT file to be output with at least their +full resolution. A PICT file may indicate that a contained +image is to be scaled down before output. This option forces images +to retain their sizes and prevent information loss. +This option disables all PICT operations except images. + +.TP +\fB-noheader\fP +Do not assume the first 512 bytes of the file are a header. All PICT +files have such a header, but this is useful when you have PICT data that was +not stored in the data fork of a PICT file. + +.TP +\fB-quickdraw\fP +Execute only pure quickdraw operations. In particular, turn off +the interpretation of special PostScript printer operations. + +.TP +\fB-verbose=\fP\fIn\fP +Print a whole bunch of information about the PICT file and the conversion +process that only \fBpicttoppm\fP hackers really care about. +.sp +\fIn\fP is the verbosity level, 0-2. +.sp +Before Netpbm 10.98 (March 2022), this option is a flag option that you +specify multiple times to specify increasing verbosity. + + + +.UN limitations +.SH LIMITATIONS + +The PICT file format is a general drawing format. \fBpicttoppm\fP +does not recognize all the drawing commands, but it does fully +implement all image commands and mostly implements line, rectangle, +polygon and text drawing. It is useful for converting scanned images +and some drawing conversion. +.PP +With \fB-fullres\fP, \fBpicttoppm\fP ignores text drawing commands. +Beginning in Netpbm 10.45 (December 2008), it issues a warning message +when it omits text for this reason. + +.UN fonts +.SH FONTS +.PP +Some of the information in a PICT file is text, with a number +indicating the font in which the text is supposed to rendered. +\fBpicttoppm\fP has one built-in font, but you can add others by +directing \fBpicttoppm\fP to BDF font files, which you do with font +directory files. +.PP +\fBpicttoppm\fP automatically uses the file named \fBfontdir\fP +in the current directory, if it exists. You may specify an additional +font directory file with the \fB-fontdir\fP option. +.PP +Obviously the font definitions are strongly related to the +Macintosh. You can find more font numbers and information about fonts +in Macintosh documentation. + +.UN fontdir +.SS Font Directory File Format +.PP +Each line in the file is either a comment or font information. A +comment begins with \fB#\fP. The font information consists of 4 +whitespace separated fields. The first is the font number, the second +is the font size in pixels, the third is the font style and the fourth +is the name of a BDF file containing the font. The BDF format is +defined by the X Window System and is beyond the scope of this document. +.PP +The font number indicates the type face. Here is a list of known +font numbers and their faces. + + +.TP +0 +Chicago +.TP +1 +application font +.TP +2 +New York +.TP +3 +Geneva +.TP +4 +Monaco +.TP +5 +Venice +.TP +6 +London +.TP +7 +Athens +.TP +8 +San Franciso +.TP +9 +Toronto +.TP +11 +Cairo +.TP +12 +Los Angeles +.TP +20 +Times Roman +.TP +21 +Helvetica +.TP +22 +Courier +.TP +23 +Symbol +.TP +24 +Taliesin + +.PP +The font style indicates a variation on the font. Multiple +variations may apply to a font and the font style is the sum of the +variation numbers which are: + + +.TP +1 +Boldface +.TP +2 +Italic +.TP +4 +Underlined +.TP +8 +Outlined +.TP +16 +Shadow +.TP +32 +Condensed +.TP +64 +Extended + + + +.UN seealso +.SH SEE ALSO + +Inside Macintosh volumes 1 and 5, +.BR "ppmtopict" (1)\c +\&, +.BR "ppm" (5)\c +\& + + +.UN author +.SH AUTHOR + +Copyright 1993 George Phillips +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/picttoppm.html +.PP
\ No newline at end of file |