函数名:imageresolution()
适用版本:PHP 7.2.0 及以上版本
用法:imageresolution() 函数用于获取或设置图像的分辨率。
语法:
imageresolution(resource $image, [float $resolution = -1])
参数:
- $image:需要设置分辨率的图像资源(由 imagecreate() 或 imagecreatefrom*() 函数创建)。
- $resolution(可选):要设置的分辨率。如果未提供此参数,则函数返回当前图像的分辨率。默认值为 -1。
返回值:
- 如果 $resolution 参数未提供,则返回一个包含当前图像分辨率的关联数组,数组包含 "x" 和 "y" 两个键名,分别代表水平和垂直分辨率。如果分辨率未设置,则返回 FALSE。
- 如果提供了 $resolution 参数,则返回 TRUE 表示分辨率设置成功,或者返回 FALSE 表示设置失败。
示例:
// 创建一个 200x200 像素的图像资源
$image = imagecreate(200, 200);
// 获取当前图像的分辨率
$resolution = imageresolution($image);
echo "当前图像分辨率:水平 " . $resolution['x'] . " dpi,垂直 " . $resolution['y'] . " dpi";
// 设置图像分辨率为 300 dpi
if (imageresolution($image, 300)) {
echo "图像分辨率设置成功";
} else {
echo "图像分辨率设置失败";
}
// 再次获取当前图像的分辨率
$resolution = imageresolution($image);
echo "当前图像分辨率:水平 " . $resolution['x'] . " dpi,垂直 " . $resolution['y'] . " dpi";
// 销毁图像资源
imagedestroy($image);
注意事项:
- imageresolution() 函数仅适用于 GD 库版本 2.1.0 及以上版本。
- 如果分辨率设置失败,可能是由于 GD 库版本不支持该功能或者图像资源不可写入。