# imagerotate

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

imagerotate — Fait tourner une image d'un angle

### Description

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

imagerotate() fait tourner l'image `image` d'un angle de `angle`, en degrés.

Le centre de rotation est le centre de l'image, et l'image tournée peut avoir des dimensions différentes de l'image originale.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`angle`

  L'angle de rotation, en degrés. L'angle de rotation est interprété comme étant le nombre de degrés à tourner l'image dans le sens inverse des aiguilles d'une montre.

`background_color`

  Spécifie la couleur des zones qui seront découvertes après la rotation.

### Valeurs de retour

Retourne un objet d'image correspondant à l'image après rotation, ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.3.0 | Le paramètre inutilisé `ignore_transparent` a été complètement supprimé.
8.0.0 | En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.
8.0.0 | Le paramètre inutilisé `ignore_transparent` attend désormais un bool ; auparavant il s'attendait à un int.

### Exemples

Exemple #1 Rotation d'une image de 180 degrés

Cet exemple tourne une image de 180 degrés - à l'envers.

`<?php
// Fichier et degrés de rotation
$filename = 'test.jpg';
$degrees = 180;
// Content type
header('Content-type: image/jpeg');
// Chargement
$source = imagecreatefromjpeg($filename);
// Rotation
$rotate = imagerotate($source, $degrees, 0);
// Affichage
imagejpeg($rotate);
?>`

Résultat de l'exemple ci-dessus est similaire à :

### Notes

> Note:

> Cette fonction est affectée par la méthode d'interpolation, définie par la fonction imagesetinterpolation().

### Voir aussi

- imagesetinterpolation() - Défini la méthode d'interpolation