PHP Conference Japan 2024

imagecrop

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

imagecrop裁剪影像至指定的矩形區域

說明

imagecrop(GdImage $image, 陣列 $rectangle): GdImage|false

將影像裁剪至指定的矩形區域,並返回結果影像。指定的 image 不會被修改。

參數

image

一個 GdImage 物件,由其中一個影像建立函式返回,例如 imagecreatetruecolor()

矩形

裁剪矩形以 陣列 呈現,鍵值包含 xywidthheight

返回值

成功時返回裁剪後的影像物件,失敗時返回 false

更新日誌

版本 說明
8.0.0 image 現在需要一個 GdImage 實例;先前需要一個有效的 gd 資源
8.0.0 成功時,此函式現在返回一個 GDImage 實例;先前返回一個 資源

範例

範例 #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);
?>

另請參閱

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top