Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_image_filter_module.xml @ 1929:7f290929b32d
HTTP section of the development guide.
author | Roman Arutyunyan <arut@nginx.com> |
---|---|
date | Tue, 14 Mar 2017 12:56:59 +0300 |
parents | 6ebdef43330a |
children |
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 | 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 | 20 </para> |
21 | |
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 | 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 | 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 | 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 | 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 | 64 <syntax><literal>off</literal></syntax> |
65 <syntax><literal>test</literal></syntax> | |
66 <syntax><literal>size</literal></syntax> | |
67 <syntax> | |
68 <literal>rotate</literal> | |
69 <literal>90</literal> | <literal>180</literal> | | |
70 <literal>270</literal></syntax> | |
71 <syntax> | |
72 <literal>resize</literal> | |
73 <value>ширина</value> | |
74 <value>высота</value></syntax> | |
75 <syntax> | |
76 <literal>crop</literal> | |
77 <value>ширина</value> | |
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 | 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 | 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 | 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 | 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 | 111 <tag-name><literal>rotate</literal> |
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 | 116 В значении параметра допустимо использование переменных. |
191
a4e271eb8dd6
Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents:
184
diff
changeset
|
117 Можно использовать как отдельно, так и совместно с преобразованиями |
271 | 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 | 121 <tag-name><literal>resize</literal> |
122 <value>ширина</value> | |
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 | 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 | 131 В значениях параметров допустимо использование переменных. |
132 При использовании совместно с <literal>rotate</literal>, | |
203 | 133 поворот изображения происходит <emphasis>после</emphasis> |
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 | 137 <tag-name><literal>crop</literal> |
138 <value>ширина</value> | |
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 | 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 | 148 В значениях параметров допустимо использование переменных. |
149 При использовании совместно с <literal>rotate</literal>, | |
203 | 150 поворот изображения происходит <emphasis>до</emphasis> |
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 | 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 | 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 | 200 Задаёт желаемое <value>качество</value> преобразованного изображения |
201 в формате JPEG. | |
966 | 202 Допустимые значения находятся в диапазоне от 1 до 100. |
205 | 203 Меньшим значениям обычно соответствует худшее качество изображения |
204 и меньший объём передаваемых данных. | |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
205 Максимальное рекомендуемое значение — 95. |
271 | 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 | 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 | 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 | 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 | 237 Определяет, сохранять ли прозрачность при обработке изображений |
966 | 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> |