From ad20b0d0fe28d84d2115cca587a6d043ecf9187e Mon Sep 17 00:00:00 2001
From: Vadim Zhestikov <v.zhestikov@f5.com>
Date: Fri, 17 Jul 2026 11:00:48 -0700
Subject: [PATCH] Image filter: documented the image_filter_max_pixels
 directive.

---
 .../http/ngx_http_image_filter_module.xml     | 24 ++++++++++++++++-
 .../http/ngx_http_image_filter_module.xml     | 26 +++++++++++++++++--
 2 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/xml/en/docs/http/ngx_http_image_filter_module.xml b/xml/en/docs/http/ngx_http_image_filter_module.xml
index 87016fb12..f729bf1a6 100644
--- a/xml/en/docs/http/ngx_http_image_filter_module.xml
+++ b/xml/en/docs/http/ngx_http_image_filter_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_image_filter_module"
         link="/en/docs/http/ngx_http_image_filter_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -205,6 +205,28 @@ Parameter value can contain variables.
 </directive>
 
 
+<directive name="image_filter_max_pixels">
+<syntax><value>pixels</value></syntax>
+<default>20000000</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.31.4</appeared-in>
+
+<para>
+Limits the maximum size of an image being processed, in pixels
+(width multiplied by height).
+The limit applies both to the source image
+and to the transformation result.
+When the limit is exceeded, the image is not processed
+and the server returns error
+<http-status code="415" text="Unsupported Media Type"/>.
+The zero value disables the limit.
+</para>
+
+</directive>
+
+
 <directive name="image_filter_sharpen">
 <syntax><value>percent</value></syntax>
 <default>0</default>
diff --git a/xml/ru/docs/http/ngx_http_image_filter_module.xml b/xml/ru/docs/http/ngx_http_image_filter_module.xml
index 062c7aa09..09c5c973f 100644
--- a/xml/ru/docs/http/ngx_http_image_filter_module.xml
+++ b/xml/ru/docs/http/ngx_http_image_filter_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_image_filter_module"
         link="/ru/docs/http/ngx_http_image_filter_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -209,6 +209,28 @@ location = /empty {
 </directive>
 
 
+<directive name="image_filter_max_pixels">
+<syntax><value>пикселы</value></syntax>
+<default>20000000</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.31.4</appeared-in>
+
+<para>
+Ограничивает максимальный размер обрабатываемого изображения в пикселах
+(ширину, умноженную на высоту).
+Ограничение распространяется как на исходное изображение,
+так и на результат преобразования.
+При превышении ограничения изображение не обрабатывается
+и сервер вернёт ошибку
+<http-status code="415" text="Unsupported Media Type"/>.
+Значение <literal>0</literal> отключает ограничение.
+</para>
+
+</directive>
+
+
 <directive name="image_filter_sharpen">
 <syntax><value>процент</value></syntax>
 <default>0</default>
@@ -219,7 +241,7 @@ location = /empty {
 <para>
 Повышает резкость итогового изображения.
 Процент резкости может быть больше 100.
-Значение 0 отключает повышение резкости.
+Значение <literal>0</literal> отключает повышение резкости.
 В значении параметра допустимо использование переменных.
 </para>