七牛格式

基本处理

imageView2/<mode>/w/<LongEdge>
                 /h/<ShortEdge>
                 /format/<Format>
                 /q/<Quality> 
参数 示例 说明
缩放

/0/w/<LongEdge>/h/<ShortEdge> /0/w/200/h/200 /0/w/200/ /0/h/200 限定缩略图的长边最多为,短边最多为,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定长边(短边自适应),只指定 h 参数则表示限定短边(长边自适应)。
/2/w/<Width>/h/<Height> /2/w/200/h/200 /2/w/200 /2/h/200 限定缩略图的宽最多为,高最多为,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定宽(长自适应),只指定 h 参数则表示限定长(宽自适应)。它和模式0类似,区别只是限定宽和高,不是限定长边和短边。
转格式

/<mode>/format/<format> /0/format/png <format>输出格式,可选值 jpg、png ,<mode>可选值 [0-1]
压缩质量

/<mode>/q/<quality> /0/q/60 <quality>设置压缩质量,可选范围[1-100], <mode>可选值 [0-1]

基本处理示例

1.生成最长边为400,短边自适应的缩略图

2.生成高为100,宽自适应的缩略图

3.将图片做缩略处理,宽高最多为200x300

4.转换png的图片格式:
5.图片压缩:
6.参数组合使用:

高级处理

imageMogr2/crop/<imageSizeAndOffsetGeometry>
          /rotate/<rotateDegree>
          /sharpen/<sharpen> 
参数 示例 说明
裁剪

/crop/<Width>x /crop/300x 指定目标图片宽度,高度不变。取值范围为0-10000。
/crop/x<Height> /crop/x300 指定目标图片高度,宽度不变。取值范围为0-10000。
/crop/<Width>x<Height> /crop/300x300 同时指定目标图片宽高。取值范围为0-10000。
/crop/!{cropsize}a<dx>a<dy> /crop/!300x300a10a10 相对于偏移锚点,向右偏移dx个像素,同时向下偏移dy个像素。取值范围不限,小于原图宽高即可。
/centercrop/<Width>x<Height> /centercrop/300x300 同时指定目标图片宽高。中心剪裁(不进行缩放操作)
/fillcrop/<Width>x<Height> /fillcrop/300x300 同时指定目标图片宽高。先等比自动缩放(按图片短边优先缩放),然后从左上角开始裁剪。
旋转

/rotate/<angle> /rotate/60 按角度旋转,取值范围为1-360
锐化

/sharpen/<int> /sharpen/1 图片是否锐化,当设置值为1时打开锐化效果

高级处理示例

1.生成 300x300 裁剪图:

2.生成 300x300 裁剪图,偏移距离 30x100:

3.中心裁剪成 200x200的裁剪图

4.等比缩放(按图片短边优先缩放),再裁剪成 200x200的裁剪图

5.顺时针旋转 45 度:

6.开启锐化:


图片水印

watermark/1
           /image/<encodedImageURL>
           /gravity/<gravity> 
参数 示例 说明
/image/<encodedImageURL> /image/aHR0cDovL3YyLmxlYWRlcmhlcm8uY29tL2xvZ28ucG5n 水印源图片网址(经过URL安全的Base64编码),必须有效且返回一张图片,注意,水印图片必须和待处理图片在同一服务域名下
/gravity/<gravity> /gravity/SouthEast 水印图片放置方位,默认 SouthEast,详见位置说明

文字水印

watermark/2
           /text/<encodedText>
           /fontsize/<fontSize>
           /gravity/<gravity> 
参数 示例 说明
watermark/2

/text/<encodedText> /text/aGVsbG8= 文字内容,示例中为 hello 的 Base64 编码字符串,目前不支持中文
/gravity/<gravity> /gravity/SouthEast 水印图片放置方位,默认 SouthEast,详见位置说明
/fontsize/<fontsize> /fontsize/32 文字大小,单位 px,默认 32

图片文字混合水印

watermark/3
           /text/<textWaterMarkParams1>
           /image/<imageWaterMarkParams1>
           /image/<imageWaterMarkParams2>
           /text/<textWaterMarkParams2>
           ... 
参数 示例 说明
watermark/3

/image/<imageWaterMarkParams>
参考图片水印参数
/text/<textWaterMarkParams>
参考文字水印参数

位置说明

northwest     |     north      |     northeast
              |                |
              |                |
--------------+----------------+--------------
              |                |
west          |     center     |          east
              |                |
--------------+----------------+--------------
              |                |
              |                |
southwest     |     south      |     southeast 

水印处理示例

1.添加图片水印:

图片水印:http://qiniu.myccdn.info/img/122.png

图片位置:居中 (gravity=center)

注:水印图片必须和待处理图片在同一服务域名下,并且需要Base64编码
如水印图片为:http://qiniu.myccdn.info/img/122.png

Base64编码为:aHR0cDovL3Fpbml1Lm15Y2Nkbi5pbmZvL2ltZy8xMjIucG5n
可以添加比原图尺寸大的图片水印

2.添加文字水印:

水印文本:verycloud

水印文本字体大小:88

水印文本位置:左上角 (gravity=northwest)

注:文字内容需要Base64 编码,文字格式目前只能英文与数字,汉字目前不支持。

3.添加图片文字混合水印:

水印文本:verycloud

水印文本字体大小:88

水印文本位置:左上角 (gravity=northwest)

图片水印:http://qiniu.myccdn.info/img/122.png

图片位置:居中 (gravity=center)

4.水印功能可以和imageView2、imageMogr2组合使用,用 | 分割开

4.1 先加图片和文字水印,然后再裁剪成300x300的图片:

4.2 先裁剪成300x300的图片,然后再加图片和文字水印:

1

4.3 先加图片和文字水印,然后再缩小生成200x300缩略图

注:imageView2、imageMogr2、watermark多个功能可以同时使用,需要用|分隔开,处理顺序从左往右。