SaveImage()

Syntaxe

Resultat = SaveImage(#Image, NomFichier$ [, ImagePlugin [, Options [, Profondeur]]])

Enregistre une image sur un disque.

Arguments

#Image	L'image à enregistrer.
NomFichier$	Le nom du fichier. Si le nom de fichier ne contient pas de chemin complet alors le chemin est relatif. Voir répertoire courant.
ImagePlugin (optionnel)	Le format de l'image enregistrée: #PB_ImagePlugin_BMP : Enregistre l'image en BMP (défaut). #PB_ImagePlugin_JPEG : Enregistre l'image en JPEG (UseJPEGImageEncoder() doit être utilisé) #PB_ImagePlugin_JPEG2000 : Enregistre l'image en JPEG2000 (UseJPEG2000ImageEncoder() doit être utilisé) #PB_ImagePlugin_PNG : Enregistre l'image en PNG (UsePNGImageEncoder() doit être utilisé)
Options (optionnel)	N'est utilisé qu'avec les plugin JPEG et JPEG 2000. Il est possible de régler la qualité d'une image à l'aide d'une valeur allant de 0 (plus mauvaise qualité) à 10 (qualité maximale), la qualité par défaut étant fixée à 7 si aucune option n'est spécifiée avec l'encodeur JPEG ou JPEG 2000. Quand une image est enregistrée en utilisant une palette (1, 4 ou 8), l'option suivante est disponible: #PB_Image_FloydSteinberg: Appliquer un filtre Floyd-Steinberg. Lorsqu'une image 32 bits est enregistrée avec une résolution inférieure (24 bits ou moins), les options suivantes permettent de modifier la couleur utilisée pour remplir la zone transparente : #PB_Image_WhiteAlphaBackground : L'image résultante sera blanche si une zone transparente est trouvée (par défaut). #PB_Image_BlackAlphaBackground : L'image résultante sera noire si une zone transparente est trouvée.
Profondeur (optionnel)	La profondeur de couleur de l'image lors de son enregistrement. Les valeurs valides sont 1, 4, 8, 24 et 32. La valeur par défaut est la profondeur originale de l'image. Pour l'instant, seuls les encodeurs BMP et PNG supportent le mode palettisé (1, 4 ou 8 bits).

Valeur de retour

Renvoie une valeur non nulle si l'opération a réussi et zéro sinon.

Exemple

  LoadImage(0, #PB_Compiler_Home+"Examples\Sources\Data\GeeBee2.bmp") ; Charge l'image depuis un fichier
  SaveImage(0, GetTemporaryDirectory() + "ok.bmp") ; Enregistre

Exemple

  ;Dessine un rectangle bleu et l'enregistre dans un fichier PNG
  UsePNGImageEncoder()
  
  If CreateImage(0, 33, 33)
    If StartDrawing(ImageOutput(0))
      DrawingMode(#PB_2DDrawing_Transparent)
        Box(0, 0, 33, 33, $FF0000) 
      StopDrawing()
    EndIf
    Fichier$ = SaveFileRequester("Enregistrer sous...", GetCurrentDirectory(), "*.png|*.png", 0)
    If Fichier$
      If GetExtensionPart(Fichier$) = ""
        Fichier$ + ".png"  ; Ajouter l'extension de fichier si nécessaire
      EndIf
      If SaveImage(0, Fichier$, #PB_ImagePlugin_PNG)
        MessageRequester("Fichier enregistré", Fichier$)
      Else
        MessageRequester("Erreur", "Échec de l'enregistrement du fichier")
      EndIf
    EndIf
    FreeImage(0)
  EndIf

Voir aussi

ImageDepth(), ImagePlugin library

OS Supportés

Tous