Principales étapes
- Spécifier à l'aide de glSelectBuffer(...) le tableau qui va recevoir les enregistrements de hits.
- Entrer en mode Sélection, par glRenderMode(GL_SELECT)
- Initialiser la pile des noms par glInitNames() et glPushName(...).
- Définir le volume de vision concerné par la sélection, qui peut être différent du volume de vision pour le rendu de la scène.
- Dessiner la scène, en ajoutant les commandes pour nommer les primitives significatives.
- Quitter le mode Sélection et traiter les données de sélection
retournées (les enregistrements de hits).
Détail de ces étapes :
-
Spécifier le tableau qui va recevoir les enregistrements de hits
-
glSelectBuffer(GLsizei
taille, GLuint * tab) indique que l'on veut récupérer
les données de sélection dans le tableau tab d'entiers
non signés, qui peut contenir jusqu'à taille valeurs.
Ce tableau doit être alloué au préalable.
-
Entrer en mode Sélection
-
L'appel à glRenderMode(GL_SELECT)
permet d'entrer en mode Sélection.
-
Initialiser la pile des noms
-
Les noms sont des entiers non signés que l'on associe
à des primitives. La structure de données permettant de
nommer les objets est une pile. C'est à dire que l'on peut créer
une représentation hiérarchique d'une scène, et
récupérer non seulement le nom de l'objet final, mais
tous les noms de la hiérarchie menant à cet objet. Voyons
pour l'instant comment donner un nom à un objet sans utiliser
pleinement le mécanisme de la pile : pour un usage courant, il
suffit de placer un nom dans la pile, et de le remplacer par un autre
nom pour un autre objet.
La pile des noms est initialisée par glInitNames().
Un nom name est placé dans la pile en appelant glPushName(GLuint name).
-
Définir le volume de vision
-
Si le volume de vision du mode de Sélection est différent
de celui du mode de Rendu (comme c'est le cas pour le picking), c'est
à cette étape qu'il faut le modifier.
-
Dessiner la scène en nommant les primitives significatives
-
L'appel à glLoadName(GLuint
name) permet de remplacer le nom courant dans la pile par name.
Si la pile est vide, cet appel génère l'erreur GL_INVALID_OPERATION.
-
Quitter le mode Sélection et traiter les données retournées.
-
L'appel à hits = glRenderMode(GL_RENDER)
; permet de quitter le mode Sélection pour retourner en mode
de Rendu. La valeur hits retournée est le nombre de hits
de sélection. Une valeur négative signifie que le tableau
de sélection a récupéré plus de données
qu'il ne peut en accueillir.
Les enregistrements de hits sont accessibles dans le tableau tab de la première étape.
L'enregistrement des hits
Chaque enregistrement de hit se compose des éléments suivants :- Nombre de noms dans la pile au moment du hit
- Valeurs minimale et maximale de la coordonnée z de tous les sommets
des primitives qui sont entrées en intersection avec le volume
de vision depuis le dernier hit enregistré.
Ces valeurs, situées dans la plage [0, 1], sont multipliées par 2^3 - 1, et arrondies à l'entier non signé le plus proche - Contenu de la pile de noms au moment du hit, de bas en haut de la pile.
Exemple de sélection
Le programme select.c dessine quatre triangle (un vert, un rouge et deux jaunes), et représente une boite en fil de fer correspondant au volume de vision du mode de sélection. Le premier triangle génère un hit, ce qui n'est pas le cas du second, et les troisième et quatrièmes triangles génèrent un hit unique.
 |
hits = 2 number of names for hit = 1 z1 is 0.999999; z2 is 0.999999 the name is 1 number of names for hit = 1 z1 is 0; z2 is 2 the name is 3 |