gcpUnmapRGBAPixel(3)

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)