Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_image_filter_module.xml @ 189:f9db3712d47d
Markup fixed.
author | Maxim Konovalov <maxim@nginx.com> |
---|---|
date | Tue, 22 Nov 2011 10:48:13 +0000 |
parents | 4840aa7bab2c |
children | a4e271eb8dd6 |
rev | line source |
---|---|
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1 <?xml version="1.0" encoding="utf-8"?> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
2 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
4 |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
5 <module name="Модуль ngx_http_image_filter_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
6 link="/ru/docs/http/ngx_http_image_filter_module.html" |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
7 lang="ru"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
9 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
10 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
12 Модуль ngx_http_image_filter_module — это фильтр для преобразования |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
13 изображений в форматах JPEG, GIF и PNG (0.7.54+). |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
14 <note> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
15 По умолчанию этот модуль не собирается, его сборку необходимо |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
16 разрешить с помощью конфигурационного параметра |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
17 <code>--with-http_image_filter_module</code>. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
18 </note> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
19 <note> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
20 Для сборки и работы этого модуля необходима библиотека |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
21 <link url="http://libgd.org">libgd</link>. |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
22 Рекомендуется использовать самую последнюю версию библиотеки, |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
23 на текущий момент это версия 2.0.35. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
24 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
25 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
28 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
29 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
30 <section name="Пример конфигурации" id="example"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
32 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 location /img/ { |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
35 proxy_pass http://backend; |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
36 image_filter resize 150 100; |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
37 error_page 415 = /empty; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 } |
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 location = /empty { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 empty_gif; |
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 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
44 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
45 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
46 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
47 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
48 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
49 <section name="Директивы" id="directives"> |
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 <directive name="image_filter"> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
52 <syntax><parameter>off</parameter></syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
53 <syntax><parameter>test</parameter></syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
54 <syntax><parameter>size</parameter></syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
55 <syntax><parameter>rotate </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
56 <value>90</value>|<value>180</value>|<value>270</value> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
57 </syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
58 <syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
59 <parameter>resize </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
60 <argument>ширина высота</argument> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
61 </syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
62 <syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
63 <parameter>crop </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
64 <argument>ширина высота</argument> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
65 </syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
66 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
67 <context>location</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
68 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 Директива задаёт тип преобразования изображения: |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
71 <list type="tag"> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
72 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
73 <tag-name><parameter>off</parameter></tag-name> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
74 <tag-desc> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
75 отключает обработку данным модулем во вложенном location. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
76 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
77 |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
78 <tag-name><parameter>test</parameter></tag-name> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
79 <tag-desc> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
80 проверяет, что ответ действительно является изображением |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
81 в формате JPEG, GIF или PNG. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
82 В противном случае возвращается ошибка |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
83 <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
|
84 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
85 |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
86 <tag-name><parameter>size</parameter></tag-name> |
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 выдаёт информацию об изображении в формате JSON, например: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
89 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
90 { "img" : { "width": 100, "height": 100, "type": "gif" } } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
91 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
92 В случае ошибки выдаётся |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
93 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
94 {} |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
95 </example> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
96 </tag-desc> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
97 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
98 <tag-name><parameter>rotate </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
99 <value>90</value>|<value>180</value>|<value>270</value> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
100 </tag-name> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
101 <tag-desc> |
184
4840aa7bab2c
The "rotate" rotates counter-clockwise.
Ruslan Ermilov <ru@nginx.com>
parents:
183
diff
changeset
|
102 поворачивает изображение против часовой стрелки на указанное число градусов. |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
103 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
105 <tag-name><parameter>resize </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
106 <argument>ширина высота</argument> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
107 </tag-name> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
108 <tag-desc> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
109 пропорционально уменьшает изображение до указанных размеров. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
110 Если требуется уменьшить только по одному измерению, то в качестве второго |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
111 можно указать “<code>-</code>”. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
112 В случае ошибки сервер возвращает код |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
113 <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
|
114 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
116 <tag-name><parameter>crop </parameter> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
117 <argument>ширина высота</argument> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
118 </tag-name> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
119 <tag-desc> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
120 пропорционально уменьшает изображение до размера большей стороны |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
121 и обрезает лишние края по другой стороне. |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
122 Если требуется уменьшить только по одному измерению, то в качестве второго |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
123 можно указать “<code>-</code>”. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
124 В случае ошибки сервер возвращает код |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
125 <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
|
126 </tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
127 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
128 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
129 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
132 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 <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
|
135 <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
|
136 <default>1M</default> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
137 <context>http</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
138 <context>server</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
139 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
140 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
142 Директива задаёт максимальный размер буфера для чтения изображения. |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
143 При превышении размера сервер вернёт ошибку |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
144 <http-status code="415" text="Unsupported Media Type"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
145 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
146 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
147 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
148 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
149 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
150 <directive name="image_filter_jpeg_quality"> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
151 <syntax><value>1..100</value></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
152 <default>75</default> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
153 <context>http</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
154 <context>server</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
155 <context>location</context> |
76
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
158 Директива задаёт коэффициент потери информации при обработке изображений |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
159 в формате JPEG. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
160 Максимальное рекомендуемое значение — 95. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
161 </para> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
162 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
163 </directive> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
164 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
165 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
166 <directive name="image_filter_sharpen"> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
167 <syntax><argument>процент</argument></syntax> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
168 <default>0</default> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
169 <context>http</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
170 <context>server</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
171 <context>location</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
172 |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
173 <para> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
174 Повышает резкость итогового изображения. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
175 Процент резкости может быть больше 100. |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
176 Значение 0 отключает повышение резкости. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
177 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
178 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
179 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
180 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
181 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
182 <directive name="image_filter_transparency"> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
183 <syntax><value>on</value>|<value>off</value></syntax> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
184 <default>on</default> |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
185 <context>http</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
186 <context>server</context> |
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
187 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
188 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
189 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
190 Директива определяет, сохранять ли прозрачность при обработке изображений |
183
aa4c2b46a4a3
Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents:
110
diff
changeset
|
191 в формате PNG с цветами, заданными палитрой, и в формате GIF. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
192 Потеря прозрачности позволяет получить более качественное изображение. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
193 Прозрачность альфа-канала в формате PNG сохраняется всегда. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
194 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
195 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
196 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
197 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
198 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
199 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
200 </module> |