glRasterPos4s, fonction

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

Syntaxe

void WINAPI glRasterPos4s(
   GLshort x,
   GLshort y,
   GLshort z,
   GLshort w
);

Paramètres

x

Spécifie la coordonnée x de la position raster actuelle.

y

Spécifie la coordonnée y pour la position raster actuelle.

z

Spécifie la coordonnée z pour la position raster actuelle.

w

Coordonnée w pour la position 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.

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

Voir aussi

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex