Инициализация класса
Как и большинство других классов CodeIgniter, класс для работы с изображениями инициализируется в вашем контроллере посредством функции
$this->load->library:
$this->load->library('image_lib');
После загрузки библиотека готова к использованию. Объект класса доступен как
$this->image_lib
Обработка изображений
Вне зависимости от типа обработки, которую вы собираетесь выполнять (масштабирование, обрезка, вращение или наложение ватермарка), основные действия идентичны. Вы будете устанавливать некоторые параметры, соответствующие действию, которые вы собираетесь выполнить, и затем вызывать одну из четырех функций. Например, для создания миниатюры изображения:
Код выше говорит функции image_resize искать изображение youfon.jpg, находящееся в директории ./uploads/, затем создать миниатюру размером 75 на 50 пикселей, используя GD2 image_library. Так как включена опция maintain_ratio, пропорции миниатюры будет как можно ближе к оригинальной ширине и высоте. Миниатюра будет называться mypic_thumb.jpg
Функции обработки
Доступны четыре функции для обработки изображений:
$this->image_lib->resize()
$this->image_lib->crop()
$this->image_lib->rotate()
$this->image_lib->watermark()
$this->image_lib->clear()
Эти функции возвращают булево TRUE при успехе или FALSE при неудаче. Если у них что-то не получается, вы можете получить сообщения об ошибках с этой функцией:
echo $this->image_lib->display_errors();
Хорошей практикой является использование функции в условии, показывающее ошибки при неудаче, к примеру так:
if ( ! $this->image_lib->resize())
{
echo $this->image_lib->display_errors();
}
Параметры
Параметры, описанные ниже, позволяют вам приспосабливать обработку изображений к вашим потребностям.
Заметим, что не все параметры доступны для каждой функции. Например, оси X и Y нужны только для обрезки изображения. Аналогично, ширина и высота никак не влияют на обрезку. Столбец «применяемость» отображает, к какой функции применим указанный параметр.
Легенда:
R - Масштабирование (Resizing)
C - Обрезка (Cropping)
X - Вращение (Rotation)
W - Наложение ватермарка (Watermarking)
$this->image_lib->resize()
Функция масштабирования изображения позволит вам изменить размер оригинального изображения, создать копию (с масштабированием или без него), или создать миниатюру.
Практически нет различия между созданием копии и созданием миниатюры, за исключением того, что миниатюра имеет маркер, как часть имени (например, mypic_thumb.jpg).
Все параметры, перечисленные в таблице выше, доступны для этой функции, за исключением трех: rotation_angle, x_axis и y_axis.
Создание миниатюры
Функция масштабирования создает файл миниатюры (и сохраняет оригинал), если вы установите парамер в TRUE:
$config['create_thumb'] = TRUE;
Этот единственный параметр определяет, создавать миниатюру или нет.
Создание копии
Функция масштабирования создаст копию изображения (и сохранит оригинал), если вы установите путь и (или) укажете новое имя файла в этом пераметре:
$config['new_image'] = '/path/to/new_image.jpg';
Замечания насчет этого параметра:
Если указано только имя нового изображения, оно будет помещено в ту же директорию, где находится оригинальное
Если указывать только путь, новое изображение будет размещено в новом месте, с тем же именем, что и оригинальное.
Если указать и путь и имя файла, новое изображение будет размещено по новому пути и с новым именем.
Масштабирование оригинального изображения
Если не использован ни один из параметров, указанных выше (create_thumb и new_image), функция масштабирования будет обрабатывать оригинальное изображение.
Наложение ватермарков (водяных знаков)
Функция наложения ватермарков требует библиотеку GD/GD2.
Два типа ватермарков
Есть два типа ватермарков, которые вы можете использовать:
Текст: Сообщение будет сгенерировано используя текст, с шрифтом True Type, который вы указали, или используя родной вывод текста, который предоставляет GD. Если вы используете True Type, ваша инсталляция GD должна быть скомпилирована с поддержкой True Type (чаще всего так, но не всегда).
Наложение: Ватермарк генерируется наложением изображения, обычно прозрачный PNG или GIF.
Наложение ватермарка
Также как и с другими функциями (масштабирование, обрезка и вращение), основной процесс для наложения ватермарка заключается в указании параметров, и затем вызове функции. Вот пример:
Пример выше использует 16-пиксельный шрифт True Type, чтобы создать текст "Copyright 2006 - John Doe".
Ватермарк будет размещен внизу по центру изображения, в 20 пикселях от нижней границы изображения.
Параметры наложения ватермарков
Эта таблица показывает парамеры, которые доступны для обоих типов наложения ватермарков (текст и изображение)