glMaterialfv 함수

아티클
06/13/2023

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

구문

void WINAPI glMaterialfv(
         GLenum  face,
         GLenum  pname,
   const GLfloat *params
);

매개 변수

얼굴

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

pname

업데이트되는 얼굴 또는 얼굴의 재질 매개 변수입니다. glMaterialfv를 사용하여 지정할 수 있는 매개 변수와 조명 수식에 의한 해석은 다음과 같습니다.

값	의미
GL_AMBIENT	params 매개 변수에는 재질의 앰비언트 RGBA 반사를 지정하는 4개의 부동 소수점 값이 포함됩니다. 가장 양수 표시 가능한 값이 1.0에 매핑되고 가장 음의 표현 가능한 값이 -1.0에 매핑되도록 정수 값이 선형으로 매핑됩니다. 부동 소수점 값은 직접 매핑됩니다. 정수나 부동 소수점 값은 모두 고정되지 않습니다. 전면 및 후면 재질 모두에 대한 기본 주변 반사는 (0.2, 0.2, 0.2, 1.0)입니다.
GL_DIFFUSE	params 매개 변수에는 재질의 확산 RGBA 반사를 지정하는 4개의 부동 소수점 값이 포함됩니다. 가장 양수 표시 가능한 값이 1.0에 매핑되고 가장 음의 표현 가능한 값이 -1.0에 매핑되도록 정수 값이 선형으로 매핑됩니다. 부동 소수점 값은 직접 매핑됩니다. 정수나 부동 소수점 값은 모두 고정되지 않습니다. 전면 및 후면 재질 모두에 대한 기본 확산 반사는 (0.8, 0.8, 0.8, 1.0)입니다.
GL_SPECULAR	params 매개 변수에는 재질의 반사 RGBA 반사를 지정하는 4개의 부동 소수점 값이 포함됩니다. 가장 양수 표시 가능한 값이 1.0에 매핑되고 가장 음의 표현 가능한 값이 -1.0에 매핑되도록 정수 값이 선형으로 매핑됩니다. 부동 소수점 값은 직접 매핑됩니다. 정수나 부동 소수점 값은 모두 고정되지 않습니다. 전면 및 후면 재질 모두에 대한 기본 반사 반사는 (0.0, 0.0, 0.0, 1.0)입니다.
GL_EMISSION	params 매개 변수에는 재질의 RGBA 내보내기 광도를 지정하는 4개의 부동 소수점 값이 포함됩니다. 가장 양수 표시 가능한 값이 1.0에 매핑되고 가장 음의 표현 가능한 값이 -1.0에 매핑되도록 정수 값이 선형으로 매핑됩니다. 부동 소수점 값은 직접 매핑됩니다. 정수나 부동 소수점 값은 모두 고정되지 않습니다. 전면 및 후면 재료 모두에 대한 기본 방출 강도는 (0.0, 0.0, 0.0, 1.0)입니다.
GL_SHININESS	param 매개 변수는 재질의 RGBA 반사 지수를 지정하는 단일 정수 값입니다. 정수 값은 직접 매핑됩니다. [0, 128] 범위의 값만 허용됩니다. 전면 및 후면 재질 모두에 대한 기본 반사 지수는 0입니다.
GL_AMBIENT_AND_DIFFUSE	동일한 매개 변수 값을 사용하여 glMaterial 을 두 번 호출하는 것과 동일하며, 한 번은 GL_AMBIENT, 한 번은 GL_DIFFUSE.
GL_COLOR_INDEXES	params 매개 변수에는 앰비언트, 확산 및 반사 조명에 대한 색 인덱스를 지정하는 세 개의 부동 소수점 값이 포함됩니다. 이러한 세 값과 GL_SHININESS 색 인덱스 모드 조명 수식에서 사용되는 유일한 재질 값입니다. 색 인덱스 조명에 대한 자세한 내용은 glLightModel 을 참조하세요.

params

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

반환 값

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

오류 코드

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

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

설명

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

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

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

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

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

glGetMaterial

요구 사항

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

추가 정보

glColorMaterial
glLight
glLightModel