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

/comp/gb.opengl/gl/hint

# Gl.Hint (gb.opengl)

Static Sub Hint ( Target As Integer, Mode As Integer )

### Préconise des optimisations spécifiques aux implémentations

#### Paramètres

- Target spécifie une constante symbolique indiquant le comportement à contrôler. Gl.GL_FOG_HINT, Gl.GL_LINE_SMOOTH_HINT, Gl.GL_PERSPECTIVE_CORRECTION_HINT, Gl.GL_POINT_SMOOTH_HINT, et Gl.GL_POLYGON_SMOOTH_HINT sont acceptés.

- Mode spécifie une constante symbolique indiquant le comportement désiré. Gl.GL_FASTEST, Gl.GL_NICEST, et Gl.GL_DONT_CARE sont acceptés.

#### Description

Certains aspects du comportement de GL, quand il y a assez de place pour l’interprétation, peuvent être contrôlés par les "hints". Un "hint" est spécifié par deux arguments. Target est une constante symbolique indiquant le comportement à contrôler, et Mode est une autre constante symbolique indiquant le comportement désiré. Mode peut être l’une des suivantes :

- Gl.GL_FASTEST l’option la plus efficace doit être choisie.

- Gl.GL_NICEST l’option la plus correcte, ou de plus haute qualité, doit être choisie.

- Gl.GL_DONT_CARE le client n’a pas de préférence.

  Bien que les aspects implémentation qui peuvent être optimisés soient bien définis, l’interprétation des "hints" depend de l’implémentation. Les aspects optimisés qui peuvent être spécifiés par Target, en même temps que les sémantiques suggérées, sont les suivants :

- Gl.GL_FOG_HINT indique la précision du calcul de "fog" (effet de brume). Si le calcul de "fog" pixel par pixel n’est pas efficacement pris en charge par l’implémentation de GL, l’optimisation Gl.GL_DONT_CARE ou Gl.GL_FASTEST peut entraîner un calcul d’effets de "fog" par sommet.

- Gl.GL_LINE_SMOOTH_HINT indiquent la qualité d’échantillonnage des lignes anti-aliasées. L’optimisation Gl.GL_NICEST peut conduire à plus de fragments de pixels générés pendant la rastérisation, si une plus grande fonction de filtre est appliquée.

- Gl.GL_PERSPECTIVE_CORRECTION_HINT indique la qualité de couleur et l’interpolation des coordonnées de texture. Si le paramètre d’interpolation de perspective-corrigée n’est pas efficacement pris en charge par l’implémentation de GL, l’optimisation Gl.GL_DONT_CARE ou Gl.GL_FASTEST peut résulter en une simple interpolation linéaire des couleurs et/ou coordonnées de texture.

- [../gl_point_smooth_hint|Gl.GL_POINT_SMOOTH_HINT indique la qualité d’échantillonnage des points anti-aliasés. L’optimisation gl_nicest|Gl.GL_NICEST ? peut conduire à plus de fragments de pixels générés pendant la rastérisation, si une plus grande fonction de filtre est appliquée.

- Gl.GL_POLYGON_SMOOTH_HINT HINT indique la qualité d’échantillonnage des polygones. L’optimisation Gl.GL_NICEST peut conduire à plus de fragments de pixels générés pendant la rastérisation, si une plus grande fonction de filtre est appliquée.

L’interprétation des "hints" dépend de l’implémentation. Gl.Hint peut être ignoré.

#### Erreurs

Gl.GL_INVALID_ENUM est générée si target ou mode ne sont pas des valeurs acceptées.
Gl.GL_INVALID_OPERATION est générée si Gl.Hint est appelée entre un appel à Gl.Begin et l’appel correspondant à Gl.End