image_filter_sharpen

Директива 'image_filter_sharpen' применяет фильтр повышения резкости к изображениям, обслуживаемым NGINX. — NGINX HTTP Core

image_filter_sharpen
httpserverlocation
Синтаксисimage_filter_sharpen amount;
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

Директива 'image_filter_sharpen' используется в HTTP-сервере NGINX для применения эффекта повышения резкости к изображениям, обрабатываемым модулем фильтра изображений. Эта директива может улучшить внешний вид изображений, увеличивая контраст на краях и в мелких деталях. Она принимает один параметр, задающий величину повышения резкости, который контролирует степень усиления резкости изображения. Чем выше значение, тем резче становится изображение, но чрезмерная резкость может привести к артефактам. При правильной настройке директива 'image_filter_sharpen' может размещаться в разных контекстах, таких как блоки http, server и location. Директиву следует использовать совместно с модулем фильтра изображений, который обрабатывает файлы изображений, отсылаемые NGINX. Если изображение не обрабатывается или модуль фильтра не включен, директива не окажет никакого эффекта. Эффективность повышения резкости также может варьироваться в зависимости от исходного качества изображения. Важно, чтобы пользователи указывали числовые значения (обычно в диапазоне от 0 до 100) для тонкой настройки степени применения эффекта повышения резкости. Правильная установка значения в соответствии с требованиями визуального вывода может значительно улучшить четкость изображения при сохранении естественного вида и предотвращении чрезмерной резкости.

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

location /images {
    image_filter brighten 0.1;
    image_filter_sharpen 10;
}

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

Использование чрезмерных значений резкости может привести к неестественному виду изображений и видимым артефактам.

Директива действует только для изображений, обработанных через image filter; статические изображения, отдаваемые без обработки, не будут затронуты.