Fonction SetStretchBltMode (wingdi.h)
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 |
|---|---|
|
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. |
|
Supprime les pixels. Ce mode supprime toutes les lignes de pixels supprimées sans essayer de conserver leurs informations. |
|
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. |
|
Identique à BLACKONWHITE. |
|
Identique à COLORONCOLOR. |
|
Identique à HALFTONE. |
|
Identique à 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 |
|---|---|
|
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 |