English | 简体中文 | 繁體中文
查询

imageresolution()函数—用法及示例

「 获取或设置图像的分辨率 」


函数名: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 库版本不支持该功能或者图像资源不可写入。
补充纠错
上一个函数: imagerotate()函数
下一个函数: imagerectangle()函数
热门PHP函数
分享链接