zengde / nginx_image_filter

Nginx image_filter module with ability to add placement for cropped images.

nginx image_filter

This is basically the same image_filter module, but with ability to place cropped images.

Goals

Humans usually have faces at the top of their photos, but nginx always crop image to center. We needed to make it more flexible.

Configuration

This module has additional configuration option:

image_filter_crop_offset {left,center,right} {top,center,bottom};

build

download nginx source,override the ngx_http_image_filter_module.c

• nginx installed

nginx -V
./configure // copy config from nginx-v
make

replace objs/modules/ngx_http_image_filter_module.so

• nginx not installed

./configure --with-http_image_filter_module=dynamic
// other configs
make && make install

Examples

conf

example conf

http://localhost:8888/crop/768/example.jpg

Vertical images

• Original image

• Crop and align to top: image_filter_crop_offset center top;

• Crop and align to center (original behavior): image_filter_crop_offset center center;

• Crop and align to bottom: image_filter_crop_offset center bottom;

Horizontal images

• Original image

• Crop and align to left: image_filter_crop_offset left center;

• Crop and align to center (original behavior): image_filter_crop_offset center center;

• Crop and align to right: image_filter_crop_offset right center;

ChangLog

2019/10/15 base on nginx 1.13.0/src/http/modules/ngx_http_image_filter_module.c,works on nginx-1.10.3 above

Authors

• Nginx authors
• Ian Babrou