glRasterPos4iv fonction)

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

Syntaxe

void WINAPI glRasterPos4iv(
   const GLint *v
);

Paramètres

v

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

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Remarques

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

La position actuelle du raster est constituée de trois coordonnées de fenêtre (x, y, z), d’une valeur w de la coordonnée d’un élément, d’une distance de coordonnée oculaire, d’un bit valide, 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é aux coordonnées de la fenêtre. La fonction glRasterPos4 spécifie les coordonnées d’objet x, y, z et w explicitement. La fonction glRasterPos3 spécifie les coordonnées d’objet x, y et z explicitement, 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 z et w de manière implicite 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 de projection et de modelview actuelles et transmises à l’étape de découpage. Si le vertex n’est pas sélectionné, il est projeté et mis à l’échelle sur les coordonnées de la fenêtre, qui devient la nouvelle position de la trame actuelle, et l’indicateur de la position de la _ trame active du GL _ _ _ est défini. Si le vertex est sélectionné, le bit valide est effacé et la position raster actuelle ainsi que les coordonnées de couleur et de texture associées ne sont pas définies.

La position actuelle du raster comprend également des données de couleur et des coordonnées de texture associées. Si l’éclairage est activé, la _ _ couleur de tramage actuelle de la comptabilité GL _ , en mode RVBA, ou l' _ index raster actuel du GL _ _ , en mode d’index des couleurs, est définie sur la couleur produite par le calcul de l’éclairage (voir glLight, glLightModelet glShadeModel). Si l’éclairage est désactivé, la couleur actuelle (en mode RVBA, la couleur actuelle de la comptabilité de la variable d’état _ _ ) ou l’index de couleurs (en mode d’index des couleurs, l’index de la valeur de la comptabilité générale de _ la variable d’état _ ) est utilisé pour mettre à jour la couleur raster actuelle.

De même, _ les _ _ _ coordonnées de la texture raster actuelle du GL sont mises à jour en fonction de la mesure de _ texture actuelle du GL _ _ , 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 oculaire et le sommet, telle qu’elle est transformée par la matrice modelview, remplace la distance de la _ trame actuelle du GL _ _ .

Au départ, la position du raster actuel 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, 1). En mode RVBA, _ _ l’index de tramage actuel de GL _ est toujours 1 ; dans le mode d’index de couleurs, 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 la position raster ne sont pas valides, les commandes de dessin basées sur la position raster sont ignorées (c’est-à-dire qu’elles n’entraînent pas de modifications de l’État OpenGL).

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

glGet avec argument GL _ Current _ Raster _ position
glGet avec argument GL _ Current _ Raster _ position _ valide
glGet avec argument GL _ Current _ Raster _ distance
glGet avec argument GL _ Current _ Raster _ couleur
glGet avec argument GL _ Current _ Raster _ index
glGet avec argument de _ la _ texture de TRAMe actuelle du _ GL _

Configuration requise

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