WIA_IPA_DATATYPE
La propriété WIA_IPA_DATATYPE contient le paramètre de type de données actuel pour un appareil. Un minidriver WIA crée et gère cette propriété.
Type de propriété : VT_I4
Valeurs valides : WIA_PROP_LIST
Droits d’accès : lecture/écriture
Remarques
Une application lit la propriété WIA_IPA_DATATYPE pour déterminer le type de données d’une image. L’application écrit cette propriété pour définir le type de données actuel de l’image sur le point d’être transférée.
Le tableau suivant décrit les constantes valides avec WIA_IPA_DATATYPE lorsque la propriété WIA_IPA_FORMAT n’est pas définie sur WiaImgFmt_RAW.
| Type de données | Description |
|---|---|
| WIA_DATA_AUTO | Cette valeur est valide pour tous les éléments de source de données d’image programmables, y compris le lit plat et le chargeur. Lorsque cette valeur est prise en charge par le mini-pilote WIA, le client d’application WIA peut définir : WIA_IPA_DATATYPE afin d’activer la détection automatique des couleurs sur l’appareil. Lorsque WIA_DATA_AUTO est défini, le mini-pilote WIA doit mettre à jour WIA_IPA_DEPTH sur le même élément pour WIA_DEPTH_AUTO (qui doit être une valeur prise en charge si l’appareil prend en charge la couleur automatique). Lorsque la valeur WIA_IPA_DEPTH WIA_DEPTH_AUTO est prise en charge, la valeur WIA_IPA_DATATYPE WIA_DATA_AUTO n’est plus facultative et devient une valeur obligatoire. |
| WIA_DATA_COLOR | Les données d’analyse sont rouge-vert-bleu (RVB). Le format de couleur complète est décrit à l’aide des propriétés WIA suivantes : WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PLANAR WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES |
| WIA_DATA_COLOR_DITHER | Identique à WIA_DATA_COLOR, sauf que les données sont tramées à l’aide du modèle de trame actuellement sélectionné. |
| WIA_DATA_COLOR_THRESHOLD | Données de seuil de couleur. |
| WIA_DATA_DITHER | Les données d’analyse sont tramées à l’aide du modèle de trame actuellement sélectionné. |
| WIA_DATA_GRAYSCALE | Les données d’analyse représentent l’intensité. La palette est une nuance de gris fixe, également espacée, avec une profondeur que la propriété WIA_IPA_DEPTH spécifie. |
| WIA_DATA_THRESHOLD | Le seuil est d’un bit par pixel de données en noir et blanc. Les données sur la valeur actuelle de WIA_IPS_THRESHOLD sont converties en blanc ; les données sous cette valeur sont converties en noir. |
La propriété WIA_IPA_DATATYPE est également utilisée pour décrire le type de transfert de données RAW à utiliser lorsque l’application affecte à la propriété WIA_IPA_FORMAT la valeur WiaImgFmt_RAW. Le pilote doit définir la propriété WIA_IPA_DATATYPE sur une liste de valeurs autorisées à partir de laquelle l’application peut choisir.
Le tableau suivant répertorie les constantes valides avec WIA_IPA_DATATYPE lorsque WIA_IPA_FORMAT est défini sur WiaImgFmt_RAW.
| Type de données | Description |
|---|---|
| WIA_DATA_GRAYSCALE | Les données d’analyse représentent l’intensité. La palette est une nuance de gris fixe, également espacée, avec une profondeur que la propriété WIA_IPA_DEPTH spécifie. WIA_IPA_RAW_BITS_PER_CHANNEL propriété doit avoir la valeur 1. |
| WIA_DATA_RAW_BGR | Les données d’analyse se situent dans l’espace de couleurs BGR (bleu-vert-rouge). Le format de couleur complète est décrit à l’aide des propriétés WIA suivantes : WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 3. |
| WIA_DATA_RAW_CMY | Les données d’analyse sont dans l’espace colorimétrique cyan-magenta-jaune (CMY). Le format en couleur complète est décrit à l’aide des mêmes propriétés WIA que celles répertoriées pour WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 3. |
| WIA_DATA_RAW_CMYK | Les données d’analyse se situent dans l’espace colorimétrique cyan-magenta-jaune-noir (CMJN). Le format en couleur complète est décrit à l’aide des mêmes propriétés WIA que celles répertoriées pour WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 4. |
| WIA_DATA_RAW_RGB | Les données d’analyse se situent dans l’espace colorimétrique rouge-vert-bleu (RVB). Le format en couleur est décrit à l’aide des mêmes propriétés WIA que dans WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 3. |
| WIA_DATA_RAW_YUV | Les données d’analyse se situent dans l’espace de couleurs luminance-bleu différence-rouge (YUV). Le format en couleur complète est décrit à l’aide des mêmes propriétés WIA que celles répertoriées pour WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 3. |
| WIA_DATA_RAW_YUVK | Les données d’analyse se situent dans l’espace de couleurs luminance-blue difference-red difference-black (YUVK). Le format en couleur complète est décrit à l’aide des mêmes propriétés WIA que celles répertoriées pour WIA_DATA_RAW_BGR. WIA_IPA_RAW_BITS_PER_CHANNEL doit avoir la valeur 4. |
Si vous pouvez définir l’appareil sur une seule valeur, créez un type WIA_PROP_LIST et placez-y la valeur valide.
Vérifiez la propriété WIA_IPA_DEPTH pour déterminer la profondeur de bits.
La propriété WIA_IPA_DATATYPE contient généralement une valeur unique pour les caméras.
Configuration requise
En-tête : wiadef.h (inclure Wiadef.h)