Fonction DrawDibBegin (vfw.h)

Article
08/27/2023

La fonction DrawDib modifie les paramètres d’un contrôleur de domaine DrawDib ou initialise un nouveau contrôleur de domaine DrawDib.

Syntaxe

BOOL VFWAPI DrawDibBegin(
  HDRAWDIB           hdd,
  HDC                hdc,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                dxSrc,
  int                dySrc,
  UINT               wFlags
);

Paramètres

hdd

Handle vers un contrôleur de domaine DrawDib.

hdc

Handle vers un contrôleur de domaine pour le dessin. Ce paramètre est facultatif.

dxDst

Largeur, en MM_TEXT unités clientes, du rectangle de destination.

dyDst

Hauteur, dans MM_TEXT unités clientes, du rectangle de destination.

lpbi

Pointeur vers une structure BITMAPINFOHEADER contenant le format d’image. La table de couleurs de la DIB suit le format de l’image et le membre biHeight doit être une valeur positive.

dxSrc

Largeur, en pixels, du rectangle source.

dySrc

Hauteur, en pixels, du rectangle source.

wFlags

Indicateurs applicables à la fonction. Les valeurs suivantes sont définies.

Valeur	Signification
DDF_ANIMATE	Autorise l’animation de palette. Si cette valeur est présente, DrawDib réserve autant d’entrées que possible en définissant PC_RESERVED dans les entrées de tableau palPalEntry de la structure LOGPALETTE , et la palette peut être animée à l’aide de la fonction DrawDibChangePalette . Si votre application utilise la fonction DrawDibBegin avec la fonction DrawDibDraw , définissez cette valeur avec DrawDibBegin plutôt que DrawDibDraw.
DDF_BACKGROUNDPAL	Réalise la palette utilisée pour dessiner en tant que tâche en arrière-plan, en laissant inchangée la palette actuelle utilisée pour l’affichage. (Cette valeur s’exclut mutuellement de DDF_SAME_HDC.)
DDF_BUFFER	Entraîne l’utilisation d’une mémoire tampon hors écran par DrawDib afin que DDF_UPDATE puisse être utilisé. Cela désactive la décompression et le dessin directement à l’écran. Si DrawDib ne parvient pas à créer une mémoire tampon hors écran, il décompresse ou dessine directement à l’écran. Pour plus d’informations, consultez les valeurs DDF_UPDATE et DDF_DONTDRAW décrites pour DrawDibDraw.
DDF_DONTDRAW	L’image actuelle n’est pas dessinée, mais est décompressée. DDF_UPDATE peut être utilisé ultérieurement pour dessiner l’image. 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 DrawDibBegin avec DrawDibDraw, définissez cette valeur avec DrawDibBegin plutôt que DrawDibDraw.
DDF_JUSTDRAWIT	Dessine l’image à l’aide de GDI. Interdit aux fonctions DrawDib de décompresser, d’étirer ou de tergiverser l’image. Cela supprime DrawDib des fonctionnalités qui le différencient de la fonction StretchDIBits .
DDF_SAME_DRAW	Utilisez les paramètres de dessin actuels pour DrawDibDraw. Utilisez cette valeur uniquement si lpbi, dxDest, dyDest, dxSrc et dySrc n’ont pas changé depuis l’utilisation de DrawDibDraw ou DrawDibBegin. Cet indicateur remplace les indicateurs DDF_SAME_DIB et DDF_SAME_SIZE .
DDF_SAME_HDC	Utilisez le handle DC actuel et la palette actuellement associée au contrôleur de domaine.
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

Cette fonction se prépare à dessiner une DIB spécifiée par lpbi dans le contrôleur de domaine. L’image est étendue à la taille spécifiée par dxDest et dyDest. Si dxDest et dyDest sont définis sur −1, la DIB est dessinée sur une échelle 1:1 sans étirement.

Vous pouvez mettre à jour les indicateurs d’un contrôleur de domaine DrawDib en réédisant DrawDibBegin, en spécifiant les nouveaux indicateurs et en modifiant au moins l’un des paramètres suivants : dxDest, dyDest, lpbi, dxSrc ou dySrc.

Si les paramètres de DrawDibBegin n’ont pas changé, les appels ultérieurs à la fonction n’ont aucun effet.

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