jpeg_filter_dropon_memory

Директива `jpeg_filter_dropon_memory` позволяет накладывать изображение прямо из памяти на изображения JPEG во время фильтрации.

Синтаксисjpeg_filter_dropon_memory image [mask];
По умолчаниюnone
Контекстlocation
Аргументы1-2

Описание

Директива jpeg_filter_dropon_memory является частью модуля JPEG-фильтра NGINX, который использует библиотеку libmodjpeg для эффективной обработки изображений JPEG. Эта директива предназначена для наложения указанного изображения или маски непосредственно на JPEG, обрабатываемый NGINX, без необходимости записи наложения на диск. Директива принимает один или два аргумента: первый — имя изображения, которое будет наложено, а второй необязательный аргумент указывает изображение-маску, определяющую прозрачность или смешивание наложения. Если маска не указана, наложение применяется как есть.

Когда запрашивается изображение JPEG, если эта директива указана в конфигурации для конкретного location, NGINX динамически внедряет изображение-наложение на этапе обработки изображения. Это позволяет серверам сохранять модульность и гибкость, обеспечивая наложения для различных сценариев — например, добавление логотипов или водяных знаков без изменения исходных файлов изображений на диске. Если изображение для наложения большое или сложное, важно эффективно управлять памятью сервера, так как загрузка больших изображений непосредственно в память может потенциально исчерпать доступные ресурсы.

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

location /images/ {
    jpeg_filter on;
    jpeg_filter_dropon_memory /path/to/overlay.png /path/to/mask.png;
}

Убедитесь, что изображение наложения имеет совместимый формат (например, PNG) и доступно для рабочих процессов NGINX.

Большие изображения могут потреблять значительный объём памяти, что потенциально может привести к проблемам с производительностью или сбоям.

Если используется изображение маски, убедитесь, что его размеры соответствуют размерам изображения наложения, чтобы избежать неожиданного поведения.

← Ко всем директивам