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 : 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.
| Светлая | Описание |
|---|---|
| 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) |