Função glGetMapiv

As funções glGetMapdv, glGetMapfv e glGetMapiv retornam parâmetros do avaliador.

Sintaxe

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

Parâmetros

destino

O nome simbólico de um mapa. Estes são os valores aceitos: 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 e GL_MAP2_VERTEX_4.

consulta

Especifica qual parâmetro retornar. Os nomes simbólicos a seguir são aceitos.

Valor	Significado
GL_COEFF	O parâmetro v retorna os pontos de controle para a função do avaliador. Os avaliadores unidimensionais retornam pontos de controle de ordem e os avaliadores bidimensionais retornam uorderx pontos de controle devorador. Cada ponto de controle consiste em um, dois, três ou quatro valores inteiros, ponto flutuante de precisão simples ou ponto flutuante de precisão dupla, dependendo do tipo do avaliador. Os pontos de controle bidimensionais são retornados em ordem de linha principal, incrementando rapidamente o índice uorder e o índice devorador após cada linha. Os valores inteiros, quando solicitados, são calculados arredondando os valores de ponto flutuante interno para os valores inteiros mais próximos.
GL_ORDER	O parâmetro v retorna a ordem da função do avaliador. Os avaliadores unidimensionais retornam um único valor, order. Os avaliadores bidimensionais retornam dois valores, uorder e vorder.
GL_DOMAIN	O parâmetro v retorna os parâmetros de mapeamento linear u e v . Os avaliadores unidimensionais retornam dois valores, u 1 e u 2, conforme especificado por glMap1. Os avaliadores bidimensionais retornam quatro valores (u1, u2, v1 e v2), conforme especificado por glMap2. Os valores inteiros, quando solicitados, são calculados arredondando os valores de ponto flutuante interno para os valores inteiros mais próximos.

v

Retorna os dados solicitados.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Comentários

As funções glGetMap retornam parâmetros do avaliador. (As funções glMap1 e glMap2 definem os avaliadores.) O parâmetro de destino especifica um mapa, a consulta seleciona um parâmetro específico e v aponta para o armazenamento em que os valores serão retornados.

Os valores aceitáveis para o parâmetro de destino são descritos em glMap1 e glMap2.

Se um erro for gerado, nenhuma alteração será feita no conteúdo de v.

Requisitos

Confira também

glBegin

glEnd

glEvalCoord

glMap1

glMap2