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

Destination image resource.

src_image

Source image resource.

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

Source width.

src_height

Source height.

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 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);
?>

Resultado del ejemplo anterior es 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