Freigeben über

KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

  • Artikel

Die KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL Eigenschaften-ID, die in der KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY Enumeration definiert ist, wird verwendet, um die ROI-Einstellungen abzurufen oder zu konfigurieren und die gewünschte Verarbeitung anzuwenden.

Zusammenfassungstabelle für die Verwendung

Umfang Steuerung Art

Version 1

Filter

Asynchron, abbrechend

Um die aktuellen ROI-Einstellungen vom Treiber zu erhalten oder die ROI-Einstellungen zu konfigurieren und die gewünschte Verarbeitung anzuwenden (3As), wird das KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL erweiterte Eigenschaftensteuerelement zusammen mit einer standard-KSCAMERA_EXTENDEDPROP_HEADER Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL Struktur und dann an den Treiber gesendet. durch eine oder mehrere entsprechende ISP-spezifische Steuerungsnutzlaststrukturen. Die folgende Liste veranschaulicht ein Datenstrukturlayout mit einem Fokus-ROI und zwei Belichtungs-ROIs.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Fokus)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Exposition mit 2 ROIs)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung der KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL Eigenschaft des erweiterten ROI-Steuerelements.

Mitglied Beschreibung

Version

Dies muss 1 sein,

PinId

Dies muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) sein.

Größe

Für den anfänglichen GET-Aufruf (wenn kein SET-Aufruf stattgefunden hat) muss dies sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER) sein. Darüber hinaus muss der Treiber 0 innerhalb von ControlCount in seiner ISO-Steuerheadernutzlast zurückgeben.

Bei anderen SET- oder GET-Aufrufen muss dies sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount(focus) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(exposure) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance) sein.

Ergebnis

Dies gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang ausgeführt wurde, muss dies 0 sein. Der Wert 0 gibt an, dass für alle konfigurierten ISP-Steuerelemente keine Fehler erkannt wurden.

Fähigkeit

Dies muss ein bisschen klug oder KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL und KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLEsein.

Flaggen

Dies ist ein Lese-/Schreibfeld. Dies kann für einen SET-Aufruf KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION werden. Dies muss 0 für einen GET-Aufruf sein.

Überlegungen zum anpassbaren Ausgabefenster

Die 3A ROI-Koordinaten, die an die Kamera gesendet werden, werden relativ zum aktuellen Ausgabefenster der Kamera gesendet. Wenn das Ansichtsfeld aufgrund der Verwendung eines Steuerelements wie Zoom, Schwenken oder Kippen oder digitalen Fenstersgeändert wurde, ist die Kamera (oder Komponente, die das Steuerelement "Digital Window/PTZ" implementiert) für die Zuordnung der bereitgestellten Koordinaten zurück zum vollständigen Sichtfeld des Sensors verantwortlich, wobei das aktuelle Ausgabefenster berücksichtigt wird, um sicherzustellen, dass der 3A-Algorithmus der Kamera auf die richtige Stelle ausgerichtet ist. Je nachdem, wo das Ansichtsfeld geändert wird, muss die Koordinatenzuordnung möglicherweise bidirektional sein. Wenn beispielsweise eine Kamera die Windows-Plattform-DMFT für die Gesichtserkennung verwendet, das Feld der Ansichtsänderung jedoch in einer Komponente implementiert wird, nachdem die Plattform-DMFT in der Treiberkette bereitgestellt wurde, müssen die von der Anwendung bereitgestellten ROI-Koordinaten wieder dem vollständigen Ansichtsfeld zugeordnet werden, bevor sie an die Kamera gesendet werden und ROI-Koordinaten, die in der Plattform-DMFT berechnet werden, dem geänderten Ansichtsfeld zugeordnet werden müssen, bevor sie an eine App gesendet, die sie anfordert.

Anforderungen

Kopfball

 Ksmedia.h