(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorat — Devuelve el índice del color de un píxel dado
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 :
image
Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().
x
X : coordenada del punto.
y
Y : coordenada del punto.
Devuelve el índice del color o false
en caso de error.
Esta función puede
devolver el valor booleano false
, pero también puede devolver un valor no booleano que se
evalúa como false
. Por favor lea la sección sobre Booleanos para más
información. Use el operador
=== para comprobar el valor devuelto por esta
función.
Versión | Descripción |
---|---|
8.0.0 |
image expects a GdImage
instance now; previously, a valid gd resource was expected.
|
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);
?>
El resultado del ejemplo sería algo 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);
?>
El resultado del ejemplo sería algo similar a:
array(4) { ["red"]=> int(119) ["green"]=> int(123) ["blue"]=> int(180) ["alpha"]=> int(127) }