Download the PHP package vallefor/eva-social-img-generator without Composer
On this page you can find all versions of the php package vallefor/eva-social-img-generator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vallefor/eva-social-img-generator
More information about vallefor/eva-social-img-generator
Files in vallefor/eva-social-img-generator
Package eva-social-img-generator
Short Description Generate a beautiful images for social networks
License CC-BY-NC
Informations about the package eva-social-img-generator
Генератор картинок для социальных сетей
Установка
composer require vallefor/eva-social-img-generator
Пример использования
imgTextGenerator::setText
Используется для установки текста. Имеет следующие параметры:
- Текст
- Цвет текста, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
- Позиция текста. Для определение позиции используется константа imgGenerator::position_*, текст можно поставить в любую частьк артинки
- Размер текста, может быть следующим:
- auto - размер будет равен 1/10 высоты картинки
- любое число - для размера шрифта в пикселях
- 1/10, 1/5, 1/7 и т.д., то есть размер текста будет выстраиваться относительно высоты сгенерированной картинки
- Отступы - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left)
imgTextGenerator::setTextShadow
Устанавливает тень под текстом
Параметры:
- Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
- Прозрачность - 0-100 (или 0-1)
- Размер тени
- Координата X
- Координата Y
imgTextGenerator::setFont
Устанавливает шрифт текста. Допускается как указать название шрифта (имейте ввиду, что данный шрифт должен быть установлен в системе), так и путь к шрифтовому файлу.
imgTextGenerator::setBackground
Устанавливает фон под текстом. Имеет следующие параметры:
- Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
- Отступ - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left)
imgGenerator::addOverlay
Добавляет слой, поверх фоновой картинки (если она есть). Имеет следующие параметры:
- Прозрачность - 0-100 или 0-1.
- Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
imgGenerator::addText
Добавляет текст на картинку. На вход принимает подготовленный экземпляр imgTextGenerator.
imgGenerator::setLogo
Устанавливает логотип. Имеет следующие параметры:
- Путь к файлу
- Позиция логотипа на картинке, для этого используйте константы imgGenerator::position_*
- Отступ - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left)
- Размер - в данный момент может принять двух вида:
- auto - картинка будет занимать не более 25% картинки.
- false - логотип не будет уменьшен, рекомендуется использовать только если вы картинку генерируете для определенной соц. сети.
imgGenerator::fromImg
За основу генерируемой картинки берется эта картинка.
imgGenerator::fromColor
За основу картинки берется цвет.
imgGenerator::resizeFor
Уменьшить картинку для этой соцсети. Допускаются такие строки:
- autodetect - автоопределение исходя из user agent запросившего. Если определить не удалось, то используется vk
- facebook - 1200x630
- vk - 537x240
- twitter - 1024x512
- google_plus - 2120x1192
- ok - однокласники - 780x385
Рекомендуется использовать автоопределение
imgGenerator::enableCache
В качестве параметра принимает путь к папке, в которую нужно сохранять сгенерированные картинки. Существенно снижает повторную скорость отображения картинки. Но так как, по задумке, к картинке обращаются только роботы социальных сетей - происходить это должно крайне редко.
imgGenerator::show
Завершающий метод. Генерирует и отображает картинку.
imgGenerator::getPath
Завершающий метод. Вместо отображения картинки возращает путь к ней (при условии, если был включен кеш.