免费注册
帮助文档(华北一、二)

  • 图片处理服务是浪潮云对外提供的海量、安全、低成本高可靠的图片处理服务。用户将原始图片上传保存在对象存储空间中,用户可以在任何时间、任何地点、任何设备上对图片进行处理。

    图片处理服务仅在下载时触发。

    图片处理服务提供以下功能:

    1、基本图片信息获取

    2、EXIF信息获取

    3、图片缩放

    4、图片裁剪

    5、图片旋转

    6、水印

    7、图片格式转换

    8、管道顺序调用多种图片处理功能

    基本图片信息获取

    图片基本信息包括图片格式、图片大小。

    在图片下载URL后附加imageInfo指示符(区分大小写),即可获取JSON格式的图片基本信息。

    参数名

    解释

    iopcmd

    imageinfo

    主命令

    EXIF信息获取

    EXIF(EXchangeable Image File Format)是专门为数码相机的照片设定的可交换图像文件格式,通过在图片下载URL后附加exif指示符(区分大小写)获取。

    注意:缩略图等经过处理的新图片不支持该方法。

    参数名

    解释

    iopcmd

    exif

    主命令

    图片缩放

    参数名

    解释

     iopcmd

     thumbnail

     主命令

     type

     1

     按比例缩放

     type

     2

     宽度不变,高度按百分比缩放

     type

     3

     高度不变,宽度按百分比缩放

     type

     4

     指定宽度 ,高度等比缩放

     type

     5

     指定高度,宽度等比缩放

     type

     6

     widthXheight,限定长边,短边自适应缩放

     type

     7

     widthXheight,限定短边,长边自适应缩放

     type

     8

     widthXheight,指定高和宽的最小尺寸,等比缩放,如只指定高或宽,则未指定边按照指定数值进行裁剪.但是超出指定矩形会被居中裁剪

     type

     9

     以大的缩放比例进行等比缩放,缩放后可以小于指定的矩形,如高的缩放比例更大,以高为准等比缩放

     type

     10

     以小的缩放比例进行等比缩放,缩放后可以大于指定的矩形, 如宽的缩放比例更小,以宽为准等比缩放

     type

     11

     使用指定的宽和高,会导致图像拉伸

     type

     12

     原图尺寸小于widthXheight目标尺寸,原图居中,四周补color颜色

     type

     13

     等比缩放,一边先缩到目标值,另一边居中裁剪,传widthXheight

     type

     14

     等比缩放,目标会小于等于widthXheight

     type

     15

     等比缩放,目标会等于widthXheight,不足的边,补color颜色

     color

     十六进制或颜色名red等

     scale

     最大10000

     缩放百分比

     gifmode

     该参数只对gif图片有效。若不传,则该参数默认为1

     gifmode

     1

     返回连续的图像帧,如果不能处理全部的图像帧则只返回部分,同3

     gifmode

     2

     返回第一帧静态图片,图像格式仍为gif

     gifmode

     3

     在系统处理的超时时间内,返回连续的图像帧,如果不能处理全部的图像帧则只返回部分

     gifmode

     4

     在系统处理的超时时间内,如果不能处理全部的图像帧,则返回部分跳跃的图像帧,图像帧平均分布

     gifmode

     5

     在系统处理的超时时间内,如果不能处理全部的图像帧,则返回部分跳跃的图像帧,图像帧平均分布,同时用前一帧填充跳跃的帧,保持处理前后总帧数数量不变

     gifmode 

     6

     在系统处理的超时时间内,如果不能处理全部的图像帧,则返回部分跳跃的图像帧,图像帧平均分布,同时修改图像帧的延迟时间,使播放速度和原图相同

    图片裁剪

    参数名

    解释

     iopcmd

     crop

     主命令

     width

     0-10000

     裁剪后宽度

     height

     0-10000

     裁剪后高度

     ax

     0-10000

     锚点 x 坐标

     ay

     0-10000

     锚点 y 坐标

     gravity

     NorthWest/North/NorthEast/WestCenter/East/SouthWest/South/SouthEast

     位置偏移指示符,可以和锚点同时指定(比锚点优先使用)

    图片旋转

    参数名

    解释

     iopcmd

     rotate

     主命令

     degree

     [0,360]

     旋转度数(顺时针)

    水印

    参数名

    解释

     iopcmd

     watermark

     主命令

     type

     1=文字水印,2=图片水印

     水印类型

     gravity

     NorthWest/North/NorthEast/WestCenter/East/SouthWest/South/SouthEast

     位置偏移指示符,可以和锚点同时指定(比锚点优先使用)

     opacity

     1-100,缺省为100(完全不透明)

     透明度

     ax

     小于原图宽度,默认为10

     锚点 x 坐标

     ay

     小于原图高度,默认为10

     锚点 y 坐标

     text

     base64 URL encode 后的水印文字,支持 UTF-8。

     imageurl

     可访问的图片资源URI,水印图片,必须是可以访问的资源地址,经过 base64 URL encode。

     font

     base64 URL encode 后的字体名称

     fontsize

     1-100

     水印文字大小,缺省为10,字体大小。

     direction

     1=RightToLeft,2=LeftToRight

     水印文字方向

     fill

     RGB 颜色编码表,base64 URL encode 后的RGB格式,可以是颜色名称(比如red)或十六进制(比如#FF0000),缺省为白色。

     SimSun

     宋体

     angle_type

     1=左上角,2=右上角,3=右下角,4=左下角

     九宫格中水印图片位置,默认为左上角。

    图片格式转换

    参数名

    解释

     iopcmd

     convert

     主命令

     dst

     jpg/png/bmp/webp

     目标格式

     Q

     0-100

     图片压缩质量(绝对压缩比),目标格式为jpg,webp时有效

     q

     0-100

     图片压缩质量(相对压缩比),即在图片原有压缩基础上按此比例进行压缩,目标格式为jpg,webp时有效,Q与q同时出现时,取Q

     fr

     0.0-1.0

     需要格式转换的图像帧在图像总帧中的位置,默认为0.0

    管道顺序调用多种图片处理功能

    管道顺序是一种可以实现多种图片处理任务顺序执行的机制。用户可以通过管道顺序在一次下载时中按照顺序完成对图像的不同处理。

    如:

    <blockquote> <code> http://demobucket.ufile.ucloud.com.cn/here-for-example.jpg?iopcmd=rotate&degree=180|iopcmd=thumbnail&type=1&scale=40 </code></blockquote>

    上述请求会将demobucket这个空间中的here-for-example.jpg文件先旋转180度,然后按比例缩放为原来的40%大小。

    注意:如果请求当前不支持的iopcmd,则会报错,不会返回原图。


文档是否已解决您的问题?

  已解决   未解决

如您有其它疑问,您也可以与我们技术专家联系探讨。

联系技术专家