array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagerotate.php', 1 => 'imagerotate', 2 => 'Rotaciona uma imagem em um ângulo informado', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imageresolution.php', 1 => 'imageresolution', ), 'next' => array ( 0 => 'function.imagesavealpha.php', 1 => 'imagesavealpha', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/image/functions/imagerotate.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagerotate

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

imagerotate — 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

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:

Saída do exemplo: Rotaciona uma imagem em 180 graus

Notas

Nota:

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

Veja Também