# imagescale

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

imagescale — Met à 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

- imagecopyresized() - Copie et redimensionne une partie d'une image
- imagecopyresampled() - Copie, redimensionne, rééchantillonne une image