# Gmagick

# Введение

Внимание

Модуль добавили как ЭКСПЕРИМЕНТАЛЬНЫЙ. Поведение модуля, названия функций и документацию к модулю изменяют в новых выпусках PHP без уведомления. Модулем пользуются на свой страх и риск.

Gmagick — PHP-модуль, который помогает создавать, изменять и получать метаданные изображений через API-интерфейс к функциям библиотеки GraphicsMagick.

Библиотека GraphicsMagick — армейский швейцарский нож для обработки изображений. Библиотека работает с более чем 88 форматами, включая DPX, GIF, JPEG, JPEG-2000, PNG, PDF, PNM и TIFF.

Модуль Gmagick состоит из основного класса — Gmagick, класса GmagickDraw — волшебной палочки для рисования и класса GmagickPixel, экземпляры которого представляют один пиксель изображения (цвет, непрозрачность).

- Установка и настройка
  - Требования
  - Установка
- Предопределённые константы
- Примеры
- Gmagick — Класс Gmagick
  - Gmagick::addimage — Добавление нового изображения в список изображений объекта Gmagick
  - Gmagick::addnoiseimage — Добавляет случайный шум к изображению
  - Gmagick::annotateimage — Подписать изображение текстом
  - Gmagick::blurimage — Добавить размытие изображению
  - Gmagick::borderimage — Добавить рамку к изображению
  - Gmagick::charcoalimage — Имитация рисования углём
  - Gmagick::chopimage — Удаляет область изображения и подрезает его
  - Gmagick::clear — Зачищает все ресурсы, связанные с объектом Gmagick
  - Gmagick::commentimage — Добавить комментарий к изображению
  - Gmagick::compositeimage — Накладывает одно изображение на другое
  - Gmagick::__construct — Конструктор объекта Gmagick
  - Gmagick::cropimage — Обрезает изображение
  - Gmagick::cropthumbnailimage — Создание обрезанного уменьшенного изображения
  - Gmagick::current — Вернуть самого себя
  - Gmagick::cyclecolormapimage — Смещает цветовую карту изображения
  - Gmagick::deconstructimages — Возвращает определённые пиксельные различия между изображениями
  - Gmagick::despeckleimage — Назначение despeckleimage
  - Gmagick::destroy — Уничтожить объект Gmagick
  - Gmagick::drawimage — Отображает объект GmagickDraw на текущем изображении
  - Gmagick::edgeimage — Увеличивает края в изображении
  - Gmagick::embossimage — Возвращает изображение в градациях серого с трёхмерным эффектом
  - Gmagick::enhanceimage — Улучшает качество изображения с шумом
  - Gmagick::equalizeimage — Выравнивает гистограмму изображения
  - Gmagick::flipimage — Создаёт вертикальное зеркальное отображение
  - Gmagick::flopimage — Создаёт горизонтальное зеркальное отображение
  - Gmagick::frameimage — Добавляет смоделированную трёхмерную границу
  - Gmagick::gammaimage — Гамма-коррекция изображения
  - Gmagick::getcopyright — Возвращает копирайт GraphicsMagick API в виде строки
  - Gmagick::getfilename — Возвращает имя файла связанного с последовательностью изображений
  - Gmagick::getimagebackgroundcolor — Возвращает цвет фона изображения
  - Gmagick::getimageblueprimary — Возвращает цветность синей первичной точки
  - Gmagick::getimagebordercolor — Возвращает цвет границы изображения
  - Gmagick::getimagechanneldepth — Получает глубину для определённого канала изображения
  - Gmagick::getimagecolors — Возвращает цвет индекса карты цветов
  - Gmagick::getimagecolorspace — Возвращает цветовое пространство изображения
  - Gmagick::getimagecompose — Возвращает составной оператор, связанный с изображением
  - Gmagick::getimagedelay — Получает задержку изображения
  - Gmagick::getimagedepth — Получает глубину изображения
  - Gmagick::getimagedispose — Получает метод удаления изображения
  - Gmagick::getimageextrema — Получает экстремумы для изображения
  - Gmagick::getimagefilename — Возвращает имя файла конкретного изображения в последовательности
  - Gmagick::getimageformat — Возвращает формат конкретного изображения в последовательности
  - Gmagick::getimagegamma — Возвращает гамму изображения
  - Gmagick::getimagegreenprimary — Возвращает первичную зелёную точку
  - Gmagick::getimageheight — Возвращает высоту изображения
  - Gmagick::getimagehistogram — Возвращает гистограмму изображения
  - Gmagick::getimageindex — Возвращает индекс текущего активного изображения
  - Gmagick::getimageinterlacescheme — Получает схему чередования изображений
  - Gmagick::getimageiterations — Получает итерации изображения
  - Gmagick::getimagematte — Проверяет, есть ли на изображении матовый канал
  - Gmagick::getimagemattecolor — Возвращает изображение матового цвета
  - Gmagick::getimageprofile — Возвращает именованный профайл изображения
  - Gmagick::getimageredprimary — Возвращает первичную красную точку
  - Gmagick::getimagerenderingintent — Получает цель рендеринга изображения
  - Gmagick::getimageresolution — Возвращает разрешение изображения
  - Gmagick::getimagescene — Получает сцену изображения
  - Gmagick::getimagesignature — Создаёт подпись сообщения SHA-256
  - Gmagick::getimagetype — Возвращает потенциальный тип изображения
  - Gmagick::getimageunits — Возвращает единицы разрешения изображения
  - Gmagick::getimagewhitepoint — Возвращает хроматическую белую точку
  - Gmagick::getimagewidth — Возвращает ширину изображения
  - Gmagick::getpackagename — Возвращает имя пакета GraphicsMagick
  - Gmagick::getquantumdepth — Возвращает глубину цвета (бит на канал) объекта Gmagick в виде строки
  - Gmagick::getreleasedate — Возвращает дату релиза GraphicsMagick в виде строки
  - Gmagick::getsamplingfactors — Возвращает вертикальный и горизонтальный фактор дискретизации
  - Gmagick::getsize — Возвращает размер, связанный с объектом Gmagick
  - Gmagick::getversion — Возвращает версию GraphicsMagick API
  - Gmagick::hasnextimage — Проверяет, есть ли ещё изображения в объекте
  - Gmagick::haspreviousimage — Проверяет, есть ли ещё изображения в объекте при итерации назад
  - Gmagick::implodeimage — Создаёт копию изображения
  - Gmagick::labelimage — Добавляет метку к изображению
  - Gmagick::levelimage — Регулирует уровни изображения
  - Gmagick::magnifyimage — Пропорционально масштабирует изображение в 2 раза
  - Gmagick::mapimage — Заменяет цвета изображения на ближайший цвет из эталонного изображения
  - Gmagick::medianfilterimage — Применяет цифровой фильтр
  - Gmagick::minifyimage — Масштабирует изображение пропорционально половине его размера
  - Gmagick::modulateimage — Управляет яркостью, насыщенностью и оттенком
  - Gmagick::motionblurimage — Имитирует размытие при движении
  - Gmagick::newimage — Создаёт новое изображение
  - Gmagick::nextimage — Осуществляет переход к следующему изображению
  - Gmagick::normalizeimage — Повышает контрастность цветного изображения
  - Gmagick::oilpaintimage — Имитирует эффект картины маслом
  - Gmagick::previousimage — Осуществляет переход к предыдущему изображению в объекте
  - Gmagick::profileimage — Добавляет или удаляет профиль из изображения
  - Gmagick::quantizeimage — Анализирует цвета эталонного изображения
  - Gmagick::quantizeimages — Анализирует цвета в последовательности изображений
  - Gmagick::queryfontmetrics — Возвращает массив, представляющий метрики шрифта
  - Gmagick::queryfonts — Возвращает настроенные шрифты
  - Gmagick::queryformats — Возвращает форматы, поддерживаемые Gmagick
  - Gmagick::radialblurimage — Применяет радиальное размытие к изображению
  - Gmagick::raiseimage — Создаёт имитацию эффекта трёхмерной кнопки
  - Gmagick::read — Читает изображение из файла
  - Gmagick::readimage — Читает изображение из файла
  - Gmagick::readimageblob — Читает изображение из бинарной строки
  - Gmagick::readimagefile — Читает изображение или последовательность изображений из файлового дескриптора
  - Gmagick::reducenoiseimage — Сглаживает контуры изображения
  - Gmagick::removeimage — Удаляет изображение из списка
  - Gmagick::removeimageprofile — Удаляет именованный профайл изображения и возвращает его
  - Gmagick::resampleimage — Изменяет разрешение изображения до желаемого
  - Gmagick::resizeimage — Масштабирует изображение
  - Gmagick::rollimage — Смещает изображение
  - Gmagick::rotateimage — Поворачивает изображение
  - Gmagick::scaleimage — Масштабирует размер изображения
  - Gmagick::separateimagechannel — Отделяет канал от изображения
  - Gmagick::setCompressionQuality — Устанавливает для объекта качество сжатия по умолчанию
  - Gmagick::setfilename — Устанавливает имя файла перед чтением или записью изображения
  - Gmagick::setimagebackgroundcolor — Устанавливает цвет фона изображения
  - Gmagick::setimageblueprimary — Устанавливает цветность изображения голубой основной точкой
  - Gmagick::setimagebordercolor — Устанавливает цвет рамки изображения
  - Gmagick::setimagechanneldepth — Устанавливает глубину определённого канала изображения
  - Gmagick::setimagecolorspace — Устанавливает цветовое пространство изображения
  - Gmagick::setimagecompose — Устанавливает оператор составного изображения
  - Gmagick::setimagedelay — Устанавливает задержку изображения
  - Gmagick::setimagedepth — Устанавливает глубину изображения
  - Gmagick::setimagedispose — Устанавливает метод удаления изображения
  - Gmagick::setimagefilename — Устанавливает имя файла конкретного изображения в последовательности
  - Gmagick::setimageformat — Устанавливает формат определённого изображения
  - Gmagick::setimagegamma — Устанавливает гамму изображения
  - Gmagick::setimagegreenprimary — Устанавливает цветность изображения зелёной первичной точкой
  - Gmagick::setimageindex — Устанавливает итератор в положение в списке изображений, заданном параметром index
  - Gmagick::setimageinterlacescheme — Устанавливает схему чересстрочной развёртки изображения
  - Gmagick::setimageiterations — Устанавливает итерации изображения
  - Gmagick::setimageprofile — Добавляет именованный профиль в объект Gmagick
  - Gmagick::setimageredprimary — Устанавливает цветность изображения красной основной точкой
  - Gmagick::setimagerenderingintent — Устанавливает способ рендеринга изображения
  - Gmagick::setimageresolution — Устанавливает разрешение изображения
  - Gmagick::setimagescene — Устанавливает сцену изображения
  - Gmagick::setimagetype — Устанавливает тип изображения
  - Gmagick::setimageunits — Устанавливает единицы разрешения изображения
  - Gmagick::setimagewhitepoint — Устанавливает цветность изображения белой точкой
  - Gmagick::setsamplingfactors — Устанавливает факторы выборки изображения
  - Gmagick::setsize — Устанавливает размер объекта Gmagick
  - Gmagick::shearimage — Создаёт параллелограмм
  - Gmagick::solarizeimage — Применяет соляризационный эффект к изображению
  - Gmagick::spreadimage — Случайно смещает каждый пиксель в блоке
  - Gmagick::stripimage — Снимает изображение всех профилей и комментариев
  - Gmagick::swirlimage — Закручивает пиксели вокруг центра изображения
  - Gmagick::thumbnailimage — Изменяет размер изображения
  - Gmagick::trimimage — Удаляет края с изображения
  - Gmagick::write — Псевдоним Gmagick::writeimage
  - Gmagick::writeimage — Записывает изображение в указанный файл
- GmagickDraw — Класс GmagickDraw
  - GmagickDraw::annotate — Рисует текст на изображении
  - GmagickDraw::arc — Рисует дугу
  - GmagickDraw::bezier — Рисует кривую Безье
  - GmagickDraw::ellipse — Рисует эллипс на изображении
  - GmagickDraw::getfillcolor — Возвращает цвет заливки
  - GmagickDraw::getfillopacity — Возвращает значение прозрачности, используемое при рисовании
  - GmagickDraw::getfont — Возвращает шрифт
  - GmagickDraw::getfontsize — Возвращает размер шрифта
  - GmagickDraw::getfontstyle — Возвращает стиль шрифта
  - GmagickDraw::getfontweight — Возвращает толщину шрифта
  - GmagickDraw::getstrokecolor — Возвращает цвет, используемый для обводки контуров объекта
  - GmagickDraw::getstrokeopacity — Возвращает прозрачность обведённых контуров объекта
  - GmagickDraw::getstrokewidth — Возвращает ширину обводки, используемой для отрисовки контуров объекта
  - GmagickDraw::gettextdecoration — Возвращает оформление текста
  - GmagickDraw::gettextencoding — Возвращает кодовый набор, используемый для текстовых аннотаций
  - GmagickDraw::line — Рисует линию
  - GmagickDraw::point — Рисует точку
  - GmagickDraw::polygon — Рисует многоугольник
  - GmagickDraw::polyline — Рисует ломаную линию
  - GmagickDraw::rectangle — Рисует прямоугольник
  - GmagickDraw::rotate — Применяет указанный поворот к текущему координатному пространству
  - GmagickDraw::roundrectangle — Рисует прямоугольник с закруглёнными углами
  - GmagickDraw::scale — Регулирует коэффициент масштабирования
  - GmagickDraw::setfillcolor — Устанавливает цвет заливки, который будет использоваться для рисования объектов с заливкой
  - GmagickDraw::setfillopacity — Устанавливает непрозрачность заливки
  - GmagickDraw::setfont — Устанавливает указанный шрифт для использования при аннотации текста
  - GmagickDraw::setfontsize — Устанавливает размер шрифта для использования при аннотации текста
  - GmagickDraw::setfontstyle — Устанавливает стиль шрифта для использования при аннотации текста
  - GmagickDraw::setfontweight — Устанавливает толщину шрифта
  - GmagickDraw::setstrokecolor — Устанавливает цвет, используемый для обводки контуров объекта
  - GmagickDraw::setstrokeopacity — Определяет прозрачность обводки контуров объекта
  - GmagickDraw::setstrokewidth — Устанавливает ширину обводки, используемой для отрисовки контуров объекта
  - GmagickDraw::settextdecoration — Определяет оформление
  - GmagickDraw::settextencoding — Задаёт кодовый набор текста
- GmagickPixel — Класс GmagickPixel
  - GmagickPixel::__construct — Конструктора класса GmagickPixel
  - GmagickPixel::getcolor — Возвращает цвет
  - GmagickPixel::getcolorcount — Получить количество пикселей изображения, имеющих заданный цвет
  - GmagickPixel::getcolorvalue — Возвращает нормализованное значение для заданного цветового канала
  - GmagickPixel::setcolor — Задать цвет
  - GmagickPixel::setcolorvalue — Установить нормализованное значение цветового канала

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open