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
mode 不是三个接受值之一。
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