fonction glGetMapiv

Les fonctions glGetMapdv, glGetMapfv et glGetMapiv retournent les paramètres de l’évaluateur.

Syntaxe

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

Paramètres

cible

Nom symbolique d’une carte. Les valeurs suivantes sont acceptées : 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 et GL_MAP2_VERTEX_4.

requête

Spécifie le paramètre à retourner. Les noms symboliques suivants sont acceptés.

Valeur	Signification
GL_COEFF	Le paramètre v retourne les points de contrôle de la fonction évaluateur. Les évaluateurs unidimensionnels retournent des points de contrôle d’ordre , et les évaluateurs bidimensionnels retournent des points de contrôle uorderxvorder . Chaque point de contrôle se compose d’un, deux, trois ou quatre entiers, à virgule flottante simple précision ou à virgule flottante double précision, selon le type de l’évaluateur. Les points de contrôle bidimensionnels sont retournés dans l’ordre principal des lignes, incrémentant rapidement l’index uorder et l’index vorder après chaque ligne. Les valeurs entières, lorsqu’elles sont demandées, sont calculées en arrondissant les valeurs à virgule flottante internes aux valeurs entières les plus proches.
GL_ORDER	Le paramètre v retourne l’ordre de la fonction évaluateur. Les évaluateurs unidimensionnels retournent une seule valeur, l’ordre. Les évaluateurs bidimensionnels retournent deux valeurs, uorder et vorder.
GL_DOMAIN	Le paramètre v retourne les paramètres de mappage linéaire u et v . Les évaluateurs unidimensionnels retournent deux valeurs, u 1 et u 2, comme spécifié par glMap1. Les évaluateurs bidimensionnels retournent quatre valeurs (u1, u2, v1 et v2) spécifiées par glMap2. Les valeurs entières, lorsqu’elles sont demandées, sont calculées en arrondissant les valeurs à virgule flottante internes aux valeurs entières les plus proches.

v

Retourne les données demandées.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom	Signification
GL_INVALID_ENUM	target ou query n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant.

Notes

Les fonctions glGetMap retournent les paramètres de l’évaluateur. (Les fonctions glMap1 et glMap2 définissent les évaluateurs.) Le paramètre cible spécifie une carte, la requête sélectionne un paramètre spécifique et v pointe vers le stockage où les valeurs seront retournées.

Les valeurs acceptables pour le paramètre cible sont décrites dans glMap1 et glMap2.

Si une erreur est générée, aucune modification n’est apportée au contenu de v.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnd

glEvalCoord

glMap1

glMap2