glDrawElements 函式

GlDrawElements 函式會從陣列資料呈現基本專案。

語法

void WINAPI glDrawElements(
         GLenum  mode,
         GLsizei count,
         GLenum  type,
   const GLvoid  *indices
);

參數

mode

要轉譯的基本類型。 它可以採用下列其中一個符號值: GL _ 點、gl _ 線區域 _ 、gl _ 線 _ 迴圈、gl _ 線、gl 三角形區域 _ _ 、gl _ 三角形 _ 風扇、gl _ 三角形、gl _ QUAD _ 、gl _ 四邊形和 gl _ 多邊形。

計數

要呈現的元素數目。

type

索引中值的型別。 必須是 GL 不 _ 帶正負號的 _ 位元組、gl 不 _ 帶正負號的 _ 整數或 gl 不 _ 帶正負號整數之一 _ 。

指標

儲存索引之位置的指標。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

GlDrawElements 函式可讓您使用極少數的函式呼叫來指定多個幾何基本類型。 您可以事先指定個別的頂點、法線和色彩陣列,並使用它們來定義一系列的基本類型 (所有相同類型) 與 glDrawElements 的單一呼叫,而不是呼叫 OpenGL 函式來傳遞每個頂點、法線或色彩。

當您呼叫 glDrawElements 函式時,它會使用來自 索引計數 順序元素,來建立一系列幾何基本專案。 Mode 參數指定要建立的基本類型,以及陣列元素如何用來建立這些基本專案。 如果 _ _ 未啟用 GL 頂點陣列,則不會產生任何幾何基本專案。

GlDrawElements 修改的頂點屬性在 glDrawElements 傳回之後具有未指定的值。 例如,如果 _ _ 已啟用 GL 色彩陣列,則在 glDrawElements 執行之後,目前色彩的值會是未定義的。 未修改的屬性會維持不變。

您可以在顯示清單中包含 glDrawElements 函數。 當 glDrawElements 包含在顯示清單中時,必要的陣列資料 (由陣列指標決定,而且也可以在顯示清單中輸入) 。 因為陣列指標和可啟用的是用戶端狀態變數,所以它們的值會在建立清單時影響顯示清單,而不是在執行清單時影響。

注意

GlDrawElements 函數僅適用于 OpenGL 1.1 版或更新版本。

規格需求

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

另請參閱

glArrayElement

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnd

glGetPointerv

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer