glRenderMode 函式

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

語法

GLint WINAPI glRenderMode(
   GLenum mode
);

參數

mode

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

意義
GL _ 轉譯
轉譯模式。 基本專案會進行柵格化,並產生會寫入畫面格緩衝區中的圖元片段。 這是一般模式,也是預設模式。
GL _ 選取
選取模式。 不會產生任何圖元片段,也不會對畫面格緩衝區內容進行任何變更。 相反地,當轉譯模式為 GL 轉譯時,所要繪製的基本名稱記錄 _ ,會在選取的緩衝區中傳回, (在輸入選取模式之前,請參閱 glSelectBuffer) 。
GL _ 意見反應
意見反應模式。 不會產生任何圖元片段,也不會對畫面格緩衝區內容進行任何變更。 相反地,已繪製之頂點的座標和屬性 _ 會在意見反應緩衝區中傳回,該緩衝區必須建立, (在輸入意見反應模式之前,請參閱 glFeedbackBuffer) 。

錯誤碼

GlGetError函式可以取出下列錯誤碼。

Name 意義
GL _ 無效 _ 列舉
模式 不是三個接受的值之一。
GL _ 不正確 _ 操作
呼叫函式時,會使用引數 GL SELECT 來呼叫該函式, _ 然後至少呼叫 glSelectBuffer 一次。
GL _ 不正確 _ 操作
在 _ 呼叫至少一次 glBeedbackBuffer 之前,會使用引數 GL 回饋來呼叫函數。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

GlRenderMode 函式會採用一個引數,也就是可採用上述三個預先定義值之一的 模式

GlRenderMode 函式的傳回值是由在呼叫 glRenderMode 時的轉譯模式來決定,而不是透過 模式 來決定。 針對三種轉譯模式傳回的值如下所示。

意義
GL _ 轉譯 零個。
GL _ 選取 傳送至選取緩衝區的點擊記錄數。
GL _ 意見反應 (不是頂點的值數目) 傳送至意見緩衝區。

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

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

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

具有引數 GL _ 轉譯 _ 模式的 glGet

規格需求

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

另請參閱

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer