glNewList 函式

GlNewListglEndList函數會建立或取代顯示清單。

語法

void WINAPI glNewList(
   GLuint list,
   GLenum mode
);

參數

list

顯示清單名稱。

mode

編譯模式。 接受下列值。

意義
GL _ 編譯
命令只會進行編譯。
GL _ 編譯 _ 和 _ 執行
命令會在編譯到顯示清單中時執行。

傳回值

此函式不會傳回值。

錯誤碼

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

Name 意義
GL _ 無效 _ 值
清單 為零。
GL _ 無效 _ 列舉
模式 不是可接受的值。
GL _ 不正確 _ 操作
呼叫 glBegin 和對應的 glEnd呼叫之間呼叫了函數。

備註

顯示清單是已儲存以供後續執行的 OpenGL 命令群組。 顯示清單會以 glNewList 來建立。 所有後續的命令都會依發出的順序,放在顯示清單中,直到呼叫 glEndList 為止。

GlNewList 函式有兩個參數。 第一個參數 list 是一個正整數,會成為顯示清單的唯一名稱。 您可以使用 glGenLists 來建立和保留名稱,並測試 glIsList的唯一性。 第二個參數( 模式)是可採用上述兩個值之一的符號常數。

某些命令不會編譯到顯示清單中,但是會立即執行,而不論顯示清單模式為何。 這些命令有 glColorPointerglDeleteListsglDisableClientStateglEdgeFlagPointerglEnableClientStateglFeedbackBufferglFinishglFlushglGenListsglIndexPointerglInterleavedArraysglIsEnabled、glIsList 、glNormalPointer 、glPopClientAttrib 、glPixelStore 、glPushClientAttrib 、glReadPixels 、glRenderModeglSelectBuffer、glTexCoordPointer、glVertexPointer 、glGet、 、、 ,以及所有 常式。

同樣地,當第一個引數是 GL _ proxy _ 材質 _ 2d 或 gl _ proxy _ 材質 _ 1d 時,glTexImage2D 和 glTexImage1D 會立即執行,而不會編譯成顯示清單。

當遇到 glEndList 函式時,會藉由將清單與 [ glNewList ] 命令) 中指定的 [唯一名稱] (清單 產生關聯,來完成顯示清單定義。 如果已有名稱 清單 的顯示清單,則只會在呼叫 glEndList 時加以取代。

GlCallListglCallLists函數可以輸入到顯示清單中。 GlCallListglCallLists 所執行的顯示清單或清單中的命令不會包含在所建立的顯示清單中,即使清單建立模式是 GL _ 編譯 _ 和執行 _ 也一樣。

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

具有引數 GL _ 矩陣 _ 模式的 glGet

規格需求

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

另請參閱

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glEndList

glGenLists

glIsList