imagecopymerge

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

imagecopymergeCopia y fusiona una parte de una imagen

Descripción

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
): bool

Copia una parte de la imagen src_image en la imagen de destino dst_image comenzando en las coordenadas (src_x, src_y), con el ancho src_width y la altura src_height. La zona de la imagen así definida será copiada en las coordenadas (dst_x, dst_y), en la imagen de destino.

Parámetros

dst_image

Destination image resource.

src_image

Source image resource.

dst_x

X: coordenada del punto de destino.

dst_y

Y: coordenada del punto de destino.

src_x

X: coordenada del punto origen.

src_y

Y: coordenada del punto origen.

src_width

Source width.

src_height

Source height.

pct

Las dos imágenes serán fusionadas según el argumento pct, que puede valer de 0 a 100. Si pct = 0, no se realiza ninguna acción, mientras que si pct = 100, imagecopymerge() se comporta exactamente como imagecopy() para las imágenes de paleta, excepto por la ignorancia de los componentes alpha, mientras que implementa la transparencia alpha para las imágenes en color verdadero.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.0.0 dst_image y src_image ahora esperan instancias de GdImage; anteriormente, se esperaban resources.

Ejemplos

Ejemplo #1 Fusiona 2 copias del logo PHP.net con 75% de transparencia

<?php
// Creación de las instancias de imagen
$dest = imagecreatefromgif('php.gif');
$src = imagecreatefromgif('php.gif');

// Copia y fusiona
imagecopymerge($dest, $src, 10, 10, 0, 0, 100, 47, 75);

// Mostrar y liberar la memoria
header('Content-Type: image/gif');
imagegif($dest);
?>