Compartilhar via


Função glScissor

A função glScissor define a caixa de tesoura.

Sintaxe

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

Parâmetros

x

A coordenada x (eixo vertical) para o canto inferior esquerdo da caixa de tesoura.

y

A coordenada y (eixo horizontal) para o canto inferior esquerdo da caixa de tesoura. Juntos, x e y especificam o canto inferior esquerdo da caixa de tesoura. Inicialmente (0,0).

width

A largura da caixa de tesoura.

altura

A altura da caixa da tesoura. Quando um contexto OpenGL é anexado pela primeira vez a uma janela, largura e altura são definidas para as dimensões dessa janela.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Nome Significado
GL_INVALID_VALUE
A largura ou a altura foram negativas.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glScissor define um retângulo, chamado de caixa de tesoura, nas coordenadas da janela. Os dois primeiros parâmetros, x e y, especificam o canto inferior esquerdo da caixa. Os parâmetros de largura e altura especificam a largura e a altura da caixa.

O teste de tesoura é habilitado e desabilitado usando glEnable e glDisable com GL_SCISSOR_TEST de argumento. Enquanto o teste de tesoura está habilitado, somente pixels que estão dentro da caixa de tesoura podem ser modificados por comandos de desenho. As coordenadas da janela têm valores inteiros nos cantos compartilhados dos pixels do quadro, portanto, glScissor(0,0,1,1) permite que apenas o pixel inferior esquerdo na janela seja modificado e o glScissor(0,0,0,0) não permite a modificação em todos os pixels na janela.

Quando o teste de tesoura é desabilitado, é como se a caixa de tesoura inclua toda a janela.

As seguintes funções recuperam informações relacionadas ao glScissor:

glGet com GL_SCISSOR_BOX de argumento

glIsEnabled com GL_SCISSOR_TEST de argumento

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnable

glEnd

glIsEnabled

glViewport