Rotaciona uma imagem em um ângulo informado

Descrição

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

Example #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);

// Libera a memória
imagedestroy($source);
imagedestroy($rotate);
?>

O exemplo acima produzirá algo semelhante a:

Notas

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

Veja Também

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