PointLight 클래스

정의

네임스페이스:

Windows.UI.Composition

모든 방향으로 빛을 발산하는 빛의 포인트 소스입니다.

UWP용 동등한 WinUI 2 API: Microsoft.UI.Composition.PointLight(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class PointLight 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 PointLight 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 PointLight : CompositionLight

Public NotInheritable Class PointLight
Inherits CompositionLight

상속

Object IInspectable CompositionObject CompositionLight PointLight

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

PointLight는 모든 방향에서 동일하게 빛을 발산합니다.

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

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

참고

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

버전 기록

Windows 버전	SDK 버전	추가된 값
1709	16299	강도
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

속성

Color	조명의 색입니다. UWP용 동등한 WinUI 2 API: Microsoft.UI.Composition.PointLight.Color(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Comment	CompositionObject와 연결할 문자열입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Comment(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
Compositor	Compositor 이 CompositionObject값을 만드는 데 사용됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Compositor(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
ConstantAttenuation	조명 감쇠 수식의 상수 계수입니다. 조명 강도를 제어합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.ConstantAttenuation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CoordinateSpace	조명의 오프셋을 확인하는 데 사용되는 시각적 개체입니다. 조명의 오프셋 속성은 이 시각적 개체의 좌표 공간을 기준으로 합니다. PointLight.CoordinateSpace 는 필수 속성입니다. PointLight.CoordinateSpace 가 설정 PointLight 되지 않은 경우 렌더링되지 않습니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.CoordinateSpace(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Dispatcher	에 대한 디스패처입니다 CompositionObject. (다음에서 상속됨 CompositionObject)
DispatcherQueue	DispatcherQueue CompostionObject에 대한 값을 가져옵니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.DispatcherQueue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
ExclusionsFromTargets	조명의 대상이 아닌 시각적 개체의 컬렉션을 가져옵니다. (다음에서 상속됨 CompositionLight)
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.ImplicitAnimations(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
Intensity	조명의 강도를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.Intensity(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
IsEnabled	컴퍼지션 조명이 켜지는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 CompositionLight)
LinearAttenuation	광원 감쇠 수식의 선형 계수로, 거리가 멀어지면 빛이 떨어지는 방식을 결정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.LinearAttenuation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MaxAttenuationCutoff	이 표시등이 유효한 최대 범위를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.MaxAttenuationCutoff(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
MinAttenuationCutoff	이 표시등이 적용되는 최소 범위를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.MinAttenuationCutoff(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Offset	좌표 공간 시각적 개체를 기준으로 하는 광원의 오프셋입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.Offset(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Properties	에 연결된 CompositionObject속성의 컬렉션입니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Properties(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
QuadraticAttenuation	감쇠 방정식의 이차 부분으로, 거리가 멀어지면 빛이 떨어지는 방식을 결정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.PointLight.QuadraticAttenuation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Targets	조명을 대상으로 하는 시각적 개체의 컬렉션입니다. (다음에서 상속됨 CompositionLight)

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.Close(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 적용할 수 있는 속성을 정의합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.PopulatePropertyInfo(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StartAnimation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 시작합니다. StartAnimationGroup 메서드를 사용하여 CompositionObject 시작할 CompositionAnimationGroup수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StartAnimationGroup(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StopAnimation(String)	지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StopAnimation(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 중지합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.StopAnimationGroup(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)	지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Composition.CompositionObject.TryGetAnimationController(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 CompositionObject)

추가 정보

• CompositionLight
• IClosable