imagecrop

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

imagecropRecorta una imagen en el rectángulo dado

Descripción

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 recurso image, es devuelto 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 en caso de error.

Historial de cambios

Versión Descripción
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