Bewerken

Delen via


WIA RAW Data Header

The header for RAW data is as follows:

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) 

Additional Header Field Descriptions

DWORD Compression
Allows compressed raw formats, such as Nikon's compressed NEF and headerless compressed data used for compressed fax transmissions (Group 3.1, 3.2d, 4). Values for this field would be WIA_IPA_COMPRESSION constants, possibly vendor-specific for specialized applications. Default value is WIA_COMPRESSION_NONE.

Compression Examples:

G4 compressed data (WIA_COMPRESSION_G4) could be transferred either within a TIFF file (WiaImgFmt_TIFF) or using the raw format (WiaImgFmt_RAW).

JPEG compressed data (WIA_COMPRESSION_JPEG) could be transferred either using the JFIF format (WiaImgFmt_JPEG), the EEXIF format (WiaImgFmt_EXIF), or the TIFF format (WiaImgFmt_TIFF). It is not possible to transfer JPEG data formatted in one of the Interchange Formats (JFIF, EEXIF) within transfers using the raw format (WiaImgFmt_RAW) - instead, it is necessary to use one of the other JPEG-compatible formats.

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

DWORD PhotometricInterp
Describes the photometric interpretation for the image that is transferred. This field is required for black and white (1bpp) and grayscale (4bpp or more) images. These images need to indicate the values for white and black, either WIA_PHOTO_WHITE_1 (where white is 1, black is 0) or WIA_PHOTO_WHITE_0 (where white is 0, black is 1). This field is optional for color images.

DWORD LineOrder
Describes whether the lines/rows in the image data are ordered top-to-bottom or bottom-to-top. 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

There is no new property defined for this. This isn't a configurable scan setting. LingOrder only matters when executing image data transfers.

DWORD RawDataSize
Indicates the size, in bytes, of the raw data following the header (not including the optional color palette). Applications could use this field to verify the completion of a presumed successful image transfer. When this information is unknown to the minidriver at the time the transfer begins (and the header is written to the stream) - for example when the image is scanned using automatic border detection - the minidriver should be required to fill in this field at the end of the image data transfer, similar to how the XExtent and YExtent fields are handled.

DWORD PaletteOffset
Contains the offset, in bytes where the color palette starts in the data stream; this offset starts (at position zero) where the header ends.. The palette and raw image data can follow the raw header in any order and the palette can be omitted when not needed.

DWORD PaletteSize
Contains the size, in bytes, of the color palette. When no palette is required to be attached to the raw image data, minidriver should set this field to 0. This field is not related to the number of entries in the 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). Each palette entry field must be BYTE-aligned.