Вход для клиентов и партнеров
в начало сайта
Партнерская программаОнлайн демоСкачатьКарта сайта
 

Регламент
Документация
Часто задаваемые вопросы (FAQ)
Решения типовых вопросов
Форум поддержки
Библиотека разработчика

Посмотрите демо-ролики и убедитесь в том, что "Twilight CMS" очень удобна в управлении, понятна и проста.

Бесплатно скачайте "Twilight.Basic", установите на своем компьютере и изучите систему более детально.

Если вам нужно установить "Twilight CMS" на существующий сайт или разработать новый - обращайтесь в отдел интеграции.

 

Ваше имя
Ваш Email
Вопрос
Twilight.basic
  • Узнайте больше
  • Сравните версии
  • Twilight.selection
  • Узнайте больше
  • Сравните версии
  • Twilight.evolution
  • Узнайте больше
  • Сравните версии
  •  
    Главная // Библиотека разработчика // Справочники // Макроподстановки //

    GenerateTitle


    Назначение

    Генерирует графические надписи, которые могут быть использованы в качестве заголовков страниц, пунктов меню и т.п. Система возвращает сформированный тэг IMG.

    Ключи

    type Строка, определяющая графический формат выходного изображения - "gif" или "jpg". Если ключ не задан или пустой - используется значение "gif".
    width Положительное число, ширина изображения в пикселах.

    До версии 4.38 если ключ не был определен ему присваивалось значение 100. Начиная с версии 4.38 если ключ не определен, либо в него передана строка auto система автоматически создаст изображение под максимальную ширину надписи.

    Внимание: для больших надписей данная функция будет работать медленнее, поскольку из-за проблем в совместимости разных версий ImageMagick система "тупо" ищет край надписи перебором пикселов (хоть и умным алгоритмом). Поэтому время выполнения функции напрямую зависит от длины надписи. Для небольшого числа среднего по размеру надписей это не создаст никаких проблем, но если надписей огромное количество, и все они большой длины, то первичная генерация надписей в кэш может затянуться на несколько секунд.

    Поскольку для огромных надписей данный макрос практически не применяется, максимальный размер автоопределяемого таким образом изображения по ширине составляет 1600 пикселов. Нужно учесть, что для ускорения работы край изображения определяется с разрешением в 50 пикселов, поэтому, если в надписи будет промежуток большего размера, система обрежет надпись по первому "краю".

    В большинстве ситуаций данные условия не должны создать проблем разработчику, но в особых случаях он может изменить данные константы в коде макроса.

    height Положительное число, высота изображения в пикселах за вычетом размера шрифта. Если ключ не задан, высота точно равна размеру шрифта.
    font Строка, определяющая имя файла (с расширением) TrueType шрифта, который должен лежать в папке Fonts. Шрифт не нужно регистрировать в системе, благодаря этому все будет работать и на *nix платформе. По умолчанию используется "tahoma.ttf".
    text Строка текста в кодировке windows -1251.

    Кавычки в тексте должны быть заменены на "

    Если в строке нужно использовать символ "двоеточие", то перед ним нужно поставить обратный слэш - \:.

    dx Число, смещение надписи от левого края изображения в пикселах.
    dy Число, смещение надписи от верхнего края изображения в пикселах. Измеряется от базовой линии надписи, поэтому в большинстве случаев это значение нужно подбирать итеративно, сверяясь с результатом. Если надпись не видна на картинке вероятнее всего нужно увеличить это число.
    bgcolor Строка, определяющая цвет фона изображения в мнемокоде (white, black и т.д.) или в hex (#HHHHHH) формате.
    transparent Строка, обозначающая цвет, который будет считаться прозрачным. Параметр имеет смысл только для gif изображений. Формат цвета аналогичен формату ключа bgcolor.
    color Строка, обозначающая цвет текста. Формат аналогичен формату для ключа bgcolor.
    size Положительное число, размер шрифта в пунктах (points).
    maxlength Положительное число, максимальная длина строки, после которой можно автоматически переносить её остаток на следующую строку. Поскольку перенос делается по границе слова, данный параметр носит тип "ограничение сверху". При переносе, высота изображения автоматически увеличивается на size.
    gravity Строка, определяющая выравнивание надписи на изображении. Используются английские названия сторон света: North (север, верх), South (юг, низ), East (восток, справа), West (запад, слева) и их комбинации, например NorthWest – левый верхний угол.

    Строка принимает одно из следующих значений: NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast.

    nocache Логическое значение. Для улучшения производительности Система генерирует изображение только при первом запросе, после чего изображение попадает в кэш и при дальнейших запросах берется оттуда как обычный графический файл. Для отладки иногда полезно отключить это поведение, установив параметру nocache значение 1.
    params Строка, которая вставляется в тэг IMG. Используется для присвоения дополнительных атрибутов.
    condition Составное условие выполнения макроса.

    Доступен только с версии 4.35.

    Комментарии

    Позволяет в определенных случаях не отрисовывать все возможные варианты графических заголовков страниц, а создавать их "на лету".

    Для работы сервиса требуется установленная библиотека ImageMagick.

    Некоторые сложные шрифты при отрисовке выглядят не очень хорошо, поэтому использование данного сервиса оправдано в основном на простых шрифтах (Arial, Tahoma, Times и т.п.).

    Изображения кэшируются независимо от параметров кэширования, переданных через URL или настроек в preferences.xml. Поскольку сгенерированные изображения находятся в папке Cache, время жизни определяется временем жизни кэша.

    Примеры

    Пример №1
    $GenerateTitle[type: gif; width: 550; height: 10; font: tahoma.ttf; text: $NodeProperty[title]$; dx: 0; dy: 4; bgcolor: white; transparent: white; color: #2789BE; size: 18; maxlength: 60; params: "alt='$NodeProperty[title]$' style='margin-bottom\: 0'"]$

    Выводит название текущей страницы в графическом виде.

    « к списку макроподстановок

    версия для печати

     
    © 2003-19 Страта Технологии (создание сайтов, разработка cms), Twilight CMS in english.
    Наш адрес: Москва, пр. Маршала Жукова д.51
    Тел.: (495) 222-6436, E-mail: , карта сайта, условия использования информации о CMS
    Звоните через Skype:  

    Реклама: