Recorta una imagen en el rectángulo dado

# imagecrop

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imagecrop — Recorta una imagen en el rectángulo dado

### Descripción

function imagecrop(GdImage `$image`, array `$rectangle`): GdImage|false

Recorta una imagen en la zona rectangular dada y devuelve la imagen resultante. La `image` no se modifica.

### Parámetros

`image`
  Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
`rectangle`

  array que contiene las claves `x`, `y`, `width` y `height`.

### Valores devueltos

Devuelve el objeto de la imagen recortada en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.
8.0.0 | En caso de éxito, esta función devuelve ahora una instancia de GDImage; anteriormente, se devolvía un resource.

### Ejemplos

Ejemplo #1 Ejemplo con imagecrop()

Este ejemplo muestra cómo recortar una imagen en una zona cuadrada.

    <?php
    $im = imagecreatefrompng('example.png');
    $size = min(imagesx($im), imagesy($im));
    $im2 = imagecrop($im, ['x' => 0, 'y' => 0, 'width' => $size, 'height' => $size]);
    if ($im2 !== FALSE) {
        imagepng($im2, 'example-cropped.png');
    }
    ?>

### Ver también

- imagecropauto() - Recorta una imagen automáticamente utilizando uno de los modos disponibles

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open