imagescale
imagescale
(PHP 5 >= 5.5.0, PHP 7)
imagescale — Scale an image using the given new width and height
Description
resource imagescale ( resource $image , int $new_width [, int $new_height = -1 [, int $mode = IMG_BILINEAR_FIXED ]] )
imagescale() scales an image using the given interpolation algorithm.
Parameters
-
image
-
An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().
-
new_width
-
The width to scale the image to.
-
new_height
-
The height to scale the image to. If omitted or negative, the aspect ratio will be preserved.
CautionYou should always provide the height if using PHP 5.5.18 or earlier, or PHP 5.6.2 or earlier, as the aspect ratio calculation was incorrect.
-
mode
-
One of
IMG_NEAREST_NEIGHBOUR
,IMG_BILINEAR_FIXED
,IMG_BICUBIC
,IMG_BICUBIC_FIXED
or anything else (will use two pass).Note:
IMG_WEIGHTED4
is not yet supported.
Return Values
Return the scaled image resource on success or FALSE
on failure.
Changelog
Version | Description |
---|---|
5.5.19/5.6.3 | The calculation of the height if new_height was negative or omitted was fixed; prior to these versions, the aspect ratio was not maintained correctly. |
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.imagescale.php