DistantLight 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
無限大型遠距光源，會以單一方向發出光線。 例如，遠距光線可用來代表 S。
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 : CompositionLightPublic NotInheritable Class DistantLight
Inherits CompositionLight- 繼承
- 屬性
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 | 光線的點來源，會以所有方向發出光線。 |
| 聚光燈 | 發出光線內部和外部圓錐的光源。 |
注意
Visual 無法以兩個以上的非環境光線為目標， (PointLight、SpotLight 或 DistantLight) 。
版本歷程記錄
| Windows 版本 | SDK 版本 | 新增值 |
|---|---|---|
| 1709 | 16299 | 強度 |
屬性
| Color |
發出之 DistantLight 的色彩。 |
| Comment |
要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) |
| Compositor |
用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) |
| CoordinateSpace |
用來判斷光線方向的視覺效果。 光線的 Direction 屬性相對於這個視覺效果的座標空間。 是必要屬性。 如果未設定 CoordinateSpace ， 則 DistantLight 將不會轉譯。 |
| Direction |
光線指向的方向，相對於其 CoordinateSpace Visual 指定。 |
| Dispatcher |
CompositionObject的發送器。 (繼承來源 CompositionObject) |
| DispatcherQueue |
取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject) |
| ExclusionsFromTargets |
取得不是以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) |
| ImplicitAnimations |
附加至這個 物件的隱含動畫集合。 (繼承來源 CompositionObject) |
| Intensity |
取得或設定光線的強度。 |
| IsEnabled |
取得或設定值，這個值會判斷組合光線是否開啟。 (繼承來源 CompositionLight) |
| Properties |
與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject) |
| Targets |
以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) |