Nagłówek danych RAW WIA

Nagłówek danych RAW jest następujący:

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) 

Dodatkowe opisy pól nagłówka

DWORD Compression
Umożliwia skompresowane nieprzetworzone formaty, takie jak skompresowany format NEF Firmy Firmy i skompresowane dane bez nagłówka używane do transmisji skompresowanych faksów (grupa 3.1, 3.2d, 4). Wartości dla tego pola będą WIA_IPA_COMPRESSION stałe, prawdopodobnie specyficzne dla dostawcy dla wyspecjalizowanych aplikacji. Wartość domyślna to WIA_COMPRESSION_NONE.

Compression Examples:

Skompresowane dane G4 (WIA_COMPRESSION_G4) mogą być przesyłane w pliku TIFF (WiaImgFmt_TIFF) lub przy użyciu formatu pierwotnego (WiaImgFmt_RAW).

Skompresowane dane JPEG (WIA_COMPRESSION_JPEG) można przesyłać przy użyciu formatu JFIF (WiaImgFmt_JPEG), formatu EEXIF (WiaImgFmt_EXIF) lub formatu TIFF (WiaImgFmt_TIFF). Nie można przesyłać danych JPEG sformatowanych w jednym z formatów wymiany (JFIF, EEXIF) w transferach przy użyciu formatu pierwotnego (WiaImgFmt_RAW) — zamiast tego należy użyć jednego z innych formatów zgodnych z plikiem JPEG.

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

DWORD PhotometricInterp
Opisuje interpretację fotometryczną obrazu, który jest przesyłany. To pole jest wymagane dla obrazów czarno-białych (1bpp) i skali szarości (4bpp lub więcej). Te obrazy muszą wskazywać wartości białych i czarnych, albo WIA_PHOTO_WHITE_1 (gdzie biały to 1, to 0) lub WIA_PHOTO_WHITE_0 (gdzie biały to 0, to 1). To pole jest opcjonalne dla obrazów kolorów.

DWORD LineOrder
Opisuje, czy wiersze w danych obrazu są uporządkowane od góry do dołu, czy od dołu do góry do góry. 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

Dla tej funkcji nie zdefiniowano żadnej nowej właściwości. Nie jest to konfigurowalne ustawienie skanowania. LingOrder only matters when executing image data transfers.

DWORD RawDataSize
Wskazuje rozmiar danych pierwotnych w bajtach po nagłówku (nie obejmuje opcjonalnej palety kolorów). Aplikacje mogą użyć tego pola do zweryfikowania ukończenia domniemanego pomyślnego transferu obrazów. Jeśli te informacje nie są znane minidriver w momencie rozpoczęcia transferu (i nagłówek jest zapisywany w strumieniu) — na przykład gdy obraz jest skanowany przy użyciu automatycznego wykrywania obramowania — minidriver powinien być wymagany do wypełnienia tego pola na końcu transferu danych obrazu, podobnie jak w przypadku obsługi pól XExtent i YExtent.

DWORD PaletteOffset
Zawiera przesunięcie w bajtach, w których paleta kolorów rozpoczyna się w strumieniu danych; to przesunięcie rozpoczyna się (w pozycji zero), gdzie kończy się nagłówek. Paleta i nieprzetworzone dane obrazu mogą być zgodne z nieprzetworzonym nagłówkiem w dowolnej kolejności, a paleta może zostać pominięta, gdy nie jest to konieczne.

DWORD PaletteSize
Zawiera rozmiar palety kolorów w bajtach. Jeśli do nieprzetworzonych danych obrazu nie trzeba dołączać palety, minidriver powinien ustawić to pole na 0. To pole nie jest powiązane z liczbą wpisów na palecie.

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). Każde pole wprowadzania palety musi być wyrównane do bajtów.