php8.5
Home/ Manual/ image / functions/ imagecopymerge

imagecopymerge

PHP function Edit on GitHub ✎

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

Copy and merge part of an image

Description

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

Copy a part of src_image onto dst_image starting at the x,y coordinates src_x, src_y with a width of src_width and a height of src_height. The portion defined will be copied onto the x,y coordinates, dst_x and dst_y.

Parameters

dst_image

Destination

src_image

Source

dst_x

x-coordinate of destination point.

dst_y

y-coordinate of destination point.

src_x

x-coordinate of source point.

src_y

y-coordinate of source point.

src_width

Width

src_height

Height

pct

The two images will be merged according to pct which can range from 0 to 100. When pct = 0, no action is taken, when 100 this function behaves identically to imagecopy() for palette images, except for ignoring alpha components, while it implements alpha transparency for true colour images.

Return Values

Always

Changelog

VersionDescription
8.0.0dst_image and src_image expect GdImage instances now; previously, resources were expected.

Examples

Merging two copies of the PHP.net logo with 75% transparency

php
<?php
// Create image instances
$dest = imagecreatefromgif('php.gif');
$src = imagecreatefromgif('php.gif');

// Copy and merge
imagecopymerge($dest, $src, 10, 10, 0, 0, 100, 47, 75);

// Output
header('Content-Type: image/gif');
imagegif($dest);
?>

Source: reference/image/functions/imagecopymerge.xml · from the official PHP manual (php/doc-en)