imagerotate

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

imagerotateПоворот изображения с заданным углом

Описание

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

Поворот изображения image на заданный угол angle в градусах.

Центром поворота является центр изображения. Поворачиваемое изображение может отличаться размером от оригинала.

Список параметров

image

Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().

angle

Угол поворота в градусах против часовой стрелки.

background_color

Цвет фона свободной зоны после поворота.

Возвращаемые значения

Возвращает объект повёрнутого изображения в случае успешного выполнения или false, если возникла ошибка.

Список изменений

Версия Описание
8.3.0 Неиспользуемый параметр ignore_transparent был полностью удалён.
8.0.0 В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource).
8.0.0 Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd-ресурс (resource).
8.0.0 Неиспользуемый v теперь ожидает логическое значение (bool); ранее ожидалось целое число (int).

Примеры

Пример #1 Поворот изображения на 180 градусов

Этот пример поворачивает изображения на 180 градусов - верхом вниз.

<?php
// Файл и угол поворота
$filename = 'test.jpg';
$degrees = 180;

// Тип содержимого
header('Content-type: image/jpeg');

// Загрузка изображения
$source = imagecreatefromjpeg($filename);

// Поворот
$rotate = imagerotate($source, $degrees, 0);

// Вывод
imagejpeg($rotate);

// Высвобождение памяти
imagedestroy($source);
imagedestroy($rotate);
?>

Вывод приведённого примера будет похож на:

Пример выведет изображение повёрнутое на 180 градусов

Примечания

Замечание:

Эта функция подвержена влиянию метода интерполяции, установленным функцией imagesetinterpolation().

Смотрите также