imagerotate

Rotate an image with a given angle

&reftitle.description; ``GdImage``false```imagerotate` `GdImage` `image` `float` `angle` `int` `background_color`

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.

&reftitle.parameters;

&gd.image.description;

`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

&reftitle.returnvalues;

Returns an image object for the rotated image, &return.falseforfailure;.

&reftitle.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.
&gd.changelog.image-param;
8.0.0 | The unused `ignore_transparent` expects a `bool` now; previously it expected an `int`.

&reftitle.examples;

### 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);
    ?>

&example.outputs.similar; Output of example : Rotate an image 180 degrees
&reftitle.notes; ¬e.gd.interpolation;
&reftitle.seealso;

- `imagesetinterpolation`