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.


Si le paramètre optionel 'Profondeur' est omis ou égal à #PB_Image_DisplayFormat, le format de l'image sera le même que celui du bureau (écran). Dans ce mode, les images sont plus rapide à afficher, mais il peut y avoir des pertes au niveaux des couleurs, par exemple si l'image est en 32 bits alors que le bureau est en 16 bits. Les autres valeurs valides pour 'Profondeur' sont: 1, 2, 4, 8, 16, 24 et 32 bits. Lors de la manipulation des images riches en couleurs, il est conseillé d'utiliser une profondeur de 24 ou 32 bits pour éviter une perte d'information.

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