Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_image_filter_module.xml @ 191:a4e271eb8dd6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented that "rotate" can be combined with "resize/crop". Documented the allowed use of variables in arguments.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 23 Nov 2011 10:24:07 +0000
parents 4840aa7bab2c
children 876d36c69e01
comparison
equal deleted inserted replaced
190:c52987a234e2 191:a4e271eb8dd6
32 <para> 32 <para>
33 <example> 33 <example>
34 location /img/ { 34 location /img/ {
35 proxy_pass http://backend; 35 proxy_pass http://backend;
36 image_filter resize 150 100; 36 image_filter resize 150 100;
37 image_filter rotate 90;
37 error_page 415 = /empty; 38 error_page 415 = /empty;
38 } 39 }
39 40
40 location = /empty { 41 location = /empty {
41 empty_gif; 42 empty_gif;
51 <directive name="image_filter"> 52 <directive name="image_filter">
52 <syntax><parameter>off</parameter></syntax> 53 <syntax><parameter>off</parameter></syntax>
53 <syntax><parameter>test</parameter></syntax> 54 <syntax><parameter>test</parameter></syntax>
54 <syntax><parameter>size</parameter></syntax> 55 <syntax><parameter>size</parameter></syntax>
55 <syntax><parameter>rotate </parameter> 56 <syntax><parameter>rotate </parameter>
56 <value>90</value>|<value>180</value>|<value>270</value> 57 <value>90</value> | <value>180</value> | <value>270</value>
57 </syntax> 58 </syntax>
58 <syntax> 59 <syntax>
59 <parameter>resize </parameter> 60 <parameter>resize </parameter>
60 <argument>ширина высота</argument> 61 <argument>ширина высота</argument>
61 </syntax> 62 </syntax>
98 <tag-name><parameter>rotate </parameter> 99 <tag-name><parameter>rotate </parameter>
99 <value>90</value>|<value>180</value>|<value>270</value> 100 <value>90</value>|<value>180</value>|<value>270</value>
100 </tag-name> 101 </tag-name>
101 <tag-desc> 102 <tag-desc>
102 поворачивает изображение против часовой стрелки на указанное число градусов. 103 поворачивает изображение против часовой стрелки на указанное число градусов.
104 В значении аргумента допустимо использование переменных.
105 Можно использовать как отдельно, так и совместно с преобразованиями
106 <parameter>resize</parameter> и <parameter>crop</parameter>.
103 </tag-desc> 107 </tag-desc>
104 108
105 <tag-name><parameter>resize </parameter> 109 <tag-name><parameter>resize </parameter>
106 <argument>ширина высота</argument> 110 <argument>ширина высота</argument>
107 </tag-name> 111 </tag-name>
109 пропорционально уменьшает изображение до указанных размеров. 113 пропорционально уменьшает изображение до указанных размеров.
110 Если требуется уменьшить только по одному измерению, то в качестве второго 114 Если требуется уменьшить только по одному измерению, то в качестве второго
111 можно указать “<code>-</code>”. 115 можно указать “<code>-</code>”.
112 В случае ошибки сервер возвращает код 116 В случае ошибки сервер возвращает код
113 <http-status code="415" text="Unsupported Media Type"/>. 117 <http-status code="415" text="Unsupported Media Type"/>.
118 В значениях аргументов допустимо использование переменных.
119 При использовании совместно с <parameter>rotate</parameter>,
120 поворот изображения происходит после уменьшения размеров изображения.
114 </tag-desc> 121 </tag-desc>
115 122
116 <tag-name><parameter>crop </parameter> 123 <tag-name><parameter>crop </parameter>
117 <argument>ширина высота</argument> 124 <argument>ширина высота</argument>
118 </tag-name> 125 </tag-name>
121 и обрезает лишние края по другой стороне. 128 и обрезает лишние края по другой стороне.
122 Если требуется уменьшить только по одному измерению, то в качестве второго 129 Если требуется уменьшить только по одному измерению, то в качестве второго
123 можно указать “<code>-</code>”. 130 можно указать “<code>-</code>”.
124 В случае ошибки сервер возвращает код 131 В случае ошибки сервер возвращает код
125 <http-status code="415" text="Unsupported Media Type"/>. 132 <http-status code="415" text="Unsupported Media Type"/>.
133 В значениях аргументов допустимо использование переменных.
134 При использовании совместно с <parameter>rotate</parameter>,
135 поворот изображения происходит до уменьшения размеров изображения.
126 </tag-desc> 136 </tag-desc>
127 137
128 </list> 138 </list>
129 </para> 139 </para>
130 140
156 166
157 <para> 167 <para>
158 Директива задаёт коэффициент потери информации при обработке изображений 168 Директива задаёт коэффициент потери информации при обработке изображений
159 в формате JPEG. 169 в формате JPEG.
160 Максимальное рекомендуемое значение — 95. 170 Максимальное рекомендуемое значение — 95.
171 В значении аргумента допустимо использование переменных.
161 </para> 172 </para>
162 173
163 </directive> 174 </directive>
164 175
165 176
172 183
173 <para> 184 <para>
174 Повышает резкость итогового изображения. 185 Повышает резкость итогового изображения.
175 Процент резкости может быть больше 100. 186 Процент резкости может быть больше 100.
176 Значение 0 отключает повышение резкости. 187 Значение 0 отключает повышение резкости.
188 В значении аргумента допустимо использование переменных.
177 </para> 189 </para>
178 190
179 </directive> 191 </directive>
180 192
181 193