imagecolortransparent

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

imagecolortransparent — Определяет цвет как прозрачный

Описание

imagecolortransparent(GdImage $image, ?int $color = null): int

Функция получает или устанавливает прозрачность цвета в изображении image.

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

image: Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
color: Идентификатор цвета, созданный функцией imagecolorallocate().

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

Функция возвращает идентификатор нового (или текущего, если ничего не изменилось) цвета. При установке для параметра color значения null, когда в изображении нет прозрачных цветов, функция вернёт -1.

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

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

Примеры

Пример #1 Пример определения цвета прозрачным функцией imagecolortransparent()

<?php

// Создадим изображение размером 55x30
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// Сделаем фон прозрачным
imagecolortransparent($im, $black);

// Нарисуем красный прямоугольник
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// Сохраним изображение
imagepng($im, './imagecolortransparent.png');

?>

Вывод приведённого примера будет похож на:

Примечания

Замечание:
Прозрачность копируется только функцией imagecopymerge() и для truecolor-изображений. При вызове функции imagecopy() или палитрового изображения значение альфа-компонента не копируется.

Замечание:
Прозрачный цвет — свойство изображения, прозрачность не относится к свойствам цвета. При установке прозрачности цвета отдельные области изображения этого цвета, которые нарисовали прежде, станут прозрачными.