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

# glIsEnabled(3x)

test whether a capability is enabled

## NAME

**glIsEnabled** - test whether a capability is enabled

## C SPECIFICATION

GLboolean **glIsEnabled**( GLenum *cap* )

```

```

## PARAMETERS

- *cap*

  Specifies a symbolic constant indicating a GL capability.

## DESCRIPTION

**glIsEnabled** returns **GL\_TRUE** if *cap* is an enabled capability and returns **GL\_FALSE** otherwise. Initially all capabilities except **GL\_DITHER** are disabled; **GL\_DITHER** is initially enabled.

The following capabilities are accepted for *cap*:

| | |
| --- | --- |
| **Constant** | **See** |
| **GL\_ALPHA\_TEST** | **glAlphaFunc** |
| **GL\_AUTO\_NORMAL** | **glEvalCoord** |
| **GL\_BLEND** | **glBlendFunc**, **glLogicOp** |
| **GL\_CLIP\_PLANE***i* | **glClipPlane** |
| **GL\_COLOR\_ARRAY** | **glColorPointer** |
| **GL\_COLOR\_LOGIC\_OP** | **glLogicOp** |
| **GL\_COLOR\_MATERIAL** | **glColorMaterial** |
| **GL\_COLOR\_TABLE** | **glColorTable** |
| **GL\_CONVOLUTION\_1D** | **glConvolutionFilter1D** |
| **GL\_CONVOLUTION\_2D** | **glConvolutionFilter2D** |
| **GL\_CULL\_FACE** | **glCullFace** |
| **GL\_DEPTH\_TEST** | **glDepthFunc**, **glDepthRange** |
| **GL\_DITHER** | **glEnable** |
| **GL\_EDGE\_FLAG\_ARRAY** | **glEdgeFlagPointer** |
| **GL\_FOG** | **glFog** |
| **GL\_HISTOGRAM** | **glHistogram** |
| **GL\_INDEX\_ARRAY** | **glIndexPointer** |
| **GL\_INDEX\_LOGIC\_OP** | **glLogicOp** |
| **GL\_LIGHT***i* | **glLightModel**, **glLight** |
| **GL\_LIGHTING** | **glMaterial**, **glLightModel**, **glLight** |
| **GL\_LINE\_SMOOTH** | **glLineWidth** |
| **GL\_LINE\_STIPPLE** | **glLineStipple** |
| **GL\_MAP1\_COLOR\_4** | **glMap1** |
| **GL\_MAP1\_INDEX** | **glMap1** |
| **GL\_MAP1\_NORMAL** | **glMap1** |
| **GL\_MAP1\_TEXTURE\_COORD\_1** | **glMap1** |
| **GL\_MAP1\_TEXTURE\_COORD\_2** | **glMap1** |
| **GL\_MAP1\_TEXTURE\_COORD\_3** | **glMap1** |
| **GL\_MAP1\_TEXTURE\_COORD\_4** | **glMap1** |
| **GL\_MAP2\_COLOR\_4** | **glMap2** |
| **GL\_MAP2\_INDEX** | **glMap2** |
| **GL\_MAP2\_NORMAL** | **glMap2** |
| **GL\_MAP2\_TEXTURE\_COORD\_1** | **glMap2** |
| **GL\_MAP2\_TEXTURE\_COORD\_2** | **glMap2** |
| **GL\_MAP2\_TEXTURE\_COORD\_3** | **glMap2** |
| **GL\_MAP2\_TEXTURE\_COORD\_4** | **glMap2** |
| **GL\_MAP2\_VERTEX\_3** | **glMap2** |
| **GL\_MAP2\_VERTEX\_4** | **glMap2** |
| **GL\_MINMAX** | **glMinmax** |
| **GL\_NORMAL\_ARRAY** | **glNormalPointer** |
| **GL\_NORMALIZE** | **glNormal** |
| **GL\_POINT\_SMOOTH** | **glPointSize** |
| **GL\_POLYGON\_SMOOTH** | **glPolygonMode** |
| **GL\_POLYGON\_OFFSET\_FILL** | **glPolygonOffset** |
| **GL\_POLYGON\_OFFSET\_LINE** | **glPolygonOffset** |
| **GL\_POLYGON\_OFFSET\_POINT** | **glPolygonOffset** |
| **GL\_POLYGON\_STIPPLE** | **glPolygonStipple** |
| **GL\_POST\_COLOR\_MATRIX\_COLOR\_TABLE** | **glColorTable** |
| **GL\_POST\_CONVOLUTION\_COLOR\_TABLE** | **glColorTable** |
| **GL\_RESCALE\_NORMAL** | **glNormal** |
| **GL\_SCISSOR\_TEST** | **glScissor** |
| **GL\_SEPARABLE\_2D** | **glSeparableFilter2D** |
| **GL\_STENCIL\_TEST** | **glStencilFunc**, **glStencilOp** |
| **GL\_TEXTURE\_1D** | **glTexImage1D** |
| **GL\_TEXTURE\_2D** | **glTexImage2D** |
| **GL\_TEXTURE\_3D** | **glTexImage3D** |
| **GL\_TEXTURE\_COORD\_ARRAY** | **glTexCoordPointer** |
| **GL\_TEXTURE\_GEN\_Q** | **glTexGen** |
| **GL\_TEXTURE\_GEN\_R** | **glTexGen** |
| **GL\_TEXTURE\_GEN\_S** | **glTexGen** |
| **GL\_TEXTURE\_GEN\_T** | **glTexGen** |
| **GL\_VERTEX\_ARRAY** | **glVertexPointer** |

## NOTES

If an error is generated, **glIsEnabled** returns 0.

**GL\_COLOR\_LOGIC\_OP**,  **GL\_COLOR\_ARRAY**, **GL\_EDGE\_FLAG\_ARRAY**, **GL\_INDEX\_ARRAY**, **GL\_INDEX\_LOGIC\_OP**, **GL\_NORMAL\_ARRAY**, **GL\_POLYGON\_OFFSET\_FILL**,   **GL\_POLYGON\_OFFSET\_LINE**, **GL\_POLYGON\_OFFSET\_POINT**, **GL\_TEXTURE\_COORD\_ARRAY**, and **GL\_VERTEX\_ARRAY** are available only if the GL version is 1.1 or greater

**GL\_RESCALE\_NORMAL**, and **GL\_TEXTURE\_3D** are available only if the GL version is 1.2 or greater.

**GL\_COLOR\_TABLE**, **GL\_CONVOLUTION\_1D**, **GL\_CONVOLUTION\_2D**, **GL\_HISTOGRAM**, **GL\_MINMAX**, **GL\_POST\_COLOR\_MATRIX\_COLOR\_TABLE**, **GL\_POST\_CONVOLUTION\_COLOR\_TABLE**, and **GL\_SEPARABLE\_2D** are available only if **GL\_ARB\_imaging** is returned when **glGet** is called with **GL\_EXTENSIONS**.

When the **GL\_ARB\_multitexture** extension is supported, the following parameters return the associated value for the active texture unit. **GL\_TEXTURE\_1D**, **GL\_TEXTURE\_BINDING\_1D**, **GL\_TEXTURE\_2D**, **GL\_TEXTURE\_BINDING\_2D**, **GL\_TEXTURE\_3D**, **GL\_TEXTURE\_BINDING\_3D**, **GL\_TEXTURE\_GEN\_S**, **GL\_TEXTURE\_GEN\_T**, **GL\_TEXTURE\_GEN\_R**, **GL\_TEXTURE\_GEN\_Q**, **GL\_TEXTURE\_MATRIX**, and **GL\_TEXTURE\_STACK\_DEPTH**. Likewise, the following parameters return the associated value for the active client texture unit: **GL\_TEXTURE\_COORD\_ARRAY**, **GL\_TEXTURE\_COORD\_ARRAY\_SIZE**, **GL\_TEXTURE\_COORD\_ARRAY\_STRIDE**, **GL\_TEXTURE\_COORD\_ARRAY\_TYPE**.

## ERRORS

**GL\_INVALID\_ENUM** is generated if *cap* is not an accepted value.

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

## SEE ALSO

**glEnable(3G)**, **glEnableClientState(3G)**, **glGet(3G)**