glRenderMode 函数

glRenderMode 函数设置光栅化模式。

语法

GLint WINAPI glRenderMode(
   GLenum mode
);

参数

mode

光栅化模式。 接受以下三个值。 默认值为GL_RENDER。

含义
GL_RENDER
呈现模式。 基元进行光栅化,生成写入帧缓冲区的像素片段。 这是正常模式,也是默认模式。
GL_SELECT
选择模式。 不会生成像素片段,并且不会更改帧缓冲区内容。 相反,如果在选择缓冲区中返回呈现模式GL_RENDER,则必须在选择缓冲区中返回基元的名称记录, (在输入选择模式之前查看 glSelectBuffer) 。
GL_FEEDBACK
反馈模式。 不会生成像素片段,并且不会更改帧缓冲区内容。 相反,在反馈缓冲区中返回呈现模式时,绘制的顶点的坐标和属性GL_RENDER,必须在输入反馈模式之前看到 glFeedbackBuffer) ,必须 (创建该缓冲区。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_ENUM
模式 不是三个接受的值之一。
GL_INVALID_OPERATION
至少调用一次 glSelectBuffer 之前,该函数使用参数GL_SELECT调用。
GL_INVALID_OPERATION
glBeedbackBuffer 至少调用一次之前,该函数使用参数GL_FEEDBACK调用。
GL_INVALID_OPERATION
函数在 对 glBegin 的调用和 glEnd 的相应调用之间调用。

备注

glRenderMode 函数采用一个参数、模式,该模式假定上述三个预定义值之一。

glRenderMode 函数的返回值由调用 glRenderMode 时呈现模式确定,而不是按模式确定。 为三种呈现模式返回的值如下所示。

含义
GL_RENDER Zero。
GL_SELECT 传输到选择缓冲区的命中记录数。
GL_FEEDBACK (未传输到反馈缓冲区的顶点的值数) 。

有关选择和反馈操作的更多详细信息,请参阅 glSelectBufferglFeedbackBuffer

如果生成错误, glRenderMode 将返回零,而不考虑当前呈现模式。

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

带参数GL_RENDER_MODE的 glGet

要求

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

Opengl32.lib
DLL
Opengl32.dll

另请参阅

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer