# imagerotate

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

imagerotate — Rotate an image with a given angle

### Description

imagerotate ( resource `$image` , float `$angle` , int `$bgd_color` [, int `$dummy` = 0 ] ) : resource|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

`image`

  An image resource, returned by one of the image creation functions, such as imagecreatetruecolor().

`angle`

  Rotation angle, in degrees. The rotation angle is interpreted as the number of degrees to rotate the image anticlockwise.

`bgd_color`

  Specifies the color of the uncovered zone after the rotation

`dummy`

  This parameter is unused.

### Return Values

Returns an image resource for the rotated image, or `FALSE` on failure.

### Examples

Example #1 Rotate an image 180 degrees

This example rotates an image 180 degrees - upside down.

`<?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);
// Free the memory
imagedestroy($source);
imagedestroy($rotate);
?>`

The above example will output something similar to:

### Notes

> Note:

> This function is affected by the interpolation method set by imagesetinterpolation().

### See Also

- imagesetinterpolation() - Set the interpolation method