glDrawArrays 함수

아티클
06/13/2023

glDrawArrays 함수는 렌더링할 여러 기본 형식을 지정합니다.

구문

void WINAPI glDrawArrays(
   GLenum  mode,
   GLint   first,
   GLsizei count
);

매개 변수

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.
first: 활성화된 배열의 시작 인덱스입니다.
count: 렌더링할 인덱스 수입니다.

반환 값

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

오류 코드

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

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

설명

glDrawArrays를 사용하면 렌더링할 여러 기하학적 기본 형식을 지정할 수 있습니다. 개별 꼭짓점, 법선 또는 색을 전달하기 위해 별도의 OpenGL 함수를 호출하는 대신 꼭짓점, 법선 및 색의 별도 배열을 지정하여 glDrawArrays에 대한 단일 호출을 사용하여 기본 형식 시퀀스(모두 동일한 종류)를 정의할 수 있습니다.

glDrawArrays를 호출할 때 활성화된 각 배열의 순차 요소 개수를 사용하여 첫 번째 요소부터 기하학적 기본 형식의 시퀀스를 생성합니다. mode 매개 변수는 생성할 기본 형식의 종류와 배열 요소를 사용하여 기본 형식을 생성하는 방법을 지정합니다.

glDrawArrays가 반환되면 glDrawArrays에서 수정한 꼭짓점 특성의 값이 정의되지 않습니다. 예를 들어 GL_COLOR_ARRAY 사용하도록 설정된 경우 glDrawArrays 가 반환된 후 현재 색의 값이 정의되지 않습니다. glDrawArrays에서 수정하지 않은 특성은 정의된 상태로 유지됩니다. GL_VERTEX_ARRAY 사용하도록 설정되지 않으면 기하학적 기본 형식이 생성되지 않지만 활성화된 배열에 해당하는 특성이 수정됩니다.

표시 목록에 glDrawArrays를 포함할 수 있습니다. 표시 목록에 glDrawArrays 를 포함하면 배열 포인터 및 사용으로 결정되는 필요한 배열 데이터가 생성되어 표시 목록에 입력됩니다. 배열 포인터 및 사용의 값은 표시 목록을 만드는 동안 결정됩니다.

언제든지 정적 배열 데이터를 읽을 수 있습니다. 정적 배열 요소가 수정되고 배열이 다시 지정되지 않은 경우 glDrawArrays 에 대한 후속 호출 결과가 정의되지 않습니다.

glBegin 및 glend 쌍 내에서 배열을 두 번 이상 지정하면 오류가 생성되지 않지만 결과는 정의되지 않습니다.

요구 사항

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

추가 정보

glArrayElement
glBegin
glColorPointer
glEdgeFlagPointer
glEnd
glGetPointerv
glGetString
glIndexPointer
glNormalPointer
glTexCoordPointer
glVertexPointer

다음을 통해 공유