glGetLightiv 함수

glGetLightfv 및 glGetLightiv 함수는 광원 매개 변수 값을 반환합니다.

구문

void WINAPI glGetLightiv(
   GLenum light,
   GLenum pname,
   GLint  *params
);

매개 변수

light

광원입니다. 가능한 조명 수는 구현에 따라 달라지지만 8개 이상의 조명이 지원됩니다. 0 = i< GL_MAX_LIGHTS GL_LIGHT 양식의 기호 이름으로 식별됩니다.

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_POSITION	params 매개 변수는 광원의 위치를 나타내는 4개의 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 값을 가장 가까운 정수 값으로 반올림하여 계산됩니다. 반환된 값은 눈 좌표에서 유지 관리되는 값입니다. glLight가 호출될 때 modelview 행렬이 식별되지 않는 한 glLight를 사용하여 지정된 값과 같지 않습니다.
GL_SPOT_DIRECTION	params 매개 변수는 광원의 방향을 나타내는 세 개의 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 값을 가장 가까운 정수 값으로 반올림하여 계산됩니다. 반환된 값은 눈 좌표에서 유지 관리되는 값입니다. glLight가 호출될 때 modelview 행렬이 식별되지 않는 한 glLight를 사용하여 지정된 값과 같지 않습니다. 조명 수식에 사용되기 전에 스폿 방향이 정규화되지만 반환된 값은 정규화 전에 지정된 값의 변환된 버전입니다.
GL_SPOT_EXPONENT	params 매개 변수는 조명의 스폿 지수를 나타내는 단일 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 표현을 가장 가까운 정수로 반올림하여 계산됩니다.
GL_SPOT_CUTOFF	params 매개 변수는 조명의 스폿 컷오프 각도를 나타내는 단일 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 표현을 가장 가까운 정수로 반올림하여 계산됩니다.
GL_CONSTANT_ATTENUATION	params 매개 변수는 광원의 상수(거리와 관련이 없음) 감쇠를 나타내는 단일 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 표현을 가장 가까운 정수로 반올림하여 계산됩니다.
GL_LINEAR_ATTENUATION	params 매개 변수는 조명의 선형 감쇠를 나타내는 단일 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 표현을 가장 가까운 정수로 반올림하여 계산됩니다.
GL_QUADRATIC_ATTENUATION	params 매개 변수는 광원의 이차 감쇠를 나타내는 단일 정수 또는 부동 소수점 값을 반환합니다. 요청 시 정수 값은 내부 부동 소수점 표현을 가장 가까운 정수로 반올림하여 계산됩니다.

params

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

반환 값

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

설명

glGetLight 함수는 광원 매개 변수의 값 또는 값을 매개 변수로 반환합니다. light 매개 변수는 조명의 이름을 지정하고 0 = i<GL_MAX_LIGHTS GL_LIGHT 형식의 기호 이름입니다. 여기서 GL_MAX_LIGHTS 8보다 크거나 같은 구현 종속 상수입니다. pname 매개 변수는 기호 이름으로 다시 10개의 광원 매개 변수 중 하나를 지정합니다.

항상 i = GL_LIGHT0 + i를 GL_LIGHT 경우입니다.

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

요구 사항

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

추가 정보

glBegin

glEnd

glLight