Image Processing Overview

2026-01-26 02:04:27

This document helps you understand how to use ZOS image processing.

For images stored in ZOS, you can add image processing parameters to the GetObject request to process images. The main supported features include image rotation, image watermarking, etc.

Supported Features and Parameters

The image processing feature of ZOS supports processing multiple parameters in a single request to achieve sequential processing. Processing order follows the sequence of parameters in the request.

Supported Image Processing Features and Parameters Include:

Function	Parameter	Note
Resizing Images	resize	Resizes images to a specified size.
Watermarking Images	Adds text or image watermarks.
Cropping Images	crop	Crops a specified rectangle at a designated position.
Rotating Images	rotate	Rotates images from 0° to 360°.
Format Conversion	format	Converts between multiple image formats.
Retrieving Information	info	Retrieves basic information of the image and EXIF information.
Stripping EXIF Information	strip	Strips EXIF information from the image.
Image Quality Adjustment	quality	Adjusts the quality of images in the JPG format and WebP format.
Brightness Adjustment	bright	Adjusts the brightness of images.
Gradual Display	interlace	Configures gradual display for JPG images.
Gaussian Blur	blur	Applies a Gaussian blur effect to images.
Auto Orientation	auto-orient	Auto-rotates images.
Average Hue Query	average-hue	Queries the average-hue of images.
Sharpening	sharpen	Sharpens images.
Contrast Adjustment	contrast	Adjusts the contrast of images.
Circle Crop	circle	Crops images into inscribed circles.
Rounded Rectangle	rounded-corners	Crops images into rounded rectangles based on the specified rounded radius.
Indexed Slice	indexcrop	Crops images along the specified horizontal axis or vertical axis and return the desired partition.

Image Restrictions

The text below describes image processing restrictions from three aspects: format, size, and image resolution. Note: Additional operational restrictions may apply when using various image processing parameters. See the constraints in the Image Processing Parameters section for details.

Restriction	Note
Image Format	Supported source formats: JPG, PNG, GIF, WebP, and TIFF. Animated images only support resize, crop, rotate, watermark, and information retrieval.
Image Size	The size of a source image cannot exceed 20 MB.
Image Resolution	Source image limits vary by operation: a maximum dimension of 4,096 px for rotation, and 30,000 px (with a total pixel limit of 250 million) for all other operations. When resizing by percentage: width/height ≤ 16,384 px, and total pixels ≤ 16.78 million. When specifying width & height: Each dimension ≤ 4,096 px. Note For animated images (such as GIFs), the total pixel count is calculated as width * height * number of frames. For static images (such as PNGs), the total pixel count is calculated as width * height.

Zettabyte Object Storage

Image Processing Overview