glClipPlane, fonction

La fonction glClipPlane spécifie un plan sur lequel toute la géométrie est découpée.

Syntaxe

void WINAPI glClipPlane(
         GLenum   plane,
   const GLdouble *equation
);

Paramètres

plane (avion)

Plan de découpage en cours de positionnement. Les noms symboliques de la forme GL_CLIP_PLANEi, où i est un entier compris entre 0 et GL_MAX_CLIP_PLANES - 1, sont acceptés.

equation

Adresse d’un tableau de quatre valeurs à virgule flottante double précision. Ces valeurs sont interprétées comme une équation de plan.

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	plane n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La géométrie est toujours découpée par rapport aux limites d’un frustum à six plans dans x, y et z. La fonction glClipPlane permet de spécifier des plans supplémentaires, pas nécessairement perpendiculaires à l’axe x, à l’axe Y ou à l’axe z, sur lesquels toute la géométrie est découpée. Jusqu’à GL_MAX_CLIP_PLANES plans peuvent être spécifiés, où GL_MAX_CLIP_PLANES est au moins six dans toutes les implémentations. Étant donné que la zone de découpage résultante est l’intersection des demi-espaces définis, elle est toujours convexe.

La fonction glClipPlane spécifie un demi-espace à l’aide d’une équation de plan à quatre composants. Lorsque vous appelez glClipPlane, l’équation est transformée par l’inverse de la matrice modelview et stockée dans les coordonnées oculaires résultantes. Les modifications ultérieures apportées à la matrice modelview n’ont aucun effet sur les composants d’équation de plan stockés. Si le produit de point des coordonnées oculaires d’un vertex avec les composants de l’équation du plan stocké est positif ou nul, le vertex est dans par rapport à ce plan de découpage. Sinon, il est sorti.

Utilisez les fonctions glEnable et glDisable pour activer et désactiver les plans de découpage. Appelez les plans de découpage avec l’argument GL_CLIP_PLANEi, où i est le numéro du plan.

Par défaut, tous les plans de découpage sont définis comme (0,0,0,0) en coordonnées oculaires et sont désactivés.

Il est toujours le cas que GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

Les fonctions suivantes récupèrent des informations relatives à glClipPlane :

glGetClipPlane

glIsEnabled avec l’argument GL_CLIP_PLANE i

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

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled