1991-2006 Silicon Graphics, Inc.
glGetHistogramParameter 3G
glGetHistogramParameter 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 format
`GL_HISTOGRAM_RED_SIZE` | Red component counter size, in bits
`GL_HISTOGRAM_GREEN_SIZE` | Green component counter size, in bits
`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 `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, glHistogram

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.