imagecolorexact

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

imagecolorexact — Получение индекса заданного цвета

Описание

imagecolorexact(
    GdImage $image,
    int $red,
    int $green,
    int $blue
): int

Возвращает индекс для заданного цвета в палитре изображения.

Если изображение было создано из файла, то будут распознаны только цвета, используемые в изображении. Цвета, которые используются только в палитре, распознаны не будут.

Список параметров

image: Объект GdImage, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
red: Значение красного компонента цвета.
green: Значение зелёного компонента цвета.
blue: Значение синего компонента цвета.

Возвращаемые значения

Возвращает индекс для заданного цвета в палитре изображения либо -1, если такого цвета в палитре нет.

Список изменений

Версия	Описание
8.0.0	`image` теперь ожидает экземпляр GdImage; ранее ожидался корректный `gd` ресурс (resource).

Примеры

Пример #1 Получение цветов GD логотипа

<?php
// создание изображения
$im = imagecreatefrompng('./gdlogo.png');

$colors   = Array();
$colors[] = imagecolorexact($im, 255, 0, 0);
$colors[] = imagecolorexact($im, 0, 0, 0);
$colors[] = imagecolorexact($im, 255, 255, 255);
$colors[] = imagecolorexact($im, 100, 255, 52);

print_r($colors);

// освобождение памяти
imagedestroy($im);
?>

Результатом выполнения данного примера будет что-то подобное:

Array
(
    [0] => 16711680
    [1] => 0
    [2] => 16777215
    [3] => 6618932
)

Смотрите также

imagecolorclosest() - Получение индекса цвета ближайшего к заданному