Функция glRasterPos4i

Задает растровую позицию для операций с пикселями.

Синтаксис

void WINAPI glRasterPos4i(
   GLint x,
   GLint y,
   GLint z,
   GLint w
);

Параметры

x

Задает координату x для текущей растровой позиции.

y

Задает координату Y для текущей растровой позиции.

z

Задает координату z для текущей растровой позиции.

w

Координата w для текущей растровой позиции.

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

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

Remarks

OpenGL поддерживает трехмерную позицию в координатах окна. Эта позиция, называемая растровой позицией, поддерживается с точностью подпикселя. Он используется для размещения операций записи пикселей и растровых изображений. См. glBitmap, glDrawPixels и glCopyPixels.

Текущая растровая позиция состоит из трех координат окна (x, y, z), значения координат клипа w , расстояния координат глаз, допустимого бита и связанных данных цвета и координат текстуры. Координата w — это координата клипа, так как w не проецируется в координаты окна. Функция glRasterPos4 задает координаты объектов x, y, z и w явным образом. Функция glRasterPos3 задает координаты объектов x, y и z явным образом, а w неявно присваивается одному. Функция glRasterPos2 использует значения аргументов для x и y при неявном задании z и w равным нулю и одному.

Координаты объекта, представленные glRasterPos , обрабатываются так же, как и в команде glVertex . Они преобразуются текущим представлением модели и матрицами проекции и передаются на этап вырезки. Если вершина не отбрасвана, она проецируется и масштабируется до координат окна, которые становятся новой текущей растровой позицией, и устанавливается флаг GL_CURRENT_RASTER_POSITION_VALID. Если вершина отбрасываются, допустимый бит очищается, а текущая растровая позиция и сопоставленные цвета и координаты текстуры не определены.

Текущая растровая позиция также включает некоторые связанные данные цвета и координаты текстуры. Если освещение включено, то GL_CURRENT_RASTER_COLOR в режиме RGBA или в режиме GL_CURRENT_RASTER_INDEX в режиме цветового индекса устанавливается цвет, создаваемый вычислением освещения (см. glLight, glLightModel и glShadeModel). Если освещение отключено, текущий цвет (в режиме RGBA, переменная состояния GL_CURRENT_COLOR) или цветовой индекс (в режиме цветового индекса, переменная состояния GL_CURRENT_INDEX) используется для обновления текущего растрового цвета.

Аналогичным образом GL_CURRENT_RASTER_TEXTURE_COORDS обновляется как функция GL_CURRENT_TEXTURE_COORDS на основе матрицы текстуры и функций создания текстур (см. glTexGen). Наконец, расстояние от источника системы координат глаз до вершины, преобразованное только матрицей представления модели, заменяет GL_CURRENT_RASTER_DISTANCE.

Изначально текущая растровая позиция составляет (0,0,0,1), текущее расстояние растра равно 0, допустимый бит, связанный цвет RGBA (1,1,1,1), связанный цветовой индекс равен 1, а связанные координаты текстуры — (0, 0, 0, 1). В режиме RGBA GL_CURRENT_RASTER_INDEX всегда равен 1; в режиме цветового индекса текущий растровый цвет RGBA всегда сохраняет свое начальное значение.

Примечание

Положение растра изменяется как glRasterPos , так и glBitmap.

Примечание

Если координаты растровой позиции недопустимы, команды рисования, основанные на растровой позиции, игнорируются (то есть они не приводят к изменению состояния OpenGL).

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

glGet с аргументом GL_CURRENT_RASTER_POSITION
glGet с аргументом GL_CURRENT_RASTER_POSITION_VALID
glGet с аргументом GL_CURRENT_RASTER_DISTANCE
glGet с аргументом GL_CURRENT_RASTER_COLOR
glGet с GL_CURRENT_RASTER_INDEX аргументов
glGet с аргументом GL_CURRENT_RASTER_TEXTURE_COORDS

Требования

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

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

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex