imagerotate

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

imagerotateRota una imagen en un ángulo

Descripción

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

imagerotate() rota la imagen image en un ángulo de angle, en grados.

El centro de rotación es el centro de la imagen, y la imagen rotada puede tener dimensiones diferentes de la imagen original.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

angle

El ángulo de rotación, en grados. El ángulo de rotación es interpretado como el número de grados para rotar la imagen en sentido contrario a las agujas del reloj.

background_color

Especifica el color de las zonas que serán descubiertas después de la rotación.

Valores devueltos

Devuelve un objeto de imagen correspondiente a la imagen después de la rotación, o false en caso de error.

Historial de cambios

Versión Descripción
8.3.0 El parámetro no utilizado ignore_transparent ha sido completamente eliminado.
8.0.0 En caso de éxito, esta función devuelve ahora una instancia de GDImage ; anteriormente, se devolvía un resource.
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.
8.0.0 El parámetro no utilizado ignore_transparent ahora espera un bool ; anteriormente esperaba un int.

Ejemplos

Ejemplo #1 Rotación de una imagen de 180 grados

Este ejemplo rota una imagen de 180 grados - al revés.

<?php
// Archivo y grados de rotación
$filename = 'test.jpg';
$degrees = 180;

// Tipo de contenido
header('Content-type: image/jpeg');

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

// Rotación
$rotate = imagerotate($source, $degrees, 0);

// Mostrar
imagejpeg($rotate);

?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: Rotación de una imagen de 180 grados

Notas

Nota:

Está función se ve afectada por el método de interpolación establecido por imagesetinterpolation().

Ver también