glGetColorTableParameterEXT

NAME

glGetColorTableParameterfvEXT, glGetColorTableParameterfvEXT - get color lookup table parameters

C SPECIFICATION

void glGetColorTableParameterfvEXT(GLenum target,
                                   GLenum pname
                                   GLfloat *params)

void glGetColorTableParameterivEXT(GLenum target,
                                   GLenum pname
                                   GLint *params)

PARAMETERS

target	Must be one of the following: GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT, GL_TEXTURE_COLOR_TABLE_EXT, GL_PROXY_COLOR_TABLE_EXT, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE_EXT, or GL_PROXY_TEXTURE_COLOR_TABLE_EXT.
pname	The symbolic name of a color lookup table parameter. Must be one of GL_COLOR_TABLE_BIAS_EXT, GL_COLOR_TABLE_SCALE_EXT, GL_COLOR_TABLE_FORMAT_EXT, GL_COLOR_TABLE_WIDTH_EXT, GL_COLOR_TABLE_RED_SIZE_EXT, GL_COLOR_TABLE_GREEN_SIZE_EXT, GL_COLOR_TABLE_BLUE_SIZE_EXT, GL_COLOR_TABLE_ALPHA_SIZE_EXT, GL_COLOR_TABLE_LUMINANCE_SIZE_EXT, or GL_COLOR_TABLE_INTENSITY_SIZE_EXT.
params	A pointer to an array where the values of the parameters are stored.

DESCRIPTION

glGetColorTableParameterEXT retrieves the color table scale and bias parameters set by glColorTableParameterEXT, as well as the format and size parameters set by glColorTableEXT. target must be GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT, or GL_TEXTURE_COLOR_TABLE_EXT to retrieve the scale and bias parameters, and either GL_COLOR_TABLE_EXT, GL_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_POST_COLOR_MATRIX_COLOR_TABLE_EXT, GL_TEXTURE_COLOR_TABLE_EXT, GL_PROXY_COLOR_TABLE_EXT, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE_EXT, GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE_EXT, or GL_PROXY_TEXTURE_COLOR_TABLE_EXT to retrieve the other table parameters.

pname must be GL_COLOR_TABLE_SCALE_EXT to retrieve the scale factors. In this case, params points to an array of four elements, which receive the scale factors for red, green, blue, and alpha. pname must be GL_COLOR_TABLE_BIAS_EXT to retrieve the bias terms. params points to an array of four elements, which receive the bias terms for red, green, blue, and alpha.

pname may also be one of the symbolic constants in the following table, in which case params must point to an array of the given length.

pname Length Meaning
GL_COLOR_TABLE_FORMAT_EXT 1 Internal format (e.g., GL_RGBA)
GL_COLOR_TABLE_WIDTH_EXT 1 Number of elements in table
GL_COLOR_TABLE_RED_SIZE_EXT 1 Size of red component, in bits
GL_COLOR_TABLE_GREEN_SIZE_EXT 1 Size of green component
GL_COLOR_TABLE_BLUE_SIZE_EXT 1 Size of blue component
GL_COLOR_TABLE_ALPHA_SIZE_EXT 1 Size of alpha component
GL_COLOR_TABLE_LUMINANCE_SIZE_EXT 1 Size of luminance component
GL_COLOR_TABLE_INTENSITY_SIZE_EXT 1 Size of intensity component

pname	Length	Meaning
GL_COLOR_TABLE_FORMAT_EXT	1	Internal format (e.g., GL_RGBA)
GL_COLOR_TABLE_WIDTH_EXT	1	Number of elements in table
GL_COLOR_TABLE_RED_SIZE_EXT	1	Size of red component, in bits
GL_COLOR_TABLE_GREEN_SIZE_EXT	1	Size of green component
GL_COLOR_TABLE_BLUE_SIZE_EXT	1	Size of blue component
GL_COLOR_TABLE_ALPHA_SIZE_EXT	1	Size of alpha component
GL_COLOR_TABLE_LUMINANCE_SIZE_EXT	1	Size of luminance component
GL_COLOR_TABLE_INTENSITY_SIZE_EXT	1	Size of intensity component

EXTENSIONS

Some routines and constants for this function are part of an extension, not part of the core GL command set. The following extension names must be present in the string returned by glGetString when called with argument GL_EXTENSIONS to use these routines and constants.

GL_EXT_texture_color_table: GL_TEXTURE_COLOR_TABLE_EXT is part of the EXT_texture_color_table extension.

ERRORS

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

GL_INVALID_OPERATION is generated if glGetColorTableParameterEXT is executed between the execution of glBegin and the corresponding execution of glEnd.