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

Recurso de tipo enlace a la imagen de destino.

src_image

Recurso de tipo enlace a la imagen original.

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

Ancho original.

src_height

Altura original.

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

Devuelve true en caso de éxito o false en caso de 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);
?>