---
name: "glCopyColorSubTable"
section: "3x"
platform: "linux"
package: "xlibmesa-gl-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/glCopyColorSubTable"
---

# glCopyColorSubTable(3x)

respecify a portion of a color table

## NAME

**glCopyColorSubTable** - respecify a portion of a color table

## C SPECIFICATION

void **glCopyColorSubTable**( GLenum *target*,

```
	GLsizei start,
	GLint x,
	GLint y,
	GLsizei width )
```

## PARAMETERS

- *target*

  Must be one of **GL\_COLOR\_TABLE**, **GL\_POST\_CONVOLUTION\_COLOR\_TABLE**, or **GL\_POST\_COLOR\_MATRIX\_COLOR\_TABLE**.

- *start*

  The starting index of the portion of the color table to be replaced.

- *x*, *y*

  The window coordinates of the left corner of the row of pixels to be copied.

- *width*

  The number of table entries to replace.

## DESCRIPTION

**glCopyColorSubTable** is used to respecify a contiguous portion of a color table previously defined using **glColorTable**.  The pixels copied from the framebuffer replace the portion of the existing table from indices *start* to $"start"~+~"x"~-~1$, inclusive.  This region may not include any entries outside the range of the color table, as was originally specified. It is not an error to specify a subtexture with width of 0, but such a specification has no effect.

## NOTES

**glCopyColorSubTable** is present only if **GL\_ARB\_imaging** is returned when **glGetString** is called with an argument of **GL\_EXTENSIONS**.

## ERRORS

**GL\_INVALID\_VALUE** is generated if *target* is not a previously defined color table.

**GL\_INVALID\_VALUE** is generated if *target* is not one of the allowable values.

**GL\_INVALID\_VALUE** is generated if $"start"~+~"x"~\>~width$.

**GL\_INVALID\_OPERATION** is generated if **glCopyColorSubTable** is executed between the execution of **glBegin** and the corresponding execution of **glEnd**.

## ASSOCIATED GETS

**glGetColorTable**, **glGetColorTableParameter**

## SEE ALSO

**glColorSubTable(3G)**, **glColorTableParameter(3G)**, **glCopyColorTable(3G)**, **glCopyColorSubTable(3G)**, **glGetColorTable(3G)**