SpotLight 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
안쪽 및 바깥쪽 원뿔의 빛을 투사하는 광원입니다. 예를 들어 손전등입니다.
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 : CompositionLightPublic NotInheritable Class SpotLight
Inherits CompositionLight- 상속
- 특성
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) |