다음을 통해 공유


DistantLight 클래스

정의

한 방향으로 조명을 방출하는 무한히 큰 원거리 광원. 예를 들어 먼 빛을 사용하여 햇빛을 나타낼 수 있습니다.

public ref class DistantLight sealed : CompositionLight
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DistantLight final : CompositionLight
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DistantLight : CompositionLight
Public NotInheritable Class DistantLight
Inherits CompositionLight
상속
Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

예제

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);          

설명

DistantLightSpotLight의 지원 방향입니다.

DistantLight는 CompositionLight에서 파생된 4가지 광원 유형 중 하나입니다.

밝음 설명
AmbientLight 장면의 모든 항목에서 반사된 것처럼 보이는 비방향 광원을 방출하는 광원입니다.
DistantLight 한 방향으로 조명을 방출하는 무한히 큰 원거리 광원.
PointLight 모든 방향으로 조명을 방출하는 점광원.
SpotLight 조명의 내부 및 외부 원뿔을 방출하는 광원.

참고

시각적 개체는 둘 이상의 비앰비언트 조명(PointLight, SpotLight 또는 DistantLight)의 대상이 될 수 없습니다.

버전 기록

Windows 버전 SDK 버전 추가된 값
1709 16299 강도

속성

Color

내보낸 DistantLight의 색입니다.

Comment

CompositionObject와 연결할 문자열입니다.

(다음에서 상속됨 CompositionObject)
Compositor

CompositionObject를 만드는 데 사용되는 Compositor입니다.

(다음에서 상속됨 CompositionObject)
CoordinateSpace

빛의 방향을 결정하는 데 사용되는 시각적 개체입니다. 조명의 Direction 속성은 이 시각적 개체의 좌표 공간을 기준으로 합니다.

**CoordinateSpace**

는 필수 속성입니다. CoordinateSpace가 설정되지 않으면 DistantLight가 렌더링되지 않습니다.

Direction

표시등이 가리키는 방향이며, 좌표 영역 시각적 개체를 기준으로 지정됩니다.

Dispatcher

CompositionObject의 디스패처입니다.

(다음에서 상속됨 CompositionObject)
DispatcherQueue

CompostionObject에 대한 DispatcherQueue 를 가져옵니다.

(다음에서 상속됨 CompositionObject)
ExclusionsFromTargets

조명의 대상이 아닌 시각적 개체의 컬렉션을 가져옵니다.

(다음에서 상속됨 CompositionLight)
ImplicitAnimations

이 개체에 연결된 암시적 애니메이션의 컬렉션입니다.

(다음에서 상속됨 CompositionObject)
Intensity

조명의 강도를 가져오거나 설정합니다.

IsEnabled

컴퍼지션 표시등이 켜져 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 CompositionLight)
Properties

CompositionObject와 연결된 속성의 컬렉션입니다.

(다음에서 상속됨 CompositionObject)
Targets

빛을 대상으로 하는 시각적 개체의 컬렉션입니다.

(다음에서 상속됨 CompositionLight)

메서드

Close()

CompositionObject를 닫고 시스템 리소스를 해제합니다.

(다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)

연결 및 애니메이션.

(다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)

애니메이션의 연결을 끊습니다.

(다음에서 상속됨 CompositionObject)
Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

(다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

애니메이션 효과를 주는 속성을 정의합니다.

(다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다.

(다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)

개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다.

(다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

애니메이션 그룹을 시작합니다.

CompositionObject의 StartAnimationGroup 메서드를 사용하면 CompositionAnimationGroup을 시작할 수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다.

(다음에서 상속됨 CompositionObject)
StopAnimation(String)

지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다.

(다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

애니메이션 그룹을 중지합니다.

(다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)

지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다.

(다음에서 상속됨 CompositionObject)

적용 대상

추가 정보