SpotLight Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Composition

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Sumber cahaya yang melemparkan kerujut cahaya dalam dan luar. Misalnya, senter.

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

Warisan: Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Contoh

_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);

Keterangan

SpotLight adalah salah satu dari empat jenis cahaya yang berasal dari CompositionLight.

Terang	Deskripsi
AmbientLight	Sumber cahaya yang memancarkan cahaya non-arah yang tampaknya telah tercermin oleh semua yang ada di adegan.
DistantLight	Sumber cahaya jauh yang sangat besar yang memancarkan cahaya ke satu arah.
PointLight	Sumber titik cahaya yang memancarkan cahaya ke segala arah.
Sorotan	Sumber cahaya yang memancarkan kerujut cahaya dalam dan luar.

Catatan

Visual tidak dapat ditargetkan oleh lebih dari dua lampu non-sekitar (PointLight, SpotLight, atau DistantLight).

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1709	16299	InnerConeIntensity
1709	16299	OuterConeIntensity
1803	17134	MaxAttenuationCutoff
1803	17134	MinAttenuationCutoff

Properti

Comment	String yang akan dikaitkan dengan CompositionObject. (Diperoleh dari CompositionObject)
Compositor	Compositor digunakan untuk membuat CompositionObject ini. (Diperoleh dari CompositionObject)
ConstantAttenuation	Koefisien konstan dalam persamaan redaman cahaya. Mengontrol intensitas cahaya. Bisa dianimasikan.
CoordinateSpace	Visual yang digunakan untuk menentukan arah dan offset lampu. Properti offset dan arah lampu relatif terhadap ruang koordinat Visual ini. SpotLight.CoordinateSpace adalah properti yang diperlukan. Jika SpotLight.CoordinateSpace tidak diatur, SpotLight tidak akan dirender.
Direction	Arah di mana cahaya menunjuk, ditentukan relatif terhadap Visual CoordinateSpace-nya.
Dispatcher	Dispatcher untuk CompositionObject. (Diperoleh dari CompositionObject)
DispatcherQueue	Mendapatkan DispatcherQueue untuk CompostionObject. (Diperoleh dari CompositionObject)
ExclusionsFromTargets	Mendapatkan kumpulan Visual yang tidak ditargetkan oleh cahaya. (Diperoleh dari CompositionLight)
ImplicitAnimations	Kumpulan animasi implisit yang melekat pada objek ini. (Diperoleh dari CompositionObject)
InnerConeAngle	Sudut kerujut bagian dalam SpotLight, dinyatakan sebagai sudut semi-vertikal dalam radian. Bisa dianimasikan.
InnerConeAngleInDegrees	Sudut kerujut bagian dalam SpotLight, dinyatakan sebagai sudut semi-vertikal dalam derajat. Bisa dianimasikan.
InnerConeColor	Warna kerujut bagian dalam lampu sorot. Bisa dianimasikan.
InnerConeIntensity	Mendapatkan atau mengatur intensitas cahaya di kerujut bagian dalam lampu sorot.
IsEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah lampu komposisi menyala. (Diperoleh dari CompositionLight)
LinearAttenuation	Koefisien linier dalam persamaan redaman cahaya yang menentukan bagaimana cahaya jatuh dengan jarak. Bisa dianimasikan.
MaxAttenuationCutoff	Mendapatkan atau mengatur rentang maksimum di mana cahaya ini efektif.
MinAttenuationCutoff	Mendapatkan atau mengatur rentang minimum di mana cahaya ini efektif.
Offset	Offset sumber cahaya relatif terhadap Visual CoordinateSpace-nya . Bisa dianimasikan.
OuterConeAngle	Sudut kerujut luar SpotLight, dinyatakan sebagai sudut semi-vertikal dalam radian. Bisa dianimasikan.
OuterConeAngleInDegrees	Sudut semi-vertikal, dalam derajat, dari kerujut luar SpotLight. Bisa dianimasikan.
OuterConeColor	Warna kerujut luar lampu sorot. Bisa dianimasikan.
OuterConeIntensity	Mendapatkan atau mengatur intensitas cahaya di kerujut luar lampu sorot.
Properties	Kumpulan properti yang terkait dengan CompositionObject. (Diperoleh dari CompositionObject)
QuadraticAttenuation	Bagian kuadrat dari persamaan redaman yang menentukan bagaimana cahaya jatuh dengan jarak. Bisa dianimasikan.
Targets	Koleksi Visual yang ditargetkan oleh cahaya. (Diperoleh dari CompositionLight)

Metode

Close()	Menutup CompositionObject dan merilis sumber daya sistem. (Diperoleh dari CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Menyambungkan dan animasi. (Diperoleh dari CompositionObject)
DisconnectAnimation(String)	Memutuskan sambungan animasi. (Diperoleh dari CompositionObject)
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Menentukan properti yang dapat dianimasikan. (Diperoleh dari CompositionObject)
StartAnimation(String, CompositionAnimation)	Menyambungkan animasi dengan properti objek yang ditentukan dan memulai animasi. (Diperoleh dari CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Menyambungkan animasi dengan properti objek yang ditentukan dan memulai animasi. (Diperoleh dari CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Memulai grup animasi. Metode StartAnimationGroup pada CompositionObject memungkinkan Anda memulai KomposisiAnimationGroup. Semua animasi dalam grup akan dimulai pada saat yang sama pada objek. (Diperoleh dari CompositionObject)
StopAnimation(String)	Memutuskan sambungan animasi dari properti yang ditentukan dan menghentikan animasi. (Diperoleh dari CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Menghentikan grup animasi. (Diperoleh dari CompositionObject)
TryGetAnimationController(String)	Mengembalikan AnimationController untuk animasi yang berjalan pada properti yang ditentukan. (Diperoleh dari CompositionObject)

Berlaku untuk