PointLight Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje źródło światła, które ma określoną pozycję w przestrzeni i projektuje światło we wszystkich kierunkach.
public ref class PointLight sealed : System::Windows::Media::Media3D::PointLightBasepublic sealed class PointLight : System.Windows.Media.Media3D.PointLightBasetype PointLight = class
inherit PointLightBasePublic NotInheritable Class PointLight
Inherits PointLightBase- Dziedziczenie
Przykłady
W poniższych przykładach utworzono PointLight obiekt i ustawiono niektóre jego właściwości.
// Point light values.
PointLight _ptLight = new PointLight();
' Point light values.
Private _ptLight As New PointLight()
public MyLights()
{
for (int i = 0; i < nbrDirLights; i++)
{
_dirLight[i] = new DirectionalLight();
_dirLight[i].Color = _dirLightColor[i];
_dirLight[i].Direction = _dirVector[i];
}
_ptLight.Position = new Point3D(-3, -7, 10);
_ptLight.Color = System.Windows.Media.Brushes.White.Color;
_ptLight.Range = 15.0;
_ptLight.ConstantAttenuation = 3.0;
}
Public Sub New()
For i As Integer = 0 To nbrDirLights - 1
_dirLight(i) = New DirectionalLight()
_dirLight(i).Color = _dirLightColor(i)
_dirLight(i).Direction = _dirVector(i)
Next i
_ptLight.Position = New Point3D(-3, -7, 10)
_ptLight.Color = System.Windows.Media.Brushes.White.Color
_ptLight.Range = 15.0
_ptLight.ConstantAttenuation = 3.0
End Sub
Uwagi
Szybkość, w której intensywność światła zmniejsza się w odległości, jest nazywana tłumieniem i może być kontrolowana przez ustawienie ConstantAttenuationwłaściwości , LinearAttenuationlub QuadraticAttenuation .
Konstruktory
| PointLight() |
Inicjuje PointLight nowe wystąpienie klasy w miejscu pochodzenia. |
| PointLight(Color, Point3D) |
Inicjuje nowe wystąpienie PointLight klasy na określonej pozycji przy użyciu określonego koloru. |
Właściwości
| Bounds |
Pobiera element Rect3D określający pole ograniczenia wyrównane do osi tego Model3Dobiektu . (Odziedziczone po Model3D) |
| CanFreeze |
Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable) |
| Color |
Pobiera lub ustawia kolor światła. (Odziedziczone po Light) |
| ConstantAttenuation |
Pobiera lub ustawia stałą wartość, za pomocą której intensywność światła zmniejsza się w odległości. (Odziedziczone po PointLightBase) |
| DependencyObjectType |
Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject) |
| Dispatcher |
Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject) |
| HasAnimatedProperties |
Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable) |
| IsFrozen |
Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable) |
| IsSealed |
Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject) |
| LinearAttenuation |
Pobiera lub ustawia wartość określającą liniową rozminuj intensywność światła na odległość. (Odziedziczone po PointLightBase) |
| Position |
Pobiera lub ustawia Point3D element określający położenie światła w przestrzeni światowej. (Odziedziczone po PointLightBase) |
| QuadraticAttenuation |
Pobiera lub ustawia wartość, która określa dyminucję efektu światła na odległość, obliczoną przez operację kwadratową. (Odziedziczone po PointLightBase) |
| Range |
Pobiera lub ustawia odległość, poza którą światło nie ma efektu. (Odziedziczone po PointLightBase) |
| Transform |
Pobiera lub ustawia Transform3D zestaw w modelu. (Odziedziczone po Model3D) |
Metody
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable) |
| CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
| ClearValue(DependencyProperty) |
Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject) |
| Clone() |
Tworzy modyfikowalny klon tego PointLightobiektu , tworząc głębokie kopie wartości tego obiektu. Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie animacje ani ich bieżące wartości. |
| CloneCore(Freezable) |
Sprawia, że wystąpienie jest klonem (kopia głęboka) określonego Freezable obiektu przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable) |
| CloneCurrentValue() |
Tworzy modyfikowalny klon tego PointLight obiektu, tworząc głębokie kopie bieżących wartości tego obiektu. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są. |
| CloneCurrentValueCore(Freezable) |
Sprawia, że wystąpienie jest modyfikowalnym klonem (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable) |
| CoerceValue(DependencyProperty) |
Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject) |
| CreateInstance() |
Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable) |
| CreateInstanceCore() |
Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable) |
| Equals(Object) |
Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject) |
| Freeze() |
Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego IsFrozen właściwość na |
| FreezeCore(Boolean) |
Sprawia, że ten Animatable obiekt jest niemodyfikowalny lub określa, czy można go zmodyfikować. (Odziedziczone po Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Zwraca nieimętowaną wartość określonego DependencyPropertyelementu . (Odziedziczone po Animatable) |
| GetAsFrozen() |
Tworzy zamrożoną kopię Freezableobiektu przy użyciu podstawowych (nieimowanych) wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
| GetAsFrozenCore(Freezable) |
Sprawia, że wystąpienie jest zamrożonym klonem określonego Freezable przy użyciu wartości właściwości base (nieimowane). (Odziedziczone po Freezable) |
| GetCurrentValueAsFrozen() |
Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Powoduje, że bieżące wystąpienie jest zamrożonym klonem określonego Freezableelementu . Jeśli obiekt ma animowane właściwości zależności, zostaną skopiowane bieżące animowane wartości. (Odziedziczone po Freezable) |
| GetHashCode() |
Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject) |
| GetLocalValueEnumerator() |
Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| GetValue(DependencyProperty) |
Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnChanged() |
Wywoływana, gdy bieżący Freezable obiekt jest modyfikowany. (Odziedziczone po Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Zapewnia, że dla elementu członkowskiego danych, który właśnie został ustawiony, są ustanawiane DependencyObjectType odpowiednie wskaźniki kontekstu. (Odziedziczone po Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Zastępuje implementację DependencyObject elementu OnPropertyChanged(DependencyPropertyChangedEventArgs) , aby również wywoływać wszelkie Changed procedury obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable) |
| ReadLocalValue(DependencyProperty) |
Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject) |
| ReadPreamble() |
Zapewnia dostęp do obiektu Freezable z prawidłowego wątku. Dziedziczenie Freezable elementu musi wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject) |
| SetValue(DependencyProperty, Object) |
Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject) |
| ToString() |
Tworzy reprezentację ciągu modelu Model3D. (Odziedziczone po Model3D) |
| ToString(IFormatProvider) |
Tworzy reprezentację ciągu modelu Model3D. (Odziedziczone po Model3D) |
| VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
| WritePostscript() |
Changed Wywołuje zdarzenie dla klasy Freezable i wywołuje jego OnChanged() metodę. Klasy pochodzące z Freezable klasy powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable) |
| WritePreamble() |
Sprawdza, czy element Freezable nie jest zamrożony i czy jest on uzyskiwany z prawidłowego kontekstu wątkowego. Freezable dziedziczenie powinno wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje dane członkom, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
Zdarzenia
| Changed |
Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable) |
Jawne implementacje interfejsu
| IFormattable.ToString(String, IFormatProvider) |
Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu. (Odziedziczone po Model3D) |
