imagecrop
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Crop 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 -
由图象创建函数(例如imagecreatetruecolor())返回的图象资源。
-
rectangle -
The cropping rectangle as array with keys
x,y,widthandheight.
返回值
Return cropped image object on success 或者在失败时返回 false.
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 |
image expects a GdImage
instance now; previously, a resource was expected.
|
| 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