SpotLight 클래스

정의

네임스페이스:

Windows.UI.Composition

안쪽 및 바깥쪽 원뿔의 빛을 투사하는 광원입니다. 예를 들어 손전등입니다.

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

Public NotInheritable Class SpotLight
Inherits CompositionLight

상속

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

_spotLight = _compositor.CreateSpotLight(); 
_spotLight.CoordinateSpace = root; 
_spotLight.InnerConeAngleInDegrees = 30; 
_spotLight.InnerConeColor = Colors.Red; 
_spotLight.OuterConeAngleInDegrees = 45; 
_spotLight.OuterConeColor = Colors.Yellow; 
_spotLight.Offset = new Vector3(30, 30, 200); 
_spotLight.Targets.Add(root);          

설명

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

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

참고

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

버전 기록

Windows 버전	SDK 버전	추가된 값
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

속성

Comment	CompositionObject와 연결할 문자열입니다. (다음에서 상속됨 CompositionObject)
Compositor	이 CompositionObject를 만드는 데 사용되는 Compositor입니다. (다음에서 상속됨 CompositionObject)
ConstantAttenuation	광원 감쇠 수식의 상수 계수입니다. 조명 강도를 제어합니다. 애니메이션 가능.
CoordinateSpace	조명의 방향과 오프셋을 결정하는 데 사용되는 시각적 개체입니다. 조명의 오프셋 및 방향 속성은 이 시각적 개체의 좌표 공간을 기준으로 합니다. SpotLight.CoordinateSpace 는 필수 속성입니다. SpotLight.CoordinateSpace가 설정되지 않으면 SpotLight가 렌더링되지 않습니다.
Direction	표시등이 가리키는 방향이며, 좌표 영역 시각적 개체를 기준으로 지정됩니다.
Dispatcher	CompositionObject의 디스패처입니다. (다음에서 상속됨 CompositionObject)
DispatcherQueue	CompostionObject에 대한 DispatcherQueue 를 가져옵니다. (다음에서 상속됨 CompositionObject)
ExclusionsFromTargets	조명의 대상이 아닌 시각적 개체의 컬렉션을 가져옵니다. (다음에서 상속됨 CompositionLight)
ImplicitAnimations	이 개체에 연결된 암시적 애니메이션의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
InnerConeAngle	SpotLight의 내부 원뿔 각도는 라디안의 반 수직 각도로 표현됩니다. 애니메이션 가능.
InnerConeAngleInDegrees	SpotLight의 내부 원뿔 각도는 반 수직 각도로 도 단위로 표현됩니다. 애니메이션 가능.
InnerConeColor	스포트라이트의 내부 원뿔 색입니다. 애니메이션 가능.
InnerConeIntensity	스포트라이트의 내부 원뿔에서 조명의 강도를 가져오거나 설정합니다.
IsEnabled	컴퍼지션 표시등이 켜져 있는지 여부를 결정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 CompositionLight)
LinearAttenuation	광원 감쇠 수식의 선형 계수로, 거리가 멀어 빛이 떨어지는 방식을 결정합니다. 애니메이션 가능.
MaxAttenuationCutoff	이 표시등이 유효한 최대 범위를 가져오거나 설정합니다.
MinAttenuationCutoff	이 표시등이 유효한 최소 범위를 가져오거나 설정합니다.
Offset	좌표 영역 시각적 개체를 기준으로 하는 광원의 오프셋입니다. 애니메이션 가능.
OuterConeAngle	SpotLight의 외부 원뿔 각도는 라디안의 반 수직 각도로 표현됩니다. 애니메이션 가능.
OuterConeAngleInDegrees	SpotLight의 외부 원뿔의 반 수직 각도(도)입니다. 애니메이션 가능.
OuterConeColor	스포트라이트의 외부 원뿔 색입니다. 애니메이션 가능.
OuterConeIntensity	스포트라이트의 외부 원뿔에서 조명의 강도를 가져오거나 설정합니다.
Properties	CompositionObject와 연결된 속성의 컬렉션입니다. (다음에서 상속됨 CompositionObject)
QuadraticAttenuation	감쇠 수식의 사분면 부분은 빛이 거리와 함께 떨어지는 방법을 결정합니다. 애니메이션 가능.
Targets	빛을 대상으로 하는 시각적 개체의 컬렉션입니다. (다음에서 상속됨 CompositionLight)

메서드

Close()	CompositionObject를 닫고 시스템 리소스를 해제합니다. (다음에서 상속됨 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	연결 및 애니메이션. (다음에서 상속됨 CompositionObject)
DisconnectAnimation(String)	애니메이션의 연결을 끊습니다. (다음에서 상속됨 CompositionObject)
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. (다음에서 상속됨 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 주는 속성을 정의합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	개체의 지정된 속성에 애니메이션을 연결하고 애니메이션을 시작합니다. (다음에서 상속됨 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 시작합니다. CompositionObject의 StartAnimationGroup 메서드를 사용하면 CompositionAnimationGroup을 시작할 수 있습니다. 그룹의 모든 애니메이션은 개체에서 동시에 시작됩니다. (다음에서 상속됨 CompositionObject)
StopAnimation(String)	지정된 속성에서 애니메이션의 연결을 끊고 애니메이션을 중지합니다. (다음에서 상속됨 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	애니메이션 그룹을 중지합니다. (다음에서 상속됨 CompositionObject)
TryGetAnimationController(String)	지정된 속성에서 실행되는 애니메이션에 대한 AnimationController를 반환합니다. (다음에서 상속됨 CompositionObject)

추가 정보

• CompositionLight
• Targets
• CreateSpotLight()