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的四種光線類型之一。
| 淺色 | 描述 |
|---|---|
| AmbientLight | 光線來源，發出場景中所有專案似乎已反映的非方向光線。 |
| DistantLight | 無限大型遠距光源，會以單一方向發出光線。 |
| PointLight | 光線的點來源，會以所有方向發出光線。 |
| 聚光燈 | 發出光線內部和外部圓錐的光源。 |
注意
Visual 無法以兩個以上的非環境光線為目標， (PointLight、SpotLight 或 DistantLight) 。
版本歷程記錄
| Windows 版本 | SDK 版本 | 新增值 |
|---|---|---|
| 1709 | 16299 | InnerConeIntensity |
| 1709 | 16299 | OuterConeIntensity |
| 1803 | 17134 | MaxAttenuationCutoff |
| 1803 | 17134 | MinAttenuationCutoff |
屬性
| Comment |
要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) |
| Compositor |
用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) |
| ConstantAttenuation |
光線衰減方程式中的常數係數。 控制光線強度。 可產生動畫效果。 |
| CoordinateSpace |
用來判斷光線方向和位移的視覺效果。 光線的位移和方向屬性相對於這個視覺效果的座標空間。 SpotLight.CoordinateSpace 是必要屬性。 如果未設定 SpotLight.CoordinateSpace ，SpotLight 將不會轉譯。 |
| Direction |
光線指向的方向，相對於其 CoordinateSpace Visual 指定。 |
| 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 |
衰減方程式的二次方程式部分，決定光線與距離的落差方式。 可產生動畫效果。 |
| Targets |
以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) |