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
GL_INVALID_VALUE	El ancho o el alto eran negativos.
GL_INVALID_OPERATION	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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnable

glEnd

glIsEnabled

glViewport