glRasterPos4fv, fonction

Spécifie la position raster pour les opérations de pixels.

Syntaxe

void WINAPI glRasterPos4fv(
   const GLfloat *v
);

Paramètres

C

Pointeur vers un tableau de quatre éléments, spécifiant les coordonnées x, y, z et w pour la position de raster actuelle.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

OpenGL conserve une position 3D dans les coordonnées de la fenêtre. Cette position, appelée position raster, est conservée avec une précision de sous-pixel. Il est utilisé pour positionner les opérations d’écriture de pixels et bitmaps. Consultez glBitmap, glDrawPixels et glCopyPixels.

La position raster actuelle se compose de trois coordonnées de fenêtre (x, y, z), d’une valeur de coordonnée de découpage w , d’une distance de coordonnées oculaires, d’un bit valide et de données de couleur et de coordonnées de texture associées. La coordonnée w est une coordonnée de clip, car w n’est pas projeté sur les coordonnées de fenêtre. La fonction glRasterPos4 spécifie explicitement les coordonnées d’objet x, y, z et w . La fonction glRasterPos3 spécifie explicitement les coordonnées d’objet x, y et z , tandis que w est implicitement défini sur un. La fonction glRasterPos2 utilise les valeurs d’argument pour x et y tout en définissant implicitement z et w sur zéro et un.

Les coordonnées d’objet présentées par glRasterPos sont traitées comme celles d’une commande glVertex . Elles sont transformées par les matrices modelview et projection actuelles et passées à l’étape de découpage. Si le sommet n’est pas supprimé, il est projeté et mis à l’échelle en coordonnées de fenêtre, qui deviennent la nouvelle position raster actuelle, et l’indicateur GL_CURRENT_RASTER_POSITION_VALID est défini. Si le sommet est éliminé, le bit valide est effacé et la position raster actuelle et les coordonnées de couleur et de texture associées ne sont pas définies.

La position actuelle du raster inclut également des données de couleur et des coordonnées de texture associées. Si l’éclairage est activé, GL_CURRENT_RASTER_COLOR, en mode RGBA ou le GL_CURRENT_RASTER_INDEX, en mode d’index de couleur, est défini sur la couleur produite par le calcul de l’éclairage (voir glLight, glLightModel et glShadeModel). Si l’éclairage est désactivé, la couleur actuelle (en mode RVBA, variable d’état GL_CURRENT_COLOR) ou l’index de couleur (en mode d’index de couleur, variable d’état GL_CURRENT_INDEX) est utilisée pour mettre à jour la couleur raster actuelle.

De même, GL_CURRENT_RASTER_TEXTURE_COORDS est mis à jour en fonction de GL_CURRENT_TEXTURE_COORDS, en fonction de la matrice de texture et des fonctions de génération de texture (voir glTexGen). Enfin, la distance entre l’origine du système de coordonnées oculaires et le sommet, telle que transformée uniquement par la matrice modelview, remplace GL_CURRENT_RASTER_DISTANCE.

Initialement, la position raster actuelle est (0,0,0,1), la distance de trame actuelle est 0, le bit valide est défini, la couleur RVBA associée est (1,1,1,1), l’index de couleur associé est 1 et les coordonnées de texture associées sont (0, 0, 0, 0, 1). En mode RVBA, GL_CURRENT_RASTER_INDEX est toujours 1 ; En mode d’index de couleur, la couleur RVBA raster actuelle conserve toujours sa valeur initiale.

Notes

La position raster est modifiée à la fois par glRasterPos et par glBitmap.

Notes

Lorsque les coordonnées de position raster ne sont pas valides, les commandes de dessin basées sur la position raster sont ignorées (autrement dit, elles n’entraînent pas de modifications de l’état OpenGL).

Les fonctions suivantes récupèrent des informations relatives à glRasterPos :

glGet avec GL_CURRENT_RASTER_POSITION d’arguments
glGet avec argument GL_CURRENT_RASTER_POSITION_VALID
glGet avec GL_CURRENT_RASTER_DISTANCE d’arguments
glGet avec GL_CURRENT_RASTER_COLOR d’arguments
glGet avec argument GL_CURRENT_RASTER_INDEX
glGet avec argument GL_CURRENT_RASTER_TEXTURE_COORDS

Spécifications

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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex