CreateImage()

Syntaxe

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

Crée une nouvelle image vierge (fond noir).

Arguments

#Image	Le numéro d'identification de l'image. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
Largeur, Hauteur	Les dimensions de la nouvelle image. À la fois la largeur et la hauteur doivent être supérieures à zéro.
Profondeur (optionnel)	La profondeur de couleur de la nouvelle image. Les valeurs valides sont: 24 et 32. La valeur par défaut est 24 bits, si la profondeur n'est pas spécifiée.
CouleurDeFond (optionnel)	Couleur d'arrière-plan utilisée lors de la création de l'image. Si l'image est en 24 bits, utilisez RGB() pour obtenir une couleur valide. Si l'image est en 32 bits, utilisez RGBA() pour obtenir une couleur valide. Pour les images 32 bits, des constantes spéciales peuvent également être utilisées : - #PB_Image_Transparent, similaire à RGBA(255,255,255,0), un fond blanc peut être utilisé pour un anticrénelage clair. - #PB_Image_TransparentBlack, similaire à RGBA(0,0,0,0), un fond noir peut être utilisé pour un anticrénelage foncé. La couleur d'arrière-plan par défaut est le noir si elle n'est pas spécifiée.

Valeur de retour

Renvoie une valeur non nulle si l'image a été créée avec succès et zéro sinon. Si #PB_Any a été spécifié comme paramètre #Image alors le numéro généré automatiquement est renvoyé dans 'Resultat' en cas de succès.

Remarques

La taille maximale de l'image est fonction du système d'exploitation et de la quantité de mémoire disponible. Si la mémoire disponible est suffisante alors une image de 8192x8192 peut être traitée par tous les systèmes d'exploitation pris en charge par PureBasic.

Avec l'image créée , vous pouvez notamment utiliser les commandes suivantes :
StartDrawing() avec ImageOutput() pour dessiner dans l'image.
StartVectorDrawing() avec ImageVectorOutput() pour faire du dessin vectoriel.
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.

Exemple

  If OpenWindow(0, 0, 0, 256, 256, "CreateImage", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ImageGadget(0, 0, 0, 256, 256, 0)
    
    If CreateImage(0, 256, 256, 32, RGB(255,255,255))
      StartDrawing(ImageOutput(0))
      Ellipse(70, 50, 30, 10, RGB(0,0,255))
      Ellipse(186, 50, 30, 10, RGB(0,0,255))
      LineXY(128, 80, 128, 150, RGB(255, 0, 255))
      RoundBox(70, 200, 110, 30, 20, 20, RGB(255, 0, 0))
      StopDrawing()
    EndIf
    
    SetGadgetState(0, ImageID(0)) ; Affichage
    
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
   EndIf

Voir aussi

LoadImage(), CatchImage(), FreeImage()

OS Supportés

Tous