funzione glViewport

La funzione glViewport imposta il viewport .

Sintassi

void WINAPI glViewport(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

Parametri

x

Angolo inferiore sinistro del rettangolo del riquadro di visualizzazione, in pixel. Il valore predefinito è (0,0).

y

Angolo inferiore sinistro del rettangolo del riquadro di visualizzazione, in pixel. Il valore predefinito è (0,0).

width

Larghezza del riquadro di visualizzazione. Quando un contesto OpenGL viene prima collegato a una finestra, la larghezza e l'altezza vengono impostate sulle dimensioni di tale finestra.

height

Altezza del riquadro di visualizzazione. Quando un contesto OpenGL viene prima collegato a una finestra, la larghezza e l'altezza vengono impostate sulle dimensioni di tale finestra.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome Significato
GL_INVALID_VALUE
La larghezza o l'altezza erano negative.
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glViewport specifica la trasformazione affine di x e y dalle coordinate del dispositivo normalizzate alle coordinate della finestra. Let (xnd , ynd ) essere normalizzato coordinate del dispositivo. Le coordinate della finestra (xw , yw ) vengono quindi calcolate come segue:

Equazione che mostra il calcolo delle coordinate della finestra.

La larghezza e l'altezza del viewport vengono bloccate in modo silenzioso a un intervallo che dipende dall'implementazione. Questo intervallo viene sottoposto a query chiamando glGet con argomento GL_MAX_VIEWPORT_DIMS.

Le funzioni seguenti recuperano informazioni correlate a glViewport:

glGet con argomento GL_VIEWPORT

glGet con argomento GL_MAX_VIEWPORT_DIMS

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

glDepthRange