Fonction SetStretchBltMode (wingdi.h)

  • Article

La fonction SetStretchBltMode définit le mode d’étirement bitmap dans le contexte d’appareil spécifié.

Syntaxe

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] mode

Mode d’étirement. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
BLACKONWHITE
 Effectue une opération Boolean AND à l’aide des valeurs de couleur pour les pixels supprimés et existants. Si la bitmap est une bitmap monochrome, ce mode conserve les pixels noirs au détriment des pixels blancs.
COLORONCOLOR
 Supprime les pixels. Ce mode supprime toutes les lignes de pixels supprimées sans essayer de conserver leurs informations.
DEMI-TEINTES
 Mappe les pixels du rectangle source en blocs de pixels dans le rectangle de destination. La couleur moyenne sur le bloc de pixels de destination se rapproche de la couleur des pixels sources.

Après avoir défini le mode d’étirement HALFTONE, une application doit appeler la fonction SetBrushOrgEx pour définir l’origine du pinceau. S’il ne le fait pas, un mauvais alignement de pinceau se produit.
STRETCH_ANDSCANS
 Identique à BLACKONWHITE.
STRETCH_DELETESCANS
 Identique à COLORONCOLOR.
STRETCH_HALFTONE
 Identique à HALFTONE.
STRETCH_ORSCANS
 Identique à WHITEONBLACK.
WHITEONBLACK
 Effectue une opération booléenne OR à l’aide des valeurs de couleur des pixels supprimés et existants. Si la bitmap est une bitmap monochrome, ce mode conserve les pixels blancs au détriment des pixels noirs.

Valeur retournée

Si la fonction réussit, la valeur de retour est le mode d’étirement précédent.

Si la fonction échoue, la valeur de retour est égale à zéro.

Cette fonction peut retourner la valeur suivante.

Code de retour Description
ERROR_INVALID_PARAMETER
 Un ou plusieurs des paramètres d’entrée n’est pas valide.

Remarques

Le mode d’étirement définit la façon dont le système combine des lignes ou des colonnes d’une bitmap avec des pixels existants sur un périphérique d’affichage lorsqu’une application appelle la fonction StretchBlt .

Les modes BLACKONWHITE (STRETCH_ANDSCANS) et WHITEONBLACK (STRETCH_ORSCANS) sont généralement utilisés pour préserver les pixels de premier plan dans les bitmaps monochromes. Le mode COLORONCOLOR (STRETCH_DELETESCANS) est généralement utilisé pour préserver la couleur dans les bitmaps de couleur.

Le mode HALFTONE est plus lent et nécessite plus de traitement de l’image source que les trois autres modes ; mais produit des images de qualité supérieure. Notez également que SetBrushOrgEx doit être appelé après avoir défini le mode HALFTONE pour éviter un mauvais alignement de pinceau.

Des modes d’étirement supplémentaires peuvent également être disponibles en fonction des fonctionnalités du pilote de périphérique.

Configuration requise

Condition requise Valeur
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

Fonctions bitmap

Vue d’ensemble des bitmaps

GetStretchBltMode

SetBrushOrgEx

StretchBlt