元信息保留与去除
简介
imageMogr2 提供一系列高级图片处理功能,本文介绍 图片元信息保留与去除 的使用,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价。
- 图片元信息包括:bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、sRGB、tEXt、zCCP、zTXt、date等
限制说明
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
、heic
- webp动图,仅支持持久化处理
- 输出限制
- 输出为
gif
,一般处理时间比较长,建议优先使用 持久化处理
- 输出为
- 同步处理
- 原图只支持 20MB 以内的图片,超过 20MB 的图片需要使用持久化处理
- 处理前的gif最大帧数为 200
- 处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 处理后的图片
w
和h
参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
- 持久化处理
- 原图无大小限制
- 处理前的
gif
、webp动图
,最大帧数为 500 - 处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 处理后的图片
w
和h
参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素
参数说明
注意:接口规格不含任何空格与换行符。
imageMogr2/strip
/meta-keep-list/<metaKeepList>
/ignore-error/<ignoreError>
参数说明
参数名称 | 必填 | 说明 |
---|---|---|
/strip |
去除图片的全部元信息 ● strip 参数单独使用保留指定的图片元信息,其他信息删除 ● strip 和 meta-keep-list 参数一起使用,即 strip/meta-keep-list |
|
/meta-keep-list/<metaKeepList> |
保留指定的图片元信息,其他信息尽量保留 (参数单独使用时) ● 取值范围: icc (图片色彩信息),使用URL安全的Base64编码。● 该参数不能与 exif-retain-names 一起使用。 |
|
/ignore-error/<ignoreError> |
主要针对图片兼容性的问题导致无法处理,取值为1时,则处理失败时返回原图; 不设置此参数,默认处理失败时返回错误信息。 |
注意:
- 如果图片格式不支持保留某类元信息或原图没有某类元信息,指定
meta-keep-list
参数后,处理结果是保留不生效,不会报错。
使用示例
1.去除图片的全部元信息
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/strip
2.保留指定图片元信息,其他信息尽量保留
- 示例:
icc
base64 后是 aWNj
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/meta-keep-list/aWNj
3.保留指定的图片元信息,其他信息删除
- 示例:
icc
base64后是 aWNj
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/strip/meta-keep-list/aWNj
操作方式
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)