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ãoDescriçã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 resourcegd 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);

    // Libera a memória
    imagedestroy($source);
    imagedestroy($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

    To Top