Home/ Manual/ image / functions/ imagerotate

imagerotate

PHP function Edit on GitHub ✎

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

Rotate an image with a given angle

Description

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

Rotates the image image using the given angle in degrees.

The center of rotation is the center of the image, and the rotated image may have different dimensions than the original image.

Parameters

angle: Rotation angle, in degrees. The rotation angle is interpreted as the number of degrees to rotate the image anticlockwise.
background_color: Specifies the color of the uncovered zone after the rotation

Return Values

Returns an image object for the rotated image, Falseforfailure.

Changelog

Version	Description
8.3.0	The unused `ignore_transparent` has been completely removed.
8.0.0	On success, this function returns a `GDImage` instance now; previously, a `resource` was returned.
8.0.0	The unused `ignore_transparent` expects a `bool` now; previously it expected an `int`.

Examples

Rotate an image 180 degrees

This example rotates an image 180 degrees - upside down.

php

<?php
// File and rotation
$filename = 'test.jpg';
$degrees = 180;

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

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

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

// Output
imagejpeg($rotate);
?>

The above example will output something similar to: Output of example : Rotate an image 180 degrees