Fonction DrawDibDraw (vfw.h)

Article
08/27/2023

La fonction DrawDibDraw dessine une DIB à l’écran.

Syntaxe

BOOL VFWAPI DrawDibDraw(
  HDRAWDIB           hdd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  UINT               wFlags
);

Paramètres

hdd

Handle vers un contrôleur de domaine DrawDib.

hdc

Handle vers le contrôleur de domaine.

xDst

Coordonnée x, dans MM_TEXT coordonnées du client, du coin supérieur gauche du rectangle de destination.

yDst

Coordonnée y, dans MM_TEXT coordonnées du client, du coin supérieur gauche du rectangle de destination.

dxDst

Largeur, dans MM_TEXT coordonnées du client, du rectangle de destination. Si dxDst a la valeur −1, la largeur de la bitmap est utilisée.

dyDst

Hauteur, dans MM_TEXT coordonnées du client, du rectangle de destination. Si dyDst a la valeur −1, la hauteur de la bitmap est utilisée.

lpbi

Pointeur vers la structure BITMAPINFOHEADER contenant le format d’image. La table de couleurs de la DIB dans BITMAPINFOHEADER suit le format et le membre biHeight doit être une valeur positive ; DrawDibDraw ne dessine pas de DIB inversés.

lpBits

Pointeur vers la mémoire tampon qui contient les bits bitmap.

xSrc

Coordonnée x, en pixels, du coin supérieur gauche du rectangle source. Les coordonnées (0,0) représentent le coin supérieur gauche de la bitmap.

ySrc

Coordonnée y, en pixels, du coin supérieur gauche du rectangle source. Les coordonnées (0,0) représentent le coin supérieur gauche de la bitmap.

dxSrc

Largeur, en pixels, du rectangle source.

dySrc

Hauteur, en pixels, du rectangle source.

wFlags

Indicateurs applicables pour le dessin. Les valeurs suivantes sont définies.

Valeur	Signification
DDF_BACKGROUNDPAL	Réalise la palette utilisée pour dessiner en arrière-plan, en laissant inchangée la palette réelle utilisée pour l’affichage. Cette valeur est valide uniquement si DDF_SAME_HDC n’est pas défini.
DDF_DONTDRAW	L’image actuelle est décompressée, mais pas dessinée. Cet indicateur remplace l’indicateur DDF_PREROLL .
DDF_FULLSCREEN	Non pris en charge.
DDF_HALFTONE	Classe toujours la DIB dans une palette standard, quelle que soit la palette de la DIB. Si votre application utilise la fonction DrawDibBegin , définissez cette valeur dans DrawDibBegin plutôt que dans DrawDibDraw.
DDF_HURRYUP	Les données n’ont pas besoin d’être dessinées (c’est-à-dire qu’elles peuvent être supprimées) et DDF_UPDATE ne seront pas utilisées pour rappeler ces informations. DrawDib vérifie cette valeur uniquement si elle est nécessaire pour générer le frame suivant ; sinon, la valeur est ignorée. Cette valeur est généralement utilisée pour synchroniser la vidéo et l’audio. Lors de la synchronisation des données, les applications doivent envoyer l’image avec cette valeur au cas où le pilote aurait besoin de mettre en mémoire tampon la trame pour décompresser les images suivantes.
DDF_NOTKEYFRAME	Les données DIB ne sont pas une trame clé.
DDF_SAME_HDC	Utilisez le handle DC actuel et la palette actuellement associée au contrôleur de domaine.
DDF_SAME_DRAW	Utilisez les paramètres de dessin actuels pour DrawDibDraw. Utilisez cette valeur uniquement si lpbi, dxDst, dyDst, dxSrc et dySrc n’ont pas changé depuis l’utilisation de DrawDibDraw ou DrawDibBegin. DrawDibDraw vérifie généralement les paramètres et, s’ils ont changé, DrawDibBegin prépare le contrôleur de domaine DrawDib pour le dessin. Cet indicateur remplace les indicateurs DDF_SAME_DIB et DDF_SAME_SIZE .
DDF_UPDATE	La dernière bitmap mise en mémoire tampon doit être redessinée. Si le dessin échoue avec cette valeur, une image mise en mémoire tampon n’est pas disponible et une nouvelle image doit être spécifiée avant que l’affichage puisse être mis à jour.

Valeur retournée

Retourne TRUE en cas de réussite ou FALSE dans le cas contraire.

Remarques

DDF_DONTDRAW entraîne la décompression de DrawDibDraw , mais pas l’affichage d’une image. Un appel ultérieur à DrawDibDraw spécifiant DDF_UPDATE affiche l’image.

Si le contrôleur de domaine DrawDib n’a pas de mémoire tampon hors écran spécifiée, la spécification de DDF_DONTDRAW entraîne le dessin immédiat du cadre vers l’écran. Les appels ultérieurs à DrawDibDraw spécifiant DDF_UPDATE échouent.

Bien qu’ils soient définis à des moments différents, DDF_UPDATE et DDF_DONTDRAW peuvent être utilisés ensemble pour créer des images composites hors écran. Une fois l’image hors écran terminée, vous pouvez l’afficher en appelant DrawDibDraw.

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	vfw.h
Bibliothèque	Vfw32.lib
DLL	Msvfw32.dll

Voir aussi

Fonctions DrawDib

Partager via