KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
L’ID de propriété KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL défini dans l’énumération KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY permet d’obtenir ou de configurer les paramètres de retour sur investissement et d’appliquer le traitement souhaité.
Tableau récapitulatif de l’utilisation
| Étendue | Control | Type |
|---|---|---|
version 1 |
Filtrer |
Asynchrone, Annulable |
Pour obtenir les paramètres de retour sur investissement actuels à partir du pilote ou pour configurer les paramètres roi et appliquer le traitement souhaité (3A), le contrôle de propriété étendu KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL est envoyé au pilote avec une structure de KSCAMERA_EXTENDEDPROP_HEADER standard suivie d’une structure de KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER suivie d’uneKSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL structure, puis par une ou plusieurs structures de charge utile de contrôle spécifiques aux FAI correspondantes. La liste suivante illustre une disposition de structure de données avec un retour sur investissement focus et deux URI d’exposition.
KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Focus)
KSCAMERA_EXTENDEDPROP_ROI_FOCUS
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (Exposition avec 2 ROIs)
KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)
KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)
Le tableau ci-dessous contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL du contrôle ROI étendu.
| Membre | Description |
|---|---|
Version |
Cela doit être 1, |
PinId |
Cela doit être KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF), |
Taille |
Pour l’appel GET initial (lorsqu’aucun appel SET n’a jamais eu lieu), il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER). En outre, le pilote doit retourner 0 dans ControlCount dans sa charge utile d’en-tête de contrôle ISO. Pour tout autre appel SET ou GET, il doit s’agir de 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(exposition) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance). |
Résultats |
Cela indique les résultats d’erreur de la dernière opération SET. Si aucune opération SET n’a eu lieu, il doit s’agir de 0. La valeur 0 indique qu’aucune erreur n’a été détectée pour tous les contrôles ISP configurés. |
Fonctionnalité |
Il doit s’agir d’un OR un peu sage de KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL et KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE. |
Indicateurs |
Il s’agit d’un champ en lecture/écriture Il peut être KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION pour un appel SET. Cette valeur doit être 0 pour un appel GET. |
Considérations relatives à la fenêtre de sortie réglable
Les coordonnées de retour sur investissement 3A envoyées à la caméra sont envoyées par rapport à la fenêtre de sortie actuelle de l’appareil photo. Si le champ d’affichage a été modifié en raison de l’utilisation d’un contrôle tel que Zoom, Panoramique ou Inclinaison ou Fenêtre numérique, l’appareil photo (ou le composant implémentant le contrôle Fenêtre numérique/PTZ) est chargé de mapper les coordonnées fournies au champ de vue complet du capteur, en prenant en considération la fenêtre de sortie actuelle pour s’assurer que l’algorithme 3A de l’appareil photo cible l’emplacement approprié. Selon l’emplacement où la modification du champ d’affichage se produit, le mappage de coordonnées peut devoir être bidirectionnel. Par exemple, si une caméra utilise le DMFT de la plateforme Windows pour la détection des visages, mais que la modification du champ de vue est implémentée dans un composant après le DMFT de la plateforme dans la chaîne de pilotes, les coordonnées de retour sur investissement fournies par l’application doivent être mappées au champ de vue complet avant d’être envoyées à la caméra, et les coordonnées de retour sur investissement calculées dans le DMFT de la plateforme doivent être mappées au champ d’affichage modifié avant d’être mappées au champ d’affichage modifié avant d’être envoyées à la caméra. envoyé à une application qui les demande.
Configuration requise
En-tête |
Ksmedia.h |