Функция glRasterPos2iv

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

Синтаксис

void WINAPI glRasterPos2dv(
   const GLint *v
);

Параметры

V

Указатель на массив из двух элементов, указывающий координаты x и y для текущей позиции растра.

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

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

Комментарии

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

Текущее положение растра состоит из трех координат окна (x, y, z), значения w координаты клипа, расстояния координат глаз, допустимого бита и связанных данных цвета и координат текстуры. Координата w является координатой клипа, так как w не проецируется на координаты окна. Функция glRasterPos4 явно задает координаты объекта x, y, z и w . Функция glRasterPos3 явно задает координаты объекта x, y и z , тогда как w неявно имеет значение 1. Функция 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). Наконец, расстояние от источника системы координат глаза до вершины, преобразованное только матрицей modelview, заменяет GL_CURRENT_RASTER_DISTANCE.

Изначально текущая позиция растра — (0,0,0,1), текущее расстояние растра — 0, задан допустимый бит, связанный цвет RGBA — (1,1,1;1), связанный индекс цвета — 1, а координаты текстуры — (0, 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