imagescale

(PHP 5 >= 5.5.0, PHP 7)

imagescaleScale an image using the given new width and height

Описание

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.

Список параметров

image

Ресурс изображения, полученный одной из функций создания изображений, например, такой как 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.

Предостережение

You 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).

Замечание: IMG_WEIGHTED4 is not yet supported.

Возвращаемые значения

Return the scaled image resource on success или FALSE в случае возникновения ошибки.

Список изменений

Версия Описание
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.

add a note add a note

User Contributed Notes 1 note

up
0
andrew at rollason dot com
1 month ago
It's worth noting that -- unlike many of the image functions -- imagescale returns a new image resource and leaves the existing image resource untouched.  

If you don't need the original image after generating a scaled version, remember to imagedestroy() it.
To Top