黑客派（HacPai）图片处理 imageView2 接口使用，可用于摘要图片

  |   0 评论   |   0 浏览

黑客派博客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为限定最小值时，未指定参数等于给定的参数，也就限定的矩形是正方形
  • 处理后的图片w和h参数不能超过 9999 像素，总像素不得超过 24999999（2500 万-1）像素
  • 处理前的图片w和h参数不能超过 3 万像素，总像素不能超过 1.5 亿像素
参数名称 说明
/format/ 新图的输出格式取值范围：jpg，gif，png，webp等，默认为原图格式。参考支持转换的图片格式。
/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

缩略图