vallefor/eva-social-img-generator

Generate a beautiful images for social networks

Генератор картинок для социальных сетей

Установка

composer require vallefor/eva-social-img-generator, _(*1)

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

seTextShadow("#000000", 75, 1, 2, 2)
        ->setText("Направление деятельности АО «МОСГАЗ»","#ffffff",imgGenerator::position_left_bottom,"auto",'5%')
        ->setFont($_SERVER["DOCUMENT_ROOT"]."/upload/fonts/fonts2_7/hinted-PTF55F.ttf");

    $generator = new imgGenerator();
    $generator
        ->addText($text)
        ->addOverlay(0.5, "#999900")
        ->setLogo($_SERVER["DOCUMENT_ROOT"] . "/images/logo.png", imgGenerator::position_left_top, "5%",'auto')
        ->fromImg($_SERVER["DOCUMENT_ROOT"] . "/images/background.jpeg")
        ->resizeFor("autodetect")
        ->show();
}

?>

imgTextGenerator::setText

Используется для установки текста. Имеет следующие параметры:, _(*2)

1. Текст
2. Цвет текста, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
3. Позиция текста. Для определение позиции используется константа imgGenerator::position_*, текст можно поставить в любую частьк артинки
4. Размер текста, может быть следующим:
   • auto - размер будет равен 1/10 высоты картинки
   • любое число - для размера шрифта в пикселях
   • 1/10, 1/5, 1/7 и т.д., то есть размер текста будет выстраиваться относительно высоты сгенерированной картинки
5. Отступы - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left)

imgTextGenerator::setTextShadow

Устанавливает тень под текстом, _(*3)

Параметры:, _(*4)

1. Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.
2. Прозрачность - 0-100 (или 0-1)
3. Размер тени
4. Координата X
5. Координата Y

imgTextGenerator::setFont

Устанавливает шрифт текста. Допускается как указать название шрифта (имейте ввиду, что данный шрифт должен быть установлен в системе), так и путь к шрифтовому файлу., _(*5)

imgTextGenerator::setBackground

Устанавливает фон под текстом. Имеет следующие параметры: 1. Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом. 2. Отступ - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left), _(*6)

imgGenerator::addOverlay

Добавляет слой, поверх фоновой картинки (если она есть). Имеет следующие параметры:, _(*7)

1. Прозрачность - 0-100 или 0-1.
2. Цвет, допускается использование HEX, RGB, RGBA и другие типы цветов, которые поддерживаются Imagick'ом.

imgGenerator::addText

Добавляет текст на картинку. На вход принимает подготовленный экземпляр imgTextGenerator., _(*8)

imgGenerator::setLogo

Устанавливает логотип. Имеет следующие параметры:, _(*9)

1. Путь к файлу
2. Позиция логотипа на картинке, для этого используйте константы imgGenerator::position_*
3. Отступ - можно указать как целое значение, так и в процентах. Можно задать каждый отступ отдельно, для этого передайте массив: array(top, right, bottom, left)
4. Размер - в данный момент может принять двух вида:
   • auto - картинка будет занимать не более 25% картинки.
   • false - логотип не будет уменьшен, рекомендуется использовать только если вы картинку генерируете для определенной соц. сети.

imgGenerator::fromImg

За основу генерируемой картинки берется эта картинка., _(*10)

imgGenerator::fromColor

За основу картинки берется цвет., _(*11)

imgGenerator::resizeFor

Уменьшить картинку для этой соцсети. Допускаются такие строки:, _(*12)

• autodetect - автоопределение исходя из user agent запросившего. Если определить не удалось, то используется vk
• facebook - 1200x630
• vk - 537x240
• twitter - 1024x512
• google_plus - 2120x1192
• ok - однокласники - 780x385

Рекомендуется использовать автоопределение, _(*13)

imgGenerator::enableCache

В качестве параметра принимает путь к папке, в которую нужно сохранять сгенерированные картинки. Существенно снижает повторную скорость отображения картинки. Но так как, по задумке, к картинке обращаются только роботы социальных сетей - происходить это должно крайне редко., _(*14)

imgGenerator::show

Завершающий метод. Генерирует и отображает картинку., _(*15)

imgGenerator::getPath

Завершающий метод. Вместо отображения картинки возращает путь к ней (при условии, если был включен кеш., _(*16)