imagegd2

    (PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

    imagegd2 — Génère une image au format GD2, vers le navigateur ou un fichier

    Description

    imagegd2(
        GdImage$image,
        ?string$file = null,
        int$chunk_size = 128,
        int$mode = IMG_GD2_RAW
    ): bool

    Génère une image au format GD2, vers le fichier file.

    Liste de paramètres

    image

    Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

    file

    Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si non-défini ou null, le flux brute de l'image sera affiché directement.

    chunk_size

    Taille de la pièce.

    mode

    Soit IMG_GD2_RAW, soit IMG_GD2_COMPRESSED. Par défaut, vaut IMG_GD2_RAW.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Attention

    Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne true.

    Historique

    VersionDescription
    8.0.3file is now nullable.
    8.0.0image attend une instance de GdImage désormais; auparavant, une resourcegd était attendue.

    Exemples

    Exemple #1 Affichage d'une image GD2

    <?php
    // Création d'une image vide et ajout d'un texte
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "Un texte simple", $text_color);

    // Affichage de l'image
    imagegd2($im);

    // Libération de la mémoire
    imagedestroy($im);
    ?>

    Exemple #2 Sauvegarde d'une image GD2

    <?php
    // Création d'une image vide et ajout d'un texte
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "Un texte simple", $text_color);

    // Sauvegarde de l'image GD2
    // Le format de fichier pour les images GD2 est .gd2, voir http://www.libgd.org/GdFileFormats
    imagegd2($im, 'simple.gd2');

    // Libération de la mémoire
    imagedestroy($im);
    ?>

    Notes

    Note:

    Le format GD2 est communément utilisé pour charger rapidement les parties d'une image. Notez que le format GD2 est uniquement utilisable dans les applications compatibles GD2.

    Avertissement

    Les formats d'image GD et GD2 sont des formats d'images propriétaire de libgd. Ils doivent être considérés obsolète, et devraient seulement être utilisé lors du développement et la phase de test.

    Voir aussi

    • imagegd() - Génère une image au format GD, vers le navigateur ou un fichier
    To Top