glIndexPointer 함수

아티클
06/13/2023

glIndexPointer 함수는 색 인덱스 배열을 정의합니다.

구문

void WINAPI glIndexPointer(
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

매개 변수

type: GL_SHORT, GL_INT, GL_FLOAT, GL_DOUBLE 기호 상수를 사용하여 배열에 있는 각 색 인덱스의 데이터 형식입니다.
Stride: 연속된 색 인덱스 간의 바이트 오프셋입니다. stride가 0이면 색 인덱스가 배열에 단단히 압축됩니다.
포인터: 배열의 첫 번째 색 인덱스 포인터입니다.

반환 값

이 함수는 값을 반환하지 않습니다.

오류 코드

glGetError 함수에서 다음 오류 코드를 검색할 수 있습니다.

Name	의미
GL_INVALID_ENUM	형식 이 허용되는 값이 아닙니다.
GL_INVALID_VALUE	stride 또는 count 가 음수였습니다.

설명

glIndexPointer 함수는 렌더링할 때 사용할 색 인덱스 배열의 위치와 데이터를 지정합니다. type 매개 변수는 각 색 인덱스의 데이터 형식을 지정하고 stride는 한 색 인덱스에서 다음 색 인덱스로 바이트 오프셋을 결정하여 단일 배열 또는 스토리지의 꼭짓점 및 특성을 별도의 배열로 압축할 수 있도록 합니다. 일부 구현에서는 꼭짓점과 특성을 단일 배열에 저장하는 것이 별도의 배열을 사용하는 것보다 더 효율적일 수 있습니다. 자세한 내용은 glInterleavedArrays를 참조하세요.

색 인덱스 배열은 glEnableClientState를 사용하여 GL_INDEX_ARRAY 상수를 지정할 때 사용하도록 설정됩니다. 사용하도록 설정하면 glDrawArrays 및 glArrayElement 는 색 인덱스 배열을 사용합니다. 기본적으로 색 인덱스 배열은 사용하지 않도록 설정됩니다.

표시 목록에 는 glIndexPointer를 포함할 수 없습니다.

glIndexPointer를 사용하여 색 인덱스 배열을 지정하면 모든 함수의 색 인덱스 배열 매개 변수 값이 클라이언트 쪽 상태로 저장되고 정적 배열 요소가 캐시될 수 있습니다. 색 인덱스 배열 매개 변수는 클라이언트 쪽 상태이므로 해당 값은 glPushAttrib 및 glPopAttrib에 의해 저장되거나 복원되지 않습니다.

glBegin 및 glEnd 쌍 내에서 glIndexPointer를 호출할 때 오류가 생성되지 않지만 결과는 정의되지 않습니다.

다음 함수는 glIndexPointer와 관련된 정보를 검색합니다.

인수 GL_INDEX_ARRAY glIsEnabled

인수가 GL_INDEX_ARRAY_STRIDE glGet

인수가 GL_INDEX_ARRAY_COUNT glGet

인수가 GL_INDEX_ARRAY_TYPE glGet

인수가 GL_INDEX_ARRAY_SIZE glGet

인수가 GL_INDEX_ARRAY_POINTER glGetPointerv

요구 사항

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

추가 정보

glArrayElement
glColorPointer
glDrawArrays
glEdgeFlagPointer
glGetPointerv
glGetString
glNormalPointer
glPushAttrib
glTexCoordPointer
glVertexPointer

다음을 통해 공유