Skip to main content

图片实时处理说明

S4 支持处理存储的图片文件,您可以通过在 Url 末尾(或在 GetObject 接口中)携带图片处理的相关参数的方式使用。

注意

当前处于测试阶段,暂不收费。收费时间及标准会另行通知,请您及时关注相应通知。

CoreIX 特点

  1. 高性能:比国内主流对象存储中图片处理性能平均高 100%;
  2. 支持颜色管理:支持范围 sRGB、Adobe RGB、Display P3、Prophoto、CMYK;
  3. 可处理超大图片:与竞品普遍最大只能处理 20MB 的图片不同,CoreIX 允许实时处理高达 200MB 的图片;
  4. 客户端协商机制:当设定输出格式为 fm=webp 时,系统将通过 Accept 判断客户端是否支持 webp 图片;

图片处理功能

info
  1. CoreIX 关心图片的最终分享效果,包括准确度与访问速度。所以在每次执行手动参数前,都会对图片做必要的自动优化,以最大程度达到处理效果节省流量的最佳平衡。
  2. CoreIX 在生成分享图时做实时处理,所有操作均不会造成对存储桶中原图的修改。

自动优化:

  • 自适应方向:可依据原图的 Exif 信息对图片做自动的方向调整处理,支持带 Exif 信息的 Jpeg、PNG、Webp、Avif、Heif 和 主流相机 Raw 图;
  • 自动删减 Exif:在快速分享场景中,Exif 没有实际作用,去掉 Exif 可减少相应传输流量,此举最多可节省约 500 KiB 容量;
  • 自动颜色管理:CoreIX 生成缩略图时,会自动进行必要的颜色空间转换,然后删除 ICC profile,此举对于特殊色彩空间的图片最多可节省约 2.5 MiB 容量;
  • 自动转换Tinysrgb:对于包含 sRGB 的原图,在生成小号缩略图时,CoreIX 会自动用 Tinysrgb 替代,此举通常可节省 3 KiB 容量;
  • 自动支持 HDR:在对 HDR 视频进行截图(取帧)操作时,CoreIX 将默认自动输出 HDR 图片,指定 cs 参数为 srgb 时将自动把色彩空间映射为 SDR,避免出现灰图;

手动参数:

限制项相关参数作用说明
缩略宽高- w: 图片宽度
- h: 图片高度
将图片缩放至指定大小。
缩放倍数- dpr: 倍数值可简易设置 2x 3x 大小缩略尺寸。
缩略模式- mode: crop / clip当设定w、h全部指定且与原图比例不符时。
默认使用 crop 裁剪缩略模式。
保留位置- pos: 缩略裁剪模式情况下保留的部分缩略裁剪后提取的保留部分。
自定义裁剪- rect: 裁剪坐标与大小裁剪指定位置和大小的矩形图片。
质量变化- q: 质量百分比调整 JPG、WebP、Avif 格式图片的质量。
图像锐化- sharp: 锐化程度对图片进行锐化效果处理。
图像模糊- blur: 模糊程度对图片增加模糊效果。
文字水印- txt: 水印的文字内容详细请看:详细参数
图片水印- mark: 水印图片的桶内路径详细请看:详细参数
静帧提取- frame: 毫秒数(视频)或 帧数(GIF)格式支持:MP4、MKV;
色彩支持:SDR 视频 / BT.2020/2100 色域 HDR 视频
* 注意:frame 只能对已经存入 S4 对象存储的文件生效
(镜像回源场景下回源成功后才会生效)
色彩空间- cs: ColorSpace设定希望输出的色彩空间,支持:tinysrgb、srgb、adobe rgb
格式转换- fm/fmt: 格式代号图片格式:jpeg、png、tpng、webp、bmp、avif、gif、tiff
- 其他格式:blurhash(输出 blurhash 代码)、json(输出图片信息)
info

目前 CoreIX 不对 GIF 动图 做任何缩略(缺少 frame 参数的情况下直接返回源文件)

自2024年1月1日起,将支持 GIF / WEBP 动图除水印外的所有处理:

  1. 图片水印与文字水印不会在动图处理下生效(用 frame 参数截帧情况下不影响);
  2. 只支持 WEBP/GIF 动图,目前不支持 apng、Avif 的动图输入与输出;
  3. 目前不能保证处理后的动图一定比原图小;
  4. 动图请尽量输出为 WEBP,无论从画质和容量大小都是最优选择。

图片处理方法

直接在图片类型对象的 Url 末尾加上相应参数即可使用。

示例 URL 如下:

原图:https://fanfan.s3.bitiful.net/girl.jpeg

加上处理参数后:https://fanfan.s3.bitiful.net/girl.jpeg? w=800&h=500&pos=top

girl.resize.jpg