diff options
Diffstat (limited to '')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/rletopnm.1 | 157 |
1 files changed, 157 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/rletopnm.1 b/upstream/opensuse-tumbleweed/man1/rletopnm.1 new file mode 100644 index 00000000..e7a31575 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/rletopnm.1 @@ -0,0 +1,157 @@ +\ +.\" 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 "Rletopnm User Manual" 0 "13 April 2000" "netpbm documentation" + +.SH NAME +rletopnm - convert a Utah Raster Tools RLE image file to a PNM image file. + +.UN synopsis +.SH SYNOPSIS + +\fBrletopnm\fP + +[\fB--alphaout=\fP{\fIalpha-filename\fP,\fB-\fP}] +[\fB--headerdump\fP|\fB-h\fP] + +[\fB--verbose\fP|\fB-v\fP] + +[\fIrlefile\fP|\fB-\fP] +.PP +All options may be abbreviated to their minimum unique abbreviation +and options and arguments may be in any order. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBrletopnm\fP converts Utah Raster Toolkit RLE image files to PNM +image files. \fBrletopnm\fP handles four types of RLE files: +Grayscale (8 bit data, no color map), Pseudocolor (8 bit data with a +color map), Truecolor (24 bit data with color map), and Directcolor +(24 bit data, no color map). \fBrletopnm\fP generates a PPM file for +all these cases except for the Grayscale file, for which +\fBrletopnm\fP generates a PGM file. +.PP +\fIrlefile\fP is the RLE input file. If it is absent or \fB-\fP, +the input comes from Standard Input. + +.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 +\&), \fBrletopnm\fP recognizes the following +command line options: + + +.TP +\fB--alphaout=\fP\fIalpha-filename\fP +\fBrletopnm \fP creates a PGM (portable graymap) file containing the +transparency channel values in the input image. If the input image doesn't +contain an transparency channel, the \fIalpha-filename\fP file contains all +zero (transparent) transparency values. If you don't specify +\fB--alphaout\fP, \fBrletopnm\fP does not generate a transparency file, +and if the input image has a transparency channel, \fBrletopnm\fP simply +discards it. +.sp +If you specify \fB-\fP as the filename, \fBrletopnm\fP writes the +transparency output to Standard Output and discards the image. +.sp +See +.BR "pamcomp" (1)\c +\& for one way to use +the transparency output file. + +.TP +\fB--verbose\fP +This option causes \fBrletopnm \fP to operate in verbose mode. +It prints messages about what it's doing, including the contents of +the RLE image header, to Standard Error. + +.TP +\fB--headerdump\fP +This option causes \fBrletopnm\fP to operate in header dump mode. +It prints the contents of the RLE image header to Standard Error, but +does not produce any other output. + + + +.UN examples +.SH EXAMPLES + + +.IP \(bu +While running in verbose mode, convert lenna.rle to PPM format and +store the resulting image as lenna.ppm: + +.nf +\f(CW + rletopnm --verbose lenna.rle >lenna.ppm +\fP + +.fi + +.IP \(bu +Dump the header information of the RLE file called file.rle: + +.nf +\f(CW + rletopnm --headerdump file.rle +\fP + +.fi + +.IP \(bu +Convert RLE file dart.rle to PPM format as dart.ppm. Store the +transparency channel of dart.rle as dartalpha.pgm (if dart.rle doesn't have +a transparency channel, store a fully transparent transparency mask as +dartalpha.pgm): + +.nf +\f(CW + rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm +\fP + +.fi + + + +.UN seealso +.SH SEE ALSO +.BR "pnmtorle" (1)\c +\&, +.BR "pnmconvol" (1)\c +\&, +.BR "pnm" (5)\c +\&, +.BR "ppm" (5)\c +\&, +.BR "pgm" (5)\c +\&, + +.UN author +.SH AUTHOR + +Wes Barris +Army High Performance Computing Research Center (AHPCRC) +Minnesota Supercomputer Center, Inc. +.PP +Modifications by Eric Haines to produce raw and plain formats. +.PP +Modifications by Bryan Henderson to create transparency files and use +mnemonic options. +.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/rletopnm.html +.PP
\ No newline at end of file |