Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_image_filter_module.xml @ 270:945d7299c26c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Spaces are now preserved here, so removed all the hacks.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 22 Dec 2011 13:39:18 +0000
parents bfe3eff81d04
children 4c6d2c614d2c
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
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>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
12 Модуль <code>ngx_http_image_filter_module</code> — это фильтр для преобразования
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
13 изображений в форматах JPEG, GIF и PNG (0.7.54+).
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
14 </para>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
15
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
16 <para>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
17 По умолчанию этот модуль не собирается, его сборку необходимо
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
18 разрешить с помощью конфигурационного параметра
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
19 <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
20 <note>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
21 Для сборки и работы этого модуля необходима библиотека
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 <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
23 Рекомендуется использовать самую последнюю версию библиотеки,
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
24 на текущий момент это версия 2.0.35.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
25 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 </section>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
31 <section name="Пример конфигурации" id="example">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
32
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 location /img/ {
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
36 proxy_pass http://backend;
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
37 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
38 image_filter rotate 90;
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
39 error_page 415 = /empty;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
41
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 location = /empty {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 empty_gif;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46 </para>
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 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49
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 <section name="Директивы" id="directives">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 <directive name="image_filter">
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
54 <syntax><parameter>off</parameter></syntax>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
55 <syntax><parameter>test</parameter></syntax>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
56 <syntax><parameter>size</parameter></syntax>
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
57 <syntax><parameter>rotate</parameter>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
58 <value>90</value> | <value>180</value> | <value>270</value></syntax>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
59 <syntax>
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
60 <parameter>resize</parameter>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
61 <argument>ширина</argument>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
62 <argument>высота</argument></syntax>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
63 <syntax>
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
64 <parameter>crop</parameter>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
65 <argument>ширина</argument>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
66 <argument>высота</argument></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
67 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68 <context>location</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
71 Задаёт тип преобразования изображения:
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
72 <list type="tag">
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
73
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
74 <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
75 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
76 отключает обработку данным модулем во вложенном location.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
77 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
79 <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
80 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
81 проверяет, что ответ действительно является изображением
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
82 в формате JPEG, GIF или PNG.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
83 В противном случае возвращается ошибка
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
84 <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
85 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
87 <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
88 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
89 выдаёт информацию об изображении в формате JSON, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91 { "img" : { "width": 100, "height": 100, "type": "gif" } }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 В случае ошибки выдаётся
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 {}
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96 </example>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
97 </tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
98
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
99 <tag-name><parameter>rotate</parameter>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
100 <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
101 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
102 <tag-desc>
184
4840aa7bab2c The "rotate" rotates counter-clockwise.
Ruslan Ermilov <ru@nginx.com>
parents: 183
diff changeset
103 поворачивает изображение против часовой стрелки на указанное число градусов.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
104 В значении аргумента допустимо использование переменных.
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
105 Можно использовать как отдельно, так и совместно с преобразованиями
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
106 <parameter>resize</parameter> и <parameter>crop</parameter>.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
107 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
109 <tag-name><parameter>resize</parameter>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
110 <argument>ширина</argument>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
111 <argument>высота</argument>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
112 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
113 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
114 пропорционально уменьшает изображение до указанных размеров.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
115 Если требуется уменьшить только по одному измерению, то в качестве второго
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
116 можно указать “<code>-</code>”.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
117 В случае ошибки сервер возвращает код
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
118 <http-status code="415" text="Unsupported Media Type"/>.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
119 В значениях аргументов допустимо использование переменных.
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
120 При использовании совместно с <parameter>rotate</parameter>,
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
121 поворот изображения происходит <emphasis>после</emphasis>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
122 уменьшения размеров изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
123 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
124
270
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
125 <tag-name><parameter>crop</parameter>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
126 <argument>ширина</argument>
945d7299c26c Spaces are now preserved here, so removed all the hacks.
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
127 <argument>высота</argument>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
128 </tag-name>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
129 <tag-desc>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
130 пропорционально уменьшает изображение до размера большей стороны
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
131 и обрезает лишние края по другой стороне.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
132 Если требуется уменьшить только по одному измерению, то в качестве второго
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
133 можно указать “<code>-</code>”.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
134 В случае ошибки сервер возвращает код
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
135 <http-status code="415" text="Unsupported Media Type"/>.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
136 В значениях аргументов допустимо использование переменных.
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
137 При использовании совместно с <parameter>rotate</parameter>,
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
138 поворот изображения происходит <emphasis>до</emphasis>
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
139 уменьшения размеров изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
140 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
141
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
142 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
144
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
145 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
148 <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
149 <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
150 <default>1M</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
151 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
152 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
153 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
154
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
155 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
156 Задаёт максимальный размер буфера для чтения изображения.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
157 При превышении размера сервер вернёт ошибку
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
158 <http-status code="415" text="Unsupported Media Type"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
159 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
164 <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
165 <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
166 <default>75</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
167 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
168 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
169 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
172 Задаёт желаемое качество преобразованного изображения в формате JPEG.
205
f743d1f4683a Fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 203
diff changeset
173 Меньшим значениям обычно соответствует худшее качество изображения
f743d1f4683a Fixed wording.
Ruslan Ermilov <ru@nginx.com>
parents: 203
diff changeset
174 и меньший объём передаваемых данных.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
175 Максимальное рекомендуемое значение — 95.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
176 В значении аргумента допустимо использование переменных.
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
177 </para>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
178
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
179 </directive>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
180
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
181
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
182 <directive name="image_filter_sharpen">
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
183 <syntax><argument>процент</argument></syntax>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
184 <default>0</default>
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>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
188
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
189 <para>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
190 Повышает резкость итогового изображения.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
191 Процент резкости может быть больше 100.
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
192 Значение 0 отключает повышение резкости.
191
a4e271eb8dd6 Documented that "rotate" can be combined with "resize/crop".
Ruslan Ermilov <ru@nginx.com>
parents: 184
diff changeset
193 В значении аргумента допустимо использование переменных.
76
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 <directive name="image_filter_transparency">
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
200 <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
201 <default>on</default>
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
202 <context>http</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
203 <context>server</context>
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
204 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 <para>
203
876d36c69e01 Refurbished content.
Ruslan Ermilov <ru@nginx.com>
parents: 191
diff changeset
207 Определяет, сохранять ли прозрачность при обработке изображений
183
aa4c2b46a4a3 Revised ngx_http_image_filter_module documentation, unfinished.
Igor Sysoev <igor@sysoev.ru>
parents: 110
diff changeset
208 в формате PNG с цветами, заданными палитрой, и в формате GIF.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
209 Потеря прозрачности позволяет получить более качественное изображение.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210 Прозрачность альфа-канала в формате PNG сохраняется всегда.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
213 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
214
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
216
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217 </module>