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 |
|---|---|
|
A largura ou a altura foram negativas. |
|
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 |
|
| Biblioteca |
|
| DLL |
|