BITMAP-Struktur (wingdi.h)

Artikel
03/13/2024

Die BITMAP-Struktur definiert den Typ, die Breite, die Höhe, das Farbformat und die Bitwerte einer Bitmap.

Syntax

typedef struct tagBITMAP {
  LONG   bmType;
  LONG   bmWidth;
  LONG   bmHeight;
  LONG   bmWidthBytes;
  WORD   bmPlanes;
  WORD   bmBitsPixel;
  LPVOID bmBits;
} BITMAP, *PBITMAP, *NPBITMAP, *LPBITMAP;

Member

bmType

Der Bitmaptyp. Dieser Member muss 0 sein.

bmWidth

Die Breite der Bitmap in Pixel. Die Breite muss größer als 0 sein.

bmHeight

Die Höhe der Bitmap in Pixel. Die Höhe muss größer als 0 sein.

bmWidthBytes

Die Anzahl der Bytes in jeder Scanzeile. Dieser Wert muss durch 2 teilbar sein, da das System davon ausgeht, dass die Bitwerte einer Bitmap ein Array bilden, das wortbündig ist.

bmPlanes

Die Anzahl der Farbebenen.

bmBitsPixel

Die Anzahl der Bits, die erforderlich sind, um die Farbe eines Pixels anzugeben.

bmBits

Ein Zeiger auf die Position der Bitwerte für die Bitmap. Das bmBits-Element muss ein Zeiger auf ein Array von Zeichenwerten (1 Byte) sein.

Hinweise

Die derzeit verwendeten Bitmapformate sind Monochrom und Farbe. Die monochrome Bitmap verwendet ein Ein-Bit-Format mit einer Ebene. Jeder Scan ist ein Vielfaches von 16 Bits.

Scans werden für eine monochrome Bitmap mit der Höhe n wie folgt organisiert:


    Scan 0 
    Scan 1 
    . 
    . 
    . 
    Scan n-2 
    Scan n-1

Die Pixel auf einem monochromen Gerät sind entweder schwarz oder weiß. Wenn das entsprechende Bit in der Bitmap 1 ist, wird das Pixel auf die Vordergrundfarbe festgelegt. wenn das entsprechende Bit in der Bitmap 0 ist, wird das Pixel auf die Hintergrundfarbe festgelegt.

Alle Geräte, die über die RC_BITBLT Gerätefunktion verfügen, unterstützen Bitmaps. Weitere Informationen finden Sie unter GetDeviceCaps.

Jedes Gerät verfügt über ein eindeutiges Farbformat. Um eine Bitmap von einem Gerät auf ein anderes zu übertragen, verwenden Sie die Funktionen GetDIBits und SetDIBits .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h (einschließlich Windows.h)