glTexCoordPointer 函式

GlTexCoordPointer 函式會定義材質座標的陣列。

語法

void WINAPI glTexCoordPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

參數

size

每個陣列元素的座標數目。 大小 的值必須是1、2、3或4。

type

陣列中每個材質座標的資料類型,使用下列符號常數: GL _ SHORTgl _ INTgl _ FLOATgl _ DOUBLE

大步

連續陣列元素之間的位元組位移。 當 stride 為零時,陣列元素會緊密地封裝在陣列中。

指標

陣列中第一個元素的第一個座標指標。

傳回值

此函式不會傳回值。

錯誤碼

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

Name 意義
GL _ 無效 _ 列舉
類型 不是可接受的值。
GL _ 無效 _ 值
大小 不是1、2、3或4。
GL _ 無效 _ 值
stride 為負數。

備註

GlTexCoordPointer 函式會指定轉譯時要使用之材質座標陣列的位置和資料。Size 參數會指定陣列中每個元素所使用的座標數目。Type 參數指定每個材質座標的資料類型。 Stride 參數會決定從某個陣列元素到下一個陣列專案的位元組位移,以便將單一陣列或儲存區中的頂點和屬性封裝成不同的陣列。 在某些情況下,將頂點和屬性儲存在單一陣列中的效率可能比使用個別陣列更有效率。 如需詳細資訊,請參閱 glInterleavedArrays。 當指定紋理座標陣列時,大小、類型、跨距和指標都會儲存用戶端狀態。

當您使用 glEnableClientState指定 GL _ 紋理 _ COORD _ 陣列 常數時,會啟用紋理座標陣列。 啟用時, glDrawArraysglDrawElementsglArrayElement 會使用材質座標陣列。 紋理座標陣列預設為停用。

您無法在顯示清單中包含 glTexCoordPointer

當您使用 glTexCoordPointer 指定紋理座標陣列時,所有函式的材質座標陣列參數值都會儲存在用戶端狀態中,而且可以快取靜態陣列元素。 因為材質座標陣列參數是用戶端狀態,所以它們的值不會由 glPushAttribglPopAttrib儲存或還原。

雖然在 glBeginglEnd配對內呼叫 glTexCoordPointer 時不會產生任何錯誤,但結果未定義。

下列函式會取出與 glTexCoordPointer 相關的資訊:

具有引數 GL _ 紋理 _ COORD _ 陣列glIsEnabled

具有引數 GL _ 紋理 _ COORD _ 陣列 _ 大小glGet

glGet 與引數 GL _ 紋理 _ COORD _ 陣列 _ STRIDE

具有引數 GL _ 紋理 _ COORD _ 陣列 _ 計數glGet

具有引數 GL _ 紋理 _ COORD _ 陣列 _ 類型glGet

具有引數 GL _ 紋理 _ COORD _ 陣列 _ 指標glGetPointerv

規格需求

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

另請參閱

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnable

glGetPointerv

glGetString

glIndexPointer

glIsEnabled

glNormalPointer

glPopClientAttrib

glPushClientAttrib

glTexCoord

glVertexPointer