GLGETHISTOGRAMPARAMETER

Section: Misc. Reference Manual Pages (3G)
Index Return to Main Contents
 

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:

ParameterDescription

GL_HISTOGRAM_WIDTHHistogram table width
GL_HISTOGRAM_FORMATInternal
GL_HISTOGRAM_RED_SIZERed component counter size, in bits
GL_HISTOGRAM_GREEN_SIZEGreen component counter size, in bits

ParameterDescription

GL_HISTOGRAM_BLUE_SIZEBlue component counter size, in bits
GL_HISTOGRAM_ALPHA_SIZEAlpha component counter size, in bits
GL_HISTOGRAM_LUMINANCE_SIZELuminance component counter size, in bits
GL_HISTOGRAM_SINKValue 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)


 

Index

NAME
C SPECIFICATION
PARAMETERS
DESCRIPTION
NOTES
ERRORS
SEE ALSO

linux.jgfs.net manual pages