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

/comp/gb.opengl/gl/depthfunc

# Gl.DepthFunc (gb.opengl)

Static Sub DepthFunc ( Function As Integer )

### Spécifie la valeur utilisée pour les comparaisons avec le tampon de profondeur

#### Paramètres

- Function spécifie la fonction comparaisons de profondeur. Les constantes symboliques Gl.GL_NEVER, Gl.GL_LESS, Gl. GL_EQUAL, Gl.GL_LEQUAL, Gl.GL_GREATER, Gl.GL_NOTEQUAL, Gl.GL_GEQUAL, et Gl.GL_ALWAYS sont acceptées. La valeur par défaut est Gl.GL_LESS.

#### Description

Gl.DepthFunc spécifie la fonction utilisée pour comparer la valeur z de chaque pixel entrant avec celle présente dans le tampon de profondeur. La comparaison n’est effectuée que si le test de profondeur est activé. (Voir Gl.Enable et Gl.Disable de Gl.GL_DEPTH_TEST).

Function spécifie les conditions sous lesquelles un pixel sera tracé. Les fonctions de comparaison sont :

- Gl.GL_NEVER jamais tracé.

- Gl.GL_LESS tracé si la valeur z entrante est inférieure à la valeur z enregistrée.

- Gl.GL_EQUAL tracé si la valeur z entrante est égale à la valeur z enregistrée.

- Gl.GL_LEQUAL tracé si la valeur z entrante est inférieure à ou égale à la valeur z enregistrée.

- Gl.GL_GREATER tracé si la valeur z entrante est plus grande que la valeur z enregistrée.

- Gl.GL_NOTEQUAL tracé si la valeur z entrante est différente de la valeur z enregistrée.

- Gl.GL_GEQUAL tracé si la valeur z entrante est plus grande ou égale à la valeur z enregistrée.

- Gl.GL_ALWAYS toujours tracé.

  La valeur initiale de la Function est Gl.GL_LESS. Initialement, le test de profondeur est désactivé. Si le test de profondeur est désactivé ou s’il n’existe pas de tampon de profondeur, c’est comme si le test de profondeur était toujours satisfait.

Même si le tampon de profondeur existe et le masque de profondeur est différent de zéro, le tampon de profondeur n’est pas mis à jour si le test de profondeur est désactivé.

#### Erreurs

Gl.GL_INVALID_ENUM est générée si Function n’est pas une valeur acceptée.
Gl.GL_INVALID_OPERATION est générée si Gl.DepthFunc est appelée entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

#### _ Gets Associés

Gl.Get avec l’argument Gl.GL_DEPTH_FUNC
Gl.IsEnabled avec l’argument Gl.GL_DEPTH_TEST

### Voir aussi

- Gl.DepthRange,

- Gl.Enable, Gl.PolygonOffset