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

Начиная с версии 5.9.0.18235 в Неткэте также поддерживаются функции автоматической обработки изображений, загружаемых в поля компонентов, системных таблиц и визуальных настроек.

Начиная с версии 6.1.0.21164 в Неткэте добавлена поддержка обработки изображений в формате WebP, но только для PHP версии 5.4+.

Доступность: везде, при подключении соответствующего файла

Класс предназначен для работы с изображениями и содержит набор статических методов.

Подключение

Класс автоматически загружается в действиях после добавления и изменения объекта. Чтобы загрузить его в других местах, нужно подключить файл nc_imagetransform.class.php.

Сделать это можно следующем способом:

require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");

$INCLUDE_FOLDER, если она не определена. Перед подключением должна быть объявлена как глобальная.

Методы класса

string imgResize($src_img, $dest_img, $width, $height, $mode=0, $format='jpg', $quality=null, $message_id = 0, $field = 0, $color = ''ffffff')

Публичный статический метод служит для изменения размера изображения.

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

Пример использования:

1. Необходимо уменьшить аватар пользователя (поле ForumAvatar) до размеров 120 на 120.

В действиях после добавления/изменения пользователя нужно написать:

// разрываем html-код для вставки php-кода
// подключаем класс
require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");
// определяем текущий аватар
$photo_path = nc_file_path('User', $message, 'ForumAvatar', "");
// при наличии аватара
if ($photo_path) {
     $photo_path .= $DOCUMENT_ROOT;
     // вызываем статический метод класса
     nc_ImageTransform::imgResize($photo_path,$photo_path,'120', '120', 0, 'jpg', 90, $message, 'ForumAvatar');
}

2. Необходимо изменить размер изображения объекта. Имя поля — Photo:

В действиях после добавления нужно написать:

require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");
$photo_path = nc_file_path($classID, $message, 'Photo', "");
if ($photo_path) {
    $photo_path .= $DOCUMENT_ROOT;
    nc_ImageTransform::imgResize($photo_path,$photo_path,'120', '120', 0, 'jpg', 90, $message, 'Photo');
}

3. Необходимо изменить размер изображения объекта с приоритетом по ширине и залить получившиеся поля желтым цветом. Имя поля — Photo:

В действиях после добавления нужно написать:

require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");
$photo_path = nc_file_path($classID, $message, 'Photo', "");
if ($photo_path) {
    $photo_path .= $DOCUMENT_ROOT;
    nc_ImageTransform::imgResize($photo_path,$photo_path,'120', '120', 3, 'jpg', 90, $message, 'Photo', 'ffff00');
}

bool createThumb($src_img, $dest_img, $width, $height, $mode=0, $format='jpg', $quality=null)

Публичный статический метод для создания копии изображении с возможностью изменения ее размеров (создание превью).

Пример использования:

При добавлении объекта с изображением (например, фотогалерея) создать превью размером 50 на 50.

Имя поля с изображением — Picture.

Имя поля для превью — Preview.

В действие после добавления объекта нужно прописать:

// если файл был закачан
if ($_FILES['f_Picture'][size] != 0 ) {
    require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");
    // создать превью
    nc_ImageTransform::createThumb('Picture','Preview',50,50);
}

bool putWatermark ( $classID, $field, $message, $watermark, $mode = 0, $quality = null )

Публичный статический метод для наложения водяного знака (watermark, ватермарк) на изображение объекта.

Пример использования:

Есть компонент с полем Picture, при добавление объекта с изображением

надо наложить ватермарк. В действии после добавления пишем:

nc_ImageTransform::putWatermark($classID,'Picture',$message, '/images/netcat.png', 1 );

Путь до ватермарка может быть как абсолютным, так и относительным от корневой директории сайта.

bool putWatermark_file ( $filepath, $watermark, $mode = 0, $quality = null )

Публичный статический метод для наложения ватермарка на файл.

Пример использования (версия NetCat 5.7.0.16240+):

При добавлении и изменении объекта наложить водяной знак на правый нижний угол только новых картинок в поле типа множественная загрузка файлов.

Имя поля с изображениями — Images.

В действие после добавления (или изменения) объекта нужно прописать:

if (is_array($f_Images->records)) {
    require_once($INCLUDE_FOLDER . "classes/nc_imagetransform.class.php");
    foreach ($f_Images->records as $record) {
        // Добавляем водяной знак, если изображение было только что загружено
        if ($record->is_new()) {
            nc_ImageTransform::putWatermark_file($record['Path'], '/img/watermark.png', 4);
        }
    }
}