mirror of
https://github.com/xcat2/xNBA.git
synced 2024-12-15 15:51:44 +00:00
121 lines
2.5 KiB
Groff
121 lines
2.5 KiB
Groff
|
.TH PPMTOANSI 1 "January 12, 1997"
|
||
|
|
.SH NAME
|
||
|
|
ppmtoansi \- Graphics Conversion Program For Extended ANSI Escape Codes
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B ppmtoansi
|
||
|
|
[
|
||
|
|
.SM \-b
|
||
|
|
r/g/b ] [
|
||
|
|
.SM \-t
|
||
|
|
r/g/b:idx] [
|
||
|
|
.SM \-x
|
||
|
|
<xoffset> ] [
|
||
|
|
.SM \-y
|
||
|
|
<yoffset> ] [
|
||
|
|
<filename> ]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.I ppmtoansi
|
||
|
|
converts input files in
|
||
|
|
.IR ppm (5)
|
||
|
|
format to escape sequences that are understood by
|
||
|
|
.IR etherboot .
|
||
|
|
This allows for displaying icons and logos on the BOOT-Prom's splash
|
||
|
|
screen.
|
||
|
|
.PP
|
||
|
|
If no input file is specified, data is read from
|
||
|
|
.IR standard
|
||
|
|
.IR input .
|
||
|
|
All output is send to
|
||
|
|
.IR standard
|
||
|
|
.IR output ,
|
||
|
|
error messages go to
|
||
|
|
.IR standard
|
||
|
|
.IR error .
|
||
|
|
.I ppmtoansi
|
||
|
|
tries to do some compression and minimizes the output filesize.
|
||
|
|
.SH OPTIONS
|
||
|
|
.TP
|
||
|
|
.B \-b
|
||
|
|
Specifies the
|
||
|
|
.IR red ,
|
||
|
|
.IR green , and
|
||
|
|
.IR blue
|
||
|
|
intensities for the background color. This information is
|
||
|
|
used for providing a shape mask. All values are in the range from 0 to
|
||
|
|
255.
|
||
|
|
.TP
|
||
|
|
.B \-t
|
||
|
|
Allows for explicitly providing a translation between color values and
|
||
|
|
color indices. The indices are in the range 0 to 7 and conform to the
|
||
|
|
standard
|
||
|
|
.IR ANSI
|
||
|
|
.IR colorcodes .
|
||
|
|
.RS
|
||
|
|
.PP
|
||
|
|
0 black 4 blue
|
||
|
|
.PP
|
||
|
|
1 red 5 magenta
|
||
|
|
.PP
|
||
|
|
2 green 6 cyan
|
||
|
|
.PP
|
||
|
|
3 yellow 7 white
|
||
|
|
.PP
|
||
|
|
If no translations apply,
|
||
|
|
.IR ppmtoansi
|
||
|
|
will automatically select the color that is closest.
|
||
|
|
.RE
|
||
|
|
.TP
|
||
|
|
.B \-x
|
||
|
|
Specify an X offset relative to the current text cursor position.
|
||
|
|
.TP
|
||
|
|
.B \-y
|
||
|
|
Specify an Y offset relative to the current text cursor position.
|
||
|
|
.SH FILE FORMAT
|
||
|
|
.IR ppmtoansi
|
||
|
|
uses these extensions to the standard
|
||
|
|
.B ANSI escape
|
||
|
|
.BR codes .
|
||
|
|
.TP
|
||
|
|
.B <esc>[a;b;c;d+<data>
|
||
|
|
Draw pixel data. Use one byte per pixel. Colors are encoded as shown
|
||
|
|
above. In text mode, graphics is approximated by outputting suitable
|
||
|
|
characters. Parameters differ depending on the number of parameters
|
||
|
|
passed:
|
||
|
|
.RS
|
||
|
|
.TP
|
||
|
|
.B cnt
|
||
|
|
.IR cnt
|
||
|
|
data bytes follow. They will be drawn to the right of the last
|
||
|
|
graphics position.
|
||
|
|
.TP
|
||
|
|
.B rle;col
|
||
|
|
The next
|
||
|
|
.IR rle
|
||
|
|
pixels have the value
|
||
|
|
.IR col .
|
||
|
|
They will be drawn to the right of the last graphics position. No data
|
||
|
|
bytes follow.
|
||
|
|
.TP
|
||
|
|
.B x;y;cnt
|
||
|
|
.IR cnt
|
||
|
|
data bytes follow. They will be drawn relative to the top left corner
|
||
|
|
of the text cursor with an offset of
|
||
|
|
.RI ( x / y ).
|
||
|
|
.TP
|
||
|
|
.B x;y;rle;col
|
||
|
|
the next
|
||
|
|
.IR rle
|
||
|
|
pixels have the value
|
||
|
|
.IR col .
|
||
|
|
They will be drawn relative to the top left corner of the text cursor
|
||
|
|
with an offset of
|
||
|
|
.RI ( x / y ).
|
||
|
|
No data bytes follow.
|
||
|
|
.RE
|
||
|
|
.TP
|
||
|
|
.B <esc>[a;b;c;d\-<data>
|
||
|
|
same as above, but pack pixels into three bits. The first pixel is
|
||
|
|
stored in the three most significant bits of the first data byte.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
ppm(5), mknbi-linux(8), mknbi-dos(8).
|