D3DImage Klasa

Definicja

Przestrzeń nazw:

System.Windows.Interop

Zestaw:

PresentationCore.dll

Obiekt ImageSource , który wyświetla utworzoną przez użytkownika powierzchnię Direct3D.

public ref class D3DImage : System::Windows::Media::ImageSource

public class D3DImage : System.Windows.Media.ImageSource

type D3DImage = class
    inherit ImageSource

Public Class D3DImage
Inherits ImageSource

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

D3DImage

Przykłady

Poniższy przykład kodu pokazuje, jak zadeklarować element D3DImage w języku XAML. Należy zamapować System.Windows.Interop przestrzeń nazw, ponieważ nie jest ona uwzględniona w domyślnych przestrzeniach nazw XAML. Aby uzyskać więcej informacji, zobacz Przewodnik: hostowanie zawartości Direct3D9 w WPF.

    <Window x:Class="D3DHost.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:i="clr-namespace:System.Windows.Interop;assembly=PresentationCore"
    Title="MainWindow" Height="300" Width="300" Background="PaleGoldenrod">
    <Grid>
        <Image x:Name="imgelt">
            <Image.Source>
                <i:D3DImage x:Name="d3dimg" />
            </Image.Source>
        </Image>
    </Grid>
</Window>

Uwagi

D3DImage Użyj klasy do hostowania zawartości Direct3D w aplikacji Windows Presentation Foundation (WPF).

Wywołaj metodę Lock , aby zmienić zawartość Direct3D wyświetlaną D3DImageprzez element . Wywołaj metodę , SetBackBuffer aby przypisać powierzchnię Direct3D do elementu D3DImage. Wywołaj metodę , AddDirtyRect aby śledzić aktualizacje powierzchni Direct3D. Wywołaj metodę , Unlock aby wyświetlić zmienione obszary.

Klasa zarządza dwoma D3DImage buforami wyświetlania, które są nazywane buforem wstecznym i buforem frontu. Bufor wsteczny to powierzchnia Direct3D. Zmiany buforu wstecznego są kopiowane do buforu frontonu podczas wywoływania Unlock metody, gdzie jest ona wyświetlana na sprzęcie. Czasami bufor frontu staje się niedostępny. Ten brak dostępności może być spowodowany blokowaniem ekranu, pełnoekranowymi ekskluzywnymi aplikacjami Direct3D, przełączaniem użytkowników lub innymi działaniami systemowymi. W takim przypadku aplikacja WPF jest powiadamiana przez obsługę IsFrontBufferAvailableChanged zdarzenia. Sposób reagowania aplikacji na bufor frontowy staje się niedostępny zależy od tego, czy WPF jest włączony, aby powrócić do renderowania oprogramowania. Metoda SetBackBuffer ma przeciążenie, które przyjmuje parametr określający, czy WPF wraca do renderowania oprogramowania.

Reagowanie na niedostępny bufor frontu, gdy WPF nie wraca do renderowania oprogramowania

W przypadku wywołania przeciążenia lub wywołania SetBackBuffer(D3DResourceType, IntPtr)SetBackBuffer(D3DResourceType, IntPtr, Boolean) przeciążenia z enableSoftwareFallback ustawionym falseparametrem system renderowania zwalnia odwołanie do buforu wstecznego, gdy bufor frontu staje się niedostępny i nic nie jest wyświetlane. Gdy bufor frontu jest ponownie dostępny, system renderowania zgłasza IsFrontBufferAvailableChanged zdarzenie, aby powiadomić aplikację WPF. Możesz utworzyć procedurę obsługi zdarzeń IsFrontBufferAvailableChanged , aby ponownie uruchomić renderowanie przy użyciu prawidłowej powierzchni Direct3D. Aby ponownie uruchomić renderowanie, należy wywołać metodę SetBackBuffer.

Reagowanie na niedostępny bufor frontu, gdy WPF wraca do renderowania oprogramowania

Po wywołaniu SetBackBuffer(D3DResourceType, IntPtr, Boolean) przeciążenia z parametrem ustawionym enableSoftwareFallback na truewartość system renderowania zachowuje odwołanie do buforu wstecznego, gdy bufor frontu staje się niedostępny, więc nie trzeba wywoływać SetBackBuffer , gdy bufor frontu jest ponownie dostępny. Mogą wystąpić sytuacje, w których urządzenie użytkownika staje się niedostępne. W takim przypadku wywołaj odwołanie SetBackBuffer WPF do buforu wstecznego. Jeśli musisz zresetować urządzenie, wywołaj metodę SetBackBuffer z parametrem ustawionym backBuffer na null, a następnie wywołaj SetBackBuffer ponownie element z backBuffer ustawionym na prawidłową powierzchnię Direct3D.

Uwaga

Wydajność zależy znacznie od ustawień powierzchni Direct3D. Aby uzyskać więcej informacji, zobacz Zagadnienia dotyczące wydajności dotyczące współdziałania direct3D9 i WPF.

Uwaga

Klasa D3DImage nie wyświetla zawartości Direct3D, gdy WPF renderuje się w oprogramowaniu, na przykład za pośrednictwem połączenia pulpitu zdalnego, chyba że wywołasz SetBackBuffer(D3DResourceType, IntPtr, Boolean) i określisz true parametr enableSoftwareFallback .

Konstruktory

D3DImage()	Inicjuje nowe wystąpienie klasy D3DImage.
D3DImage(Double, Double)	Inicjuje D3DImage nowe wystąpienie klasy z określoną rozdzielczością wyświetlania.

Pola

IsFrontBufferAvailableProperty

Identyfikuje IsFrontBufferAvailable właściwość zależności.

Właściwości

CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (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)
Height	Pobiera wysokość obiektu D3DImage.
IsFrontBufferAvailable	Pobiera wartość wskazującą, czy istnieje bufor frontu.
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)
Metadata	Pobiera metadane skojarzone ze źródłem obrazu.
PixelHeight	Pobiera wysokość obiektu w pikselach D3DImage.
PixelWidth	Pobiera szerokość elementu , w pikselach D3DImage.
Width	Pobiera szerokość elementu D3DImage.

Metody

AddDirtyRect(Int32Rect)	Określa obszar zmienionego buforu wstecznego.
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 zostanie użyte 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 DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego D3DImage obiektu, 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 (które mogą już nie być rozpoznawane), ale nie animacje ani ich bieżące wartości.
CloneCore(Freezable)	Sprawia, że wystąpienie jest klonem (kopią głęboką) określonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych).
CloneCurrentValue()	Tworzy modyfikowalny klon tego D3DImage 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ą kopiowane.
CloneCurrentValueCore(Freezable)	Sprawia, że wystąpienie jest modyfikowalny klon (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości.
CoerceValue(DependencyProperty)	Coerce 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)
CopyBackBuffer()	Tworzy kopię oprogramowania elementu D3DImage.
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej D3DImage .
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Finalize()	Zwalnia zasoby i wykonuje inne operacje oczyszczania przed D3DImage odzyskaniem przez odzyskiwanie pamięci.
Freeze()	Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, D3DImage że niemodyfikowalne lub określa, czy można go niemodyfikować.
GetAnimationBaseValue(DependencyProperty)	Zwraca wartość nie animowaną określonego DependencyPropertyelementu . (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). 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ślonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych).
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)	Sprawia, że bieżące wystąpienie jest klonem zamrożonym określonego Freezableobiektu . Jeśli obiekt ma animowane właściwości zależności, są kopiowane ich bieżące animowane wartości.
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (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 w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
Lock()	Blokuje operacje D3DImage i włącza operacje w buforze wstecznym.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (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ę DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur 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()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable 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)
SetBackBuffer(D3DResourceType, IntPtr)	Przypisuje powierzchnię Direct3D jako źródło buforu wstecznego.
SetBackBuffer(D3DResourceType, IntPtr, Boolean)	Przypisuje powierzchnię Direct3D jako źródło buforu wstecznego.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego 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ślona 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ść podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Tworzy reprezentację ciągu tego obiektu na podstawie bieżącej kultury. (Odziedziczone po ImageSource)
ToString(IFormatProvider)	Tworzy reprezentację ciągu tego obiektu na podstawie przekazanego IFormatProvider elementu. Jeśli dostawca to null, CurrentCulture jest używany. (Odziedziczone po ImageSource)
TryLock(Duration)	Próbuje zablokować element D3DImage i czeka na określony czas trwania.
Unlock()	Dekrementuje liczbę blokad dla .D3DImage
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu 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 Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, 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)
IsFrontBufferAvailableChanged	Występuje, gdy IsFrontBufferAvailable właściwość ulegnie zmianie.

Jawne implementacje interfejsu

IFormattable.ToString(String, IFormatProvider)

Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu. (Odziedziczone po ImageSource)