glDrawElements 함수
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 | 의미 |
|---|---|
|
mode 가 허용되는 값이 아니었습니다. |
|
count 는 음수 값이었습니다. |
|
함수는 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[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|