glColorPointer 함수

아티클
06/12/2023

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	의미
GL_INVALID_VALUE	크기 가 3 또는 4가 아닙니다.
GL_INVALID_ENUM	형식 이 허용되는 값이 아닙니다.
GL_INVALID_VALUE	stride 또는 count 가 음수였습니다.

설명

glColorPointer 함수는 렌더링할 때 사용할 색 구성 요소 배열의 위치 및 데이터 형식을 지정합니다. stride 매개 변수는 바이트 오프셋을 한 색에서 다음 색으로 결정하여 단일 배열 또는 스토리지의 꼭짓점 특성을 별도의 배열로 압축할 수 있도록 합니다. 일부 구현에서는 단일 배열에 꼭짓점 특성을 저장하는 것이 별도의 배열을 사용하는 것보다 더 효율적일 수 있습니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Gl.h
라이브러리	Opengl32.lib
DLL	Opengl32.dll

추가 정보

glArrayElement
glBegin
glDrawArrays
glEdgeFlagPointer
glEnableClientState
glEnd
glGet
glGetString
glGetPointerv
glIndexPointer
glIsEnabled
glNormalPointer
glPopAttrib
glPushAttrib
glTexCoordPointer
glVertexPointer

Share via