Description
HDR (High Dynamic Range Imaging), a technique that displays images with a wider exposure dynamic range, preserves more details and color information in images. It enhances the contrast between light and dark areas while enriching colors, thus delivering a more authentic and immersive visual experience.
Cloud Infinite supports preserving the original HDR information of images during basic image processing (such as scaling, cropping, and so on), enabling the processed images to still display HDR effects.
Authorization Description
When using a sub-account, you need to add cos:GetObject to the action in the authorization policy. For all supported operation interfaces of COS, see COS action. Note:
The resource corresponding to GetObject is the source file.
Service Activation
When you use this feature for the first time, Cloud Infinite will be enabled by default, and the Bucket will be automatically bound to Cloud Infinite, allowing direct use without role authorization.
Note:
After Cloud Infinite is bound, if you manually unbind Cloud Infinite from the Bucket, you will not be able to continue using this feature.
Use Limits
Images in the Archive and Deep Archive storage classes on COS cannot be processed. If you need to process such files, restore the archived files first. Currently, only some HDR types and image formats are supported, as shown in the table below:
|
JPG/JPEG: Ultra HDR (ISO standard for GainMap HDR) | Processing upon download |
HEIF/HEIC: 10-bit native HDR, Apple standard for GainMap HDR | Processing upon download |
AVIF: 10-bit native HDR | Processing upon download |
Fee Information
HDR images are a paid service. When HDR images are used in conjunction with Basic Image Processing, fees for HDR image processing will be incurred. If the processed image is in HEIF/HEIC or AVIF format, both fees for advanced image compression and fees for HDR image processing will be incurred. For detailed billing information, see Image Processing fees. API Format
GET /<ObjectKey>?imageMogr2/hdr/<mode> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Note:
Authorization: Carries authentication information to validate the request. For details, see the Request Signature documentation. Description of Processing Parameters
Cloud Infinite provides a series of image processing operations through imageMogr2. The parameter for HDR image processing is hdr, which must be used in conjunction with other parameters for imageMogr2 processing.
|
ObjectKey | File name of the object, for example, folder/sample.jpg. | None. | String | Yes |
/hdr/<mode> | This parameter takes effect only when the original image is an HDR image (10-bit color depth or with GainMap), and must be used in conjunction with other processing parameters of imageMogr2. Valid values for <mode> are 0 and 1: 0: Does not retain HDR information. The image will be downgraded to an SDR picture after processing. 1: Retains HDR information according to the HDR type of the original image after processing. Currently supports HDR images in JPG, HEIF, and AVIF formats, as detailed in the table above. | 0 | Int | No |
Practical Case
Example 1: Scaling the Width and Height
Resize the original HDR image to 50% of its dimensions and output it as an HDR image. Example:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/thumbnail/!50p/hdr/1
Example 2: Scaling and Cropping
Scale and crop the original HDR image with the center point as the reference, scaling and cropping to 300×400 and outputting as an HDR image. Example:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/crop/300x400/gravity/center/hdr/1