blob: 954e94bdd2b08fb92c08b20f723cf8c3d9b045d3 [file] [log] [blame]
.TH "PPMTOLSS16" "1"
.SH "NAME"
ppmtolss16 \(em Convert a PPM to an LSS16 image
.SH "SYNOPSIS"
.PP
\fBppmtolss16\fR [ \fB \fI#rrggbb\fR=\fIi\fR \fP \&...] [< input.ppm] [> output.rle]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the \fBppmtolss16\fR command.
.PP
The \fBppmtolss16\fR program converts a "raw" PPM file with
max 16 colors to a simple RLE-based format:
.PP
\fBsimple RLE-based format\fR
.TS
tab();
l l.
unint32 0x1413f3dmagic (littleendian)
unint16 xsizelittleendian
unint15 ysizelittleendian
16 x unint8 r,g,bcolor map
.TE
.PP
Color map is in 6-bit format (each byte is 0..63)
.PP
Then, a sequence of nybbles:
.PP
N ... if N is != previous pixel, one pixel of color N, otherwise
run sequence follows ...
.PP
M ... if M > 0 then run length is M+1, otherwise run sequence is
encoded in two nybbles, littleendian, +17
.PP
The nybble sequences are on a per-row basis, runs may not extend across
rows and odd-nybble rows are zero-padded.
.PP
At the start of a row, the "previous pixel" is assumed to be zero.
.SH "OPTIONS"
.PP
A summary of options is included below.
.IP "\fB\fI#rrggbb\fR=\fIi\fR\fP" 10
Specify that the color #rrggbb (hex) should be assigned index
i (decimal).
.SH "BUG"
.PP
This program cannot handle comments in the header, nor "plain" ppm
format.
.SH "SEE ALSO"
.PP
\fBppmtolss16\fR(1)
.SH "AUTHOR"
.PP
This manual page was compiled by dann frazier <dannf@debian.org> for
the \fBDebian GNU/Linux\fP system (but may be used by others). Most of the content
was written by H. Peter Anvin.