BITMAPINFO Structure

FreeImage.NET

BITMAPINFO Structure
The BITMAPINFO structure defines the dimensions and color information for a DIB.

Namespace: FreeImageAPI
Assembly: FreeImageNET (in FreeImageNET.dll) Version: 3.17.0.4 (3.17.0)
Syntax
C#
[SerializableAttribute]
public struct BITMAPINFO : IEquatable<BITMAPINFO>

The BITMAPINFO type exposes the following members.

Methods
  NameDescription
Public methodEquals(Object)
Tests whether the specified object is a BITMAPINFO structure and is equivalent to this BITMAPINFO structure.
(Overrides ValueTypeEquals(Object).)
Public methodEquals(BITMAPINFO)
Tests whether the specified BITMAPINFO structure is equivalent to this BITMAPINFO structure.
Public methodGetHashCode
Returns a hash code for this BITMAPINFO structure.
(Overrides ValueTypeGetHashCode.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodToString
Returns the fully qualified type name of this instance.
(Inherited from ValueType.)
Top
Operators
  NameDescription
Public operatorStatic memberEquality
Tests whether two specified BITMAPINFO structures are equivalent.
Public operatorStatic memberInequality
Tests whether two specified BITMAPINFO structures are different.
Top
Fields
  NameDescription
Public fieldbmiColors
The bmiColors member contains one of the following: An array of RGBQUAD. The elements of the array that make up the color table. An array of 16-bit unsigned integers that specifies indexes into the currently realized logical palette. This use of bmiColors is allowed for functions that use DIBs. When bmiColors elements contain indexes to a realized logical palette, they must also call the following bitmap functions: CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

The iUsage parameter of CreateDIBSection must be set to DIB_PAL_COLORS.

The number of entries in the array depends on the values of the biBitCount and biClrUsed members of the BITMAPINFOHEADER structure.

The colors in the bmiColors table appear in order of importance. For more information, see the Remarks section.

Public fieldbmiHeader
Specifies a BITMAPINFOHEADER structure that contains information about the dimensions of color format.
Top
Remarks
A DIB consists of two distinct parts: a BITMAPINFO structure describing the dimensions and colors of the bitmap, and an array of bytes defining the pixels of the bitmap. The bits in the array are packed together, but each scan line must be padded with zeroes to end on a LONG data-type boundary. If the height of the bitmap is positive, the bitmap is a bottom-up DIB and its origin is the lower-left corner. If the height is negative, the bitmap is a top-down DIB and its origin is the upper left corner.

A bitmap is packed when the bitmap array immediately follows the BITMAPINFO header. Packed bitmaps are referenced by a single pointer. For packed bitmaps, the biClrUsed member must be set to an even number when using the DIB_PAL_COLORS mode so that the DIB bitmap array starts on a DWORD boundary.

Note The bmiColors member should not contain palette indexes if the bitmap is to be stored in a file or transferred to another application.

Unless the application has exclusive use and control of the bitmap, the bitmap color table should contain explicit RGB values.

See Also