| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Rawtoppm User Manual" 1 "06 February 1991" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
|
| 10 |
rawtoppm - convert a stream of raw RGB bytes to a PPM image |
| 11 |
|
| 12 |
.UN synopsis |
| 13 |
.SH SYNOPSIS |
| 14 |
|
| 15 |
\fBrawtoppm\fP |
| 16 |
|
| 17 |
[\fB-headerskip\fP \fIN\fP] |
| 18 |
|
| 19 |
[\fB-rowskip\fP \fIN\fP] |
| 20 |
|
| 21 |
[ |
| 22 |
\fB-rgb\fP|\fB-rbg\fP|\fB-grb\fP |
| 23 |
|\fB-gbr\fP|\fB-brg\fP|\fB-bgr\fP |
| 24 |
] |
| 25 |
|
| 26 |
[\fB-interpixel\fP|\fB-interrow\fP] \fIwidth\fP \fIheight\fP |
| 27 |
|
| 28 |
[\fIimagedata\fP] |
| 29 |
|
| 30 |
.UN description |
| 31 |
.SH DESCRIPTION |
| 32 |
.PP |
| 33 |
This program is part of |
| 34 |
.BR "Netpbm" (1)\c |
| 35 |
\&. |
| 36 |
.PP |
| 37 |
\fBrawtoppm\fP reads raw RGB bytes as input and produces a PPM |
| 38 |
image as output. The input file is just RGB bytes. You have to |
| 39 |
specify the width and height on the command line, since the program |
| 40 |
obviously can't get them from the file. \fBrawtoppm\fP assumes the |
| 41 |
maxval of the input samples is 255, and makes the maxval of the output |
| 42 |
PPM 255. |
| 43 |
.PP |
| 44 |
\fBrawtoppm\fP assumes the pixels come top first in the input stream. |
| 45 |
If they are actually bottom first, the resulting PPM is upside down, so |
| 46 |
run it through \fBpamflip -tb\fP. |
| 47 |
|
| 48 |
.UN options |
| 49 |
.SH OPTIONS |
| 50 |
.PP |
| 51 |
In addition to the options common to all programs based on libnetpbm |
| 52 |
(most notably \fB-quiet\fP, see |
| 53 |
.UR index.html#commonoptions |
| 54 |
Common Options |
| 55 |
.UE |
| 56 |
\&), \fBrawtoppm\fP recognizes the following |
| 57 |
command line options: |
| 58 |
|
| 59 |
|
| 60 |
.TP |
| 61 |
\fB-headerskip\fP |
| 62 |
Skip over this many bytes at the beginning of the input stream. |
| 63 |
Use this option when the input has some kind of header followed by |
| 64 |
a raster suitable for \fBrawtoppm\fP. |
| 65 |
|
| 66 |
.TP |
| 67 |
\fB-rowskip\fP |
| 68 |
Skip this many bytes at the end of each row of the raster. (Some |
| 69 |
input streams have padding at the end of rows). |
| 70 |
|
| 71 |
.TP |
| 72 |
\fB-rgb -rbg -grb -gbr -brg -bgr\fP |
| 73 |
This option specifies the order of the color components for each |
| 74 |
pixel. The default is \fB-rgb\fP. |
| 75 |
|
| 76 |
.TP |
| 77 |
\fB-interpixel -interrow\fP |
| 78 |
These options specify how the colors are interleaved. The default |
| 79 |
is \fB-interpixel\fP, meaning interleaved by pixel. A byte of red, a |
| 80 |
byte of green, and a byte of blue, or whatever color order you |
| 81 |
specified. \fB-interrow\fP means interleaved by row - a row of red, |
| 82 |
a row of green, a row of blue, assuming standard rgb color order. An |
| 83 |
\fB-interplane\fP option - all the red pixels, then all the green, |
| 84 |
then all the blue - would be an obvious extension, but is not |
| 85 |
implemented. You could get the same effect by splitting the file into |
| 86 |
three parts (perhaps using \fBdd\fP), turning each part into a PGM |
| 87 |
file with \fBrawtopgm\fP, and then combining them with \fBrgb3toppm\fP. |
| 88 |
|
| 89 |
|
| 90 |
|
| 91 |
.UN seealso |
| 92 |
.SH SEE ALSO |
| 93 |
.BR "ppm" (1)\c |
| 94 |
\&, |
| 95 |
.BR "rawtopgm" (1)\c |
| 96 |
\&, |
| 97 |
.BR "rgb3toppm" (1)\c |
| 98 |
\&, |
| 99 |
.BR "pamflip" (1)\c |
| 100 |
\& |
| 101 |
|
| 102 |
.UN author |
| 103 |
.SH AUTHOR |
| 104 |
|
| 105 |
Copyright (C) 1991 by Jef Poskanzer. |
| 106 |
.SH DOCUMENT SOURCE |
| 107 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 108 |
source. The master documentation is at |
| 109 |
.IP |
| 110 |
.B http://netpbm.sourceforge.net/doc/rawtoppm.html |
| 111 |
.PP |