Поделиться через


Функция glScissor

Функция 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