Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_image_filter_module.xml @ 203:876d36c69e01

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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