glColorPointer

glColorPointer圖形編程（OpenGL GLSL）函式，shader（著色器）中會用到，作用是：指定含有頂點顏色數據的數組。

簡介

glColorPointer 圖形編程（OpenGL OLSL）函式，shader（著色器）中會用到，作用是：指定含有頂點顏色數據的數組。

語法

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。

跨越

連續顏色之間的位元組偏移量。 當偏移量為0時，表示數據是連續的。

指針

顏色顏色數組中的第一個元素的第一個組件的指針。

返回值

返回以下錯誤代碼和他們的條件。

返回代碼

說明

GL_INVALID_VALUE

大小 不是 3 或 4。

GL_INVALID_ENUM

類型 不是接受的值。

GL_INVALID_VALUE

邁進 或 計數 是負面的。

備註

glColorPointer 函式指定頂點數組呈現時要使用的顏色分量的位置和數據格式。

通過調用函式glEnableClientState，並傳入參數GL_COLOR_ARRAY，來啟用顏色數組。默認情況下，顏色數組被禁用；向Shader中傳入顏色時必須先啟用顏色數組，否則無法傳入顏色。 調用 glArrayElement、 glDrawElements 或 glDrawArrays時，會用到顏色數組。

詳細內容請參考OpenGL OLSL API。