HDR 图片处理

最近更新时间:2025-04-22 17:38:22

我的收藏

功能描述

HDR(High Dynamic Range Imaging),高动态范围成像,是一种能够显示更大曝光动态范围的图像,它能保留图像中的更多细节和色彩信息,使图像的明暗差别更明显、色彩更丰富,从而提供更真实和丰富的视觉体验。
数据万象支持在进行图片基础处理(如缩放、裁剪等)时保留图片原有的 HDR 信息,使处理后的图片依然能展示出 HDR 效果。

授权说明

通过子账号使用时,需要在 授权策略 的 action 中添加 cos:GetObject,数据万象支持的所有操作接口请参见 action

服务开通

使用该功能将默认为您开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。
使用该功能需先开启 图片高级压缩

使用限制

该接口需要与基础图片处理搭配使用,请先确认基础图片处理相关限制条件。详情请参见 使用限制
不支持处理 COS 上的归档存储类型和深度归档存储类型的图片,如果需要处理此类型文件,请先 恢复归档文件
当前仅支持处理部分 HDR 类别与图片格式,见下表格:
支持处理的原图
支持输出的图片
支持的处理方式
HDR heif/heic:10-bit色深、Apple iOS GainMap
HDR heif/heic:10-bit色深
HDR avif:10-bit色深
下载时处理
HDR avif:10-bit色深
HDR heif/heic:10-bit色深
HDR avif:10-bit色深
下载时处理
说明:
目前还不支持处理 Ultra JPG HDR ,即将支持,敬请期待!

费用说明

HDR 图片为付费服务,与基础图片处理搭配使用时,当前仅支持输出 heif/heic 和 avif 格式图片,因为将产生图片高级压缩和 HDR 图片处理两项费用,详细计费说明可参见 图片处理费用
通过下载时处理的方式,且通过外网进行下载,调用会产生 流量费用
如果图片为 COS 上的低频存储类型,调用接口会产生 COS 低频数据取回费用

接口形式

GET /<ObjectKey>?imageMogr2/hdr/<mode> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
Authorization:携带鉴权信息,用于验证请求的合法性,详情请参见 请求签名 文档。

处理参数说明

数据万象通过 imageMogr2提供一系列的图片处理操作,HDR 图片处理的参数为hdr,需要搭配其他 imageMogr2处理参数一起使用。
参数
含义
默认值
类型
是否必选
ObjectKey
对象文件名,例如 folder/sample.jpg。
String
/hdr/<mode>
在原图为 HDR 图片(10-bit色深或带有 GainMap)时该参数才有意义,需要搭配 imageMogr2的其他处理参数一起使用,<mode>值可取0、1:
0:处理后不保留 HDR 信息,图片在处理后将降级为 SDR 图片。
1:处理后保留 HDR 信息,当前仅支持输出10-bit色深的 HDR 图片,若原图中带有 GainMap 信息,将解析 GainMap 信息并映射为10-bit色深。
0
Int
说明:
要保留图片为 heif/heic 或 avif 格式,需开启 图片高级压缩功能

实际案例

案例一:缩放宽高

对原图为 HDR 的图片进行缩放宽高操作,缩放为原图50%并输出为 HDR 图片,示例如下:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/thumbnail/!50p/hdr/1

案例二:缩放裁剪

对原图为 HDR 的图片进行缩放裁剪操作,以中心点 center 为参考点,缩放裁剪至300×400并输出为 HDR 图片,示例如下:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/crop/300x400/gravity/center/hdr/1