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 |
|---|---|
|
plane n’était pas une valeur acceptée. |
|
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 :
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 |
|
| Bibliothèque |
|
| DLL |
|