NAME
gcpUnmapRGBAPixel, gcpUnpackRGBAPixels, gcpUnmapYUVPixel,
gcpUnpackYUVPixels, gcpUnmapCMYKPixel, gcpUnpackCMYKPixels,
gcpUnmapHSVPixel, gcpUnpackHSVPixels, gcpUnmapYCCPixel,
gcpUnpackYCCPixels - Convert from gcp_pixel(s) to gcp_*colors(s)
SYNOPSIS
#include <ggi/gcp.h>
int gcpUnmapRGBAPixel(ggi_visual_t vis,
gcp_pixel pixel,gcp_RGBAcolor *col);
int gcpUnpackRGBAPixels(ggi_visual_t vis,
void *buf,gcp_RGBAcolor *cols,int len);
int gcpUnmapYUVPixel(ggi_visual_t vis,
gcp_pixel pixel, gcp_YUVcolor *col);
int gcpUnpackYUVPixels(ggi_visual_t vis,
void *buf,gcp_YUVcolor *cols,int len);
int gcpUnmapCMYKPixel(ggi_visual_t vis,
gcp_pixel pixel, gcp_CMYKcolor *col);
int gcpUnpackCMYKPixels(ggi_visual_t vis,
void *buf,gcp_CMYKcolor *cols,int len);
int gcpUnmapHSVPixel(ggi_visual_t vis,
gcp_pixel pixel, gcp_HSVcolor *col);
int gcpUnpackHSVPixels(ggi_visual_t vis,
void *buf,gcp_HSVcolor *cols,int len);
int gcpUnmapYCCPixel(ggi_visual_t vis,
gcp_pixel pixel, gcp_YCCcolor *col);
int gcpUnpackYCCPixels(ggi_visual_t vis,
void *buf,gcp_YCCcolor *cols,int len);
DESCRIPTION
gcpUnmap*Pixel gets the color associated with the given pixelvalue.
gcpUnpack*Pixels 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 gcp_color(3).
Try to cache the results of color lookups in your application for
efficiency purposes.
RETURN VALUE
gcpUnmap*Pixel and gcpUnpack*Pixels return 0 for OK, otherwise an ggi-
error(3) code.
SEE ALSO
gcp_color(3), gcp_pixel(3),
gcpMapRGBAColor(3), gcpPackRGBAColors(3), gcpMapYUVColor(3),
gcpPackYUVColors(3), gcpMapCMYKColor(3), gcpPackCMYKColors(3),
gcpMapHSVColor(3), gcpPackHSVColors(3), gcpMapYCCColor(3),
gcpPackYCCColors(3) ggiGetBox(3), ggiGetHLine(3), ggiGetVLine(3)