Zettabyte Object Storage

Circle Crop

2026-01-26 03:03:30

This document helps you understand circle crop.

 

Operation Scenarios

ZOS supports cropping an image into an inscribed circle. You can configure parameters to crop images stored in ZOS into an inscribed circle, with non-circular areas filled with transparency or white.

 

Constraints and Restrictions

  • For images that support transparency channels (such as PNG), non-circular areas are filled with transparency after cropping. For images that do not support transparency channels (such as JPG), non-circular areas are filled with white after cropping.

  • For general limitations on the source format, file size, and image resolution, see Image Processing Overview - Image Restrictions.

  • For regions supporting circle crop, see Product Capability Map.

 

Description

Operator: circle

Parameter Name

Purpose

Value

Required

r

Represents the radius of the   inscribed circle.

 

Note

If the specified inscribed circle   radius is greater   than half of the shortest side length of the
  source image, the image will be   cropped by the radius equal to half of   the shortest side length.

[1,4096]

Yes

 

Example

To crop an image into an inscribed circle with radius 200 px, the specific request parameter is:

image/circle,r_200



MDsHLsLFEUj7