# imagescale

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

imagescale — Scale 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

- imagecopyresized() - Kopieren und Ändern der Größe eines Bild-Teiles
- imagecopyresampled() - Copy and resize part of an image with resampling

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open