NAME

       restorepalette - set the color palette for textmode.

SYNOPSIS

       restorepalette [filename]

DESCRIPTION

       restorepalette  without  arguments sets the standard VGA palette. This can be useful if it
       is somehow messed up.

       With a 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.

               0  0  0  0   # black
               1  0  0 42   # blue
               2  0 42  0   # green
               3  0 42 42   # cyan
               4 42  0  0   # red
               5 42  0 42   # magenta
               6 42 21  0   # brown
               7 42 42 42   # white
               8 21 21 21   # bright black
               9 21 21 63   # bright blue
              10 21 63 21   # bright green
              11 21 63 63   # bright cyan
              12 63 21 21   # bright red
              13 63 21 63   # bright magenta
              14 63 63 21   # bright brown
              15 63 63 63   # bright white

       The inline comments are the only kind of allowed, as I use a little 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
       restorepalette  /etc/palette  in  my  /etc/rc.   If  the  program  is  given  the  correct
       permissions,  then  individual users can have 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 TERM is a virtual console is needed for that
       case.

SEE ALSO

       svgalib(7),  vgagl(7),  libvga.config(5),   vga_setpalvec(3),   dumpreg(1),   convfont(1),
       fix132x43(1),  restorefont(1),  restoretextmode(1),  runx(1), savetextmode(1), setmclk(1),
       textmode(1).

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.