共用方式為


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的四種光線類型之一。

淺色 描述
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

用來建立這個CompositionObjectCompositor

(繼承來源 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)

方法

Close()

關閉 CompositionObject 並釋放系統資源。

(繼承來源 CompositionObject)
ConnectAnimation(String, CompositionAnimation)

連接和動畫。

(繼承來源 CompositionObject)
DisconnectAnimation(String)

中斷動畫的連線。

(繼承來源 CompositionObject)
Dispose()

執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。

(繼承來源 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)

適用於

另請參閱