PHP 8.4.2 Released!

imagescale

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

imagescaleMet à l'échelle une image en utilisant une hauteur et une largeur fournies

Description

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

imagescale() met à l'échelle une image en utilisant l'algorithme d'interpolation donné.

Note:

Contrairement à beaucoup d'autres fonctions d'image, imagescale() ne modifie pas l'image fournit ; à la place, une nouvelle image est retournée.

Liste de paramètres

image

Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

width

La largeur à utiliser pour la mise à l'échelle de l'image.

height

La hauteur à utiliser pour la mise à l'échelle de l'image. Si omis ou négative, le ratio de l'image sera préservé.

mode

Une des constantes IMG_NEAREST_NEIGHBOUR, IMG_BILINEAR_FIXED, IMG_BICUBIC, IMG_BICUBIC_FIXED ou toute autre (utilisera deux passages).

Note: IMG_WEIGHTED4 n'est pas encore pris en charge.

Valeurs de retour

Retourne l'objet de l'image mise à l'échelle en cas de succès ou false si une erreur survient.

Erreurs / Exceptions

Lève une ValueError si width ou height provoque un dépassement ou un sous-dépassement.

Lève une ValueError si mode est invalide.

Historique

Version Description
8.4.0 Lève désormais une ValueError si width ou height provoque un dépassement ou un sous-dépassement.
8.4.0 Lève désormais une ValueError si mode est invalide.
8.0.0 En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.
8.0.0 image attend une instance de GdImage désormais; auparavant, une resource gd était attendue.

Voir aussi

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