SpotLight クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
光の内側と外側の円錐形をキャストする光源。 たとえば、懐中電灯などです。
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 から派生した 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) |