Rotaciona uma imagem em um ângulo informado

# imagerotate

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

imagerotate — Rotaciona uma imagem em um ângulo informado

### Descrição

function imagerotate(GdImage `$image`, float `$angle`, int `$background_color`): GdImage|false

Rotaciona a imagem informada em `image` usando o ângulo, em graus, definido por `angle`.

O centro de rotação é o centro da image, e a imagem rotacionada pode ter dimensões diferentes da imagem original.

### Parâmetros

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

  Ângulo de rotação, em graus. O ângulo de rotação é interpretado como o número de graus a rotacionar a imagem no sentido anti-horário.

`background_color`

  Especifica a cor da área não coberta após a rotação.

### Valor Retornado

Retorna um objeto de imagem para a imagem rotacionada, ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.3.0 | O parâmetro não utilizado `ignore_transparent` foi completamente removido.
8.0.0 | Em caso de sucesso, a função agora retorna uma instância 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.
8.0.0 | O parâmetrop não utilizado `ignore_transparent` agora espera um bool; anteriormente era esperado um int.

### Exemplos

Exemplo #1 Rotaciona a imagem em 180 graus

Este exemplo rotaciona a imagem em 180 graus - de cabeça para baixo.

    <?php
    // Arquivo e rotação
    $filename = 'test.jpg';
    $degrees = 180;

    // Tipo de conteúdo
    header('Content-type: image/jpeg');

    // Carrega
    $source = imagecreatefromjpeg($filename);

    // Rotaciona
    $rotate = imagerotate($source, $degrees, 0);

    // Mostra
    imagejpeg($rotate);
    ?>

O exemplo acima produzirá algo semelhante a:

### Notas

> Nota: Esta função é afetada pelo método de interpolação definido por imagesetinterpolation().

### Veja Também

- imagesetinterpolation() - Define o método de interpolação

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