PHP Conference Nagoya 2025

imagescale

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

imagescaleMuda 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.

Nota:

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

Nota: 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.

Erros/Exceções

Lança uma ValueError se width ou height puderem causar um estouro de limites.

Lança uma ValueError se mode for inválido.

Registro de Alterações

Versão Descrição
8.4.0 Agora lança uma ValueError se width ou height puderem causar um estouro de limites.
8.4.0 Agora lança uma ValueError se mode for inválido.
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

adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
6
Anonymous
1 year ago
Seemingly, you can't omit the width the same way you do with the height. If you write -1 for the width and specify a number for the height it will return false
To Top