UDF > WinAPIEx > GDI > BitMaps >

_WinAPI_StretchDIBits

Copie les données de couleur d'un rectangle de pixels d'une image DIB, JPEG ou PNG dans un rectangle de destination donné, avec étirement ou retrécissement des rangées et des colonnes en utilisant une opération de trame donnée

#include <WinAPIGdi.au3>
_WinAPI_StretchDIBits ( $hDestDC, $iXDest, $iYDest, $iWidthDest, $iHeightDest, $iXSrc, $iYSrc, $iWidthSrc, $iHeightSrc, $tBITMAPINFO, $iUsage, $pBits, $iRop )

Paramètres

$hDestDC Handle du contexte de périphérique de destination.
$iXDest La coordonnée x, en unités logiques, du coin supérieur gauche du rectangle de destination.
$iYDest La coordonnée y, en unités logiques, du coin supérieur gauche du rectangle de destination.
$iWidthDest La largeur, en unités logiques du rectangle de destination.
$iHeightDest La hauteur, en unités logiques, du rectangle de destination.
$iXSrc La coordonnées x, en pixels, du rectangle source dans l'image.
$iYSrc La coordonnée y, en pixels, du rectangle source dans l'image.
$iWidthSrc La largeur, en pixels, du rectangle source dans l'image.
$iHeightSrc La hauteur, en pixels, du rectangle source dans l'image.
$tBITMAPINFO La structure $tagBITMAPINFO qui contient des informations sur le DIB.
$iUsage Le type de couleur utilisé. (soit des index d'une palette logique, soit des valeurs RVB littérales).
Les valeurs suivantes sont définies:
    $DIB_PAL_COLORS
    $DIB_RGB_COLORS
$pBits Un pointeur sur les bits de l'image, qui sont stockées dans un tableau d'octets.
$iRop Le code de l'opération de trame qui spécifie comment les pixels de la source, le pinceau en cours du contexte de périphérique de destination, et les pixels de destination doivent être combinées pour former la nouvelle image.
Ce paramètre doit être égal à 0 ou l'une des valeurs suivantes:
    $BLACKNESS
    $CAPTUREBLT
    $DSTINVERT
    $MERGECOPY
    $MERGEPAINT
    $NOMIRRORBITMAP
    $NOTSRCCOPY
    $NOTSRCERASE
    $PATCOPY
    $PATINVERT
    $PATPAINT
    $SRCAND
    $SRCCOPY
    $SRCERASE
    $SRCINVERT
    $SRCPAINT
    $BLANCHEUR

Valeur de retour

Succès: Retourne le nombre de lignes de balayage copiées. Notez que cette valeur peut être négative pour un contenu en miroir.
0 - Sinon.
Échec: Définit @error <> 0 (GDI_ERROR).

Remarque

_WinAPI_StretchDIBits() crée une image symétrique d'un bitmap, si les signes des paramètres $iWidthSrc et $iWidthDest, ou si les paramètres $iHeightSrc et $iHeightDest sont différents.
Si $iWidthSrc et $iWidthDest ont des signes différents, la fonction crée une image symétrique par rapport à l'axe des x du bitmap.
Si $iHeightSrc et $iHeightDest ont des signes différents, la fonction crée une image symétrique par rapport à l'axe des y du bitmap.

Voir aussi

Consultez StretchDIBits dans la librairie MSDN.