对象存储

索引切割

2026-01-22 03:36:21

本文帮助您了解索引切割。

操作场景

ZOS支持索引切割。您可以通过配置参数,将存储在ZOS的图片按指定大小切割并返回一块需要的图片区域。

约束与限制

        原图的格式、大小和分辨率的通用限制请参考图片处理概述-图片限制

        索引切割操作支持的地域请参见产品能力地图

参数说明

操作符:indexcrop

参数名称

参数用途

取值

是否必须

x

指定 x 轴切割区域的长度

[1,图片宽度]

否,但 x 与 y 必须最少指定一个

y

指定 y 轴切割区域的长度

[1,图片高度]

否,但 x 与 y 必须最少指定一个

i

 指定索引,表示返回切割后的图片区域

 索引号从0开始,值为0表示返回第1块区域

[0,区域数)

 

注意

 当参数 x 或参数 y 指定的长度超过原图的宽度和高度限制时,会拒绝请求。

 同时指定了 x 和 y 且值合法时,会以参数 y 的值为准。

 指定的参数 i 超过切割后生成的区域数量时,将会返回原图。

示例

一个宽度为1920 px,高度为1080 px 的图片,分别在 x 轴和 y 轴切割。

        将图片在 x 轴切割,指定切割间隔为200 px

       切割后的图片情况:会切割成10块区域,其中最后一块区域宽度为120 px,其余区域宽度为200 px

       返回切割后的第2块区域,具体请求参数为:

image/indexcrop,x_200,i_1


        将图片在 y 轴切割,指定切割间隔为200 px

       切割后的图片情况:会切割成6块区域,其中最后一张区域高度为80 px,其余区域高度为200 px

       返回切割后的第5块区域,具体请求参数为:

image/indexcrop,y_200,i_4




IXHwD8353SFZ