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


DistantLight Класс

Определение

Бесконечно большой удаленный источник света, излучающий свет в одном направлении. Например, для представления солнечного света можно использовать далекий свет.

public ref class DistantLight 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 DistantLight 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 DistantLight : CompositionLight
Public NotInheritable Class DistantLight
Inherits CompositionLight
Наследование
Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v3.0)

Примеры

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);          

Комментарии

Направление поддержки DistantLightи SpotLight.

DistantLight является одним из четырех типов света, производных от CompositionLight.

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

Примечание

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

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

Версия Windows Версия пакета SDK Добавленная стоимость
1709 16299 Интенсивность

Свойства

Color

Цвет излучаемого объекта DistantLight.

Comment

Строка, связанная с CompositionObject.

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

Составитель, используемый для создания этого объекта CompositionObject.

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

Визуальный элемент, используемый для определения направления света. Свойство направления света относительно координатного пространства этого визуального элемента.

**CoordinateSpace**

является обязательным свойством. Если значение CoordinateSpace не задано, функция DistantLight не будет отображаться.

Direction

Направление, в котором указывает свет, указанное относительно его визуального элемента CoordinateSpace .

Dispatcher

Диспетчер для CompositionObject.

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

Возвращает dispatcherQueue для объекта CompostionObject.

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

Возвращает коллекцию визуальных элементов, не предназначенных для света.

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

Коллекция неявных анимаций, присоединенных к этому объекту.

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

Возвращает или задает интенсивность света.

IsEnabled

Возвращает или задает значение, определяющее, включен ли индикатор композиции.

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

Коллекция свойств, связанных с CompositionObject.

(Унаследовано от CompositionObject)
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)

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

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