imagealphablending

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imagealphablending Устанавливает режим сопряжения цветов для изображения

Описание

imagealphablending(GdImage $image, bool $enable): true

Функция imagealphablending() устанавливает режим сопряжения цветов для truecolor-изображений при рисовании. В режиме сопряжения альфа-компонент цвета, который передаётся функциям рисования наподобие imagesetpixel(), определяет силу просачивания цвета нижележащего слоя через накладываемое изображение. В результате, модуль gd автоматически сопрягает текущий цвет в каждой точке с цветом рисуемого поверх изображения и сохраняет результат сопряжения в изображении. Сопряжённые пиксели не сохраняют прозрачность. В режиме без сопряжения цвет рисуемого поверх изображения пикселя буквально копируется вместе со своим альфа-компонентом, заменяя пиксель в исходном изображении. Режим сопряжения недоступен при рисовании на палитровых изображениях.

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

image

Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.

enable

Указывает, включать ли режим сопряжения. Включён (true) по умолчанию для truecolor-изображений, для остальных по умолчанию выключен (false).

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

Функция возвращает логическое значение true.

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

Версия Описание
8.0.0 Параметр image теперь принимает объект GdImage; раньше параметр принимал корректный gd-ресурс (resource).

Примеры

Пример #1 Пример установки режима сопряжения цветов функцией imagealphablending()

<?php

// Создаём изображение
$im = imagecreatetruecolor(100, 100);

// Включаем режим сопряжения цветов
imagealphablending($im, true);

// Рисуем прямоугольник
imagefilledrectangle($im, 30, 30, 70, 70, imagecolorallocate($im, 255, 0, 0));

// Устанавливаем заголовок с MIME-типом изображения
header('Content-Type: image/png');

imagepng($im);