glClipPlane fonction)
La fonction glClipPlane spécifie un plan par rapport auquel 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 positionné. Les noms symboliques de la forme _ plan du clip GL _ i, où i est un nombre entier compris entre 0 et _ le nombre maximal _ de clips de la comptabilité _ -1, sont acceptés.
-
Sommaire
-
Adresse d’un tableau de quatre valeurs à virgule flottante double précision. Ces valeurs sont interprétées comme une équation 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 |
|---|---|
|
le plan n’est pas une valeur acceptée. |
|
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Remarques
La géométrie est toujours découpée par rapport aux limites d’un frustum à six plans en x, y et z. La fonction glClipPlane permet de spécifier des plans supplémentaires, pas nécessairement perpendiculairement à l’axe des x, à l’axe y ou à l’axe z, par rapport auquel toutes les géométries sont découpées. Vous pouvez spécifier jusqu’à un _ nombre maximal de _ plans de captures de l’élément GL _ , où le _ nombre maximal _ _ de plans de clip GL est d’au moins six dans toutes les implémentations. Étant donné que la zone de découpage obtenue 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. Quand vous appelez glClipPlane,Equation est transformé par l’inverse de la matrice modelview et stocké dans les coordonnées oculaire obtenues. Les modifications ultérieures apportées à la matrice modelview n’ont aucun effet sur les composants d’équation plan stocké. Si le produit scalaire des coordonnées oculaires d’un vertex avec les composants de l’équation du plan stocké est positif ou zéro, le vertex est en rapport avec ce plan de découpage. Sinon, elle est en sortie.
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 _ plan i, où i est le numéro de plan.
Par défaut, tous les plans de découpage sont définis en tant que (0, 0, 0, 0) dans les coordonnées oculaires et sont désactivés.
C’est toujours le cas dans le cadre du _ plan de clip GL _ i = GL _ clip _ PLANE0 + i.
Les fonctions suivantes récupèrent les informations relatives à glClipPlane:
glIsEnabled avec argument GL _ clip _ plan i
Configuration requise
| 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 |
|