imagecolorat

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

imagecolorat — Retourne l'index de la couleur d'un pixel donné

Description

Retourne l'index de la couleur du pixel situé aux coordonnées spécifiées, dans l'image image.

Si l'image est une image en TrueColor, cette fonction retourne la valeur RGB du pixel, sous forme d'un entier. Utiliser les opérateurs de bits et les masques pour distinguer le rouge, du vert et du bleu :

Liste de paramètres

image

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

x

X : coordonnée du point.

y

Y : coordonnée du point.

Valeurs de retour

Retourne l'index de la couleur ou false si une erreur survient.

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

Exemples

Exemple #1 Accès aux valeurs RGB

Résultat de l'exemple ci-dessus est similaire à :

int(119)
int(123)
int(180)

Exemple #2 Valeurs RVB lisibles en utilisant la fonction imagecolorsforindex()

Résultat de l'exemple ci-dessus est similaire à :

array(4) {
  ["red"]=>
  int(119)
  ["green"]=>
  int(123)
  ["blue"]=>
  int(180)
  ["alpha"]=>
  int(127)
}

Voir aussi

• imagecolorset() - Change la couleur dans une palette à l'index donné
• imagecolorsforindex() - Retourne la couleur associée à un index
• imagesetpixel() - Dessine un pixel