Man Linux: Main Page and Category List

NAME

       ggiSetPalette, ggiGetPalette - Manipulate the palette of a visual

SYNOPSIS

       #include <ggi/ggi.h>

       int ggiSetPalette(ggi_visual_t vis, int s, int len, const ggi_color *cmap);

       int ggiGetPalette(ggi_visual_t vis, int s, int len, ggi_color *cmap);

DESCRIPTION

       LibGGI   visuals   in  GT_PALETTE  mode  map  all  pixelvalues  to  the
       corresponding ggi_color(3) entry in the visual’s palette.

       ggiSetPalette sets a range of palette values of length len, starting at
       index number s.  The index can be GGI_PALETTE_DONTCARE to indicate that
       the palette can  be  installed  anywhere  in  the  CLUT.   This  allows
       optimized  use  in  windowing  environments (to minimize color flashing
       between windows) and should be used if possible.

       ggiGetPalette copies the specified colors (starting  from  s,  for  len
       colors) from the visual’s palette to the array pointed by cmap.

RETURN VALUE

       ggiSetPalette  returns  the  number  of  the  first  entry changed.  <0
       indicate a ggi-error(3).

       ggiGetPalette returns 0 for OK, otherwise  a  ggi-error(3)  code.  When
       called with len=0 this function will not automatically succeed, but the
       return code will indicate whether there is a readable CLUT.

PALETTE IN GGI

       Write something useful here.

SEE ALSO

       ggiSetColorfulPalette(3)