Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_image_filter_module.xml @ 3090:27532d42102b default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the "rate" parameter of the "error_log" directive.
author Maxim Dounin <mdounin@mdounin.ru>
date Sun, 16 Jun 2024 06:55:30 +0300
parents 6ebdef43330a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 205
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
10 <module name="Модуль ngx_http_image_filter_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_image_filter_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
1830
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
13 rev="4">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
347
daae2b619815 Specify the module history information in a unified place.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
18 Модуль <literal>ngx_http_image_filter_module</literal> (0.7.54+) — это фильтр
1830
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
19 для преобразования изображений в форматах JPEG, GIF, PNG и WebP.
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
20 </para>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
21
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
22 <para>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
23 По умолчанию этот модуль не собирается, его сборку необходимо
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
24 разрешить с помощью конфигурационного параметра
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
25 <literal>--with-http_image_filter_module</literal>.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
26 <note>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
27 Для сборки и работы этого модуля необходима библиотека
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 <link url="http://libgd.org">libgd</link>.
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 873
diff changeset
29 Рекомендуется использовать самую последнюю версию библиотеки.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
30 </note>
1830
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
31 <note>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
32 Поддержка формата WebP появилась в версии 1.11.6.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
33 Для преобразования изображений в данном формате
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
34 библиотека <literal>libgd</literal> должна быть собрана с поддержкой WebP.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
35 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
41 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 location /img/ {
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
46 proxy_pass http://backend;
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
47 image_filter resize 150 100;
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
48 image_filter rotate 90;
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
49 error_page 415 = /empty;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 location = /empty {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 empty_gif;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
56 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
58 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
59
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
61 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 <directive name="image_filter">
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
64 <syntax><literal>off</literal></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
65 <syntax><literal>test</literal></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
66 <syntax><literal>size</literal></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
67 <syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
68 <literal>rotate</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
69 <literal>90</literal> | <literal>180</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
70 <literal>270</literal></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
71 <syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
72 <literal>resize</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
73 <value>ширина</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
74 <value>высота</value></syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
75 <syntax>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
76 <literal>crop</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
77 <value>ширина</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
78 <value>высота</value></syntax>
683
6c14c73d74ee Documented default value of the image_filter directive.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
79 <default>off</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
82 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
83 Задаёт тип преобразования изображения:
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
84 <list type="tag">
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
85
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
86 <tag-name><literal>off</literal></tag-name>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
87 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
88 отключает обработку данным модулем во вложенном location.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
89 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
91 <tag-name><literal>test</literal></tag-name>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
92 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
93 проверяет, что ответ действительно является изображением
1830
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
94 в формате JPEG, GIF, PNG или WebP.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
95 В противном случае возвращается ошибка
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
96 <http-status code="415" text="Unsupported Media Type"/>.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
97 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
98
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
99 <tag-name><literal>size</literal></tag-name>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
100 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
101 выдаёт информацию об изображении в формате JSON, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
102 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103 { "img" : { "width": 100, "height": 100, "type": "gif" } }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105 В случае ошибки выдаётся
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
107 {}
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108 </example>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
109 </tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
110
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
111 <tag-name><literal>rotate</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
112 <literal>90</literal>|<literal>180</literal>|<literal>270</literal>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
113 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
114 <tag-desc>
184
4840aa7bab2c The "rotate" rotates counter-clockwise.
Ruslan Ermilov <ru@nginx.com>
parents: 183
diff changeset
115 поворачивает изображение против часовой стрелки на указанное число градусов.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
116 В значении параметра допустимо использование переменных.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
117 Можно использовать как отдельно, так и совместно с преобразованиями
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
118 <literal>resize</literal> и <literal>crop</literal>.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
119 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
121 <tag-name><literal>resize</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
122 <value>ширина</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
123 <value>высота</value>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
124 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
125 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
126 пропорционально уменьшает изображение до указанных размеров.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
127 Если требуется уменьшить только по одному измерению, то в качестве второго
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
128 можно указать “<literal>-</literal>”.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
129 В случае ошибки сервер возвращает код
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
130 <http-status code="415" text="Unsupported Media Type"/>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
131 В значениях параметров допустимо использование переменных.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
132 При использовании совместно с <literal>rotate</literal>,
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
133 поворот изображения происходит <emphasis>после</emphasis>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
134 уменьшения размеров изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
135 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
137 <tag-name><literal>crop</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
138 <value>ширина</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
139 <value>высота</value>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
140 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
141 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
142 пропорционально уменьшает изображение до размера большей стороны
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 и обрезает лишние края по другой стороне.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
144 Если требуется уменьшить только по одному измерению, то в качестве второго
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
145 можно указать “<literal>-</literal>”.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
146 В случае ошибки сервер возвращает код
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
147 <http-status code="415" text="Unsupported Media Type"/>.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
148 В значениях параметров допустимо использование переменных.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
149 При использовании совместно с <literal>rotate</literal>,
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
150 поворот изображения происходит <emphasis>до</emphasis>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
151 уменьшения размеров изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
152 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
153
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
156
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
157 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
158
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 <directive name="image_filter_buffer">
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
161 <syntax><value>размер</value></syntax>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
162 <default>1M</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
163 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
164 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
165 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
166
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
167 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
168 Задаёт максимальный размер буфера для чтения изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
169 При превышении размера сервер вернёт ошибку
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
170 <http-status code="415" text="Unsupported Media Type"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
172
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
173 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175
873
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
176 <directive name="image_filter_interlace">
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
177 <syntax><literal>on</literal> | <literal>off</literal></syntax>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
178 <default>off</default>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
179 <context>http</context>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
180 <context>server</context>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
181 <context>location</context>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
182 <appeared-in>1.3.15</appeared-in>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
183
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
184 <para>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
185 Если включено, то итоговые изображения будут с чересстрочностью.
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
186 В случае JPEG итоговые изображения будут в формате “progressive JPEG”.
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
187 </para>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
188
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
189 </directive>
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
190
1e4f86ac3716 Documented the "image_filter_interlace" directive.
Homutov Vladimir <vl@nginx.com>
parents: 710
diff changeset
191
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 <directive name="image_filter_jpeg_quality">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
193 <syntax><value>качество</value></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
194 <default>75</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
195 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
196 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
197 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
198
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 <para>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
200 Задаёт желаемое <value>качество</value> преобразованного изображения
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 347
diff changeset
201 в формате JPEG.
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 873
diff changeset
202 Допустимые значения находятся в диапазоне от 1 до 100.
205
f743d1f4683a Fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 203
diff changeset
203 Меньшим значениям обычно соответствует худшее качество изображения
f743d1f4683a Fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 203
diff changeset
204 и меньший объём передаваемых данных.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
205 Максимальное рекомендуемое значение — 95.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
206 В значении параметра допустимо использование переменных.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
207 </para>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
208
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
209 </directive>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
210
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
211
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
212 <directive name="image_filter_sharpen">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
213 <syntax><value>процент</value></syntax>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
214 <default>0</default>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
215 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
216 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
217 <context>location</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
218
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
219 <para>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
220 Повышает резкость итогового изображения.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
221 Процент резкости может быть больше 100.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
222 Значение 0 отключает повышение резкости.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
223 В значении параметра допустимо использование переменных.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
225
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
226 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
227
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
228
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
229 <directive name="image_filter_transparency">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 270
diff changeset
230 <syntax><literal>on</literal>|<literal>off</literal></syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
231 <default>on</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
232 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
233 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
234 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
236 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
237 Определяет, сохранять ли прозрачность при обработке изображений
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 873
diff changeset
238 в формате GIF и в формате PNG с цветами, заданными палитрой.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
239 Потеря прозрачности позволяет получить более качественное изображение.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
240 Прозрачность альфа-канала в формате PNG сохраняется всегда.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
241 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
242
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244
1830
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
245
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
246 <directive name="image_filter_webp_quality">
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
247 <syntax><value>качество</value></syntax>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
248 <default>80</default>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
249 <context>http</context>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
250 <context>server</context>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
251 <context>location</context>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
252 <appeared-in>1.11.6</appeared-in>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
253
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
254 <para>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
255 Задаёт желаемое <value>качество</value> преобразованного изображения
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
256 в формате WebP.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
257 Допустимые значения находятся в диапазоне от 1 до 100.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
258 Меньшим значениям обычно соответствует худшее качество изображения
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
259 и меньший объём передаваемых данных.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
260 В значении параметра допустимо использование переменных.
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
261 </para>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
262
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
263 </directive>
6ebdef43330a Added support for WebP to the image_filter module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 966
diff changeset
264
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
265 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
266
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267 </module>