Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
restorepalette(1)	       Svgalib User Manual	       restorepalette(1)

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 per-
     sonal 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  fs-
     canf(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 individ-
     ual  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), conv-
     font(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-es-
     sen.de>. The exact source of the referenced utility as well as of the orig-
     inal 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 orig-
     inal author and will happily accept any additions or  corrections	to  this
     first version of the svgalib manual.

Svgalib (>= 1.2.11)		   2 Aug 1997		       restorepalette(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=restorepalette&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help