glRenderMode 函式

glRenderMode函式會設定點陣化模式。

語法

GLint WINAPI glRenderMode(
   GLenum mode
);

參數

mode

點陣化模式。 接受下列三個值。 預設值為 GL_RENDER。

意義
GL_RENDER
轉譯模式。 基本類型會進行點陣化,產生圖元片段,這些片段會寫入框架緩衝區中。 這是一般模式,也是預設模式。
GL_SELECT
選取模式。 不會產生圖元片段,而且不會變更框架緩衝區內容。 相反地,如果在選取緩衝區中傳回轉譯模式GL_RENDER,則必須在選取緩衝區中傳回基本類型名稱的記錄, (在輸入選取模式之前,先查看 glSelectBuffer) 。
GL_FEEDBACK
意見反應模式。 不會產生圖元片段,而且不會變更框架緩衝區內容。 相反地,在意見反應緩衝區中傳回轉譯模式GL_RENDER繪製頂點的座標和屬性,必須在輸入意見反應模式之前,先 (查看 glFeedbackBuffer) 。

錯誤碼

glGetError函式可以擷取下列錯誤碼。

Name 意義
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 零個。
GL_SELECT 傳送至選取緩衝區的點擊記錄數目。
GL_FEEDBACK (不是頂點的值數目,) 傳送至意見反應緩衝區。

如需有關選取和意見反應作業的詳細資訊,請參閱 glSelectBufferglFeedbackBuffer

如果產生錯誤, glRenderMode 會傳回零,而不論目前的轉譯模式為何。

下列函式會擷取 glRenderMode的相關資訊:

glGet with argument GL_RENDER_MODE

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Gl.h
程式庫
Opengl32.lib
DLL
Opengl32.dll

另請參閱

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer