Image Processing

Bunny Optimizer is a real-time on the fly image manipulation and optimization service that automatically optimizes your images for faster image delivery, bandwidth savings and enables smart dynamic image manipulation using a simple query API.

This article explains the image optimizer engine query API.

Width

Parameter: width    Units: Pixels    Default: auto
Resize the output image to the given width maintaining the current aspect ratio.

?width=250?width=150?width=75
?width=250?width=150?width=75

📘

Aspect Ratio Crop has priority over the Width or Height commands. If the Aspect Ratio Crop is defined in the query and is not set to auto, it will be applied first.

Height

Parameter: height    Units: Pixels    Default: auto

Resize the output image to the given height maintaining the current aspect ratio.

?height=150?height=125?height=75
?height=150?height=125?height=75

Aspect Ratio Crop

Parameter: aspect_ratio    Default: auto
Crop the output image to match the given aspect ratio. The default origin point (gravity) is positioned on the center of the image.

?aspect_ratio=1:1?aspect_ratio=16:9?aspect_ratio=2:4

Quality

Parameter: quality    Units: Percent    Range: 0-100    Default: 85
Determines the compression level of the resulting image with 100 being the lowest level of compression and 0 being the highest. Higher compression means smaller files, but might visually degrade the image (e.g. JPEG compression under 70 tends to produce visible artefacts.

?quality=100?quality=40?quality=5

📘

The quality parameter is ignored if the requested output image format is lossless (e.g. PNG).

Sharpen

Parameter: sharpen    Units: Boolean    Default: false
Sharpen the output image.

?sharpen=false?sharpen=true

Blur

Parameter: blur    Units: Number    Range: 0-100    Default: 0
Blur the output image.

?blur=0?blur=25?blur=80

Crop

Parameter: crop    Units: Pixels    Format 1: width,height    Format 2: width,height,x,y
Crop the output image to the given width and height. Two formats are accepted. Format 1 one only includes the width and height of the crop. Format 2 also includes the X and Y position where the crop should start. Image resizing with the width and height parameters is processed after the crop and the resized measurements apply.

If only width and height are given, the Crop Gravity parameter will be used.

?crop=3500,3500?crop=3500,3500,250,300?crop=300,300

Crop Gravity

Parameter: crop_gravity    Default: center
Values: center,forget,east,north,south,west,northeast,northwest,southeast,southwest
Set the gravity of the crop operation. This is used with the Format 1 cropping only and snaps the crop to the selected position.

?crop_gravity=center?crop_gravity=west?crop_gravity=east

Flip

Parameter: flip    Units: Boolean    Default: false
Flip the output image vertically.

?flip=false?flip=true

Flop

Parameter: flop    Units: Boolean    Default: false
Flip the output image horizontally.

?flop=false?flop=true

Brightness

Parameter: brightness    Units: Number    Range: -100-100    Default: 0
Adjusts the brightness of the output image. This can either brighten or darker the image.

?brightness=0?brightness=15?brightness=-15

Saturation

Parameter: saturation    Units: Number    Range: -100 - 100    Default: 0
Adjusts the saturation of the output image. Use -100 for grayscale.

?saturation=0?saturation=50?saturation=-60

Hue

Parameter: hue    Units: Number    Range: 0-100    Default: 0
Adjusts the hue of the output image by rotating the color wheel. The default value of 0 is the base color and increasing the value modulates to the next color for each 33 change.

?hue=0?hue=33?hue=66

Contrast

Parameter: contrast    Units: Number    Range: -100 - 100    Default: 0
Adjusts the contrast of the output image.

?contrast=0?contrast=20?contrast=-20

Automatic Optimization

Parameter: auto_optimize    Units: String    Values: low,medium,high    Default: none
Automatically enhance the output image with multiple levels of optimizations. With high, sharpening is also applied automatically.

?auto_optimize=low?auto_optimize=medium?auto_optimize=high

Sepia

Parameter: sepia Units: Integer Values: 0 - 100 Default: 0
Changes the image color to the sepia color scheme.

?sepia=0?sepia=50?sepia=100