Muda a escala de uma imagem usando largura e altura informadas

# imagescale

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

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

### Descrição

function 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

- imagecopyresized() - Copia e redimensiona parte de uma imagem
- imagecopyresampled() - Copia e redimensiona parte de uma imagem com reamostragem

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open