DistantLight クラス

リファレンス

定義

名前空間:: Windows.UI.Composition

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

1 つの方向に光を発する、無限に遠く離れた光源。たとえば、遠くの光を使用して太陽光を表す場合があります。

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

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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);

注釈

DistantLightsと SpotLightのサポート方向。

DistantLight は、 CompositionLight から派生した 4 種類のライトの 1 つです。

ライト	説明
AmbientLight	シーン内のすべてのものが反射しているように見える非方向ライトを放射する光源。
DistantLight	1 つの方向に光を発する、無限に遠く離れた光源。
PointLight	すべての方向に光を出す点光源。
SpotLight	光の内部コーンと外部コーンを生成する光源。

注意

ビジュアルは、2 つ以上の非アンビエントライト (PointLight、SpotLight、または DistantLight) の対象にすることはできません。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1709	16299	強度

プロパティ

Color	出力された DistantLight の色。
Comment	CompositionObject に関連付ける文字列。 (継承元 CompositionObject)
Compositor	この CompositionObject の作成に使用されるコンポジター。 (継承元 CompositionObject)
CoordinateSpace	ライトの方向を決定するために使用されるビジュアル。ライトの Direction プロパティは、このビジュアルの座標空間に対して相対的です。 `CoordinateSpace` は必須プロパティです。 CoordinateSpace が設定されていない場合、DistantLight はレンダリングされません。
Direction	CoordinateSpace ビジュアルを基準にして指定された、ライトがポイントする方向。
Dispatcher	CompositionObject のディスパッチャー。 (継承元 CompositionObject)
DispatcherQueue	CompostionObject の DispatcherQueue を取得します。 (継承元 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)	アニメーションをオブジェクトの指定したプロパティに接続し、アニメーションを開始します。 (継承元 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	アニメーションをオブジェクトの指定したプロパティに接続し、アニメーションを開始します。 (継承元 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	アニメーショングループを開始します。 CompositionObject の StartAnimationGroup メソッドを使用すると、CompositionAnimationGroup を開始できます。グループ内のすべてのアニメーションは、オブジェクトで同時に開始されます。 (継承元 CompositionObject)
StopAnimation(String)	指定したプロパティからアニメーションを切断し、アニメーションを停止します。 (継承元 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	アニメーショングループを停止します。 (継承元 CompositionObject)
TryGetAnimationController(String)	指定したプロパティで実行されているアニメーションの AnimationController を返します。 (継承元 CompositionObject)

適用対象