Skip to main content

Documentation Index

Fetch the complete documentation index at: https://autorender.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Overview

AutoRender’s zoom feature allows you to magnify or reduce specific regions of an image before applying other transformations. Zoom is particularly useful for focusing on details, creating close-up views, or adjusting the effective crop area of an image.

Zoom Parameter - (z)

The zoom parameter controls the magnification level of the image. Zooming is applied relative to the center or a specified position before other transformations like cropping or resizing.
A zoom factor greater than 1.0 zooms in, while a factor less than 1.0 zooms out. Zoom is typically used in combination with crop modes to focus on a particular area.
The z_ parameter supports a range from 1.0 (original) up to 5.0 (maximum magnification).
https://assets.autorender.io/LOKVTtKVGb/doc1/coffee_cup.jpg
Original image

Zoom Levels

FactorDescription
1.0Original representation (no zoom)
1.5Moderate zoom, suitable for product close-ups
2.0Strong zoom for fine details
3.0Strong zoom (use with high-res source)
5.0Maximum magnification level
Higher zoom factors (> 2.0) may result in reduced image quality if the source resolution is low. Use appropriate output formats (WebP, AVIF) to maintain quality.

Zoom with Position

You can control where the zoom focuses by combining the z_ parameter with the position (p_) parameter.
Position CodeDescription
p_cCenter (Default)
p_tTop Center
p_bBottom Center
p_tlTop-left
p_brBottom-right
https://assets.autorender.io/LOKVTtKVGb/z_3,w_360,h_360,c_crop,p_t/doc1/coffee_cup.jpg
Top zoom

Best Practices

  • Combine with Crop: Always use c_crop or c_fill when zooming to maintain your target dimensions.
  • Source Quality: Start with a high-resolution source image for high zoom factors (> 2.0).
  • Subtle Details: Use subtle zoom (1.1 - 1.3) for hero images to create a sense of focus.
  • Performance: Zoom is applied server-side before other transformations, ensuring minimal overhead for the client.