glColorMaterial 함수

glColorMaterial 함수는 재질 색이 현재 색을 추적하도록 합니다.

구문

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

매개 변수

얼굴

앞면, 후면 또는 앞면 및 후면 재질 매개 변수가 현재 색을 추적해야 하는지 여부를 지정합니다. 허용되는 값은 GL_FRONT, GL_BACK 및 GL_FRONT_AND_BACK. 기본값은 GL_FRONT_AND_BACK.

mode

현재 색을 추적하는 여러 재질 매개 변수를 지정합니다. 허용되는 값은 GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR 및 GL_AMBIENT_AND_DIFFUSE. 기본값은 GL_AMBIENT_AND_DIFFUSE.

반환 값

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

오류 코드

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

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

설명

glColorMaterial 함수는 현재 색을 추적하는 재질 매개 변수를 지정합니다. GL_COLOR_MATERIAL 사용하도록 설정하면 얼굴로 지정된 각 재질 또는 재질에 대해 모드 로 지정된 재질 매개 변수 또는 매개 변수가 항상 현재 색을 추적합니다. GL_COLOR_MATERIAL 인수로 호출하는 glEnable 및 glDisable 함수를 사용하여 GL_COLOR_MATERIAL 사용하거나 사용하지 않도록 설정합니다. 기본적으로 GL_COLOR_MATERIAL 사용할 수 없습니다.

glColorMaterial을 사용하면 glMaterial을 호출하지 않고 glColor 함수만 사용하여 각 꼭짓점의 재질 매개 변수 하위 집합을 변경할 수 있습니다. 각 꼭짓점마다 이러한 매개 변수 하위 집합만 지정하려는 경우 glMaterial보다 glColorMaterial로 지정하는 것이 좋습니다.

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

인수가 GL_COLOR_MATERIAL_PARAMETER glGet

인수가 GL_COLOR_MATERIAL_FACE glGet

인수 GL_COLOR_MATERIAL glIsEnabled

요구 사항

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

추가 정보

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial