Visual Effects Parameters#
Apply creative visual effects to enhance your images with rotation, blur, grayscale conversion, and flipping.
Rotation#
Description#
Rotate the image by a specified angle in degrees.
Range#
- -360 to 360 degrees
- Angles are automatically normalized (e.g., 370° becomes 10°)
Usage#
?transform=rotation:90
Examples#




Common angles:
rotation:90- Quarter turn clockwiserotation:180- Half turnrotation:270- Quarter turn counter-clockwiserotation:15- Slight artistic tilt
Blur#
Description#
Apply Gaussian blur effect to the image.
Range#
- 0 to 20
- Higher values create stronger blur
- Values above 15 may significantly increase processing time
Usage#
?transform=blur:5
Examples#




Common use cases:
blur:1-2- Subtle softeningblur:3-5- Background blur for text overlayblur:10-15- Strong privacy blurblur:15-20- Maximum blur (slower processing)
Performance Note#
Higher blur values (15-20) consume more CPU resources and may increase processing time. Use lower values when possible.
Grayscale#
Description#
Convert the image to grayscale (black and white).
Usage#
?transform=grayscale
Examples#


Use cases:
- Artistic portfolio images
- Vintage/classic aesthetic
- Print-friendly versions
- Consistent styling across galleries
Flip (Vertical)#
Description#
Flip the image vertically (top to bottom).
Usage#
?transform=flip
Examples#


Flop (Horizontal)#
Description#
Flip the image horizontally (left to right).
Usage#
?transform=flop
Examples#


Combining Effects#
You can combine multiple effects for creative results:
Rotation + Flip#
?transform=rotation:90,flip
Blur + Grayscale#
?transform=blur:5,grayscale
Multiple Effects#
?transform=rotation:15,blur:2,grayscale
With Sizing#
?transform=w:800,h:600,rotation:45,blur:3,fit:cover
Common Use Cases#
Background Images with Text Overlay#
?transform=w:1920,h:1080,blur:10,format:webp
Blur the background to make text more readable.
Artistic Portfolio#
?transform=w:800,grayscale,blur:1,format:webp
Create a cohesive black-and-white gallery aesthetic.
Privacy Protection#
?transform=extract:10-10-30-30,blur:20
Blur sensitive regions (faces, license plates, etc.).
Creative Rotation#
?transform=w:600,rotation:15,format:webp
Add visual interest with slight rotation.
Processing Order#
Effects are applied in this order:
- Extract (region extraction)
- Resize (width/height/fit/dpr)
- Rotation
- Flip/Flop
- Blur
- Grayscale
- Format conversion
Understanding the processing order helps predict the final result when combining multiple transformations.
Next Steps#
- Region & Output - Extract regions and control output format
- Best Practices - Learn optimization strategies
- Use Cases - See real-world examples
