Documentation de Gambas - /comp/gb.opengl/gl/clipplane

/comp/gb.opengl/gl/clipplane

# Gl.ClipPlane (gb.opengl)

Static Sub ClipPlane ( Plane As Integer, Equation As Float[] )

Spécifie le plan auquel toute la géométrie est attachée.

### Paramètres

plane

  Spécifie quel plan de découpage est positionné. Les noms symboliques de la forme Gl.CLIP_PLANE i, où i est un entier entre 0 et Gl.MAX_CLIP_PLANES -1 , sont acceptés.

equation

  Spécifie un tableau de quatre valeurs Float double précision. Ces valeurs sont interprétées comme les équations du plan.

### Description

La géométrie est toujours fixée dans les limites d’une pyramide de six plans en x, y, et z. Gl.ClipPlane permet la spécification de plans additionnels, qui ne sont pas nécessairement perpendiculaires à l’axe x, y, ou z, auxquels toute la géométrie est attachée. Pour connaître le nombre maximum de plans additionnels, appelez Gl.GetIntegerv avec l’argument Gl.MAX_CLIP_PLANES. Toute implémentation gère au moins six de ces plans de coupe. Comme il en résulte une région de découpage qui est l’intersection des demi-espaces définis, elle est toujours convexe.

Gl.ClipPlane spécifie un demi-espace en utilisant une équation plane à quatre composantes. Quand Gl.ClipPlane est appelé, equation est transformée par la matrice inverse de modelview et enregistrée dans les coordonnées de point de vue (eye) résultant. Les changements subséquents de la matrice modelview sont sans effet sur les composantes de l’équation plane enregistrée. Si le point, produit des coordonnées du point de vue d’un sommet par l’équation plane enregistrée, est positif ou nul, le sommet est intérieur par rapport au plan de découpage. Autrement, il est extérieur.

Les plans de coupe (Clipping planes) sont activés ou désactivés par Gl.Enable et Gl.Disable, appelés avec l’argument Gl.GL_CLIP_PLANEi, où i est le numéro du plan.

Tous les plans de coupe sont initialement définis par (0, 0, 0, 0) dans les coordonnées du point de vue et sont désactivés.

### Notes

Dans tous les cas Gl.CLIP_PLANE i = Gl.CLIP_PLANE0 + i.

### Erreurs

Gl.INVALID_ENUM est généré si plane n’est pas une valeur acceptée.

Gl.INVALID_OPERATION est généré si Gl.ClipPlane est appelée entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

### Gets Associés

Gl.GetClipPlane

Gl.IsEnabled with argument Gl.CLIP_PLANEi

### Voir aussi

- Gl.Enable

Voir documentation originale sur le site OpenGL