imagecolorat

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

imagecoloratDevuelve el índice del color de un píxel dado

Descripción

imagecolorat(GdImage $image, int $x, int $y): int|false

Devuelve el índice del color del píxel situado en las coordenadas especificadas, en la imagen image.

Si la imagen es una imagen en TrueColor, esta función devuelve el valor RGB del píxel, en forma de un entero. Utilizar los operadores a nivel de bits y los máscaras para distinguir el rojo, del verde y del azul :

Parámetros

image

Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().

x

X : coordenada del punto.

y

Y : coordenada del punto.

Valores devueltos

Devuelve el índice del color o false si ocurre un error.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Historial de cambios

Versión Descripción
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Ejemplos

Ejemplo #1 Acceso a los valores RGB

<?php
$im
= imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);
$r = ($rgb >> 16) & 0xFF;
$g = ($rgb >> 8) & 0xFF;
$b = $rgb & 0xFF;
var_dump($r, $g, $b);
?>

Resultado del ejemplo anterior es similar a :

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

Ejemplo #2 Valores RVB legibles utilizando la función imagecolorsforindex()

<?php
$im
= imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);

$colors = imagecolorsforindex($im, $rgb);

var_dump($colors);
?>

Resultado del ejemplo anterior es similar a :

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

Ver también