黑客派(HacPai)图片处理 imageView2 接口使用,可用于摘要图片

@zxniuniu   2019-02-26  
0 评论   138 浏览

黑客派博客Solo配图可使用imageView2接口显示不同大小的摘要图,通过给定参数 imageView2 可调整图片的大小,使之显示出来比较美观,但是参数具体代表什么含义,看完这篇博文你就知道,也自己留个底,方便后面查看。

描述

imageView2 是原 imageView 接口的更新版本,实现略有差异,功能更为丰富。同样,只需要填写几个参数即可对图片进行缩略操作,生成各种缩略图。imageView2 接口可支持处理的原图片格式有psd、jpeg、jpg、png、gif、webp、tiff、bmp

接口规格

注意:接口规格**不含任何空格及换行符**:

imageView2/<mode>                     // 模式,可选值:0, 1, 2, 3, 4, 5
          /w/<LongEdge>               // 宽度,长边
          /h/<ShortEdge>              // 高度,短边
          /format/<Format>            // 图片模式,可选值:
          /interlace/<Interlace>      // 渐进显示,可选值:0, 1;仅对jpg有效;默认0,不渐进显示
          /q/<Quality>                // 显示质量,默认值

其中<mode>分为如下几种情况:

模式 说明
/0/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最多为<LongEdge>,短边最多为<ShortEdge>,进行等比缩放,不裁剪
* 若只指定w参数则表示限定长边,短边自适应
* 若只指定h参数则表示限定短边,长边自适应
/1/w/<Width>/h/<Height> 限定缩略图的宽最少为<Width>,高最少为<Height>,进行等比缩放,居中裁剪
* 裁剪后的缩略图通常恰好是<Width>x<Height>的大小,缩放时超出矩形框的边会被裁剪掉
* 若只指定 w 参数或只指定 h 参数,代表限定为长宽相等的正方形图
/2/w/<Width>/h/<Height> 限定缩略图的宽最多为<Width>,高最多为<Height>,进行等比缩放,不裁剪
如果只指定 w 参数则表示限定宽(长自适应),只指定 h 参数则表示限定长(宽自适应)。它和模式 0 类似,区别只是限定宽和高,不是限定长边和短边。从应用场景来说,模式 0 适合移动设备上做缩略图,模式 2 适合 PC 上做缩略图。
/3/w/<Width>/h/<Height> 限定缩略图的宽最少为<Width>,高最少为<Height>,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,代表长宽限定为同样的值。你可以理解为模式 1 是模式 3 的结果再做居中裁剪得到的。
/4/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看(把这里的长边短边分别设为手机屏幕的分辨率即可),生成的图片尺寸刚好充满整个屏幕(某一个边可能会超出屏幕)。
/5/w/<LongEdge>/h/<ShortEdge> 限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,居中裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。同上模式 4,但超出限定的矩形部分会被裁剪。

注意:

  • 可以仅指定w参数或h参数
  • 新图的宽/高/,长边/短边,不会比原图大,即接口总是缩小图片
  • 所有模式都可以只指定w参数或只指定h参数
    • w、h为限定最大值时,未指定某参数等价于将该参数设置为自适应
    • w、h为限定最小值时,未指定参数等于给定的参数,也就限定的矩形是正方形
  • 处理后的图片wh参数不能超过 9999 像素,总像素不得超过 24999999(2500 万-1)像素
  • 处理前的图片wh参数不能超过 3 万像素,总像素不能超过 1.5 亿像素
参数名称 说明
/format/ 新图的输出格式取值范围:jpggifpngwebp等,默认为原图格式。参考支持转换的图片格式
/interlace/<Interlace> 是否支持渐进显示
取值范围:1支持渐进显示,0不支持渐进显示(默认为 0)。
适用目标格式:jpg
效果:网速慢时,图片显示由模糊到清晰。
/q/<Quality> 新图的图片质量
取值范围是[1, 100],默认 75。
● 指定值后面可以增加!,表示强制使用指定值,如100!
● 支持图片类型:jpg。
/ignore-error/<ignoreError> 可选取值:1
● 未设置此参数时,正常返回处理结果。
● 设置了此参数时,若图像处理的结果失败,则返回原图。
● 设置了此参数时,若图像处理的结果成功,则正常返回处理结果。

<Quality>修正值算法:
● 原图 quality <= 90: min[90, 原图 quality*sqrt(原图长宽乘积/结果图片长宽乘积)]
● 原图 quality > 90: 原图 quality*sqrt(原图长宽乘积/结果图片长宽乘积)

示例

模块0,仅指定高度: image_path?imageView2/0/h/200 

缩略图

模块1,仅指定高度: image_path?imageView2/1/h/200 

缩略图

模块2,仅指定高度: image_path?imageView2/2/h/200 

缩略图

模块3,仅指定高度: image_path?imageView2/3/h/200 

缩略图

模块4,仅指定高度: image_path?imageView2/4/h/200 

缩略图

模块5,仅指定高度: image_path?imageView2/5/h/200 

缩略图

模块0,指定宽高: image_path?imageView2/0/h/200/w/200 

缩略图

模块1,指定宽高: image_path?imageView2/1/h/200 /w/200

缩略图

模块2,指定宽高: image_path?imageView2/2/h/200/w/200

缩略图

模块3,指定宽高: image_path?imageView2/3/h/200/w/200 

缩略图

模块4,指定宽高: image_path?imageView2/4/h/200/w/200 

缩略图

模块5,指定宽高: image_path?imageView2/5/h/200/w/200 

缩略图

image_path?imageView2/1/w/200/h/200

缩略图

  • 指定图片高度和宽度,裁剪图片:
image_path?imageView2/1/w/960/h/270/interlace/1/q/100

缩略图

  • 指定图片质量,取值范围是[1, 100],默认 75,此处为 1:
image_path?imageView2/1/interlace/1/q/1

缩略图

  • 渐进显示图片:
image_path?imageView2/1/interlace/1 

缩略图


评论列表

添加新评论