KSPROPERTY_CAMERACONTROL_PAN
Les clients en mode utilisateur utilisent la propriété KSPROPERTY_CAMERACONTROL_PAN pour obtenir ou définir le paramètre panoramique d’une caméra. Cette propriété est facultative.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtre ou nœud | KSPROPERTY_CAMERACONTROL_S ou KSPROPERTY_CAMERACONTROL_NODE_S | LONG |
La valeur de propriété (données d’opération) est une valeur LONG qui spécifie le paramètre panoramique d’une caméra. Cette valeur est exprimée en degrés.
Les valeurs positives indiquent que la caméra est pivotée dans le sens des aiguilles d’une montre. Les valeurs négatives indiquent que la caméra est pivotée dans le sens inverse des aiguilles d’une montre, comme illustré dans l’illustration suivante.
Chaque minidriver de capture vidéo qui prend en charge cette propriété doit définir une plage et une valeur par défaut pour cette propriété. La plage de l’appareil doit être comprise entre -180 et +180. La valeur par défaut doit être 0.
Attention
Lorsque vous écrivez ou testez une application, vous devez savoir qu’en pratique, certains pilotes définissent une plage personnalisée de valeurs panoramiques et de valeurs d’étape personnalisées qui peuvent ne pas être basées sur des unités classiques. Les pilotes peuvent implémenter le contrôle panoramique physiquement ou numériquement.
Notes
Le membre Value de la structure KSPROPERTY_CAMERACONTROL_S spécifie le paramètre panoramique.
Pour les caméras utilisant le DMFT de plateforme pour les visages 3A, le contrôle Panoramique a un impact sur la fenêtre de sortie de la caméra. Les coordonnées de visage produites par le DMFT de la plateforme seront relatives à cette fenêtre de sortie modifiée, de sorte que la caméra est chargée de remapper les coordonnées roi sur le champ de vision complet de la caméra lorsque le champ de vue actuel est modifié par le contrôle Panoramique. Selon l’endroit où la modification du champ de vue se produit, le mappage de coordonnées peut avoir besoin d’être bidirectionnel. Par exemple, si 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 vision complet avant de les envoyer à la caméra et les coordonnées de retour sur investissement calculées dans le DMFT de plateforme doivent être mappées au champ de vue modifié avant d’être envoyées à une application qui les demande.
Spécifications
En-tête : ksmedia.h (include Ksmedia.h)