边缘安全加速 ESA提供图像转换功能,可直接对源站图片进行格式/质量转换、裁剪、缩放等处理并进行缓存,提升获取图片的速度,减少回源流量。
使用限制
使用图片处理功能时有如下限制。
原图限制:
图片格式只支持JPEG、JPG、PNG、WebP、BMP、GIF、TIFF、JPEG 2000。
原图大小不能超过10 MB。
原图的宽×高不能超过16,777,216 px。
若图片为 GIF 格式时,GIF 图片的原图宽×高为所有帧相加之和,您可以使用 ImageMagick 等工具查看 GIF 图片的帧信息。
处理后的图片限制:
图片的宽×高不能超过16,777,216 px。
转 WebP 格式时,图片的宽×高不能超过16,777,216 px,且宽和高单边均不能超过16,384 px。如果原图为动图,转 WebP 格式时会被转换为静态图片。
开启图像转换
在ESA控制台,选择站点管理,在站点列单击目标站点。
在左侧导航栏中,单击
,进入速度优化页面。单击图像转换开关后,可以通过在请求URL中添加图片处理参数,来实现不同的图像处理功能。
例如,您可以在JavaScript中,通过编写URL处理方法,将图片转换为其他格式。
function updateImageUrl(format) { let baseUrl = "https://example.com/image_01"; let newUrl = `${baseUrl}.png?image_process=format,${format}`; document.getElementById('imageElement').src = newUrl; } // 调用示例,转换为BMP格式 updateImageUrl("bmp"); // 如果需要转换为其他格式,例如jpg: // updateImageUrl("jpg");
上述代码中image_process=format,${format}
为图像处理参数的配置部分,更多支持变更的参数及参数的取值范围,请参见支持的图片处理方式。
支持的图片处理方式
ESA支持携带一个或多个转换参数处理图片,支持的参数请参见下表。
图片处理功能 | 处理参数 | 说明 |
图片处理功能 | 处理参数 | 说明 |
format | 转换图片格式。 | |
quality | 调整图片质量。 | |
crop | 裁剪指定大小的图片。 | |
resize | 将图片缩放至指定大小(目前只支持将原图缩小处理,暂不支持将原图放大处理)。 | |
| 将携带旋转参数的图片进行自适应旋转或按指定角度以顺时针方向旋转图片。 | |
| 调整图片的亮度、对比度和清晰度。 | |
watermark | 为图片添加图片水印或文字水印。 | |
info | 获取图片信息,包括图片的长、宽、高、图片格式和图片质量等信息。 |
- 本页导读
- 使用限制
- 开启图像转换
- 支持的图片处理方式