PHP Conference Japan 2024

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_NEIGHBOUR(最近鄰插值), IMG_BILINEAR_FIXED(固定雙線性插值), IMG_BICUBIC(雙三次插值), IMG_BICUBIC_FIXED(固定雙三次插值)或其他任何值(將使用兩次傳遞)。

注意 IMG_WEIGHTED4(加權 4 插值)目前尚未支援。

返回值

成功時返回縮放後的影像物件,失敗時返回 false

錯誤/異常

如果 widthheight 會導致溢位/下溢,則會擲出 ValueError 異常。

如果 mode 無效,則會擲出 ValueError 異常。

更新日誌

版本 說明
8.4.0 現在,如果 widthheight 會導致溢位/下溢,則會擲出 ValueError 異常。
8.4.0 現在,如果 mode 無效,則會擲出 ValueError 異常。
8.0.0 成功時,此函式現在返回 GDImage 實例;先前返回的是 資源
8.0.0 image 現在需要 GdImage 實例;先前需要有效的 gd 資源

參見

新增註釋

使用者貢獻的註釋 1 則註釋

匿名
1 年前
似乎您不能像省略高度那樣省略寬度。如果您將寬度寫成 -1 並指定高度的數字,它將返回 false
To Top