imagecopymerge

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

imagecopymergeКопирует часть изображения с наложением

Описание

imagecopymerge(
    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.

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

dst_image

Ресурс целевого изображения.

src_image

Ресурс исходного изображения.

dst_x

Координата точки по оси x на целевом изображении.

dst_y

Координата точки по оси y на целевом изображении.

src_x

Координата точки по оси x на исходном изображении.

src_y

Координата точки по оси y на исходном изображении.

src_width

Ширина области на исходном изображении.

src_height

Высота области на исходном изображении.

pct

Два изображения совмещаются в зависимости от параметра pct, который варьируется в диапазоне от 0 до 100. Когда параметр pct = 0, наложение не выполняется. Со значением 100 поведение функции аналогично функции imagecopy() для палитровых изображений, несмотря на поддержку прозрачности для truecolor-изображений.

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

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

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

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

Примеры

Пример #1 Пример совмещения двух копий логотипа PHP.net с 75-процентной прозрачностью

<?php

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

// Копируем и накладываем части
imagecopymerge($dest, $src, 10, 10, 0, 0, 100, 47, 75);

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