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

# glGetHistogramParameter(3x)

get histogram parameters

## NAME

**glGetHistogramParameterfv, glGetHistogramParameteriv** - get histogram parameters

## C SPECIFICATION

void **glGetHistogramParameterfv**( GLenum *target*,

```
	GLenum pname,
	GLfloat *params )
```

void **glGetHistogramParameteriv**( GLenum *target*,

```
	GLenum pname,
	GLint *params )
```

## PARAMETERS

- *target*

  Must be one of **GL\_HISTOGRAM** or **GL\_PROXY\_HISTOGRAM**.

- *pname*

  The name of the parameter to be retrieved. Must be one of **GL\_HISTOGRAM\_WIDTH**, **GL\_HISTOGRAM\_FORMAT**, **GL\_HISTOGRAM\_RED\_SIZE**, **GL\_HISTOGRAM\_GREEN\_SIZE**, **GL\_HISTOGRAM\_BLUE\_SIZE**, **GL\_HISTOGRAM\_ALPHA\_SIZE**, **GL\_HISTOGRAM\_LUMINANCE\_SIZE**, or **GL\_HISTOGRAM\_SINK**.

- *params*

  Pointer to storage for the returned values.

## DESCRIPTION

**glGetHistogramParameter** is used to query parameter values for the current histogram or for a proxy.  The histogram state information may be queried by calling **glGetHistogramParameter** with a *target* of **GL\_HISTOGRAM** (to obtain information for the current histogram table) or **GL\_PROXY\_HISTOGRAM** (to obtain information from the most recent proxy request) and one of the following values for the *pname* argument:

| | |
| --- | --- |
| **Parameter** | **Description** |
| **GL\_HISTOGRAM\_WIDTH** | Histogram table width |
| **GL\_HISTOGRAM\_FORMAT** | Internal |
| **GL\_HISTOGRAM\_RED\_SIZE** | Red component counter size, in bits |
| **GL\_HISTOGRAM\_GREEN\_SIZE** | Green component counter size, in bits |

| | |
| --- | --- |
| **Parameter** | **Description** |
| **GL\_HISTOGRAM\_BLUE\_SIZE** | Blue component counter size, in bits |
| **GL\_HISTOGRAM\_ALPHA\_SIZE** | Alpha component counter size, in bits |
| **GL\_HISTOGRAM\_LUMINANCE\_SIZE** | Luminance component counter size, in bits |
| **GL\_HISTOGRAM\_SINK** | Value of the *sink* parameter |

## NOTES

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

## ERRORS

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

**GL\_INVALID\_ENUM** is generated if *pname* is not one of the allowable values.

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

## SEE ALSO

**glGetHistogram(3G)**, **glHistogram(3G)**