En-tête de données RAW WIA

L’en-tête des données RAW est le suivant :

DWORD Tag;         // must contain 'WRAW' (single byte ASCII characters)
DWORD Version;        // must contain 0x00010000
DWORD HeaderSize;       // contains amount of valid bytes in header
DWORD XRes;              // X (horizontal) resolution, in DPI
DWORD YRes;              // Y (vertical) resolution, in DPI
DWORD XExtent;           // image width, in pixels
DWORD YExtent;           // image height, in pixels
DWORD BytesPerLine;      // used only for uncompressed image data, 0 (unknown) for compressed data 
DWORD BitsPerPixel;      // number of bits per pixel (all channels)
DWORD ChannelsPerPixel;  // number of color channels (samples) within a pixel
DWORD DataType;    // current WIA_IPA_DATATYPE value describing the image
BYTE  BitsPerChannel[8]; // up to 8 channels per pixel, use as many as needed  
DWORD Compression;       // current WIA_IPA_COMPRESSION value
DWORD PhotometricInterp; // current WIA_IPS_PHOTOMETRIC_INTERP value
DWORD LineOrder;         // image line order as a WIA_LINE_ORDER value
DWORD RawDataOffset;     // offset position (in bytes, starting from 0) for the raw image data
DWORD RawDataSize;       // size of raw image data, in bytes
DWORD PaletteOffset;     // offset position (in bytes, starting from 0) for the palette (0 if none)
DWORD PaletteSize;       // size, in bytes, of color palette table (0 if no palette is required) 

Descriptions supplémentaires des champs d’en-tête

DWORD Compression
Autorise les formats bruts compressés, tels que les données compressées compressées de Nikon et les données compressées sans en-tête utilisées pour les transmissions de télécopie compressées (groupe 3.1, 3.2d, 4). Les valeurs de ce champ sont WIA_IPA_COMPRESSION constantes, éventuellement spécifiques aux fournisseurs pour les applications spécialisées. La valeur par défaut est WIA_COMPRESSION_NONE.

Compression Examples:

Les données compressées G4 (WIA_COMPRESSION_G4) peuvent être transférées dans un fichier TIFF (WiaImgFmt_TIFF) ou à l’aide du format brut (WiaImgFmt_RAW).

Les données compressées JPEG (WIA_COMPRESSION_JPEG) peuvent être transférées à l’aide du format JFIF (WiaImgFmt_JPEG), du format EEXIF (WiaImgFmt_EXIF) ou du format TIFF (WiaImgFmt_TIFF). Il n’est pas possible de transférer des données JPEG mises en forme dans l’un des formats d’échange (JFIF, EEXIF) au sein des transferts à l’aide du format brut (WiaImgFmt_RAW), au lieu de cela, il est nécessaire d’utiliser l’un des autres formats compatibles JPEG.

For more information on the WIA compression constants, see the WIA_IPA_COMPRESSION property.

DWORD PhotometricInterp
Décrit l’interprétation photométrique de l’image transférée. Ce champ est requis pour les images noir et blanc (1bpp) et gris (4bpp ou plus). Ces images doivent indiquer les valeurs pour le blanc et le noir, soit WIA_PHOTO_WHITE_1 (où le blanc est 1, noir est 0) ou WIA_PHOTO_WHITE_0 (où le blanc est 0, noir est 1). Ce champ est facultatif pour les images de couleur.

DWORD LineOrder
Décrit si les lignes/lignes des données d’image sont classées en haut en bas ou en bas vers le haut. Two new constants were defined in wiadef.h for this:

#define  WIA_LINE_ORDER_TOP_TO_BOTTOM        0x00000001 
#define  WIA_LINE_ORDER_BOTTOM_TO_TOP        0x00000002

Il n’existe aucune nouvelle propriété définie pour cela. Il ne s’agit pas d’un paramètre d’analyse configurable. LingOrder only matters when executing image data transfers.

DWORD RawDataSize
Indique la taille, en octets, des données brutes qui suivent l’en-tête (sans inclure la palette de couleurs facultative). Les applications peuvent utiliser ce champ pour vérifier l’achèvement d’un transfert d’image présumé réussi. Lorsque ces informations sont inconnues du minidriver au moment où le transfert commence (et que l’en-tête est écrit dans le flux), par exemple lorsque l’image est analysée à l’aide de la détection automatique de bordure, le minidriver doit être requis pour remplir ce champ à la fin du transfert de données d’image, comme la façon dont les champs XExtent et YExtent sont gérés.

DWORD PaletteOffset
Contient le décalage, en octets, où la palette de couleurs démarre dans le flux de données ; ce décalage démarre (à la position zéro) où se termine l’en-tête. La palette et les données d’image brutes peuvent suivre l’en-tête brut dans n’importe quel ordre et la palette peut être omise si nécessaire.

DWORD PaletteSize
Contient la taille, en octets, de la palette de couleurs. Quand aucune palette n’est requise pour être attachée aux données d’image brutes, le minidriver doit définir ce champ sur 0. Ce champ n’est pas lié au nombre d’entrées dans la palette.

Black and white and grayscale data can omit the palette (because the information required to build the palette is contained in the PhotometricInterpretation field) or supply an optimized palette along with the PhotometricInterpretation field.

For indexed images, the number of entries in the color palette is dictated by the current BitsPerPixel value (2 ^ BitsPerPixel. For example, 2 entries for 1bpp, 16 entries for 4bpp, 256 entries for 8bpp). The format of the palette entries would be dictated by the number of entries in BitsPerChannel field (the number of fields/channels in each palette entry) and BitsPerChannel values (each field would contain exactly the value specified in the BitsPerChannel field for the respective channel). Chaque champ d’entrée de palette doit être aligné sur BYTE.