Man Linux: Main Page and Category List

NAME

       ggiMapColor,  ggiUnmapPixel,  ggiPackColors,  ggiUnpackPixels - Convert
       from ggi_color(s) to ggi_pixel(s) and vice versa

SYNOPSIS

       #include <ggi/ggi.h>

       ggi_pixel ggiMapColor(ggi_visual_t vis, const ggi_color *col);

       int ggiUnmapPixel(ggi_visual_t vis, ggi_pixel pixel, ggi_color *col);

       int ggiPackColors(ggi_visual_t vis, void *buf, const ggi_color *cols, int len);

       int ggiUnpackPixels(ggi_visual_t vis, const void *buf, ggi_color *cols, int len);

DESCRIPTION

       ggiMapColor gets the pixelvalue for the given color.

       ggiUnmapPixel gets the color associated with the given pixelvalue.

       ggiPackColors converts the colors in cols to pixelvalues in  buf.   The
       output   from   this   function   is   suitable   for   input   to  the
       ggiPut{HLine,VLine,Box} functions.

       ggiUnpackPixels converts the pixelvalues in buf to individual  elements
       of  cols.   This  function may be used to convert buffers output by the
       ggiGet{HLine,VLine,Box} functions from the pixelvalue representation to
       their actual colors as defined by ggi_color(3).

       The  buffers output from ggiPackColors and the input to ggiUnpackPixels
       are in the same format as the get/put buffers. Their format is  defined
       in ggi_pixelformat(3).

       Try  to  cache  the  results  of  color lookups in your application for
       efficiency purposes.

RETURN VALUE

       ggiMapColor returns a ggi_pixel(3).

       ggiUnmapPixel, ggiPackColors and  ggiUnpackPixels  returns  0  for  OK,
       otherwise a ggi-error(3) code.

SEE ALSO

       ggiGetPixelFormat(3), ggi_color(3), ggi_pixelformat(3)