Documentación offline PHP master

imagecrop

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

imagecrop

Recorta una imagen en el rectángulo dado

Descripción#

imagecrop(GdImage $image, array $rectangle): GdImage
```php

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 recurso `gd` de tipo `resource` 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 con `imagecrop`

Este ejemplo muestra cómo recortar una imagen en una zona cuadrada.
0, 'y' => 0, 'width' => $size, 'height' => $size]); if ($im2 !== FALSE) { imagepng($im2, 'example-cropped.png'); } ?>

```php

Véase también#

imagecropauto