glLightf 함수

아티클
06/12/2023

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

구문

void WINAPI glLightf(
   GLenum  light,
   GLenum  pname,
   GLfloat param
);

매개 변수

light

조명의 식별자입니다. 가능한 조명 수는 구현에 따라 달라지지만 8개 이상의 조명이 지원됩니다. 0에서 GL_MAX_LIGHTS - 1 값인 GL_LIGHT 양식의 기호 이름으로 식별됩니다.

pname

조명에 대한 단일 값 광원 매개 변수입니다. 다음 기호 이름이 허용됩니다.

값	의미
GL_SPOT_EXPONENT	param 매개 변수는 조명의 강도 분포를 지정하는 단일 부동 소수점 값입니다. 부동 소수점 값은 직접 매핑됩니다. [0, 128] 범위의 값만 허용됩니다. 유효 광강도는 광원의 방향과 광원에서 조명되는 꼭짓점까지의 방향 사이의 각도의 코사인에 의해 감쇠되고, 스폿 지수의 힘으로 높아집니다. 따라서 스폿 지수가 높을수록 스폿 컷오프 각도에 관계없이 더 집중된 광원이 생성됩니다. 기본 스폿 지수는 0이므로 균일한 조명 분포가 발생합니다.
GL_SPOT_CUTOFF	param 매개 변수는 광원의 최대 확산 각도를 지정하는 단일 부동 소수점 값입니다. 부동 소수점 값은 직접 매핑됩니다. [0, 90] 범위의 값과 특수 값 180만 허용됩니다. 조명 방향과 조명에서 조명되는 꼭짓점까지의 방향 사이의 각도가 스폿 컷오프 각도보다 크면 조명이 완전히 마스킹됩니다. 그렇지 않으면 해당 강도는 스폿 지수 및 감쇠 요인에 의해 제어됩니다. 기본 스폿 컷오프는 180이므로 균일한 조명 분포가 발생합니다.
GL_CONSTANT_ATTENUATION, GL_LINEAR_ATTENUATION, GL_QUADRATIC_ATTENUATION	param 매개 변수는 세 가지 광원 감쇠 요소 중 하나를 지정하는 단일 부동 소수점 값입니다. 부동 소수점 값은 직접 매핑됩니다. nnnegative 값만 허용됩니다. 조명이 방향이 아닌 위치인 경우 해당 강도는 상수 계수, 조명되는 광원과 꼭짓점 사이의 거리를 곱한 선형 계수, 같은 거리의 제곱을 곱한 정사각형의 합에 의해 감쇠됩니다. 기본 감쇠 요소는 (1,0,0)이므로 감쇠가 없습니다.

param

광원 광원의 매개 변수 pname을 설정할 값을 지정합니다.

반환 값

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

오류 코드

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

Name	의미
GL_INVALID_ENUM	light 또는 pname 은 허용되는 값이 아닙니다.
GL_INVALID_VALUE	스폿 지수 값이 [0, 128] 범위 외부로 지정되었거나 범위 [0, 90](특수 값 180 제외)을 벗어나 스폿 컷오프를 지정했거나 음수 감쇠 인수를 지정했습니다.
GL_INVALID_OPERATION	함수는 glBegin 호출과 glEnd에 대한 해당 호출 사이에 호출되었습니다.

설명

glLightf 함수는 개별 광원 매개 변수의 값 또는 값을 설정합니다. light 매개 변수는 조명의 이름을 지정하고 0 = i< GL_MAX_LIGHTS GL_LIGHT 형식의 기호 이름입니다.

pname 매개 변수는 기호 이름으로 다시 광원 매개 변수 중 하나를 지정합니다. param 매개 변수는 단일 값 또는 새 값을 포함하는 배열에 대한 포인터입니다.

인수 GL_LIGHTING glEnable 및 glDisable 을 사용하여 조명 계산을 사용하도록 설정하고 사용하지 않도록 설정합니다. 조명을 사용하도록 설정하면 활성화된 광원이 조명 계산에 기여합니다. 광원 i 는 인수 GL_LIGHT glEnable 및 glDisable 을 사용하여 사용하도록 설정되고 사용하지 않도록 설정됩니다.

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

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

glGetLight

인수가 GL_LIGHTING glIsEnabled

요구 사항

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

추가 정보

glBegin
glColorMaterial
glEnd
glLightModel
glMaterial