Freigeben über


KSPROPERTY_CAMERACONTROL_ZOOM

Benutzermodusclients verwenden die KSPROPERTY_CAMERACONTROL_ZOOM-Eigenschaft , um die Zoomeinstellung einer Kamera abzurufen oder festzulegen. Diese Eigenschaft ist optional.

Nutzungszusammenfassungstabelle

Herunterladen Set Ziel Eigenschaftsdeskriptortyp Eigenschaftswerttyp
Ja Ja Filtern oder Knoten KSPROPERTY_CAMERACONTROL_S oder KSPROPERTY_CAMERACONTROL_NODE_S LONG

Der Eigenschaftswert (Vorgangsdaten) ist ein LONG-Wert, der die Zoomeinstellung einer Kamera angibt. Dieser Wert wird in Millimetern ausgedrückt.

Achtung

Beim Schreiben oder Testen einer App sollten Sie beachten, dass in der Praxis einige Treiber einen benutzerdefinierten Bereich von Zoomwerten und benutzerdefinierten Schrittwerten definieren, die möglicherweise nicht auf typischen Einheiten basieren. Treiber können das Zoomsteuerelement entweder physisch oder digital implementieren.

Bemerkungen

Das Value-Element der KSPROPERTY_CAMERACONTROL_S-Struktur gibt den Zoom an.

Jeder Videoaufnahme-Minidriver, der diese Eigenschaft unterstützt, muss einen Bereich und standardwert für diese Eigenschaft definieren. Der Bereich für das Gerät muss 10 bis 600 sein. Der Standardwert muss 10 sein.

Bei Kameras, die die Plattform-DMFT für gesichtsbasierte 3A verwenden, wirkt sich das Zoom-Steuerelement auf das Ausgabefenster der Kamera aus. Die vom Plattform-DMFT erzeugten Gesichtskoordinaten sind relativ zu diesem geänderten Ausgabefenster, sodass die Kamera für die Neuzuordnung der ROI-Koordinaten in das vollständige Sichtfeld der Kamera verantwortlich ist, wenn das aktuelle Sichtfeld durch das Zoom-Steuerelement geändert wird. Je nachdem, wo die Änderung des Sichtfelds erfolgt, muss die Koordinatenzuordnung möglicherweise bidirektional sein. Wenn beispielsweise die Änderung des Sichtfelds in einer Komponente nach dem Plattform-DMFT in der Treiberkette implementiert wird, müssen die von der Anwendung bereitgestellten ROI-Koordinaten dem vollständigen Sichtfeld zugeordnet werden, bevor sie an die Kamera gesendet werden, und roi-Koordinaten, die in der Plattform-DMFT berechnet werden, müssen dem geänderten Sichtfeld zugeordnet werden, bevor sie an eine App gesendet werden, die sie anfordert.

Anforderungen

Header: ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSPROPERTY

KSPROPERTY_CAMERACONTROL_S