1. Что это?

Это очень простой плагин для обработки изображений, который можно быстро интегрировать в ваше веб-приложение. Он основан на HTTP и позволяет выполнять следующие операции с изображениями: уменьшать размер, сжимать качество, вращать, преобразовывать тип, добавлять водяные знаки и т. д.

2. Как использовать?

• Предварительный просмотр уменьшенного изображения:
  • если у вас есть изображение abc.png размером 1024x800 пикселей и вы хотите получить изображение с пропорциями 300x230, то достаточно использовать ссылку: http://host:port/upload/abc.png?imageView/s/300x230. Здесь imageView — это предварительный просмотр изображения, а 300x230 — размеры уменьшенного изображения.
  • Если вы хотите взять изображение размером 512x400 (половина исходного размера), то используйте ссылку: http://host:port/upload/abc.png?imageView/p/50. Здесь 2 — это коэффициент масштабирования, а 50 — процент от исходного размера.
• Загрузка уменьшенных изображений: просто замените imageView на imageDown.
• Просмотр информации об изображении: используйте http://host:port/upload/abc.png?imageInfo.
• Вращение изображения: используйте ссылку http://host:port/upload/abc.png?imageView/r/180.
• Добавление водяных знаков: ещё не реализовано.

Порядок параметров может быть изменён, но параметр imageView должен быть первым. Остальные параметры представляют собой пары ключ-значение, которые определяют обработку изображения.

...

3. Быстрая интеграция

Просто добавьте следующее в web.xml:

И всё!

4. Подробное описание параметров

• Предварительный просмотр изображения:

  • http://xxxxx/abc.png?imageView/s/300x200/q/90.
  • Здесь imageView/s/300x200 определяет пропорции уменьшенного изображения, q/90 — качество изображения после уменьшения.
  • Типы масштабирования: 1 — по размеру, 2 — по пропорции.
  • Параметры типа: ширина и высота для типа 1, коэффициент от 1 до 100 для типа 2.
  • Коэффициент сжатия изображения: от 1 до 100.

• Параметр загрузки изображения такой же, как и для предварительного просмотра, за исключением того, что imageView заменяется на imageDown. Я не стал усложнять его настройку, так как этот плагин предназначен только для одномашинной среды. Для распределённой архитектуры следует рассмотреть другие решения. Плагин очень лёгкий и компактный.

• Поворот изображения:

  • используйте ссылку http://xxxxx/abc.png?imageView/r/180 для поворота изображения abc на 180 градусов. Угол поворота может быть отрицательным.

• Добавление водяного знака: не реализовано.

Общие параметры:

• r — угол поворота (в градусах).
• q — качество изображения (в процентах).
• p — коэффициент пропорционального уменьшения (в процентах).
• s — размер уменьшенного изображения (в пикселях).
• c — обрезка (в пикселях).
• f — преобразование формата изображения.