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.

    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.

    Registro de Alterações

    VersãoDescriçã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 resourcegd válido era esperado.

    Veja Também

    To Top