glMateriali 함수

glMateriali 함수는 조명 모델에 대한 재질 매개 변수를 지정합니다.

구문

void WINAPI glMateriali(
   GLenum face,
   GLenum pname,
   GLint  param
);

매개 변수

얼굴

업데이트되는 얼굴 또는 얼굴입니다. GL_FRONT, GL_BACK 또는 GL_FRONT 및 GL_BACK 중 하나여야 합니다.

pname

업데이트되는 얼굴 또는 얼굴의 단일 값 재질 매개 변수입니다. GL_SHININESS 합니다.

값	의미
GL_SHININESS	param 매개 변수는 재질의 RGBA 반사 지수를 지정하는 단일 정수입니다. 정수 값은 직접 매핑됩니다. [0, 128] 범위의 값만 허용됩니다. 전면 및 후면 재질 모두에 대한 기본 반사 지수는 0입니다.

param

매개 변수 GL_SHININESS 설정할 값입니다.

반환 값

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

오류 코드

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

Name	의미
GL_INVALID_ENUM	얼굴 또는 pname은 허용되는 값이 아닙니다.
GL_INVALID_VALUE	[0, 128] 범위를 벗어난 반사 지수를 지정했습니다.

설명

glMateriali 함수는 재질 매개 변수에 값을 할당합니다. 일치하는 두 개의 재질 매개 변수 집합이 있습니다. 전면 집합인 하나는 점, 선, 비트맵 및 모든 다각형(양면 조명이 비활성화된 경우) 또는 전면 다각형(양면 조명을 사용하는 경우)을 음영하는 데 사용됩니다. 다른 세트 인 후방 조명은 양면 조명을 사용하는 경우에만 후면 다각형을 음영하는 데 사용됩니다. 단면 및 양면 조명 계산에 대한 자세한 내용은 glLightModel 을 참조하세요.

glMateriali 함수는 세 개의 인수를 사용합니다. 첫 번째 얼굴은 GL_FRONT 재질, GL_BACK 재질 또는 두 GL_FRONT_AND_BACK 재질을 수정할지 여부를 지정합니다. 두 번째 pname은 하나 또는 두 집합의 여러 매개 변수 중 수정할 매개 변수를 지정합니다. 세 번째 매개 변수는 지정된 매개 변수에 할당할 값을 지정합니다.

재료 매개 변수는 각 꼭짓점에 선택적으로 적용되는 조명 수식에 사용됩니다. 수식은 glLightModel에서 설명합니다.

재질 매개 변수는 언제든지 업데이트할 수 있습니다. 특히 glBegin 호출과 glEnd에 대한 해당 호출 간에 glMateriali를 호출할 수 있습니다. 그러나 꼭짓점당 단일 재질 매개 변수만 변경하는 경우 glColorMaterial 이 glMateriali보다 선호됩니다.

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

glGetMaterial

요구 사항

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

추가 정보

glColorMaterial

glLight

glLightModel