---
name: "gcpUnmapYCCPixel"
section: "3"
platform: "linux"
package: "libggigcp1-dev"
version: "1.0.2+dfsg1-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/gcpUnmapRGBAPixel"
---

# gcpUnmapYCCPixel(3)

Convert from gcp\_pixel(s) to gcp\_\*colors(s)

Part of [gcpUnmapRGBAPixel(3)](/gcpUnmapRGBAPixel/3.md).

## 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)`