imagecopy

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

imagecopyCopia uma parte de uma imagem

Descrição

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 uma parte de src_image para dst_image, começando nas coordenadas x, y src_x, src_y com uma largura de src_width e uma altura de src_height. A porção definida será copiada para as coordenadas x, y, dst_x e dst_y.

Parâmetros

dst_image

Recurso da imagem de destino.

src_image

Recurso da imagem de origem.

dst_x

Coordenada x do ponto de destino.

dst_y

Coordenada y do ponto de destino.

src_x

Coordenada x do ponto de origem.

src_y

Coordenada y do ponto de origem.

src_width

Largura da imagem de origem.

src_height

Altura da imagem de origem.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 dst_image e src_image esperam instâncias de GdImage; anteriormente, esperavam resource.

Exemplos

Example #1 Recortando o logotipo do PHP.net

<?php
// Criar instâncias de imagens
$src = imagecreatefromgif('php.gif');
$dest = imagecreatetruecolor(80, 40);

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

// Exibir e liberar da memória
header('Content-Type: image/gif');
imagegif($dest);

imagedestroy($dest);
imagedestroy($src);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: Recortando o logotipo do PHP.net

Veja Também

  • imagecrop() - Recorta uma imagem no retângulo informado