imagecopy

Copy part of an image

&reftitle.description; `bool` `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`

Copy a part of `src_image` onto `dst_image` starting at the x,y coordinates `src_x`, `src_y` with a width of `src_width` and a height of `src_height`. The portion defined will be copied onto the x,y coordinates, `dst_x` and `dst_y`.

&reftitle.parameters;

`dst_image`

- &gd.image.destination;

`src_image`

- &gd.image.source;

`dst_x`

- x-coordinate of destination point.

`dst_y`

- y-coordinate of destination point.

`src_x`

- x-coordinate of source point.

`src_y`

- y-coordinate of source point.

`src_width`

- &gd.source.width;

`src_height`

- &gd.source.height;

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `dst_image` and `src_image` expect `GdImage` instances now; previously, `resource`s were expected.

&reftitle.examples;

### Cropping the PHP.net logo

    <?php
    // Create image instances
    $src = imagecreatefromgif('php.gif');
    $dest = imagecreatetruecolor(80, 40);

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

    // Output and free from memory
    header('Content-Type: image/gif');
    imagegif($dest);

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

&example.outputs.similar; Output of example : Cropping the PHP.net logo
&reftitle.seealso;

- `imagecrop`