CreateDIBitmap, fonction (wingdi.h)

La fonction CreateDIBitmap crée un bitmap compatible (DDB) à partir d’une DIB et, éventuellement, définit les bits bitmap.

Syntaxe

HBITMAP CreateDIBitmap(
  [in] HDC                    hdc,
  [in] const BITMAPINFOHEADER *pbmih,
  [in] DWORD                  flInit,
  [in] const VOID             *pjBits,
  [in] const BITMAPINFO       *pbmi,
  [in] UINT                   iUsage
);

Paramètres

[in] hdc

Handle d'un contexte de périphérique.

[in] pbmih

Pointeur vers une structure d’en-tête d’informations bitmap , BITMAPV5HEADER.

Si fdwInit est CBM_INIT, la fonction utilise la structure d’en-tête d’informations bitmap pour obtenir la largeur et la hauteur souhaitées de la bitmap, ainsi que d’autres informations. Notez qu’une valeur positive pour la hauteur indique une DIB ascendante tandis qu’une valeur négative pour la hauteur indique une DIB de haut en bas. Appeler CreateDIBitmap avec fdwInit comme CBM_INIT revient à appeler la fonction CreateCompatibleBitmap pour créer une DDB au format de l’appareil, puis à appeler la fonction SetDIBits pour traduire les bits DIB en DDB.

[in] flInit

Spécifie la façon dont le système initialise les bits bitmap. La valeur suivante est définie.

Si fdwInit est égal à zéro, le système n’initialise pas les bits bitmap.

[in] pjBits

Pointeur vers un tableau d’octets contenant les données bitmap initiales. Le format des données dépend du membre biBitCount de la structure BITMAPINFO vers laquelle pointe le paramètre lpbmi .

[in] pbmi

Pointeur vers une structure BITMAPINFO qui décrit les dimensions et le format de couleur du tableau vers lequel pointe le paramètre lpbInit .

[in] iUsage

Spécifie si le membre bmiColors de la structure BITMAPINFO a été initialisé et, le cas échéant, si bmiColors contient des valeurs rouges, vertes, bleues (RVB) explicites ou des index de palette. Le paramètre fuUsage doit être l’une des valeurs suivantes.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour l’image bitmap compatible.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

La base de données DDB créée correspond à la profondeur de bits de votre contrôleur de domaine de référence. Pour créer une bitmap de profondeur de bits différente, utilisez CreateDIBSection.

Pour qu’un appareil atteigne une vitesse de dessin bitmap optimale, spécifiez fdwInit comme CBM_INIT. Ensuite, utilisez la même DIB de profondeur de couleur que le mode vidéo. Lorsque la vidéo exécute 4 ou 8 bpp, utilisez DIB_PAL_COLORS.

L’indicateur CBM_CREATDIB pour le paramètre fdwInit n’est plus pris en charge.

Lorsque vous n’avez plus besoin de la bitmap, appelez la fonction DeleteObject pour la supprimer.

ICM: Aucune gestion des couleurs n’est effectuée. Le contenu de l’image bitmap résultante n’est pas mis en correspondance de couleur une fois la bitmap créée.

Configuration requise

Voir aussi

BITMAPINFO

BITMAPINFOHEADER

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateCompatibleBitmap

CreateDIBSection

DeleteObject

GetDeviceCaps

GetSystemPaletteEntries

SélectionnerObject

SetDIBits