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 零個。
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