108 lines
2.8 KiB
Groff
108 lines
2.8 KiB
Groff
|
.TH restorepalette 1 "2 Aug 1997" "Svgalib (>= 1.2.11)" "Svgalib User Manual"
|
||
|
|
.SH NAME
|
||
|
|
restorepalette \- set the color palette for textmode.
|
||
|
|
.SH SYNOPSIS
|
||
|
|
|
||
|
|
.BI "restorepalette [" filename ]
|
||
|
|
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B restorepalette
|
||
|
|
without arguments sets the standard VGA palette. This can be useful
|
||
|
|
if it is somehow messed up.
|
||
|
|
|
||
|
|
With a
|
||
|
|
.I filename
|
||
|
|
argument a custom palette can be loaded (feature added by Charles Blake
|
||
|
|
<chuckb@alice.wonderland.caltech.edu>).
|
||
|
|
|
||
|
|
This allow a user to set up a file that looks like this one
|
||
|
|
(These color map definitions are the same as the default VGA ones.
|
||
|
|
Alter to suite personal tastes). The first column contains the number of
|
||
|
|
the color to set, then follow three integers in range 0 - 63 (lowest to
|
||
|
|
highest intensity) for red, green, blue.
|
||
|
|
|
||
|
|
.RS
|
||
|
|
.B " 0 0 0 0 # black"
|
||
|
|
.br
|
||
|
|
.B " 1 0 0 42 # blue"
|
||
|
|
.br
|
||
|
|
.B " 2 0 42 0 # green"
|
||
|
|
.br
|
||
|
|
.B " 3 0 42 42 # cyan"
|
||
|
|
.br
|
||
|
|
.B " 4 42 0 0 # red"
|
||
|
|
.br
|
||
|
|
.B " 5 42 0 42 # magenta"
|
||
|
|
.br
|
||
|
|
.B " 6 42 21 0 # brown"
|
||
|
|
.br
|
||
|
|
.B " 7 42 42 42 # white"
|
||
|
|
.br
|
||
|
|
.B " 8 21 21 21 # bright black"
|
||
|
|
.br
|
||
|
|
.B " 9 21 21 63 # bright blue"
|
||
|
|
.br
|
||
|
|
.B "10 21 63 21 # bright green"
|
||
|
|
.br
|
||
|
|
.B "11 21 63 63 # bright cyan"
|
||
|
|
.br
|
||
|
|
.B "12 63 21 21 # bright red"
|
||
|
|
.br
|
||
|
|
.B "13 63 21 63 # bright magenta"
|
||
|
|
.br
|
||
|
|
.B "14 63 63 21 # bright brown"
|
||
|
|
.br
|
||
|
|
.B "15 63 63 63 # bright white"
|
||
|
|
.RE
|
||
|
|
|
||
|
|
The inline comments are the
|
||
|
|
only kind of allowed, as I use a little
|
||
|
|
.BR fscanf (3)
|
||
|
|
trick to get them. Blank lines
|
||
|
|
are ok, but not pure comment lines. See the comments in my code, also.
|
||
|
|
|
||
|
|
This allows people to set up custom palettes for use in virtual console text
|
||
|
|
modes. I use it all the time. When combined with a color-syntax editor like
|
||
|
|
jed-0.97+ or color-ls, etc., being able to choose your own text-mode palette is
|
||
|
|
quite a bonus. I set mine up via
|
||
|
|
.B restorepalette /etc/palette
|
||
|
|
in my
|
||
|
|
.IR /etc/rc .
|
||
|
|
If the program is given the correct permissions, then individual users can
|
||
|
|
have
|
||
|
|
.B restorepalette ~/.palette
|
||
|
|
or some such thing in their shell startup
|
||
|
|
files.
|
||
|
|
Of course, it shouldn't be done when starting remote shells or when
|
||
|
|
under X, so some kind of test that
|
||
|
|
.B TERM
|
||
|
|
is a virtual console is needed for that case.
|
||
|
|
|
||
|
|
.SH SEE ALSO
|
||
|
|
|
||
|
|
.BR svgalib (7),
|
||
|
|
.BR vgagl (7),
|
||
|
|
.BR libvga.config (5),
|
||
|
|
.BR vga_setpalvec (3),
|
||
|
|
.BR dumpreg (1),
|
||
|
|
.BR convfont (1),
|
||
|
|
.BR fix132x43 (1),
|
||
|
|
.BR restorefont (1),
|
||
|
|
.BR restoretextmode (1),
|
||
|
|
.BR runx (1),
|
||
|
|
.BR savetextmode (1),
|
||
|
|
.BR setmclk (1),
|
||
|
|
.BR textmode (1).
|
||
|
|
.SH AUTHOR
|
||
|
|
|
||
|
|
This manual page was edited by Michael Weller <eowmob@exp-math.uni-essen.de>. The
|
||
|
|
exact source of the referenced utility as well as of the original documentation is
|
||
|
|
unknown.
|
||
|
|
|
||
|
|
It is very likely that both are at least to some extent are due to
|
||
|
|
Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
|
||
|
|
|
||
|
|
Occasionally this might be wrong. I hereby
|
||
|
|
asked to be excused by the original author and will happily accept any additions or corrections
|
||
|
|
to this first version of the svgalib manual.
|