glColorPointer 함수
glColorPointer 함수는 색 배열을 정의합니다.
구문
void WINAPI glColorPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
매개 변수
-
size
-
색당 구성 요소 수입니다. 값은 3 또는 4여야 합니다.
-
type
-
색 배열에 있는 각 색 구성 요소의 데이터 형식입니다. 허용되는 데이터 형식은 GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT 또는 GL_DOUBLE 상수로 지정됩니다.
-
Stride
-
연속된 색 간의 바이트 오프셋입니다. stride가 0이면 색이 배열에 단단히 압축됩니다.
-
포인터
-
색 배열에서 첫 번째 색 요소의 첫 번째 구성 요소에 대한 포인터입니다.
반환 값
이 함수는 값을 반환하지 않습니다.
오류 코드
glGetError 함수에서 다음 오류 코드를 검색할 수 있습니다.
| Name | 의미 |
|---|---|
|
크기 가 3 또는 4가 아닙니다. |
|
형식 이 허용되는 값이 아닙니다. |
|
stride 또는 count 가 음수였습니다. |
설명
glColorPointer 함수는 렌더링할 때 사용할 색 구성 요소 배열의 위치 및 데이터 형식을 지정합니다. stride 매개 변수는 바이트 오프셋을 한 색에서 다음 색으로 결정하여 단일 배열 또는 스토리지의 꼭짓점 특성을 별도의 배열로 압축할 수 있도록 합니다. 일부 구현에서는 단일 배열에 꼭짓점 특성을 저장하는 것이 별도의 배열을 사용하는 것보다 더 효율적일 수 있습니다.
glEnableClientState를 사용하여 GL_COLOR_ARRAY 상수를 지정하여 색 배열을 사용하도록 설정했습니다. glArrayElement, glDrawElements 또는 glDrawArrays를 호출하면 사용하도록 설정된 색 배열이 사용됩니다. 기본적으로 색 배열은 사용하지 않도록 설정됩니다. glColorPointer 호출은 표시 목록에 입력하여 호출할 수 없습니다.
glColorPointer를 사용하여 색 배열을 지정하면 모든 함수의 색 배열 매개 변수 값이 클라이언트 쪽 상태로 저장되고 정적 배열 요소를 캐시할 수 있습니다. 색 배열 매개 변수가 클라이언트 쪽 상태이므로 glPushAttrib 및 glPopAttrib 는 매개 변수의 값을 저장하거나 복원하지 않습니다.
glBegin 및 glend 쌍 내에서 색 배열을 지정해도 오류가 발생하지는 않지만 결과는 정의되지 않습니다.
다음 함수는 glColorPointer 함수와 관련된 정보를 검색합니다.
인수가 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
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|