imagecolorallocate

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imagecolorallocate — Alloue une couleur pour une image

    Description

    imagecolorallocate(
        GdImage$image,
        int$red,
        int$green,
        int$blue
    ): int|false

    Retourne un identifiant de couleur, représentant la couleur composée avec les couleurs RGB.

    imagecolorallocate() doit être appelée pour créer chaque couleur qui sera représentée par image.

    Note:

    Le premier appel à imagecolorallocate() remplit la couleur de fond avec la palette des images - images créées en utilisant imagecreate().

    Liste de paramètres

    image

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

    red

    Valeur du composant rouge.

    green

    Valeur du composant vert.

    blue

    Valeur du composant bleu.

    Ces paramètres sont des entiers compris entre 0 et 255 ou des hexadécimaux compris entre 0x00 and 0xFF.

    Valeurs de retour

    Un identifiant de couleur ou false si l'allocation échoue.

    Avertissement

    Cette fonction peut retourner false, mais elle peut aussi retourner une valeur équivalent à false. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

    Historique

    VersionDescription
    8.0.0image attend une instance de GdImage désormais; auparavant, une resourcegd était attendue.

    Exemples

    Exemple #1 Exemple avec imagecolorallocate()

    <?php

    $im     = imagecreate(100, 100);

    // Le fond de l'image est en rouge
    $background = imagecolorallocate($im, 255, 0, 0);

    // On définit des couleurs avec des entiers ..
    $white = imagecolorallocate($im, 255, 255, 255);
    $black = imagecolorallocate($im, 0, 0, 0);

    // .. ou des hexadécimaux
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

    ?>

    Voir aussi

    To Top