Constantes de propriété d’appareil photo
Les périphériques matériels d’acquisition d’images Windows (WIA) ont des valeurs de propriété qui sont stockées dans le Registre Windows. Pour plus d’informations, consultez Constantes de propriété d’appareil courantes.
Les constantes de propriété d’appareil suivantes, avec leurs chaînes associées, sont spécifiques aux appareils photo numériques. Le préfixe « WIA_DPC_ » indique une propriété d’appareil pour les caméras et est la convention de nommage utilisée en C/C++. À des fins de script, ces constantes utilisent le préfixe « CameraDevice » et font partie du type énuméré WiaItemPropertyId . Le nom de membre correspondant de cette énumération de script apparaît entre parenthèses en regard du nom de la constante C/C++ dans la liste suivante.
Notes
WIA ne prend pas en charge les caméras dans Windows Vista ou version ultérieure. Pour ces versions de Windows, utilisez l’API WpD (Windows Portable Device) décrite dans le Kit de développement de pilotes Windows (DDK) pour acquérir des images à partir de caméras.
| Constante/valeur | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nombre de photos prises par l’appareil photo. Le minidriver crée et gère cette propriété. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Nombre de photos pouvant être prises, en fonction des paramètres de propriété actuels. Si ces paramètres changent et que les modifications affectent la taille des images produites par l’appareil photo, le minidriver WIA doit mettre à jour le nombre d’images restantes. Le minidriver crée et gère cette propriété. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Indique le mode d’exposition actuel de l’appareil photo. Une application modifie cette propriété pour contrôler le mode d’exposition de l’appareil photo. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les sept constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Permet d’ajuster le point de set du contrôle d’exposition automatique de l’appareil photo numérique. Par exemple, un paramètre de zéro ne modifie pas le niveau d’exposition automatique de l’ensemble d’usine. Les unités sont en « arrêts » qui sont mis à l’échelle d’un facteur de 1 000, afin d’autoriser les valeurs d’arrêt fractionnaires. Un paramètre de 2000 correspond à deux arrêts d’exposition plus (quatre fois plus d’énergie sur le capteur), ce qui donne des images plus lumineuses. Un paramètre de -1000 correspond à une exposition en moins d’un arrêt (la moitié de l’énergie sur le capteur) produisant des images plus sombres. Les valeurs de paramètre se trouvent dans les unités APEX (Additive System of Photographic Exposure). Cette propriété peut être exprimée sous la forme d’une liste ou d’une plage de valeurs. Cette propriété est généralement utilisée uniquement lorsque la propriété WIA_DPC_EXPOSURE_MODE de l’appareil est définie sur EXPOSUREMODE_MANUAL. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST |
||||||||||||||||
|
Correspond à la vitesse d’obturation, en secondes qui sont mises à l’échelle de 10 000. En règle générale, l’appareil utilise cette propriété uniquement lorsque la propriété WIA_DPC_EXPOSURE_MODE est définie sur EXPOSUREMODE_MANUAL ou EXPOSUREMODE_SHUTTER_PRIORITY. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_RANGE ou WIA_PROP_LIST |
||||||||||||||||
|
Correspond à l’ouverture de l’objectif, en unités du nombre f-stop mis à l’échelle de 100. Le paramètre de cette propriété n’est généralement valide que lorsque la propriété WIA_DPC_EXPOSURE_MODE est définie sur EXPOSUREMODE_MANUAL ou EXPOSUREMODE_APERTURE_PRIORITY. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST |
||||||||||||||||
|
Définit le paramètre de mode flash actuel pour l’appareil photo. Le pilote de périphérique énumère les valeurs prises en charge de cette propriété. Une application écrit cette propriété pour définir le mode flash de l’appareil photo. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les six constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Définit le paramètre de mode focus actuel pour l’appareil photo. Le pilote de périphérique énumère les valeurs prises en charge de cette propriété. Une application écrit cette propriété pour définir le mode focus pour l’appareil photo. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Définit la source d’alimentation actuelle pour l’appareil photo. Une application lit cette propriété pour déterminer la source d’alimentation utilisée par la caméra. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE Le tableau suivant contient les deux constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Pourcentage d’alimentation de la batterie restante pour faire fonctionner l’appareil photo. Cette valeur doit être un entier compris entre 0 et 100. Une application lit cette propriété pour déterminer l’autonomie de la batterie restante de l’appareil photo. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Largeur, en pixels, d’une image miniature à utiliser pour les images nouvellement capturées. Une application lit cette valeur pour obtenir une taille estimée pour l’affichage des miniatures dans son interface utilisateur. Type : VT_I4, Access : Lecture/écriture (WIA_PROP_LIST) ou Lecture seule (WIA_PROP_NONE), Valeurs valides : WIA_PROP_LIST ou WIA_PROP_NONE |
||||||||||||||||
|
Largeur, en pixels, d’une image miniature à utiliser pour les images nouvellement capturées. Une application lit cette valeur pour obtenir une taille estimée pour l’affichage des miniatures dans son interface utilisateur. Type : VT_I4, Access : Lecture/écriture (WIA_PROP_LIST) ou Lecture seule (WIA_PROP_NONE), Valeurs valides : WIA_PROP_LIST ou WIA_PROP_NONE |
||||||||||||||||
|
Largeur en pixels à utiliser pour les images nouvellement capturées. La liste des valeurs valides pour cette propriété a une correspondance un-à-un avec la liste des valeurs valides pour la propriété WIA_DPC_PICT_HEIGHT . Si la largeur et la hauteur individuelles sont linéaires et orthogonales les unes par rapport aux autres, elles peuvent être exprimées sous forme de plage. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Hauteur en pixels à utiliser pour les images nouvellement capturées. La liste des valeurs valides pour cette propriété a une correspondance un-à-un avec la liste des valeurs valides pour la propriété WIA_DPC_PICT_WIDTH . Si la largeur et la hauteur individuelles sont linéaires et orthogonales les unes par rapport aux autres, elles peuvent être exprimées sous forme de plage. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Conçu pour être approximativement linéaire en ce qui concerne la qualité de l’image perçue sur une large gamme de contenu de scène, et il contient une plage ou une liste d’entiers. Des entiers plus petits sont utilisés pour représenter une qualité inférieure (c’est-à-dire une compression maximale), tandis que des entiers plus grands sont utilisés pour représenter une qualité supérieure (c’est-à-dire une compression minimale). Tous les paramètres disponibles sur un appareil sont relatifs uniquement à cet appareil et sont donc spécifiques à l’appareil. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Réservé, n’utilisez pas. Type : VT_I4, Access : Lecture seule, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Temps, en millisecondes, entre les captures d’images dans une opération de capture time-lapse. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Nombre d’images que l’appareil tente de capturer au cours d’une capture time-lapse. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Temps, en millisecondes, entre les captures d’images pendant une opération de rafale. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Nombre d’images que l’appareil tente de capturer pendant une opération de rafale. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE, WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Spécifie le mode d’acquisition d’image spécial de l’appareil photo. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Rapport de zoom effectif de l’image acquise de l’appareil photo numérique, mis à l’échelle d’un facteur 10. La valeur 10 correspond à l’absence de zoom numérique (1X), qui est la taille de scène standard capturée par l’appareil photo. La valeur 20 correspond à un zoom 2X, où le quart de la taille de la scène standard est capturé par l’appareil photo. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Netteté perçue d’une image capturée. Cette propriété peut utiliser une liste de valeurs ou une plage de valeurs. La valeur minimale représente la moindre netteté, tandis que la valeur maximale représente la netteté maximale. En règle générale, une valeur située au milieu de la plage représente une netteté normale ou par défaut. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Contraste perçu d’une image capturée. Cette propriété peut contenir une liste de valeurs ou une plage de valeurs. La valeur minimale prise en charge représente le moins de contraste, tandis que la valeur maximale représente le contraste le plus élevé. En règle générale, une valeur au milieu de la plage représente un contraste normal ou par défaut. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Définit le mode de capture d’image. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les trois constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Valeur représentant le délai, en millisecondes, qui doit être inséré entre le déclencheur de capture et l’initiation réelle de la capture. Cette propriété n’est pas destinée à être utilisée pour décrire le temps entre les trames pour les captures à initiation unique, telles que le burst ou le time lapse, qui ont des propriétés d’intervalle distinctes WIA_DPC_BURST_INTERVAL et WIA_DPC_TIMELAPSE_INTERVAL. Dans ces cas, il sert toujours de délai initial avant que la première image de la série soit capturée, indépendamment du temps entre les images. Pour aucun délai de précapture, cette propriété doit être définie sur zéro. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Permet l’émulation des paramètres de vitesse du film sur un appareil photo numérique. Les paramètres correspondent aux désignations ISO (ASA/DIN). En règle générale, un appareil prend en charge les valeurs énumérées discrètes, mais un contrôle continu sur une plage de valeurs est possible. La valeur 0xFFFF correspond au paramètre ISO automatique. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Spécifie le mode utilisé par la caméra pour ajuster automatiquement le paramètre d’exposition. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST
|
||||||||||||||||
|
Spécifie le mode utilisé par la caméra pour ajuster automatiquement le focus. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Le tableau suivant contient les deux constantes qui sont valides avec cette propriété.
|
||||||||||||||||
|
Distance, en millimètres, entre le plan de capture d’image de l’appareil photo numérique et le point de focus. Une valeur de 0xFFFF correspond à un paramètre supérieur à 655 mètres. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST ou WIA_PROP_RANGE |
||||||||||||||||
|
Longueur focale équivalente à 35 mm. Les valeurs de cette propriété correspondent à la longueur focale en millimètres multipliée par 100. La longueur focale détermine le zoom optique. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Chaîne Unicode terminée par null qui représente le gain rouge, vert et bleu appliqué aux données d’image, respectivement. Par exemple, « 4:25:50 » représente un gain rouge de 4, un gain vert de 25 et un gain bleu de 50. Type : VT_BSTR, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Spécifie la façon dont l’appareil photo numérique pèse les canaux de couleur. Type : VT_I4, Access : Lecture/écriture, Valeurs valides : WIA_PROP_LIST Voici la liste des valeurs possibles pour cette propriété.
|
||||||||||||||||
|
Décrit une URL. L’URL décrite par cette proroperty est celle vers laquelle les images ou les objets, une fois acquis à partir de l’appareil, peuvent être chargés, selon l’un des scénarios suivants.
Microsoft Windows ne charge pas d’images par lui-même. Type : VT_BSTR, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Nom du propriétaire (qui est l’utilisateur actuel) de l’appareil. L’appareil utilise cette propriété pour remplir le champ Artiste dans chaque image EXIF qu’il capture. Type : VT_BSTR, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
||||||||||||||||
|
Notification de copyright. L’appareil utilise cette propriété pour remplir le champ Copyright dans chaque image EXIF qu’il capture. Type : VT_BSTR, Access : Lecture/écriture, Valeurs valides : WIA_PROP_NONE |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête |
|