---
name: "gcpSetRGBAPalette"
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/gcpSetRGBAPalette"
---

# gcpSetRGBAPalette(3)

Manipulate the palette of a visual

## NAME

**gcpSetRGBAPalette**, **gcpGetRGBAPalette**, **gcpSetYUVPalette**, **gcpGetYUVPalette**, **gcpSetCMYKPalette**, **gcpGetCMYKPalette**, **gcpSetHSVPalette**, **gcpGetHSVPalette**, **gcpSetYCCPalette**, **gcpGetYCCPalette** - Manipulate the palette of a visual

## SYNOPSIS

```
#include <ggi/gcp.h>
int gcpGetRGBAPalette(ggi_visual_t vis,
              int s,int len,gcp_RGBAcolor *cmap);
int gcpSetRGBAPalette(ggi_visual_t vis,
              int s,int len,gcp_RGBAcolor *cmap);
int gcpGetYUVPalette(ggi_visual_t vis,
              int s,int len,gcp_YUVcolor *cmap);
int gcpSetYUVPalette(ggi_visual_t vis,
              int s,int len,gcp_YUVcolor *cmap);
int gcpGetCMYKPalette(ggi_visual_t vis,
              int s,int len,gcp_CMYKcolor *cmap);
int gcpSetCMYKPalette(ggi_visual_t vis,
              int s,int len,gcp_CMYKcolor *cmap);
int gcpGetHSVPalette(ggi_visual_t vis,
              int s,int len,gcp_HSVcolor *cmap);
int gcpSetHSVPalette(ggi_visual_t vis,
              int s,int len,gcp_HSVcolor *cmap);
int gcpGetYCCPalette(ggi_visual_t vis,
              int s,int len,gcp_YCCcolor *cmap);
int gcpSetYCCPalette(ggi_visual_t vis,
              int s,int len,gcp_YCCcolor *cmap);
```

## DESCRIPTION

LibGGIGCP visuals in **GT\_PALETTE** mode map all pixelvalues to the corresponding `gcp_color(3)` entry in the visual's palette.

**gcpSet\*Palette** sets a range of palette values of length *len*, starting at index number *s*.  The index can be **GCP\_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.

**gcpGet\*Palette** copies the specified colors (starting from *s*, for *len* colors) from the visual's palette to the array pointed by *cmap*.

## RETURN VALUE

**gcpSet\*Palette** returns the number of the first entry changed. **\<0** indicate `ggi-error(3)`.

**gcpGet\*Palette** returns **0** for OK, otherwise an `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.

## SEE ALSO

`gcpSetColorfulPalette(3)`