1GLGETCOLORTABLEPARAM(3G)         OpenGL Manual        GLGETCOLORTABLEPARAM(3G)
2
3
4

NAME

6       glGetColorTableParameter - get color lookup table parameters
7

C SPECIFICATION

9       void glGetColorTableParameterfv(GLenum target, GLenum pname,
10                                       GLfloat * params);
11
12       void glGetColorTableParameteriv(GLenum target, GLenum pname,
13                                       GLint * params);
14

PARAMETERS

16       target
17           The target color table. Must be GL_COLOR_TABLE,
18           GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE,
19           GL_PROXY_COLOR_TABLE, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE, or
20           GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE.
21
22       pname
23           The symbolic name of a color lookup table parameter. Must be one of
24           GL_COLOR_TABLE_BIAS, GL_COLOR_TABLE_SCALE, GL_COLOR_TABLE_FORMAT,
25           GL_COLOR_TABLE_WIDTH, GL_COLOR_TABLE_RED_SIZE,
26           GL_COLOR_TABLE_GREEN_SIZE, GL_COLOR_TABLE_BLUE_SIZE,
27           GL_COLOR_TABLE_ALPHA_SIZE, GL_COLOR_TABLE_LUMINANCE_SIZE, or
28           GL_COLOR_TABLE_INTENSITY_SIZE.
29
30       params
31           A pointer to an array where the values of the parameter will be
32           stored.
33

DESCRIPTION

35       Returns parameters specific to color table target.
36
37       When pname is set to GL_COLOR_TABLE_SCALE or GL_COLOR_TABLE_BIAS,
38       glGetColorTableParameter returns the color table scale or bias
39       parameters for the table specified by target. For these queries, target
40       must be set to GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, or
41       GL_POST_COLOR_MATRIX_COLOR_TABLE and params points to an array of four
42       elements, which receive the scale or bias factors for red, green, blue,
43       and alpha, in that order.
44
45       glGetColorTableParameter can also be used to retrieve the format and
46       size parameters for a color table. For these queries, set target to
47       either the color table target or the proxy color table target. The
48       format and size parameters are set by glColorTable().
49
50       The following table lists the format and size parameters that may be
51       queried. For each symbolic constant listed below for pname, params must
52       point to an array of the given length and receive the values indicated.
53
54       ┌──────────────────────────────────┬───────────────────────────┬─────────────────────────────────┐
55       │                                  │                           │                                 │
56       │                        Parameter │                         N │                         Meaning │
57       │                                  │                           │                                 │
58       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
59       │GL_COLOR_TABLE_FORMAT             │             1             │ Internal format (e.g., GL_RGBA) │
60       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
61       │GL_COLOR_TABLE_WIDTH              │             1             │ Number of elements in table     │
62       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
63       │GL_COLOR_TABLE_RED_SIZE           │             1             │ Size of red component, in bits  │
64       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
65       │GL_COLOR_TABLE_GREEN_SIZE         │             1             │ Size of green component         │
66       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
67       │GL_COLOR_TABLE_BLUE_SIZE          │             1             │ Size of blue component          │
68       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
69       │GL_COLOR_TABLE_ALPHA_SIZE         │             1             │ Size of alpha component         │
70       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
71       │GL_COLOR_TABLE_LUMINANCE_SIZE     │             1             │ Size of luminance component     │
72       ├──────────────────────────────────┼───────────────────────────┼─────────────────────────────────┤
73       │GL_COLOR_TABLE_INTENSITY_SIZE     │             1             │ Size of intensity component     │
74       └──────────────────────────────────┴───────────────────────────┴─────────────────────────────────┘
75

NOTES

77       glGetColorTableParameter is present only if ARB_imaging is returned
78       when glGetString() is called with an argument of GL_EXTENSIONS.
79

ERRORS

81       GL_INVALID_ENUM is generated if target or pname is not an acceptable
82       value.
83
84       GL_INVALID_OPERATION is generated if glGetColorTableParameter is
85       executed between the execution of glBegin() and the corresponding
86       execution of glEnd().
87

SEE ALSO

89       glColorTable(), glTexParameter(), glColorTableParameter()
90

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

AUTHORS

97       opengl.org
98
99
100
101opengl.org                        06/10/2014          GLGETCOLORTABLEPARAM(3G)
Impressum