imagecopy

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecopyCopia una parte de una imagen

Descripción

imagecopy(
    GdImage $dst_image,
    GdImage $src_image,
    int $dst_x,
    int $dst_y,
    int $src_x,
    int $src_y,
    int $src_width,
    int $src_height
): bool

Copia una parte de la imagen src_image a la imagen de destino dst_image, comenzando en las coordenadas src_x, src_y y con un ancho de src_width y una altura de src_height. La porción así definida será copiada y colocada en las coordenadas dst_x y dst_y.

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: coordenadas del punto de destino.

dst_y

Y: coordenadas del punto de destino.

src_x

X: coordenadas del punto origen.

src_y

Y: coordenadas del punto origen.

src_width

Ancho original.

src_height

Altura original.

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 requieren instancias de GdImage; anteriormente se esperaban resources.

Ejemplos

Ejemplo #1 Se recorta el logo PHP.net

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

// Copia
imagecopy($dest, $src, 0, 0, 20, 13, 80, 40);

// Visualización y liberación de la memoria
header('Content-Type: image/gif');
imagegif($dest);
?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: Copia una parte del logo PHP.net

Ver también

  • imagecrop() - Recorta una imagen en el rectángulo dado