Функция glScissor

Статья
06/13/2023

Функция glScissor определяет поле ножниц.

Синтаксис

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

Параметры

x: Координата x (вертикальная ось) для левого нижнего угла ножницы.
y: Координата Y (горизонтальная ось) для левого нижнего угла ножницы. Вместе x и y указывают левый нижний угол ножницы. Первоначально (0,0).
width: Ширина ножницы.
height: Высота ножницы. При первом присоединении контекста OpenGL к окну ширина и высота задаются для размеров этого окна.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

Следующий код ошибки может быть получен функцией glGetError .

Имя	Значение
GL_INVALID_VALUE	Ширина иливысота были отрицательными.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Функция glScissor определяет прямоугольник, называемый ножницей, в координатах окна. Первые два параметра, x и y, указывают левый нижний угол поля. Параметры ширины и высоты указывают ширину и высоту поля.

Проверка ножниц включена и отключена с помощью glEnable и glDisable с аргументом GL_SCISSOR_TEST. Хотя проверка ножниц включена, с помощью команд рисования можно изменить только пиксели, которые находятся в рамке ножниц. Координаты окна имеют целочисленные значения в общих углах пикселей framebuffer, поэтому glScissor(0,0;1;1) позволяет изменять только нижний левый пиксель в окне, а glScissor(0,0,0;0) запрещает изменение всех пикселей в окне.

Если проверка ножниц отключена, это похоже на то, что поле ножниц включает в себя все окно.

Следующие функции извлекают сведения, связанные с glScissor:

glGet с аргументом GL_SCISSOR_BOX

glIsEnabled с аргументом GL_SCISSOR_TEST

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

См. также раздел

glBegin
glEnable
glEnd
glIsEnabled
glViewport