PHP Conference Nagoya 2025

imagescale

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

imagescaleScale an image using the given new width and height

Beschreibung

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

imagescale() scales an image using the given interpolation algorithm.

Hinweis:

Unlike many of other image functions, imagescale() does not modify the passed image; instead, a new image is returned.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

width

The width to scale the image to.

height

The height to scale the image to. If omitted or negative, the aspect ratio will be preserved.

mode

One of IMG_NEAREST_NEIGHBOUR, IMG_BILINEAR_FIXED, IMG_BICUBIC, IMG_BICUBIC_FIXED or anything else (will use two pass).

Hinweis: IMG_WEIGHTED4 is not yet supported.

Rückgabewerte

Return the scaled image object on successBei einem Fehler wird false zurückgegeben..

Fehler/Exceptions

Throws a ValueError if width or height would cause over-/underflow.

Throws a ValueError if mode is invalid.

Changelog

Version Beschreibung
8.4.0 Now throws a ValueError if width or height would cause over-/underflow.
8.4.0 Now throws a ValueError if mode is invalid.
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.

Siehe auch

add a note

User Contributed Notes 1 note

up
6
Anonymous
1 year ago
Seemingly, you can't omit the width the same way you do with the height. If you write -1 for the width and specify a number for the height it will return false
To Top