CDrawImage-Klasse

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CDrawImage -Klasse ist eine Hilfsklasse, die die Zeichnung für einen Videorendererfilter verwaltet. Alle Zeichnungsvorgänge werden mit GDI ausgeführt. Diese Klasse bietet keine Unterstützung für das Rendern mit DirectDraw. Die CDrawImage -Klasse erfordert, dass der besitzereigene Filter auch die CBaseWindow-Klasse verwendet, die das Videofenster verwaltet. Der CDrawImage Konstruktor verwendet einen Zeiger auf das CBaseWindow-Objekt .

Das folgende Diagramm zeigt die bevorzugte Möglichkeit, diese Klasse in einem benutzerdefinierten Videorendererfilter zu verwenden.

Gehen Sie wie folgt vor, um diese Klasse zu verwenden:

• Wenn die Pins eine Verbindung herstellen, rufen Sie die Methoden CDrawImage::NotifyMediaType und CDrawImage::NotifyAllocator auf .
• Wenn sich der Medientyp ändert, rufen Sie NotifyMediaType erneut auf.
• Rufen Sie vor dem Rendern CDrawImage::SetDrawContext auf.
• Rufen Sie CDrawImage::SetSourceRect auf, wenn sich das Quellrechteck ändert, und CDrawImage::SetTargetRect , wenn sich das Zielrechteck ändert.
• Verwalten Sie die Palette für palettierte Bilder, wie im folgenden Abschnitt zu Paletten beschrieben.

Allocators

Der im vorherigen Diagramm gezeigte Filter verwendet die benutzerdefinierte Zuordnungsklasse CImageAllocator. Dieser Zuweisungsgeber erstellt DIBs im freigegebenen Arbeitsspeicher mithilfe der GDI CreateDIBSection-Funktion . Die vom Zuteilungsgeber erstellten Beispiele sind CImageSample-Objekte .

Wenn der Filter den Zuteilungsgeber für die Verbindung besitzt, sind die Medienbeispiele garantiert CImageSample-Objekte . In diesem Fall kann das CDrawImage-Objekt die Zeichnung mithilfe von BitBlt oder StretchBlt optimieren. Andernfalls müssen die langsameren Funktionen SetDIBitsToDevice oder StretchDIBits verwendet werden. Die schnellere Option wird von der CDrawImage::FastRender-Methode implementiert, die langsamere Option durch die CDrawImage::SlowRender-Methode . (Trotz des Namens werden Sie wahrscheinlich keinen großen Leistungstreffer in SlowRender sehen, insbesondere nicht auf neuerer Hardware.)

Paletten

Wenn die FastRender-Methode zum Zeichnen verwendet wird und das Bild palettisiert ist, muss der Filter die Palette wie folgt verwalten:

• Die CImageSample-Klasse enthält eine Palettenversionsnummer, die in der DIBDATA-Struktur gespeichert ist. Der Wert wird initialisiert, wenn der Zuweisungsgeber das Beispiel erstellt.
• Die CDrawImage-Klasse enthält auch eine Palettenversionsnummer, die bei der Erstellung initialisiert wird.
• Wenn sich der Medientyp in ein neues palettisiertes Format ändert, rufen Sie CDrawImage::IncrementPaletteVersion auf. Diese Methode erhöht die Palettenversionsnummer des CDrawImage-Objekts . Wenn der Filter die CImagePalette-Klasse verwendet, um die Paletteninformationen zu verwalten, können Sie einfach CImagePalette::P reparePalette aufrufen, wenn sich der Medientyp ändert. Die PreparePalette-Methode erhöht die Palettenversion nur bei Bedarf.
• Die FastRender-Methode vergleicht die CDrawImage-Palettenversion mit der Palettenversion des Beispiels. Wenn die Versionsnummer des Beispiels hinter der CDrawImage-Versionsnummer zurückbleibt, ruft die FastRender-MethodeCDrawImage::UpdateColourTable auf. Die UpdateColourTable-Methode legt die Farbtabelle im Gerätekontext mithilfe der GDI SetDIBColorTable-Funktion fest. Außerdem wird die Palettenversion des Beispiels auf die aktuelle Versionsnummer aktualisiert.
• Wenn der Pin wieder verbunden wird, sollte der Filter CDrawImage::ResetPaletteVersion aufrufen, um die Palettenversion zurückzusetzen. Beim Erneuten Herstellen der Pinverbindung weist der Zuteilungsgeber alle Beispiele neu zu.

Anforderungen