D3DDDI_LIGHT 구조체(d3dumddi.h)

  • 아티클

D3DDDI_LIGHT 구조체는 조명 속성 집합을 설명합니다.

구문

typedef struct _D3DDDI_LIGHT {
  [in] D3DLIGHTTYPE  Type;
  [in] D3DCOLORVALUE Diffuse;
  [in] D3DCOLORVALUE Specular;
  [in] D3DCOLORVALUE Ambient;
  [in] D3DVECTOR     Position;
  [in] D3DVECTOR     Direction;
  [in] FLOAT         Range;
  [in] FLOAT         Falloff;
  [in] FLOAT         Attenuation0;
  [in] FLOAT         Attenuation1;
  [in] FLOAT         Attenuation2;
  [in] FLOAT         Theta;
  [in] FLOAT         Phi;
} D3DDDI_LIGHT;

멤버

[in] Type

광원의 형식을 나타내는 D3DLIGHTTYPE 형식의 값입니다. D3DLIGHTTYPE 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

[in] Diffuse

조명에서 내보내는 확산 색을 나타내는 D3DCOLORVALUE 구조체입니다. D3DCOLORVALUE 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

[in] Specular

조명에서 내보낸 반사 색을 나타내는 D3DCOLORVALUE 구조체입니다.

[in] Ambient

조명에서 내보내는 앰비언트 색을 나타내는 D3DCOLORVALUE 구조체입니다.

[in] Position

세계 공간에서 빛의 위치를 나타내는 D3DVECTOR 구조체입니다. 이 멤버는 방향 표시등에 의미가 없으며(즉, type 멤버에서 D3DLIGHT_DIRECTIONAL 설정된 경우) 해당 상황에서 무시됩니다. D3DVECTOR 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

[in] Direction

빛이 세계 공간을 가리키는 방향을 나타내는 D3DVECTOR 구조체입니다. 이 멤버는 방향 조명 및 스포트라이트에 대해서만 의미가 있습니다(즉, D3DLIGHT_DIRECTIONAL 및 D3DLIGHT_SPOT Type으로 설정된 경우). 이 벡터는 정규화할 필요는 없지만 길이가 0이 아니어야 합니다.

[in] Range

빛이 영향을 미치지 않는 거리입니다. 이 멤버에 허용되는 최대 값은 D3DLIGHT_RANGE_MAX FLT_MAX 제곱근으로 정의됩니다. 이 멤버는 방향 표시등에 영향을 주지 않습니다.

[in] Falloff

스포트라이트의 내부 원뿔( Theta 멤버에 의해 지정된 각도)과 외부 원뿔의 바깥쪽 가장자리( Phi 멤버가 지정한 각도) 사이의 조명 감소입니다. 조명에 대한 폴오프의 효과는 미묘합니다. 또한 대체 곡선을 형성하여 작은 성능 저하가 발생합니다. 이러한 이유로 대부분의 개발자는 이 멤버를 1.0으로 설정합니다.

[in] Attenuation0

조명의 상수 감쇠 계수입니다. 감쇠 값은 광도가 거리에 따라 변하는 방식을 지정합니다. 감쇠는 방향 표시등에 영향을 주지 않습니다. 이 멤버의 유효한 값 범위는 0.0부터 무한대까지입니다.

[in] Attenuation1

조명의 선형 감쇠 계수입니다. 감쇠 값은 광도가 거리에 따라 변하는 방식을 지정합니다. 감쇠는 방향 표시등에 영향을 주지 않습니다. 이 멤버의 유효한 값 범위는 0.0부터 무한대까지입니다.

[in] Attenuation2

광원의 이차 감쇠 인자입니다. 감쇠 값은 광도가 거리에 따라 변하는 방식을 지정합니다. 감쇠는 방향 표시등에 영향을 주지 않습니다. 이 멤버의 유효한 값 범위는 0.0부터 무한대까지입니다.

[in] Theta

스포트라이트의 내부 원뿔의 각도(라디안)입니다. 즉, 완전히 조명된 스포트라이트 원뿔입니다. 이 값은 Phi 멤버가 지정한 값까지 0 범위여야 합니다.

[in] Phi

스포트라이트의 외부 원뿔의 바깥 가장자리를 정의하는 각도(라디안)입니다. 이 원뿔 외부의 지점은 스포트라이트에 의해 켜지지 않습니다. 이 값은 0과 Pi 사이여야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글 d3dumddi.h(D3dumddi.h 포함)

추가 정보

SetLight