Funzione glScissor

La funzione glScissor definisce la casella di scissor.

Sintassi

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

Parametri

x

Coordinata x (asse verticale) per l'angolo inferiore sinistro della casella di scissor.

y

Coordinata y (asse orizzontale) per l'angolo inferiore sinistro della casella della forbice. Insieme, x e y specificano l'angolo inferiore sinistro della casella di scissor. Inizialmente (0,0).

width

Larghezza della casella della forbice.

height

Altezza della casella della forbice. 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

Il codice di errore seguente può essere recuperato dalla funzione glGetError .

Nome Significato
GL_INVALID_VALUE
Larghezza o altezza è negativa.
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glScissor definisce un rettangolo, denominato casella di scissor, nelle coordinate della finestra. I primi due parametri, x e y, specificano l'angolo inferiore sinistro della casella. I parametri larghezza e altezza specificano la larghezza e l'altezza della casella.

Il test di scissor è abilitato e disabilitato usando glEnable e glDisable con l'argomento GL_SCISSOR_TEST. Mentre il test di scissor è abilitato, solo i pixel che si trovano all'interno della casella di scissor possono essere modificati dai comandi di disegno. Le coordinate della finestra hanno valori interi negli angoli condivisi dei pixel framebuffer, quindi glScissor(0,0,1,1) consente di modificare solo il pixel inferiore sinistro nella finestra e glScissor(0,0,0,0) non consente la modifica a tutti i pixel nella finestra.

Quando il test della scissor è disabilitato, è come se la casella scissor include l'intera finestra.

Le funzioni seguenti recuperano informazioni correlate a glScissor:

glGet con argomento GL_SCISSOR_BOX

glIsEnabled con argomento GL_SCISSOR_TEST

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

glEnable

glEnd

glIsEnabled

glViewport