GdipBitmapLockBits()



Syntaxe
Resultat.i = GdipBitmapLockBits(*bitmap, @rect.RECTL, flags.i, format.i, @lockedBitmapData.BitmapData)
Paramètres
*bitmap

[in] Pointeur sur un objet bitmap.

rect.RECTL

[in] Rectangle à verrouiller.

flags.i

[in] Drapeaux qui indiquent si la partie verrouillée du bitmap est disponible pour la lecture ou pour l'écriture et si le visiteur a déjà assigné une mémoire tampon. Les différents drapeaux sont définis dans l'énumération ImageLockMode.

format.i

[in] Indique le format des pixels de la mémoire tampon. Le format ne doit pas être identique à celui du bitmap. Les différents formats sont définis dans l'énumération PixelFormat.

lockedBitmapData.BitmapData

[in] [out] Variable de type BitmapData. Si le drapeau #ImageLockModeUserInputBuf n'est pas présent, alors lockedBitmapData sert seulement de paramètre de sortie. Dans ce cas, Scan0 de la structure BitmapData recevra un pointeur sur la mémoire tampon provisoire, qui contient les pixels du rectangle à verrouiller. Les autres membres de la structure BitmapData reçoivent les attributs (largeur, hauteur, format, etc.) des données de Pixel de la mémoire tampon provisoire. Si le drapeau ImageLockModeUserInputBuf du paramètre flag est placé, alors lockedBitmapData sert de paramètre d'entrée (et aussi comme paramètre de sortie). Dans ce cas, le programmeur doit assigner une mémoire tampon pour lire ou écrire les pixels. Le programmeur doit également créer une structure BitmapData et placer toutes les données (adresse de la mémoire tampon, largeur, hauteur, format, etc.).

Description
Verrouille une partie rectangulaire d'un bitmap (en mémoire système) et fournit une mémoire tampon provisoire que vous pouvez employer pour lire ou écrire des pixels dans le format indiqué. Toutes les données de la mémoire tampon sont ensuite recopiées quand vous appelez GdipBitmapUnlockBits().

Résultat de la fonction
Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.
PB - OS

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium