2024 年 PHP 日本大会

imagescale

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

imagescale使用给定的新宽度和高度缩放图像

描述

imagescale(
    GdImage $image,
    int $width,
    int $height = -1,
    int $mode = IMG_BILINEAR_FIXED
): GdImage|false

imagescale() 使用给定的插值算法缩放图像。

注意:

与许多其他图像函数不同,imagescale() 不会修改传入的 image;而是返回一个的图像。

参数

image

一个 GdImage 对象,由图像创建函数(例如 imagecreatetruecolor())返回。

width

要缩放到的图像宽度。

height

要缩放到的图像高度。如果省略或为负数,则将保持纵横比。

mode

IMG_NEAREST_NEIGHBOURIMG_BILINEAR_FIXEDIMG_BICUBICIMG_BICUBIC_FIXED 或其他任何值(将使用两遍处理)。

注意: IMG_WEIGHTED4 暂不支持。

返回值

成功时返回缩放后的图像对象,失败时返回 false

错误/异常

如果 widthheight 会导致溢出/下溢,则抛出 ValueError

如果 mode 无效,则抛出 ValueError

变更日志

版本 描述
8.4.0 现在如果 widthheight 会导致溢出/下溢,则抛出 ValueError
8.4.0 现在如果 mode 无效,则抛出 ValueError
8.0.0 成功时,此函数现在返回一个 GDImage 实例;之前返回的是 resource
8.0.0 image 现在需要一个 GdImage 实例;之前需要一个有效的 gd resource

参见

添加注释

用户贡献的注释 1 条注释

匿名
1 年前
看起来,你不能像高度那样省略宽度。如果你为宽度写 -1 并为高度指定一个数字,它将返回 false
To Top