GLCOPYCOLORTABLE
NAMEC SPECIFICATION
PARAMETERS
DESCRIPTION
NOTES
ERRORS
ASSOCIATED GETS
SEE ALSO
NAME
glCopyColorTable − copy pixels into a color table
C SPECIFICATION
void glCopyColorTable( GLenum target,
GLenum internalformat, | |
GLint x, | |
GLint y, | |
GLsizei width ) |
PARAMETERS
target |
The color table target. Must be GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, or GL_POST_COLOR_MATRIX_COLOR_TABLE. | ||
internalformat |
The internal storage of the texture image. Must be one of the following symbolic constants: GL_ALPHA, GL_ALPHA4, GL_ALPHA8, GL_ALPHA12, GL_ALPHA16, GL_LUMINANCE, GL_LUMINANCE4, GL_LUMINANCE8, GL_LUMINANCE12, GL_LUMINANCE16, GL_LUMINANCE_ALPHA, GL_LUMINANCE4_ALPHA4, GL_LUMINANCE6_ALPHA2, GL_LUMINANCE8_ALPHA8, GL_LUMINANCE12_ALPHA4, GL_LUMINANCE12_ALPHA12, GL_LUMINANCE16_ALPHA16, GL_INTENSITY, GL_INTENSITY4, GL_INTENSITY8, GL_INTENSITY12, GL_INTENSITY16, GL_R3_G3_B2, GL_RGB, GL_RGB4, GL_RGB5, GL_RGB8, GL_RGB10, GL_RGB12, GL_RGB16, GL_RGBA, GL_RGBA2, GL_RGBA4, GL_RGB5_A1, GL_RGBA8, GL_RGB10_A2, GL_RGBA12, GL_RGBA16. | ||
x |
The x coordinate of the lower-left corner of the pixel rectangle to be transferred to the color table. | ||
y |
The y coordinate of the lower-left corner of the pixel rectangle to be transferred to the color table. | ||
width |
The width of the pixel rectangle. |
DESCRIPTION
glCopyColorTable loads a color table with pixels from the current GL_READ_BUFFER (rather than from main memory, as is the case for glColorTable).
The screen-aligned pixel rectangle with lower-left corner at (x, y) having width width and height 1 is loaded into the color table. If any pixels within this region are outside the window that is associated with the GL context, the values obtained for those pixels are undefined.
The pixels in the rectangle are processed just as if glReadPixels were called, with internalformat set to RGBA, but processing stops after the final conversion to RGBA.
The four scale parameters and the four bias parameters that are defined for the table are then used to scale and bias the R, G, B, and A components of each pixel. The scale and bias parameters are set by calling glColorTableParameter.
Next, the R, G, B, and A values are clamped to the range [0,1]. Each pixel is then converted to the internal specified by internalformat. This conversion simply maps the component values of the pixel (R, G, B, and A) to the values included in the internal (red, green, blue, alpha, luminance, and intensity). The mapping is as follows:
Finally, the red, green, blue, alpha, luminance, and/or intensity components of the resulting pixels are stored in the color table. They form a one-dimensional table with indices in the range [0, width − 1].
NOTES
glCopyColorTable is available only if GL_ARB_imaging is returned from calling glGetString with an argument of GL_EXTENSIONS.
ERRORS
GL_INVALID_ENUM is generated when target is not one of the allowable values.
GL_INVALID_VALUE is generated if width is less than zero.
GL_INVALID_VALUE is generated if internalformat is not one of the allowable values.
GL_TABLE_TOO_LARGE is generated if the requested color table is too large to be supported by the implementation.
GL_INVALID_OPERATION is generated if glCopyColorTable is executed between the execution of glBegin and the corresponding execution of glEnd.
ASSOCIATED GETS
glGetColorTable, glGetColorTableParameter
SEE ALSO
glColorTable(3G), glColorTableParameter(3G), glReadPixels(3G)
More Linux Commands
manpages/FcCharSetAddChar.3.html
FcCharSetAddChar(3) - Add a character to a charset (ManPage)
FcCharSetAddChar adds a single unicode char to the set, returning FcFalse on failure, either as a result of a constant set or from running out of memory. VERSIO
manpages/gluQuadricDrawStyle.3gl.html
gluQuadricDrawStyle(3gl) - specify the draw style desired fo
gluQuadricDrawStyle specifies the draw style for quadrics rendered with quad. The legal values are as follows: GLU_FILL Quadrics are rendered with polygon primi
manpages/wcsncpy.3.html
wcsncpy(3) - copy a fixed-size string of wide characters....
The wcsncpy() function is the wide-character equivalent of the strncpy(3) function. It copies at most n wide characters from the wide-character string pointed t
manpages/Tk_Colormap.3.html
Tk_Colormap(3) - retrieve information from Tk's local data s
Tk_WindowId and the other names listed above are all macros that return fields from Tks local data structure for tkwin. None of these macros requires any intera
manpages/pcre32_study.3.html
pcre32_study(3) Perl-compatible regular expressions.........
This function studies a compiled pattern, to see if additional information can be extracted that might speed up matching. Its arguments are: code A compiled reg
manpages/XGetWMProtocols.3.html
XGetWMProtocols(3) - set or read a window's WM_PROTOCOLS pro
The XSetWMProtocols function replaces the WM_PROTOCOLS property on the specified window with the list of atoms specified by the protocols argument. If the prope
manpages/gnutls_psk_set_params_function.3.html
gnutls_psk_set_params_function(3) - API function (Man Page)
This function will set a callback in order for the server to get the Diffie-Hellman or RSA parameters for PSK authentication. The callback should return GNUTLS_
manpages/XClipBox.3.html
XClipBox(3) - generate regions (Library - Linux man page)...
The XPolygonRegion function returns a region for the polygon defined by the points array. For an explanation of fill_rule, see XCreateGC. The XClipBox function
manpages/ausearch.8.html
ausearch(8) a tool to query audit daemon logs (Man Page)....
ausearch is a tool that can query the audit daemon logs based for events based on different search criteria. The ausearch utility can also take input from stdin
manpages/Tk_ConfigureValue.3.html
Tk_ConfigureValue(3) - process configuration options for wid
Note: Tk_ConfigureWidget should be replaced with the new Tcl_Obj based API Tk_SetOptions. The old interface is retained for backward compatibility. Tk_Configure
manpages/rmiregistry.1.html
rmiregistry(1) - The Java Remote Object Registry (Man Page)
The rmiregistry command creates and starts a remote object registry on the specified port on the current host. If port is omitted, the registry is started on po
manpages/FcDefaultSubstitute.3.html
FcDefaultSubstitute(3) - Perform default substitutions in a
Supplies default values for underspecified font patterns: * Patterns without a specified style or weight are set to Medium * Patterns without a specified style
