Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API
Модуль «Интернет-магазин» 12.8.1Настройка модуля 12.8.2Настройка интернет-магазина 12.8.3Валюты 12.8.4Цены для разных групп пользователей 12.8.5Минимальная цена 12.8.6Способы доставки 12.8.7Способы оплаты 12.8.8Настройка шаблонов писем 12.8.9Бланки 12.8.10Скидки 12.8.11Сиюминутные скидки 12.8.12Купоны 12.8.13Редактирование заказов 12.8.14Статистика 12.8.15Компоненты товаров 12.8.16Варианты товаров 12.8.17Коллекции объектов 12.8.18Фильтр товаров 12.8.19Списки товаров 12.8.20Корзина 12.8.21Заказ 12.8.22Выгрузка предложений в Яндекс.Маркет 12.8.23Заказ на Маркете 12.8.24Выгрузка предложений в Товары@Mail.Ru 12.8.25Выгрузка товаров в Google Merchant 12.8.26Обмен данными с 1С 12.8.27Обмен данными с 1С 8-ой версии 12.8.28Обмен данными с 1С 7-ой версии 12.8.29Обмен данными с сервисом МойСклад 12.8.30Виджеты интернет-магазина 12.8.31Классы расчёта доставки 12.8.32Интернет-магазин <5.3 12.8.33Переход с прежней версии модуля 12.8.34Справочник API

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

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

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

Подключение

Класс автоматически загружается в действиях после добавления и изменения объекта. Чтобы загрузить его в других местах, нужно подключить файл 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=90, $message_id = 0, $field = 0, $color = ''ffffff')

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

Параметры Описание
$src_img путь к исходному изображению
$dest_img путь к создаваемому изображению
$width ширина создаваемого изображения
$height высота создаваемого изображения
$mode (опционально) режим уменьшения: 0 — пропорционально уменьшает (по умолчанию); 1 — вписывает   в указанные размеры с обрезкой; 3 — аналогично 1, но с приоритетов по ширине; 4 — аналогично 1 но с приоритетом по высоте;
$format (опционально) формат изображения: NULL, 'jpg', 'gif', 'png' или 'bmp'. Если значение параметра равно NULL (рекомендуется), формат изображения будет определен автоматически. Ввиду того, что библиотека gd не имеет встроенной поддержки bmp, обработка изображений данного формата более длительная и создает большую нагрузку на сервер, чем обработка изображений других форматов.
$quality (опционально) качество сжатия изображения при формате «jpg». Может принимать значения от 0 до 100. По умолчанию — 90
$message_id (опционально) номер   объекта,  к которому относится файл
$field (опционально) номер  поля или его имя, к которому относится файл
$color (опционально) цвет заливки полей изображения при режиме уменьшения $mode = 3

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

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

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

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

// разрываем html-код для вставки php-кода
// подключаем класс
require_once($INCLUDE_FOLDER."classes/nc_imagetransform.class.php");
// определяем текущий аватар
$photo_path = $DOCUMENT_ROOT.nc_file_path('User', $message, 'ForumAvatar', "");
// при наличии аватара
if ( $photo_path) {
     // вызываем статический метод класса
     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 = $DOCUMENT_ROOT.nc_file_path($classID, $message, 'Photo', "");
if ( $photo_path) {
    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 = $DOCUMENT_ROOT.nc_file_path($classID, $message, 'Photo', "");
if ( $photo_path) {
    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=90)

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

Параметры Описание
$src_img путь к исходному изображению
$dest_img путь к создаваемому изображению
$width ширина создаваемого изображения
$height высота создаваемого изображения
$mode (опционально) режим уменьшения: 0 — пропорционально уменьшает (по умолчанию); 1 — вписывает   в указанные размеры
$format (опционально) формат изображения: NULL, 'jpg', 'gif', 'png' или 'bmp'. Если значение параметра равно NULL (рекомендуется), формат изображения будет определен автоматически. Ввиду того, что библиотека gd не имеет встроенной поддержки bmp, обработка изображений данного формата более длительная и создает большую нагрузку на сервер, чем обработка изображений других форматов.
$quality (опционально) качество сжатия изображения при формате «jpg». Может принимать значения от 0 до 100. По умолчанию — 90

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

При добавлении объекта с изображением (например, фотогалерея) создать превью размером 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 )

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

Параметры Описание
$classID номер компонента или имя системной таблицы
$field номер поля или его латинское название
$message номер объекта
$watermark абсолютный или относительный путь до водяного знака
$mode (опционально) местоположение знака: 0 — по центру; 1 — левый верхний угол; 2 — правый верхний угол; 3 — левый нижний угол; 4 — правый нижний угол.

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

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

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

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

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

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

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

Параметры Описание
$filepath абсолютный или относительный путь до файла
$watermark абсолютный или относительный путь до водяного знака
$mode (опционально) местоположение знака: 0 — по центру; 1 — левый верхний угол; 2 — правый верхний угол; 3 — левый нижний угол; 4 — правый нижний угол.

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

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

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

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

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

Комментарии 3

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

Тут ошибка: поскольку при составлении $photo_path используется переменная $DOCUMENT_ROOT, даже если файла нет, (bool) $photo_path будет true и nc_ImageTransform::imgResize выполнится.

Нужно убирать $DOCUMENT_ROOT внутрь if.
   
werba 21 февраля 2015, 23:45:36
Странно, но не получается наложить водный знак в версии 5.2 Вставляю код в поле после добавления такой

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

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

и ничего не происходит
   
skype: celenia_yaz  Mirson Dev Team 06 сентября 2016, 01:02:07
Вотермарк очень портится в качестве при наложении на фото. Что посоветуете сделать?
   
Описание проекта