imagecropauto 函数说明

函数名

imagecropauto

适用 PHP 版本

PHP 5.5 及以上版本

函数说明

imagecropauto 函数是用于自动裁剪图像的一个功能，能够根据图像的内容和透明度自动判断裁剪区域，去除多余的透明区域或背景。该函数对于处理带有透明背景的 PNG 图片或需要去除空白区域的图像非常有用。

函数语法

imagecropauto( GdImage $image, int $mode = IMG_CROP_DEFAULT, float $threshold = 0.05, int $color = -1 ) : GdImage|false

参数

• $image (GdImage): 要裁剪的图像资源。
• $mode (int, 可选): 裁剪模式，定义裁剪时的行为，常见的模式包括：
  • IMG_CROP_DEFAULT: 默认模式，自动裁剪背景透明区域。
  • IMG_CROP_TRANSPARENT: 仅裁剪透明区域。
  • IMG_CROP_WHITE: 裁剪白色区域。
  • IMG_CROP_BLACK: 裁剪黑色区域。
• $threshold (float, 可选): 设置裁剪算法的灵敏度，范围是 0 到 1，值越小，裁剪越严格。默认值为 0.05。
• $color (int, 可选): 颜色值（如 RGB 或 HEX），用来指定裁剪背景色，默认值为 -1，表示不指定颜色。

返回值

返回裁剪后的图像资源（GdImage）。如果裁剪失败或图像无效，则返回 false。

示例

以下是使用 imagecropauto 函数的示例：

示例代码：

<?php
$image = imagecreatefrompng('image.png');
$cropped_image = imagecropauto($image, IMG_CROP_DEFAULT);
if ($cropped_image !== false) {
imagepng($cropped_image, 'cropped_image.png');
imagedestroy($cropped_image);
}
imagedestroy($image);


示例代码说明：

此示例代码首先从一个 PNG 图片中创建一个图像资源。然后，使用 imagecropauto 函数自动裁剪图像，去除多余的透明区域（采用默认模式）。裁剪后的图像会被保存为 'cropped_image.png'，并在处理完成后销毁图像资源。