Zoom-Methode

[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.]

Hinweis

Diese Komponente ist für die Verwendung in den Betriebssystemen Microsoft Windows 2000, Windows XP und Windows Server 2003 verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden.

 

Die Zoom -Methode zoomt die Videoanzeige ein- oder heraus, zentriert auf eine bestimmte Gruppe von Bildschirmkoordinaten.

MSWebDVD.Zoom(iXPos, iYPos, iZoomRatio)

Parameter

iXPos

Gibt die x-Koordinate in der Mitte des rechteckigen Zoombereichs als Integer an.

iYPos

Gibt die y-Koordinate in der Mitte des Rechtecks an, die als Integer vergrößert werden soll.

iZoomRatio

Gibt den Vergrößerungsfaktor an, der auf den aktuellen Zoomwert als Integer angewendet wird. Der maximale Gesamtwert hängt davon ab, was die Hardwareüberlagerung unterstützen kann. Dies ist in der Regel ein Faktor von 32 bis 64 mal der ursprünglichen Größe.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Das neue Zoomverhältnis bleibt wirksam, bis es auf die ursprüngliche Größe wiederhergestellt oder erneut geändert wird. Mit anderen Worten, zwei Aufrufe dieser Methode, die einen iZoomRatio von zwei angeben, führen zu einem viermal größeren Zoomverhältnis als die ursprüngliche Videogröße. Wenn der Benutzer versucht, über das zu zoomen, was die Hardware unterstützen kann, wird diese Methode erfolgreich, aber nichts tun.

Die SetClipVideoRect-Methode ist eine weitere Möglichkeit zum Vergrößern. der einzige Unterschied zwischen den beiden Methoden ist die Art und Weise, in der das Zoomrechteck angegeben wird.