KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

Die KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL-Eigenschafts-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.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Filter

Asynchron, abbrechbar

Um die aktuellen ROI-Einstellungen vom Treiber abzurufen oder die ROI-Einstellungen zu konfigurieren und die gewünschte Verarbeitung (3As) anzuwenden, wird das KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL erweiterte Eigenschaftssteuerelement zusammen mit einer Standard-KSCAMERA_EXTENDEDPROP_HEADER-Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER-Struktur gefolgt von einer KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL strukturieren und dann 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.

Member BESCHREIBUNG

Version

Dies muss 1 sein,

PinId

Dies muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE sein (0xFFFFFFFF),

Size

Für den ersten GET-Aufruf (wenn noch 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-Steuerelementheadernutzlast 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 durchgeführt wurde, muss dies 0 sein. Der Wert 0 gibt an, dass für alle konfigurierten ISP-Steuerelemente keine Fehler erkannt wurden.

Funktion

Dies muss ein bisschen weise oder von KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL und KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE sein.

Flags

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

Aspekte des anpassbaren Ausgabefensters

Die an die Kamera gesendeten 3A-ROI-Koordinaten werden relativ zum aktuellen Ausgabefenster der Kamera gesendet. Wenn das Sichtfeld aufgrund der Verwendung eines Steuerelements wie Zoom, Schwenken oder Kippen oder Digitalfenster geändert wurde, ist die Kamera (oder Komponente, die das Digital Window/PTZ-Steuerelement implementiert) für die Zuordnung der bereitgestellten Koordinaten 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 die Änderung des Sichtfelds erfolgt, muss die Koordinatenzuordnung möglicherweise bidirektional sein. Wenn eine Kamera beispielsweise das DMFT der Windows-Plattform für die Gesichtserkennung verwendet, aber 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 die Kamera gesendet werden. an eine App gesendet wird, die sie anfordert.

Anforderungen

Header

Ksmedia.h