KSPROPERTY_CAMERACONTROL_PAN
Benutzermodusclients verwenden die KSPROPERTY_CAMERACONTROL_PAN-Eigenschaft , um die Schwenkeinstellung 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 Schwenkeinstellung einer Kamera angibt. Dieser Wert wird in Grad ausgedrückt.
Positive Werte zeigen an, dass die Kamera im Uhrzeigersinn gedreht wird. Negative Werte geben an, dass die Kamera gegen den Uhrzeigersinn gedreht wird, wie in der folgenden Abbildung gezeigt.
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 zwischen -180 und +180 liegen. Der Standardwert muss 0 sein.
Achtung
Beim Schreiben oder Testen einer App sollten Sie beachten, dass in der Praxis einige Treiber einen benutzerdefinierten Bereich von Schwenkwerten und benutzerdefinierten Schrittwerten definieren, die möglicherweise nicht auf typischen Einheiten basieren. Treiber können das Schwenksteuerelement entweder physisch oder digital implementieren.
Bemerkungen
Das Value-Element der KSPROPERTY_CAMERACONTROL_S-Struktur gibt die Schwenkeinstellung an.
Bei Kameras, die die Plattform-DMFT für gesichtsbasierte 3A verwenden, wirkt sich das Pan-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 Schwenk-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)