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 から派生した 4 種類のライトの 1 つです。

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

注意

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

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1709 16299 InnerConeIntensity
1709 16299 OuterConeIntensity
1803 17134 MaxAttenuationCutoff
1803 17134 MinAttenuationCutoff

プロパティ

Comment

CompositionObject に関連付ける文字列。

(継承元 CompositionObject)
Compositor

この CompositionObject の作成に使用されるコンポジター

(継承元 CompositionObject)
ConstantAttenuation

ライトの減衰方程式の定数係数。 光の強度を制御します。 アニメーション化可能。

CoordinateSpace

ライトの方向とオフセットを決定するために使用されるビジュアル。 ライトのオフセットプロパティと方向プロパティは、このビジュアルの座標空間に対して相対的です。 SpotLight.CoordinateSpace は必須のプロパティです。 SpotLight.CoordinateSpace が設定されていない場合、SpotLight はレンダリングされません。

Direction

CoordinateSpace ビジュアルを基準にして指定された、ライトがポイントする方向。

Dispatcher

CompositionObject のディスパッチャー。

(継承元 CompositionObject)
DispatcherQueue

CompostionObject の DispatcherQueue を取得します。

(継承元 CompositionObject)
ExclusionsFromTargets

ライトの対象ではないビジュアルのコレクションを取得します。

(継承元 CompositionLight)
ImplicitAnimations

このオブジェクトにアタッチされた暗黙的なアニメーションのコレクション。

(継承元 CompositionObject)
InnerConeAngle

SpotLight の内側の円錐の角度。ラジアン単位で半垂直角度として表されます。 アニメーション化可能。

InnerConeAngleInDegrees

SpotLight の内側の円錐の角度。半垂直角度 (度単位) で表されます。 アニメーション化可能。

InnerConeColor

スポットライトの内側円錐の色。 アニメーション化可能。

InnerConeIntensity

スポットライトの内部円錐のライトの強度を取得または設定します。

IsEnabled

コンポジション ライトがオンかどうかを決定する値を取得または設定します。

(継承元 CompositionLight)
LinearAttenuation

距離と共にライトが落ちる方法を決定する、ライトの減衰式の線形係数。 アニメーション化可能。

MaxAttenuationCutoff

このライトが有効な最大範囲を取得または設定します。

MinAttenuationCutoff

このライトが有効な最小範囲を取得または設定します。

Offset

CoordinateSpace ビジュアルに対する光源の相対オフセット。 アニメーション化可能。

OuterConeAngle

SpotLight の外側の円錐の角度。ラジアン単位で半垂直角度として表されます。 アニメーション化可能。

OuterConeAngleInDegrees

SpotLight の外部円錐の半垂直角度 (度単位)。 アニメーション化可能。

OuterConeColor

スポットライトの外側の円錐の色。 アニメーション化可能。

OuterConeIntensity

スポットライトの外側の円錐のライトの強度を取得または設定します。

Properties

CompositionObject に関連付けられているプロパティのコレクション。

(継承元 CompositionObject)
QuadraticAttenuation

距離と共にライトが落ちる方法を決定する減衰方程式の 2 次部分。 アニメーション化可能。

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)

アニメーション グループを開始します。

CompositionObject の StartAnimationGroup メソッドを使用すると、CompositionAnimationGroup を開始できます。 グループ内のすべてのアニメーションは、オブジェクトで同時に開始されます。

(継承元 CompositionObject)
StopAnimation(String)

指定したプロパティからアニメーションを切断し、アニメーションを停止します。

(継承元 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

アニメーション グループを停止します。

(継承元 CompositionObject)
TryGetAnimationController(String)

指定したプロパティで実行されているアニメーションの AnimationController を返します。

(継承元 CompositionObject)

適用対象

こちらもご覧ください