array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.imagecrop.php', 1 => 'imagecrop', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Функции GD и функции для работы с изображениями', ), 'prev' => array ( 0 => 'function.imagecreatetruecolor.php', 1 => 'imagecreatetruecolor', ), 'next' => array ( 0 => 'function.imagecropauto.php', 1 => 'imagecropauto', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/image/functions/imagecrop.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Обрезать изображение до заданного прямоугольника
Обрезает изображение до заданной прямоугольной области и возвращает полученное изображение.
Заданный параметр image
не изменяется.
image
Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
rectangle
Обрезанный прямоугольник в виде массива (array) с ключами
x
, y
, width
и
height
.
Возвращает объект обрезанного изображения в случае успешного выполнения или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd -ресурс (resource).
|
8.0.0 | В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource). |
Пример #1 Пример использования imagecrop()
В этом примере показано, как обрезать изображение до квадратной области.
<?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);
?>