Функция glGetMapiv

Функции glGetMapdv, glGetMapfv и glGetMapiv возвращают параметры средства оценки.

Синтаксис

void WINAPI glGetMapiv(
   GLenum target,
   GLenum query,
   GLint  *v
);

Параметры

target

Символьное имя карты. Допустимы следующие значения: 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_1 GL_MAP2_TEXTURE_COORD_2, GL_MAP2_TEXTURE_COORD_3, GL_MAP2_TEXTURE_COORD_4, GL_MAP2_VERTEX_3 и GL_MAP2_VERTEX_4.

запрос

Указывает возвращаемый параметр. Принимаются следующие символические имена.

Значение Значение
GL_COEFF
Параметр v возвращает контрольные точки для функции вычислителя. Одномерные средства оценки возвращают контрольные точки порядка , а двумерные средства оценки возвращают контрольные точки uorderxvorder . Каждая контрольная точка состоит из одного, двух, трех или четырех целочисленных значений, значений с плавающей запятой одной точности или двойной точности с плавающей запятой в зависимости от типа средства оценки. Двумерные контрольные точки возвращаются в порядке основной строки, что быстро увеличивает индекс uorder и индекс вихря после каждой строки. При запросе целочисленные значения вычисляются путем округления внутренних значений с плавающей запятой до ближайших целочисленных значений.
GL_ORDER
Параметр v возвращает порядок функции вычислителя. Одномерные вычислители возвращают одно значение, порядок. Двумерные средства оценки возвращают два значения: uorder и vorder.
GL_DOMAIN
Параметр v возвращает линейные параметры сопоставления u и v . Одномерные средства оценки возвращают два значения: u 1 и u 2, как указано в glMap1. Двумерные средства оценки возвращают четыре значения (u1, u2, v1 и v2), как указано в glMap2. При запросе целочисленные значения вычисляются путем округления внутренних значений с плавающей запятой до ближайших целочисленных значений.

v

Возвращает запрошенные данные.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

Следующие коды ошибок могут быть получены функцией glGetError .

Имя Значение
GL_INVALID_ENUM
Целевой объект или запрос не были принятыми значениями.
GL_INVALID_OPERATION
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Комментарии

Функции glGetMap возвращают параметры средства оценки. (Функции glMap1 и glMap2 определяют средства оценки.) Целевой параметр указывает сопоставление, запрос выбирает конкретный параметр, а v указывает на хранилище, где будут возвращены значения.

Допустимые значения для целевого параметра описаны в разделах glMap1 и glMap2.

Если возникает ошибка, содержимое v не изменяется.

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Gl.h
Библиотека
Opengl32.lib
DLL
Opengl32.dll

См. также раздел

glBegin

glEnd

glEvalCoord

glMap1

glMap2