glGetMaterialfv 함수

아티클
06/13/2023

glGetMaterialfv 및 glGetMaterialiv 함수는 재질 매개 변수를 반환합니다.

구문

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

매개 변수

얼굴

쿼리할 두 재질 중 어느 것을 지정합니다. GL_FRONT 또는 GL_BACK 각각 앞면 및 후면 재질을 나타내며 허용됩니다.

pname

반환할 재질 매개 변수입니다. 다음 값이 허용됩니다.

값	의미
GL_AMBIENT	params 매개 변수는 재질의 주변 반사를 나타내는 4개의 정수 또는 부동 소수점 값을 반환합니다. 요청된 경우 정수 값은 내부 부동 소수점 표현에서 선형으로 매핑됩니다. 따라서 1.0은 가장 양수 표현 가능한 정수 값에 매핑되고 -1.0은 가장 음의 표현 가능한 정수 값에 매핑됩니다. 내부 값이 [-1,1] 범위를 벗어나면 해당 정수 반환 값이 정의되지 않습니다.
GL_DIFFUSE	params 매개 변수는 재질의 확산 반사를 나타내는 4개의 정수 또는 부동 소수점 값을 반환합니다. 요청된 경우 정수 값은 내부 부동 소수점 표현에서 선형으로 매핑됩니다. 따라서 1.0은 가장 양수 표현 가능한 정수 값에 매핑되고 -1.0은 가장 음의 표현 가능한 정수 값에 매핑됩니다. 내부 값이 [-1,1] 범위를 벗어나면 해당 정수 반환 값이 정의되지 않습니다.
GL_SPECULAR	params 매개 변수는 재질의 반사 반사를 나타내는 4개의 정수 또는 부동 소수점 값을 반환합니다. 요청된 경우 정수 값은 내부 부동 소수점 표현에서 선형으로 매핑됩니다. 따라서 1.0은 가장 양수 표현 가능한 정수 값에 매핑되고 -1.0은 가장 음의 표현 가능한 정수 값에 매핑됩니다. 내부 값이 [-1,1] 범위를 벗어나면 해당 정수 반환 값이 정의되지 않습니다.
GL_EMISSION	params 매개 변수는 재질의 내보낸 광도를 나타내는 4개의 정수 또는 부동 소수점 값을 반환합니다. 요청된 경우 정수 값은 내부 부동 소수점 표현에서 선형으로 매핑됩니다. 따라서 1.0은 가장 양수 표현 가능한 정수 값에 매핑되고 -1.0은 가장 음의 표현 가능한 정수 값에 매핑됩니다. 내부 값이 [-1,1] 범위를 벗어나면 해당 정수 반환 값이 정의되지 않습니다.
GL_SHININESS	params 매개 변수는 재질의 반사 지수를 나타내는 하나의 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 값을 가장 가까운 정수 값으로 반올림하여 계산됩니다.
GL_COLOR_INDEXES	params 매개 변수는 재질의 앰비언트, 확산 및 반사 인덱스를 나타내는 세 개의 정수 또는 부동 소수점 값을 반환합니다. 색 인덱스 조명에만 이러한 인덱스를 사용합니다. (다른 매개 변수는 모두 RGBA 조명에만 사용됩니다.) 요청 시 정수 값은 내부 부동 소수점 값을 가장 가까운 정수 값으로 반올림하여 계산됩니다.

params

요청된 데이터를 반환합니다.

반환 값

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

오류 코드

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

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

설명

glGetMaterial 함수는 매개 변수 pname의 값 또는 값을 매개 변수면에 매개 변수로 반환합니다.

오류가 생성되면 매개 변수의 내용이 변경되지 않습니다.

요구 사항

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

추가 정보

glBegin
glEnd
glMaterial

다음을 통해 공유