glRasterPos4iv 函数

指定像素操作的光栅位置。

语法

void WINAPI glRasterPos4iv(
   const GLint *v
);

参数

向量

指向由四个元素组成的数组的指针,指定当前光栅位置的 x、y、z 和 w 坐标。

返回值

此函数不返回值。

备注

OpenGL 维护窗口坐标中的三维位置。 此位置称为 "光栅位置",以子像素准确度进行维护。 它用于定位像素和位图写入操作。 请参阅 glBitmapglDrawPixelsglCopyPixels

当前光栅位置包括三个窗口坐标 (x、y、z) 、剪辑坐标 w 值、眼睛坐标距离、有效位以及关联的颜色数据和纹理坐标。 W 坐标是剪辑坐标,因为 w 并未投影到窗口坐标。 GlRasterPos4函数显式指定对象坐标 x、y、zw 。 GlRasterPos3 函数将显式指定对象坐标 x、yz ,而将 w 隐式设置为1。 GlRasterPos2 函数使用 xy 的参数值,同时将 zw 隐式设置为零和一个。

GlRasterPos提供的对象坐标与glVertex命令的坐标一样处理。 它们由当前 modelview 和投影矩阵转换并传递到剪辑阶段。 如果顶点不是剔除,则会将其投影并缩放为窗口坐标,这将成为新的当前栅格位置,并设置了 "总帐 _ 当前" _ 光栅 _ 位置 _ 有效标志。 如果顶点为剔除,则会清除有效位,并且不定义当前的光栅位置和关联的颜色和纹理坐标。

当前光栅位置还包括一些关联的颜色数据和纹理坐标。 如果已启用照明,则 _ _ 在 RGBA 模式下总帐当前光栅颜色, _ 或 _ _ _ 在颜色索引模式下将总帐当前光栅索引设置为照明计算生成的颜色 (参阅 glLightglLightModelglShadeModel) 。 如果禁用了光照,则当前颜色 (RGBA 模式,状态变量 GL _ 当前 _ 颜色) 或颜色索引在颜色索引模式下 (,状态变量 gl _ 当前 _ 索引) 用于更新当前的光栅颜色。

同样, _ _ _ _ _ _ _ 根据纹理矩阵和纹理生成函数将总帐当前光栅纹理 coords 作为 GL 当前纹理 coords 的函数进行更新 (参阅 glTexGen) 。 最后,将眼睛坐标系统的原点与顶点之间的距离(仅由 modelview 矩阵转换)替换为 _ 当前的当前 _ 等距 _ 距离。

当前,当前的光栅位置 (0,0,0,1) ,当前等距距离为0,设置有效位,关联的 RGBA 颜色为 (1,1,1,1) ,关联的颜色索引为1,关联的纹理坐标为 (0,0,0,1) 。 在 RGBA 模式下, _ GL _ 当前 _ 的光栅索引始终为 1; 在颜色索引模式下,当前光栅 RGBA 颜色始终保持其初始值。

备注

光栅位置由 glRasterPosglBitmap修改。

备注

当光栅位置坐标无效时,将忽略基于光栅位置的绘图命令 (即,它们不会导致 OpenGL 状态) 更改。

以下函数检索与 glRasterPos相关的信息:

具有参数 GL _ 当前 _ 光栅 _ 位置的 glGet
具有参数 GL _ 当前光栅位置的 glGet _ _ _ 有效
具有参数 GL _ 当前 _ 等距 _ 距离的 glGet
具有参数 GL _ 当前 _ 光栅 _ 颜色的 glGet
具有参数 GL _ 当前 _ 光栅 _ 索引的 glGet
具有参数 GL _ 当前 _ 光栅 _ 纹理 _ COORDS 的 glGet

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Gl。h

Opengl32
DLL
Opengl32.dll

请参阅

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex