Класс работы с изображениями 

Инициализация класса 

Как и большинство других классов CodeIgniter, класс изображений инициализируется в контроллере с помощью $this->load->library функции:

$this->load->library('image_lib');

Как только библиотека загружена, она готова к использованию. Объект библиотеки изображений, который вы будете использовать для вызова функций: $this->image_lib

$config['image_library'] = 'gd2';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['create_thumb'] = TRUE;
$config['maintain_ratio'] = TRUE;
$config['width']         = 75;
$config['height']       = 50;

$this->load->library('image_lib', $config);

$this->image_lib->resize();

echo $this->image_lib->display_errors();

if ( ! $this->image_lib->resize())
{
        echo $this->image_lib->display_errors();
}

$this->image_lib->display_errors('<p>', '</p>');

Водяные знаки 

Наложение водяных знаков требует GD/GD2 библиотеку.

$config['source_image'] = '/path/to/image/mypic.jpg';
$config['wm_text'] = 'Copyright 2006 - John Doe';
$config['wm_type'] = 'text';
$config['wm_font_path'] = './system/fonts/texb.ttf';
$config['wm_font_size'] = '16';
$config['wm_font_color'] = 'ffffff';
$config['wm_vrt_alignment'] = 'bottom';
$config['wm_hor_alignment'] = 'center';
$config['wm_padding'] = '20';

$this->image_lib->initialize($config);

$this->image_lib->watermark();

Настройки класса 

class CI_Image_lib 

initialize([$props = array()]) 

Параметры:	$props (массив) – Обработка предпочтений изображения
Возвращает:	TRUE при успехе, FALSE в случае недопустимых параметров
Возвращаемый тип:	булево

Инициализирует класс для обработки изображений.

resize() 

Возвращает:	TRUE при успехе, FALSE в случае неудачи
Возвращаемый тип:	булево

Метод изменения размера изображения позволяет изменять размеры исходного изображения, создавать копию (с или без изменения размеров) или создать миниатюру/эскиз изображения.

Для практических целей нет разницы между созданием копии и миниатюры, за исключением того, что эскиз будет обладать маркером как часть имени (т.е. 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) не используются, то метод изменения размеров будет обработки исходное изображение.

crop() 

Возвращает:	TRUE при успехе, FALSE в случае неудачи
Возвращаемый тип:	булево

Метод обрезки работает почти идентично функции изменения размера, кроме необходимости установить настройки для осей X и Y (в пикселях), определяющей область для обрезания:

$config['x_axis'] = 100;
$config['y_axis'] = 40;

Все настройки, кроме этих трех: rotation_angle, create_thumb and new_image, перечислены в таблице предпочтений.

Вот пример, показывающий, как можно обрезать изображение:

$config['image_library'] = 'imagemagick';
$config['library_path'] = '/usr/X11R6/bin/';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['x_axis'] = 100;
$config['y_axis'] = 60;

$this->image_lib->initialize($config);

if ( ! $this->image_lib->crop())
{
        echo $this->image_lib->display_errors();
}

Примечание

Без визуального интерфейса трудно обрезать изображения, так что этот метод не очень полезен, если вы не намерены создать такой интерфейс. Что мы и сделали для модуля фотогалереи в ExpressionEngine, в CMS, которую мы разрабатываем. Мы добавили JavaScript для пользовательского интерфейса, что позволяет выбрать области обрезки.

rotate() 

Возвращает:	TRUE при успехе, FALSE в случае неудачи
Возвращаемый тип:	булево

Метод вращения изображения требует, чтобы угол поворота устанавливался через его предпочтения:

$config['rotation_angle'] = '90';

Доступно 5 вариантов вращения:

1. 90 - вращает против часовой стрелки на 90 градусов.
2. 180 - вращает против часовой стрелки на 180 градусов.
3. 270 - вращает против часовой стрелки на 270 градусов.
4. hor - зеркальное отражение изображения относительно горизонтали.
5. vrt - зеркальное отражение изображения относительно вертикали.

Вот пример, показывающий, как можно повернуть изображение:

$config['image_library'] = 'netpbm';
$config['library_path'] = '/usr/bin/';
$config['source_image'] = '/path/to/image/mypic.jpg';
$config['rotation_angle'] = 'hor';

$this->image_lib->initialize($config);

if ( ! $this->image_lib->rotate())
{
        echo $this->image_lib->display_errors();
}

watermark() 

Возвращает:	TRUE при успехе, FALSE в случае неудачи
Возвращаемый тип:	булево

Создает водяные знаки на изображении, пожалуйста, обратитесь к разделу водяные знаки для более подробной информации.

clear() 

Возвращаемый тип:	смешанный

Метод Clear сбрасывает все значения, используемые при обработке изображения. Его следует использовать при обработке изображений в цикле.

$this->image_lib->clear();

display_errors([$open = '<p>[, $close = '</p>']]) 

Параметры:	$open (строка) – Тег открытия сообщение об ошибке $close (строка) – Тег закрытия сообщение об ошибке
Возвращает:	Сообщения об ошибках
Возвращаемый тип:	строка

Возвращает все найденные ошибки в формате строки.

echo $this->image_lib->diplay_errors();