Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_image_filter_module.xml @ 203:876d36c69e01
Refurbished content.
- Added some markup bits.
- Clarified the meaning of the "image_filter_jpeg_quality" directive.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 25 Nov 2011 09:54:13 +0000 |
parents | a4e271eb8dd6 |
children | f743d1f4683a |
comparison
equal
deleted
inserted
replaced
202:5219a1498a61 | 203:876d36c69e01 |
---|---|
7 lang="ru"> | 7 lang="ru"> |
8 | 8 |
9 <section id="summary"> | 9 <section id="summary"> |
10 | 10 |
11 <para> | 11 <para> |
12 Модуль ngx_http_image_filter_module — это фильтр для преобразования | 12 Модуль <code>ngx_http_image_filter_module</code> — это фильтр для преобразования |
13 изображений в форматах JPEG, GIF и PNG (0.7.54+). | 13 изображений в форматах JPEG, GIF и PNG (0.7.54+). |
14 <note> | 14 </para> |
15 | |
16 <para> | |
15 По умолчанию этот модуль не собирается, его сборку необходимо | 17 По умолчанию этот модуль не собирается, его сборку необходимо |
16 разрешить с помощью конфигурационного параметра | 18 разрешить с помощью конфигурационного параметра |
17 <code>--with-http_image_filter_module</code>. | 19 <code>--with-http_image_filter_module</code>. |
18 </note> | |
19 <note> | 20 <note> |
20 Для сборки и работы этого модуля необходима библиотека | 21 Для сборки и работы этого модуля необходима библиотека |
21 <link url="http://libgd.org">libgd</link>. | 22 <link url="http://libgd.org">libgd</link>. |
22 Рекомендуется использовать самую последнюю версию библиотеки, | 23 Рекомендуется использовать самую последнюю версию библиотеки, |
23 на текущий момент это версия 2.0.35. | 24 на текущий момент это версия 2.0.35. |
66 </syntax> | 67 </syntax> |
67 <default/> | 68 <default/> |
68 <context>location</context> | 69 <context>location</context> |
69 | 70 |
70 <para> | 71 <para> |
71 Директива задаёт тип преобразования изображения: | 72 Задаёт тип преобразования изображения: |
72 <list type="tag"> | 73 <list type="tag"> |
73 | 74 |
74 <tag-name><parameter>off</parameter></tag-name> | 75 <tag-name><parameter>off</parameter></tag-name> |
75 <tag-desc> | 76 <tag-desc> |
76 отключает обработку данным модулем во вложенном location. | 77 отключает обработку данным модулем во вложенном location. |
115 можно указать “<code>-</code>”. | 116 можно указать “<code>-</code>”. |
116 В случае ошибки сервер возвращает код | 117 В случае ошибки сервер возвращает код |
117 <http-status code="415" text="Unsupported Media Type"/>. | 118 <http-status code="415" text="Unsupported Media Type"/>. |
118 В значениях аргументов допустимо использование переменных. | 119 В значениях аргументов допустимо использование переменных. |
119 При использовании совместно с <parameter>rotate</parameter>, | 120 При использовании совместно с <parameter>rotate</parameter>, |
120 поворот изображения происходит после уменьшения размеров изображения. | 121 поворот изображения происходит <emphasis>после</emphasis> |
122 уменьшения размеров изображения. | |
121 </tag-desc> | 123 </tag-desc> |
122 | 124 |
123 <tag-name><parameter>crop </parameter> | 125 <tag-name><parameter>crop </parameter> |
124 <argument>ширина высота</argument> | 126 <argument>ширина высота</argument> |
125 </tag-name> | 127 </tag-name> |
130 можно указать “<code>-</code>”. | 132 можно указать “<code>-</code>”. |
131 В случае ошибки сервер возвращает код | 133 В случае ошибки сервер возвращает код |
132 <http-status code="415" text="Unsupported Media Type"/>. | 134 <http-status code="415" text="Unsupported Media Type"/>. |
133 В значениях аргументов допустимо использование переменных. | 135 В значениях аргументов допустимо использование переменных. |
134 При использовании совместно с <parameter>rotate</parameter>, | 136 При использовании совместно с <parameter>rotate</parameter>, |
135 поворот изображения происходит до уменьшения размеров изображения. | 137 поворот изображения происходит <emphasis>до</emphasis> |
138 уменьшения размеров изображения. | |
136 </tag-desc> | 139 </tag-desc> |
137 | 140 |
138 </list> | 141 </list> |
139 </para> | 142 </para> |
140 | 143 |
147 <context>http</context> | 150 <context>http</context> |
148 <context>server</context> | 151 <context>server</context> |
149 <context>location</context> | 152 <context>location</context> |
150 | 153 |
151 <para> | 154 <para> |
152 Директива задаёт максимальный размер буфера для чтения изображения. | 155 Задаёт максимальный размер буфера для чтения изображения. |
153 При превышении размера сервер вернёт ошибку | 156 При превышении размера сервер вернёт ошибку |
154 <http-status code="415" text="Unsupported Media Type"/>. | 157 <http-status code="415" text="Unsupported Media Type"/>. |
155 </para> | 158 </para> |
156 | 159 |
157 </directive> | 160 </directive> |
163 <context>http</context> | 166 <context>http</context> |
164 <context>server</context> | 167 <context>server</context> |
165 <context>location</context> | 168 <context>location</context> |
166 | 169 |
167 <para> | 170 <para> |
168 Директива задаёт коэффициент потери информации при обработке изображений | 171 Задаёт желаемое качество преобразованного изображения в формате JPEG. |
169 в формате JPEG. | 172 Меньшим значениям обычно соответствует худшее качество |
173 и меньшие размеры изображений. | |
170 Максимальное рекомендуемое значение — 95. | 174 Максимальное рекомендуемое значение — 95. |
171 В значении аргумента допустимо использование переменных. | 175 В значении аргумента допустимо использование переменных. |
172 </para> | 176 </para> |
173 | 177 |
174 </directive> | 178 </directive> |
197 <context>http</context> | 201 <context>http</context> |
198 <context>server</context> | 202 <context>server</context> |
199 <context>location</context> | 203 <context>location</context> |
200 | 204 |
201 <para> | 205 <para> |
202 Директива определяет, сохранять ли прозрачность при обработке изображений | 206 Определяет, сохранять ли прозрачность при обработке изображений |
203 в формате PNG с цветами, заданными палитрой, и в формате GIF. | 207 в формате PNG с цветами, заданными палитрой, и в формате GIF. |
204 Потеря прозрачности позволяет получить более качественное изображение. | 208 Потеря прозрачности позволяет получить более качественное изображение. |
205 Прозрачность альфа-канала в формате PNG сохраняется всегда. | 209 Прозрачность альфа-канала в формате PNG сохраняется всегда. |
206 </para> | 210 </para> |
207 | 211 |