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.

Светлая	Описание
AmbientLight	Источник света, излучающий ненаправленный свет, который, как представляется, был отражен всем в сцене.
DistantLight	Бесконечно большой удаленный источник света, излучающий свет в одном направлении.
PointLight	Точечный источник света, излучающий свет во всех направлениях.
Прожектор	Источник света, излучающий внутренние и внешние конусы света.

Примечание

Визуальный элемент не может быть нацелен более чем на два внешних индикатора (PointLight, SpotLight или DistantLight).

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Свойства

Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
Compositor	Compositor, используемый для создания объекта CompositionObject. (Унаследовано от CompositionObject)
ConstantAttenuation	Коэффициент константы в уравнении затухания света. Управляет интенсивностью света. Анимация.
CoordinateSpace	Визуальный элемент, используемый для определения направления и смещения света. Свойства смещения и направления света относятся к координатам этого визуального пространства. SpotLight.CoordinateSpace является обязательным свойством. Если Параметр SpotLight.CoordinateSpace не задан, то SpotLight не будет отображаться.
Direction	Направление, в котором указывает свет, задается относительно его visual CoordinateSpace.
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для Объекта CompostionObject. (Унаследовано от CompositionObject)
ExclusionsFromTargets	Возвращает коллекцию визуальных элементов, которые не предназначены для света. (Унаследовано от CompositionLight)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
InnerConeAngle	Угол внутреннего конуса SpotLight, выраженный в виде полу вертикального угла в радианах. Анимация.
InnerConeAngleInDegrees	Угол внутреннего конуса SpotLight, выраженный в виде полу вертикального угла в градусах. Анимация.
InnerConeColor	Цвет внутреннего конуса прожектора. Анимация.
InnerConeIntensity	Возвращает или задает интенсивность света во внутреннем конусе прожектора.
IsEnabled	Возвращает или задает значение, определяющее, включен ли свет композиции. (Унаследовано от CompositionLight)
LinearAttenuation	Линейный коэффициент в уравнении затухания света, который определяет, как свет падает с расстояния. Анимация.
MaxAttenuationCutoff	Возвращает или задает максимальный диапазон, в котором действует этот индикатор.
MinAttenuationCutoff	Возвращает или задает минимальный диапазон, в котором этот индикатор действует.
Offset	Смещение источника света относительно его visual CoordinateSpace . Анимация.
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)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно с объектом . (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой в указанном свойстве. (Унаследовано от CompositionObject)

См. также раздел

• CompositionLight
• Targets
• CreateSpotLight()