IMAGEROTATE(3) 1 IMAGEROTATE(3)
imagerotate - Rotate an image with a given angle
SYNOPSIS
resource imagerotate (resource $image, float $angle, int $bgd_color, [int $ignore_transparent])
DESCRIPTION
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
o $
image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3).
o $angle
- Rotation angle, in degrees. The rotation angle is interpreted as the number of degrees to rotate the image anticlockwise.
o $bgd_color
- Specifies the color of the uncovered zone after the rotation
o $ignore_transparent
- If set and non-zero, transparent colors are ignored (otherwise kept).
RETURN VALUES
Returns an image resource for the rotated image, or FALSE on failure.
CHANGELOG
+--------+---------------------------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+---------------------------------------------------+
| 5.5.0 | |
| | |
| | This function is now affected by the interpola- |
| | tion method set by the imagesetinterpolation(3) |
| | function. |
| | |
| 5.1.0 | |
| | |
| | $ignore_transparent was added. |
| | |
+--------+---------------------------------------------------+
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:[NOT DISPLAYABLE MEDIA]Output of example : Rotate an image 180 degrees
NOTES
Note
This function is affected by the interpolation method set by imagesetinterpolation(3).
SEE ALSO
imagesetinterpolation(3).
PHP Documentation Group IMAGEROTATE(3)
