Partager via


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.

Valeur Signification
CBM_INIT
Si cet indicateur est défini, le système utilise les données pointées par les paramètres lpbInit et lpbmi pour initialiser les bits bitmap.

Si cet indicateur est clair, les données pointées par ces paramètres ne sont pas utilisées.

 

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 Signification
DIB_PAL_COLORS
Une table de couleurs est fournie et se compose d’un tableau d’index 16 bits dans la palette logique du contexte d’appareil dans lequel la bitmap doit être sélectionnée.
DIB_RGB_COLORS
Une table de couleurs est fournie et contient des valeurs RVB littérales.

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

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

BITMAPINFO

BITMAPINFOHEADER

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateCompatibleBitmap

CreateDIBSection

DeleteObject

GetDeviceCaps

GetSystemPaletteEntries

SélectionnerObject

SetDIBits