glDrawElements 함수

아티클
06/13/2023

glDrawElements 함수는 배열 데이터의 기본 형식을 렌더링합니다.

구문

void WINAPI glDrawElements(
         GLenum  mode,
         GLsizei count,
         GLenum  type,
   const GLvoid  *indices
);

매개 변수

mode: 렌더링할 기본 형식의 종류입니다. GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS 및 GL_POLYGON 기호 값 중 하나를 가정할 수 있습니다.
count: 렌더링할 요소의 수입니다.
type: 인덱스의 값 형식입니다. GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT 또는 GL_UNSIGNED_INT 중 하나여야 합니다.
인덱스: 인덱스가 저장되는 위치에 대한 포인터입니다.

반환 값

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

오류 코드

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

Name	의미
GL_INVALID_ENUM	mode 가 허용되는 값이 아니었습니다.
GL_INVALID_VALUE	count 는 음수 값이었습니다.
GL_INVALID_OPERATION	함수는 glBegin 호출과 glEnd에 대한 해당 호출 사이에 호출되었습니다.

설명

glDrawElements 함수를 사용하면 함수 호출이 거의 없는 여러 기하학적 기본 형식을 지정할 수 있습니다. OpenGL 함수를 호출하여 각 개별 꼭짓점, 법선 또는 색을 전달하는 대신 꼭짓점, 법선 및 색의 별도 배열을 미리 지정하고 이를 사용하여 glDrawElements에 대한 단일 호출을 사용하여 기본 형식 시퀀스(모두 동일한 형식)를 정의할 수 있습니다.

glDrawElements 함수를 호출할 때 인덱스의순차 요소 개수를 사용하여 기하학적 기본 형식의 시퀀스를 생성합니다. mode 매개 변수는 생성되는 기본 형식의 종류와 배열 요소를 사용하여 이러한 기본 형식을 구성하는 방법을 지정합니다. GL_VERTEX_ARRAY 사용하도록 설정되지 않으면 기하학적 기본 형식이 생성되지 않습니다.

glDrawElements에서 수정한 꼭짓점 특성은 glDrawElements가 반환된 후 지정되지 않은 값을 갖습니다. 예를 들어 GL_COLOR_ARRAY 사용하도록 설정된 경우 glDrawElements 가 실행된 후 현재 색의 값이 정의되지 않습니다. 수정되지 않은 특성은 변경되지 않은 상태로 유지됩니다.

표시 목록에 glDrawElements 함수를 포함할 수 있습니다. glDrawElements가 표시 목록에 포함되면 필요한 배열 데이터(배열 포인터 및 사용 설정에 따라 결정됨)도 표시 목록에 입력됩니다. 배열 포인터와 사용은 클라이언트 쪽 상태 변수이므로 목록이 실행될 때가 아니라 목록을 만들 때 해당 값이 표시 목록에 영향을 줍니다.

참고

glDrawElements 함수는 OpenGL 버전 1.1 이상에서만 사용할 수 있습니다.

요구 사항

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

추가 정보

glArrayElement
glBegin
glColorPointer
glDrawArrays
glEdgeFlagPointer
glEnd
glGetPointerv
glIndexPointer
glNormalPointer
glTexCoordPointer
glVertexPointer

다음을 통해 공유