image_filter_transparency

Директива 'image_filter_transparency' управляет прозрачностью изображений, обрабатываемых модулем фильтра изображений NGINX. — NGINX HTTP Core

image_filter_transparency
httpserverlocation
Синтаксисimage_filter_transparency on | off;
По умолчаниюoff
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументыflag

Описание

Директива 'image_filter_transparency' позволяет задавать уровень прозрачности изображений, обрабатываемых модулем фильтра изображений NGINX. Эта директива принимает булев флаг, который, при включении, указывает NGINX отображать изображения с применёнными настройками прозрачности. Это особенно полезно при отдаче изображений, которым необходимо сохранять прозрачный фон для веб‑элементов, таких как логотипы или иконки, гарантируя, что заданная прозрачность в файле изображения будет соблюдена при доставке. Когда эта директива установлена в 'on', фильтр изображений будет обрабатывать изображения так, чтобы сохранять или применять прозрачные области в соответствии с альфа-каналом файла изображения. Эта настройка полезна веб‑разработчикам, стремящимся оптимизировать отображение изображений в различных браузерах и на разных платформах. Она служит простым переключателем, изменяющим способ хранения и передачи данных изображения без необходимости дополнительной обработки или манипуляций на стороне клиента. Директива влияет на то, как рендерятся изображения, но не позволяет настраивать уровни прозрачности помимо двоичного выбора включения или отключения функции. В контексте конфигурации её можно задать внутри блоков http, server или location, что обеспечивает гибкое применение в разных областях настройки. Правильное использование этой директивы в сочетании с другими директивами модуля фильтра изображений может существенно повлиять на визуальное качество изображений, отдаваемых экземпляром NGINX, и, как следствие, улучшить общий пользовательский опыт веб‑приложений.

Пример конфига

location /images/ {
    image_filter on;
    image_filter_transparency on;
    try_files $uri =404;
}

Убедитесь, что image filter module скомпилирован вместе с NGINX; в противном случае эта директива не будет иметь эффекта.

Использование этой директивы в неправильном контексте (например, внутри 'http' или 'server', когда она должна быть в 'location') может привести к ошибкам конфигурации или предупреждениям.

Эффекты прозрачности могут быть невидимы, если сами изображения не поддерживают прозрачность (например, файлы PNG).