CMS Twilight: Watermark

source	Путь к файлу на сайте. В качестве пути может быть использован как URL изображения, так и физический путь.
watermark	Путь к файлу на сайте. В качестве пути может быть использован как URL изображения, так и физический путь.
output_as	Строка, определяющая формат выводимого изображения. Может принимать значения gif, jpg, png. Если формат не задан формат изображения не меняется.
nocache	Логическое значение, которое при значении 1 заставляет при каждом новом запросе к странице перегенерировать изображение. Используется, в основном, во время отладки сайта.
params	Строка, вставляется как параметры тэга IMG в результирующую строку. Для параметра "return: path" использоваться не будет.
return	Строка, принимает значение tag или path. Значение tag используется по умолчанию (когда ключ не задан) и приводит к генерации на выходе тэга IMG. Значение path приводит к генерации пути к итоговому файлу.
gravity	Строка, принимает одно из значений NorthWest (лево-верх), North (центр-верх), NorthEast (право-верх), West (лево-центр), Center, East (право-центр), SouthWest (лево-низ), South (центр-низ), SouthEast (право-низ). Определяет расположение изображения watermark на исходном изображении.

Чаще всего применяется для автоматического создания подобия "watermark" ("водяных знаков") для защиты изображений от врагов.

Для работы сервиса на хостинг-площадке должна быть установлена библиотека ImageMagick.

Сервис возвращает либо сформированный тэг IMG, ссылка в котором ведет на созданный графический файл, либо просто путь к файлу. Второй вариант может быть применен для того, чтобы результат выполнения можно было передать на обработку в другую макроподстановку (например, для уменьшения получившегося изображения через $Thumbnail[]$).

Сам полученный в результате совмещения файл размещается в папке Cache, время его жизни определяется временем принудительного сброса кэша, определяемым в preferences.xml. При этом, установка NoCache, заданная в URL страницы или через preferences.xml, не действует на режим кэширования тамбнейлов.

Сервис ничего не возвращает, если тип графического файла, который нужно преобразовать не gif, jpeg (допустимы расширения jpe, jpeg, jpg) или png.