imagecopymergegray

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

imagecopymergegray — Копирует часть изображения с наложением в градациях серого

Описание

imagecopymergegray(
    GdImage $dst_image,
    GdImage $src_image,
    int $dst_x,
    int $dst_y,
    int $src_x,
    int $src_y,
    int $src_width,
    int $src_height,
    int $pct
): true

Функция копирует на исходном изображении src_image область шириной src_width и высотой src_height и помещает скопированную часть на целевое изображение dst_image. Координаты левого верхнего угла области на исходном изображении определяют параметры src_x и src_y, а на целевом — dst_x и dst_y.

Функция работает аналогично функции imagecopymerge(), за исключением сохранения насыщенности цвета исходного изображения при наложении путём преобразования цветов пикселей конечного изображения в градации серого перед копированием.

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

dst_image: Ресурс целевого изображения.
src_image: Ресурс исходного изображения.
dst_x: Координата точки по оси x на целевом изображении.
dst_y: Координата точки по оси y на целевом изображении.
src_x: Координата точки по оси x на исходном изображении.
src_y: Координата точки по оси y на исходном изображении.
src_width: Ширина области на исходном изображении.
src_height: Высота области на исходном изображении.
pct: Функция преобразует исходное изображение src_image в изображение в градациях серого на основе значения параметра pct: при значении 0 изображение становится серым, а со значением 100 остаётся без изменений. При передаче в параметр pct значения 100 функция ведёт себя аналогично функции imagecopy(), но игнорирует альфа-компонент для палитровых изображений; при этом для truecolor-изображений альфа-прозрачность поддерживается.

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

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

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

Версия	Описание
8.0.0	Параметры `dst_image` и `src_image` теперь ожидают объект GdImage; раньше параметры ожидали тип resource.

Примеры

Пример #1 Пример копирования фрагмента изображения функцией imagecopymergegray()

<?php

// Создаём изображении
$dest = imagecreatefromgif('php.gif');
$src = imagecreatefromgif('php.gif');

// Копируем фрагмент изображения и накладываем в оттенках серого с непрозрачностью 20 %
imagecopymergegray($dest, $src, 10, 10, 0, 0, 100, 47, 20);

// Устанавливаем заголовок с MIME-типом изображения и выводим результат
header('Content-Type: image/gif');
imagegif($dest);