glGetMap — return evaluator parameters
void glGetMapdv( | GLenum | target, |
GLenum | query, | |
GLdouble * | v) ; |
void glGetMapfv( | GLenum | target, |
GLenum | query, | |
GLfloat * | v) ; |
void glGetMapiv( | GLenum | target, |
GLenum | query, | |
GLint * | v) ; |
target
Specifies the symbolic name of a map.
Accepted values are
GL_MAP1_COLOR_4
,
GL_MAP1_INDEX
,
GL_MAP1_NORMAL
,
GL_MAP1_TEXTURE_COORD_1
,
GL_MAP1_TEXTURE_COORD_2
,
GL_MAP1_TEXTURE_COORD_3
,
GL_MAP1_TEXTURE_COORD_4
,
GL_MAP1_VERTEX_3
,
GL_MAP1_VERTEX_4
,
GL_MAP2_COLOR_4
,
GL_MAP2_INDEX
,
GL_MAP2_NORMAL
,
GL_MAP2_TEXTURE_COORD_1
,
GL_MAP2_TEXTURE_COORD_2
,
GL_MAP2_TEXTURE_COORD_3
,
GL_MAP2_TEXTURE_COORD_4
,
GL_MAP2_VERTEX_3
, and
GL_MAP2_VERTEX_4
.
query
Specifies which parameter to return.
Symbolic names
GL_COEFF
,
GL_ORDER
, and
GL_DOMAIN
are accepted.
v
Returns the requested data.
glMap1 and glMap2 define evaluators.
glGetMap
returns evaluator parameters.
target
chooses a map,
query
selects a specific parameter,
and v
points to storage where the values will be returned.
The acceptable values for the target
parameter are described
in the glMap1 and glMap2 reference pages.
query
can assume the following values:
GL_COEFF
v
returns the control points for the evaluator function.
One-dimensional evaluators return
control points,
and two-dimensional evaluators return
control points.
Each control point consists of one, two, three, or four integer,
single-precision floating-point,
or double-precision floating-point values,
depending on the type of the evaluator.
The GL returns two-dimensional control points in row-major order,
incrementing the
index quickly
and the
index after each row.
Integer values,
when requested,
are computed by rounding the internal floating-point values to the
nearest integer values.
GL_ORDER
v
returns the order of the evaluator function.
One-dimensional evaluators return a single value,
.
The initial value is 1.
Two-dimensional evaluators return two values,
and
.
The initial value is 1,1.
GL_DOMAIN
v
returns the linear
and
mapping parameters.
One-dimensional evaluators return two values,
and
,
as specified by glMap1.
Two-dimensional evaluators return four values
(,
,
,
and
)
as specified by glMap2.
Integer values,
when requested,
are computed by rounding the internal floating-point values to the
nearest integer values.
GL_INVALID_ENUM
is generated if either target
or query
is not
an accepted value.
GL_INVALID_OPERATION
is generated if glGetMap
is executed between the execution of glBegin
and the corresponding execution of glEnd.
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.