glRasterPos4i (funzione)

Specifica la posizione raster per le operazioni sui pixel.

Sintassi

void WINAPI glRasterPos4i(
   GLint x,
   GLint y,
   GLint z,
   GLint w
);

Parametri

x

Specifica la coordinata x della posizione raster corrente.

y

Specifica la coordinata y della posizione raster corrente.

z

Specifica la coordinata z per la posizione raster corrente.

w

Coordinata w della posizione raster corrente.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

OpenGL mantiene una posizione 3D nelle coordinate della finestra. Questa posizione, denominata posizione raster, viene mantenuta con l'accuratezza dei subpixel. Viene usato per posizionare le operazioni di scrittura di pixel e bitmap. Vedere glBitmap, glDrawPixelse glCopyPixels.

La posizione raster corrente è costituita da tre coordinate della finestra (x, y, z), un valore di coordinata di ritaglio w , una distanza delle coordinate oculari, un bit valido e coordinate di trama e dati di colore associati. La coordinata w è una coordinata di ritaglio, perché w non è proiettata sulle coordinate della finestra. La funzione glRasterPos4 specifica in modo esplicito le coordinate dell'oggetto x, y, z e w . La funzione glRasterPos3 specifica in modo esplicito le coordinate dell'oggetto x, y e z , mentre w viene impostato in modo implicito su uno. La funzione glRasterPos2 usa i valori degli argomenti per x e y , impostando in modo implicito z e w su zero e uno.

Le coordinate degli oggetti presentate da glRasterPos vengono gestite esattamente come quelle di un comando glVertex . Vengono trasformati dalle matrici Modelview e Projection correnti e passate alla fase di ritaglio. Se il vertice non viene raccolto, viene proiettato e ridimensionato in base alle coordinate della finestra, che diventano la nuova posizione raster corrente e _ _ _ viene impostato il flag valido della posizione raster corrente _ . Se il vertice viene eliminato, viene cancellato il bit valido e la posizione raster corrente e le coordinate del colore e della trama associate non sono definite.

La posizione raster corrente include anche alcuni dati di colore e coordinate di trama associati. Se l'illuminazione è abilitata, il _ colore raster corrente di GL, _ _ in modalità RGBA o _ l' _ Indice raster corrente GL _ , in modalità di indice dei colori, viene impostato sul colore prodotto dal calcolo dell'illuminazione (vedere glLight, glLightModele glShadeModel). Se l'illuminazione è disabilitata, per aggiornare il colore raster corrente viene usato il colore corrente (in modalità RGBA, la variabile di stato GL _ Current _ Color) o l'indice dei colori (in modalità di indice colore, variabile di stato GL _ Current _ index).

Analogamente, _ le _ _ coordinate di trama raster correnti GL _ vengono aggiornate come funzione di _ coordinate di trama correnti GL _ _ , in base alla matrice di trama e alle funzioni di generazione della trama (vedere glTexGen). Infine, la distanza dall'origine del sistema di coordinate oculari al vertice, come trasformato solo dalla matrice Modelview, sostituisce la _ distanza raster corrente di GL _ _ .

Inizialmente, la posizione raster corrente è (0, 0, 0, 1), la distanza raster corrente è 0, è impostato il bit valido, il colore RGBA associato è (1, 1, 1, 1), l'indice colori associato è 1 e le coordinate di trama associate sono (0, 0, 0, 1). In modalità RGBA, GL _ Current _ raster _ index è sempre 1; in modalità di indice dei colori, il colore RGBA raster corrente mantiene sempre il proprio valore iniziale.

Nota

La posizione raster viene modificata da glRasterPos e da glBitmap.

Nota

Quando le coordinate della posizione raster non sono valide, i comandi di disegno basati sulla posizione raster vengono ignorati, ovvero non comportano modifiche allo stato di OpenGL.

Le funzioni seguenti consentono di recuperare informazioni correlate a glRasterPos:

glGet con argomento GL _ Current _ raster _ position
glGet con argomento GL _ Current _ raster _ position _ valido
glGet con argomento GL _ Current _ raster _ distance
glGet con argomento GL _ Current _ _ color raster
glGet con argomento GL _ Current _ _ index raster
glGet con argomento con _ _ coordinate di _ trama _ raster correnti

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
GL. h
Libreria
Opengl32. lib
DLL
Opengl32.dll

Vedi anche

glBegin

glBitmap

glCopyPixels

glDrawPixels

Remo

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex