簡介
glColorPointer 函式定義顏色的數組。
語法
void WINAPI glColorPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
參數
大小
每種顏色組件的數量。 值必須為 3 或 4。
類型
顏色數組中的每個顏色分量的數據類型。 使用下列常量指定可接受的數據類型： GL_BYTE GL_UNSIGNED_BYTE，GL_SHORT GL_UNSIGNED_SHORT，GL_INT GL_UNSIGNED_INT，GL_FLOAT，或 GL_DOUBLE。
跨越
連續顏色之間的位元組偏移量。 當 邁進 為零時，緊緊地包裝顏色的數組中。
指針
顏色顏色數組中的第一個元素的第一個組件的指針。
返回值
返回以下錯誤代碼和他們的條件。
返回代碼
說明
GL_INVALID_VALUE
大小 不是 3 或 4。
GL_INVALID_ENUM
類型 不是接受的值。
GL_INVALID_VALUE
邁進 或 計數 是負面的。
備註
glColorPointer 函式指定數組呈現時要使用的顏色分量的位置和數據格式。 邁進 參數確定該位元組偏移量從一種顏色下, 一次啟用頂點屬性的單一陣列或存儲在單獨的數組中的包裝。 在某些的實現將頂點屬性存儲在單個陣列可以比單獨陣列的使用效率更高。
通過指定 glEnableClientState GL_COLOR_ARRAY 常數啟用顏色數組。 調用 glArrayElement、 glDrawElements 或 glDrawArrays 使用，因此啟用的顏色數組。 默認情況下，顏色數組被禁用。 glColorPointer 調用不能通過在顯示列表中輸入。
當您指定顏色數組時使用 glColorPointer，值函式的顏色數組參數保存在客戶端的狀態，可以快取靜態數組元素。 在客戶端的狀態顏色數組參數是 glPushAttrib 和 glPopAttrib 不要保存或還原參數的值。
雖然指定顏色數組，glBegin 和 glend 對內的不會生成一個錯誤，結果是未定義的。
以下函式檢索與相關 glColorPointer 函式的信息：
用參數 GL_COLOR_ARRAY glIsEnabled
用參數 GL_COLOR_ARRAY_SIZE glGet
用參數 GL_COLOR_ARRAY_TYPE glGet
用參數 GL_COLOR_ARRAY_STRIDE glGet
用參數 GL_COLOR_ARRAY_COUNT glGet
用參數 GL_COLOR_ARRAY_POINTER glGetPointerv
