jpeg_filter_dropon_file
Директива `jpeg_filter_dropon_file` накладывает указанное изображение поверх JPEG-изображений, обрабатываемых модулем JPEG-фильтра NGINX.
Описание
Директива jpeg_filter_dropon_file позволяет задать изображение для наложения, которое может применяться к JPEG-изображениям при их отдаче через NGINX. Эта функция особенно полезна для добавления водяных знаков или логотипов на лету без изменения исходных файлов изображений на сервере. Директива принимает один или два аргумента: первый — путь к накладываемому изображению, а опциональный второй аргумент — изображение-маска, которое может управлять прозрачностью и эффектами смешивания наложения с основным изображением.
Чтобы настроить директиву, её необходимо разместить внутри блока location, указав накладываемое изображение и, при необходимости, маску. Наложение выполняется с помощью библиотеки libmodjpeg на этапе обработки изображений в NGINX. Директива поддерживает различные сценарии использования, например динамическое нанесение фирменного знака на изображения для разных пользователей или целей без необходимости повторно обрабатывать файлы JPEG, что повышает гибкость и снижает нагрузку на сервер.
При использовании опционального изображения-маски оно определяет области наложения, которые будут видимы или изменены, что позволяет реализовать более сложные эффекты наложения. Если указан только один файл, наложение применяется на его основе и может покрывать всё JPEG-изображение. Если задана маска, она определяет области смешивания и покрытия наложения, обеспечивая более тонкий контроль над тем, как наложение отображается на исходном изображении.
Пример конфига
location /images/ {
jpeg_filter on;
jpeg_filter_dropon_file /path/to/overlay.png /path/to/mask.png;
}Убедитесь, что изображения наложения и маски имеют совместимый формат и размеры с исходным JPEG для корректного смешивания.
Следует указывать абсолютные пути, чтобы предотвратить ошибки «файл не найден», особенно в ситуациях, когда рабочая директория может отличаться.
Модуль может требовать специальных прав для чтения файлов изображений наложения и маски; убедитесь, что установлены корректные права доступа к файлам.