Заголовок данных RAW WIA

Заголовок для необработанных данных выглядит следующим образом:

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) 

Дополнительные описания полей заголовка

DWORD Compression
Позволяет сжатым необработанным форматам, таким как сжатые NEF Nikon и сжатые данные без заголовков, используемые для сжатых передач факсов (группа 3.1, 3.2d, 4). Значения этого поля будут WIA_IPA_COMPRESSION константами, возможно, конкретным поставщиком для специализированных приложений. Значение по умолчанию — WIA_COMPRESSION_NONE.

Compression Examples:

Сжатые данные G4 (WIA_COMPRESSION_G4) можно передать в TIFF-файле (WiaImgFmt_TIFF) или с помощью необработанного формата (WiaImgFmt_RAW).

Сжатые данные JPEG (WIA_COMPRESSION_JPEG) можно передать либо с помощью формата JFIF (WiaImgFmt_JPEG), формата EEXIF (WiaImgFmt_EXIF), либо формата TIFF (WiaImgFmt_TIFF). Невозможно передать данные JPEG в одном из форматов обмена (JFIF, EEXIF) в рамках передачи с помощью необработанного формата (WiaImgFmt_RAW) — вместо этого необходимо использовать один из других форматов, совместимых с JPEG.

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

DWORD PhotometricInterp
Описывает интерпретацию фотометрики для передаваемого изображения. Это поле требуется для изображений черного и белого (1bpp) и серого (4bpp или более). Эти изображения должны указывать значения для белых и черных либо WIA_PHOTO_WHITE_1 (где белый — 1, черный — 0) или WIA_PHOTO_WHITE_0 (где белый — 0, черный — 1). Это поле является необязательным для цветовых изображений.

DWORD LineOrder
Описывает, упорядочены ли строки или строки в данных изображения сверху вниз или сверху вниз. 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

Для этого не определено новое свойство. Это не настраиваемый параметр сканирования. LingOrder only matters when executing image data transfers.

DWORD RawDataSize
Указывает размер необработанных данных в байтах после заголовка (не включая необязательную цветовую палитру). Приложения могут использовать это поле для проверки завершения предполагаемой успешной передачи изображений. Если эта информация неизвестна мини-driver во время начала передачи (и заголовок записывается в поток) — например, когда изображение сканируется с помощью автоматического обнаружения границы, мини-driver должен быть необходим для заполнения этого поля в конце передачи данных изображения, аналогично тому, как обрабатываются поля XExtent и YExtent.

DWORD PaletteOffset
Содержит смещение в байтах, где цветовая палитра начинается в потоке данных; это смещение начинается (с нуля позиции), где заканчивается заголовок.. Палитра и необработанные данные изображения могут следовать за необработанным заголовком в любом порядке, и палитра может быть опущена при необходимости.

DWORD PaletteSize
Содержит размер цветовой палитры в байтах. Если палитра не требуется для присоединения к необработанным данным изображения, мини-driver должен задать для этого поля значение 0. Это поле не связано с количеством записей в палитре.

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). Каждое поле записи палитры должно быть выровнено по байтам.