Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_image_filter_module.xml @ 2769:16f6fa718be2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +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>