PHP Conference Nagoya 2025

imagecrop

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

imagecropCrop an image to the given rectangle

Опис

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

Crops an image to the given rectangular area and returns the resulting image. The given image is not modified.

Параметри

image

Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як imagecreatetruecolor().

rectangle

The cropping rectangle as array with keys x, y, width and height.

Значення, що повертаються

Return cropped image object on success або false в разі помилки.

Журнал змін

Версія Опис
8.0.0 Тепер image має бути примірником GdImage. Раніше очікувався gd-resource.
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.

Приклади

Приклад #1 imagecrop() example

This example shows how to crop an image to a square area.

<?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');
imagedestroy($im2);
}
imagedestroy($im);
?>

Прогляньте також

  • imagecropauto() - Crop an image automatically using one of the available modes
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top