SOBITMAPHEADER

Contains information about the bitmap to be output.

typedef struct SOBITMAPHEADERtag { 

    WORD wStructSize;   // see below

    WORD wImageFlags;   // see below

    WORD wImageWidth;   // see below

    WORD wImageLength;  // see below

    WORD wTileWidth;    // see below

    WORD wTileLength;   // see below

    WORD wBitsPerPixel; // see below

    WORD wNPlanes;      // see below

    WORD wHDpi;         // see below

    WORD wVDpi;         // see below

} SOBITMAPHEADER, VWPTR *PSOBITMAPHEADER;

 

Members

wStructSize

Size, in bytes, of the structure.

wImageFlags

Image flags. This member can be a combination of one (and only one) color format value and other attribute values.

The color format can be one of these values:

SO_BGRCOLOR

Pixel values are RGB color values (24-bit only); bytes are stored consecutively in the order B,G,R.

SO_BLACKANDWHITE

Pixels are black or white (1 bit per pixel only).

SO_COLORPALETTE

Pixel values are indexes into the color palette for the bitmap.

SO_GRAYSCALE

Pixel values are gray scale values.

SO_RGBCOLOR

Pixel values are RGB color values (24-bit only); bytes are stored consecutively in the order R,G,B.

 

Other attributes can be a combination of these values:

SO_BOTTOMTOTOP

The image is provided in scan lines from the bottom up. The default is top to bottom.

SO_WHITEZERO

For gray scale images and black and white images only, a pixel with a value of zero is a white pixel, and increasing pixel values become darker. By default, a value of zero is defined as a black pixel with increasing values becoming lighter.

 

wImageWidth

Horizontal width, in pixels, of the image.

wImageLength

Vertical length, in pixels, of the image.

wTileWidth

Horizontal width, in pixels, of the tile.

wTileLength

Vertical length, in pixels, of the tile.

wBitsPerPixel

Number of consecutive bits that define the pixel color. The number is currently limited to 1, 4, 8, or 24.

wNPlanes

Color planes. This member must be 1.

wHDpi

Horizontal resolution, in pixels per inch, of the display on which the image originated. If the resolution is not known, this member can be zero.

wVDpi

Vertical resolution, in pixels per inch, of the display on which the image originated. If the resolution is not known, this member can be zero.