imagecolorat

Get the index of the color of a pixel

&reftitle.description; `int` `imagecolorat` `resource` `image` `int` `x` `int` `y`

Returns the index of the color of the pixel at the specified location in the image specified by `image`.

If PHP is compiled against GD library 2.0 or higher and the image is a truecolor image, this function returns the RGB value of that pixel as integer. Use bitshifting and masking to access the distinct red, green and blue component values:

&reftitle.parameters;

&gd.image.description;

`x`

- x-coordinate of the point.

`y`

- y-coordinate of the point.

&reftitle.returnvalues;

Returns the index of the color.

&reftitle.examples;

### Access distinct RGB values

    <?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);
    ?>

&example.outputs.similar;

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

### Human-readable RGB values using `imagecolorsforindex`

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

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

    var_dump($colors);
    ?>

&example.outputs.similar;

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

&reftitle.seealso;

- `imagecolorset`
- `imagecolorsforindex`
- `imagesetpixel`