功能描述
HDR(High Dynamic Range Imaging),高动态范围成像,是一种能够显示更大曝光动态范围的图像,它能保留图像中的更多细节和色彩信息,使图像的明暗差别更明显、色彩更丰富,从而提供更真实和丰富的视觉体验。
数据万象支持在进行图片基础处理(如缩放、裁剪等)时保留图片原有的 HDR 信息,使处理后的图片依然能展示出 HDR 效果。
授权说明
服务开通
使用该功能将默认为您开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。
使用该功能需先开启 图片高级压缩。
使用限制
不支持处理 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.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
说明:
处理参数说明
数据万象通过 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 | 否 |
说明:
实际案例
案例一:缩放宽高
对原图为 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