PointLight 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
光線的點來源，會以所有方向產生光線。
public ref class PointLight 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 PointLight 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 PointLight : CompositionLightPublic NotInheritable Class PointLight
Inherits CompositionLight- 繼承
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)
|
備註
PointLight 會以相同方向提供光線。
PointLight 是衍生自 CompositionLight的四種光線類型之一。
| 淺色 | 描述 |
|---|---|
| AmbientLight | 光線來源，發出場景中所有專案似乎已反映的非方向光線。 |
| DistantLight | 無限大型遠距光源，會以單一方向發出光線。 |
| PointLight | 光線的點來源，會以所有方向發出光線。 |
| 聚光燈 | 發出光線內部和外部圓錐的光源。 |
注意
Visual 無法以兩個以上的非環境光線為目標， (PointLight、SpotLight 或 DistantLight) 。
版本歷程記錄
| Windows 版本 | SDK 版本 | 新增值 |
|---|---|---|
| 1709 | 16299 | 強度 |
| 1803 | 17134 | MaxAttenuationCutoff |
| 1803 | 17134 | MinAttenuationCutoff |
屬性
| Color |
燈光的色彩。 |
| Comment |
要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) |
| Compositor |
用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) |
| ConstantAttenuation |
光線衰減方程式中的常數係數。 控制光線強度。 |
| CoordinateSpace |
用來判斷光線位移的視覺效果。 光線的位移屬性相對於這個視覺效果的座標空間。 PointLight.CoordinateSpace 是必要屬性。 如果未設定 PointLight.CoordinateSpace ， PointLight 將不會轉譯。 |
| Dispatcher |
CompositionObject的發送器。 (繼承來源 CompositionObject) |
| DispatcherQueue |
取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject) |
| ExclusionsFromTargets |
取得不是以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) |
| ImplicitAnimations |
附加至這個 物件的隱含動畫集合。 (繼承來源 CompositionObject) |
| Intensity |
取得或設定光線的強度。 |
| IsEnabled |
取得或設定值，這個值會判斷組合光線是否開啟。 (繼承來源 CompositionLight) |
| LinearAttenuation |
光線衰減方程式中的線性係數，決定光線與距離的落差方式。 |
| MaxAttenuationCutoff |
取得或設定這個光線有效的最大範圍。 |
| MinAttenuationCutoff |
取得或設定這個光線有效的最小範圍。 |
| Offset |
相對於其座標空間 Visual 的光源位移。 |
| Properties |
與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject) |
| QuadraticAttenuation |
衰減方程式的二次方程式部分，決定光線與距離的落差方式。 |
| Targets |
以光線為目標的視覺效果集合。 (繼承來源 CompositionLight) |