imagescale

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

imagescale — Muda a escala de uma imagem usando largura e altura informadas

Descrição

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

imagescale() escala de uma imagem usando o algoritmo de interpolação informado.

Note:

Diferentemente de muitas outras funções de imagem, imagescale() não modifica o argumento image informado; ao invés disso, uma nova imagem é retornada.

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

width

A largura que a imagem terá na nova escala.

height

A altura que a imagem terá na nova escala. Se for omitida ou se for negativa, a razão de aspecto será preservada.

mode

Uma das constantes IMG_NEAREST_NEIGHBOUR, IMG_BILINEAR_FIXED (o padrão), IMG_BICUBIC, IMG_BICUBIC_FIXED ou qualquer outro valor (neste caso será feita dupla passagem).

Note: IMG_WEIGHTED4 ainda não é suportada.

Valor Retornado

Retorna o objeto imagem com a escala modificada em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função agora retorna uma instância de GDImage; anteriormente, um resource era retornado.
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resource gd válido era esperado.

Veja Também