CreateImage()

Syntaxe

Resultat = CreateImage(#Image, Largeur, Hauteur [, Profondeur])

Crée une nouvelle image vide qui peut être utilisée par les fonctions 2DDrawing comme surface de dessin. Si 'Resultat' = 0, la fonction a échoué.
Si #PB_Any est utilisé pour le paramètre '#Image', le numéro de la nouvelle image sera renvoyé dans 'Resultat'. Le format de l'image est celui de l'écran courant: DrawImage() peut servir à afficher cette image dans une fenêtre par exemple.


Les valeurs valides pour 'Profondeur' sont: 24 bits et 32 bits. La valeur par défaut est 24 bits, si la profondeur n'est pas spécifiée. La valeur de la profondeur est combinable avec #PB_Image_Transparent (en utilisant l'opérateur '|') pour créer une image avec un canal alpha complètement transparent. Cette option n'a d'effet que sur les images 32 bits.

Avec l'image créée , vous pouvez notamment utiliser les commandes suivantes :
StartDrawing() avec ImageOutput() pour dessiner dans l'image.
CopyImage() pour créer une copie de l'image.
GrabImage() pour créer une autre image en copiant une zone définie dans l'image.
DrawImage() avec ImageID() pour dessiner l'image sur la surface de dessin en cours.
ImageGadget() pour afficher l'image dans une application fenêtrée.
ButtonImageGadget() pour créer un bouton avec image dans une application fenêtrée.

Note : La taille des images est actuellement limitée à 8192x8192 pixels (si la mémoire disponible le permet).

OS Supportés

Tous