Función glScissor
La función glScissor define el cuadro tijera.
Sintaxis
void WINAPI glScissor(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Parámetros
-
x
-
Coordenada x (eje vertical) para la esquina inferior izquierda del cuadro tijera.
-
y
-
Coordenada y (eje horizontal) para la esquina inferior izquierda del cuadro tijera. Juntos, x e y especifican la esquina inferior izquierda del cuadro tijera. Inicialmente (0,0).
-
width
-
Ancho del cuadro tijera.
-
height
-
Alto del cuadro tijera. Cuando un contexto de OpenGL se adjunta primero a una ventana, el ancho y el alto se establecen en las dimensiones de esa ventana.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar el siguiente código de error.
| Nombre | Significado |
|---|---|
|
El ancho o el alto eran negativos. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La función glScissor define un rectángulo, denominado cuadro tijera, en coordenadas de ventana. Los dos primeros parámetros, x e y, especifican la esquina inferior izquierda del cuadro. Los parámetros width y height especifican el ancho y el alto del cuadro.
La prueba de tijera está habilitada y deshabilitada mediante glEnable y glDisable con el argumento GL_SCISSOR_TEST. Aunque la prueba de tijera está habilitada, solo los píxeles que se encuentran dentro del cuadro tijera se pueden modificar mediante comandos de dibujo. Las coordenadas de ventana tienen valores enteros en las esquinas compartidas de píxeles de framebuffer, por lo que glScissor(0,0,1,1) solo permite modificar el píxel inferior izquierdo de la ventana y glScissor(0,0,0,0) no permite modificar todos los píxeles de la ventana.
Cuando la prueba de tijera está deshabilitada, es como si el cuadro tijera incluye toda la ventana.
Las siguientes funciones recuperan información relacionada con glScissor:
glGet con GL_SCISSOR_BOX de argumentos
glIsEnabled con GL_SCISSOR_TEST de argumentos
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|