Поделиться через


SpotLight Класс

Определение

Источник света, который отбрасывает внутренние и внешние конусы света. Например, фонарик.

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
Атрибуты

Требования к 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, AnimationController)

Соединяет анимацию с указанным свойством объекта и запускает анимацию.

(Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)

Соединяет анимацию с указанным свойством объекта и запускает анимацию.

(Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Запускает группу анимации.

Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно с объектом .

(Унаследовано от CompositionObject)
StopAnimation(String)

Отключает анимацию от указанного свойства и останавливает анимацию.

(Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Останавливает группу анимации.

(Унаследовано от CompositionObject)
TryGetAnimationController(String)

Возвращает AnimationController для анимации, выполняемой в указанном свойстве.

(Унаследовано от CompositionObject)

Применяется к

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