(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecropauto — Обрезает изображение автоматически, используя один из доступных режимов
$image
,$mode
= IMG_CROP_DEFAULT
,$threshold
= 0.5,$color
= -1
Автоматически обрезает изображение в соответствии с заданным
mode
.
image
Объект GdImage, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
mode
Одна из следующих констант:
IMG_CROP_DEFAULT
IMG_CROP_TRANSPARENT
.
До PHP 7.4.0, связанный libgd использовал IMG_CROP_SIDES
,
если изображение не имело прозрачного цвета.
IMG_CROP_TRANSPARENT
IMG_CROP_BLACK
IMG_CROP_WHITE
IMG_CROP_SIDES
IMG_CROP_THRESHOLD
threshold
и
color
.
threshold
Определяет допуск в процентах, который будет использоваться при сравнении цвета изображения и цвета обрезки. Метод, используемый для расчёта цветовой разницы, основан на цветовом расстоянии в кубе RGB(a).
Используется только в режиме IMG_CROP_THRESHOLD
.
Замечание: До PHP 7.4.0 в комплекте libgd использовался несколько иной алгоритм, поэтому один и тот же
threshold
давал разные результаты для системного и связанного libgd.
color
Либо значение цвета RGB, либо индекс палитры.
Используется только в режиме IMG_CROP_THRESHOLD
.
Возвращает объект обрезанного изображения в случае успешного выполнения или false
в случае возникновения ошибки.
Если полное изображение было обрезано, imagecrop() возвращает false
.
Версия | Описание |
---|---|
8.0.0 |
image теперь ожидает экземпляр GdImage;
ранее ожидался корректный gd ресурс (resource).
|
8.0.0 | В случае успешного выполнения функция теперь возвращает объект GDImage; ранее возвращался ресурс (resource). |
7.4.0 |
Поведение imagecropauto() в комплекте libgd синхронизировано
с системным libgd: IMG_CROP_DEFAULT больше
не использует IMG_CROP_SIDES , и для обрезки порога теперь
используется тот же алгоритм, что и системным libgd.
|
7.4.0 |
Значение по умолчанию mode было изменено на
IMG_CROP_AUTO . Ранее значение по умолчанию было
-1 , что соответствует IMG_CROP_DEFAULT ,
но передача -1 теперь устарела.
|
Пример #1 Правильная обработка автообрезки
Как отмечено в разделе возвращаемого значения, imagecropauto()
возвращает false
, если все изображение
было обрезано. В этом примере у нас есть ресурс изображения
$im
, который должен быть автоматически обрезан, только
если есть что обрезать; в противном случае мы хотим перейти к исходному изображению.
<?php
$cropped = imagecropauto($im, IMG_CROP_DEFAULT);
if ($cropped !== false) { // в случае возврата нового объекта изображения
imagedestroy($im); // мы уничтожаем исходное изображение
$im = $cropped; // и назначаем обрезанное изображение в $im
}
?>