图片基本处理（imageView2） |
您所在的位置：网站首页 › 七和的图片 › 图片基本处理（imageView2） |
图片基本处理（imageView2）
|
智能多媒体服务 > API 文档 > 图片处理 >图片基本处理（imageView2）
图片基本处理（imageView2）
最近更新时间: 2024-05-10 17:50:25 简介imageView2 提供简单快捷的图片格式转换、缩略、质量变换功能。只需要填写几个参数，即可对图片进行缩略操作，生成各种缩略图。图片处理为收费项，详细的计费说明请参见 计费与定价。 功能 说明 缩略 等比缩放、设定目标宽高缩放等多种方式 格式转换 格式转换、GIF 颜色控制 渐进显示 图片渐进显示 质量变换 对图片质量进行调节 限制说明 原图格式支持： psd、jpeg、png、gif、webp、tiff、bmp、avif、heic 输入为 webp动图，只支持 持久化处理 同步处理 原图只支持 20MB 以内的图片，超过 20MB请使用持久化处理 处理前的 gif ，最大帧数为 200 处理前的图片 w 和h不能超过3万像素，总像素不能超过1.5亿像素 处理后的图片w和h 不能超过9999像素，总像素不得超过2500w 像素 输出为 avif 时，图片总像素不能超过768w像素 输出为 webp 时，图片 w 和 h 不能超过16383像素 持久化处理 原图无大小限制 处理前的gif、webp动图，最大帧数为 500 处理前的图片 w和h 不能超过3万像素，总像素不能超过1.5亿像素 处理后的图片 w和h 不能超过14999像素，总像素不得超过6000w像素 输出为 heic和 avif 时，图片 w和h 不能超过9999像素，总像素不能超过3072w像素 输出为 webp 时，图片 w 和 h 不能超过16383像素 参数说明注意：接口规格不含任何空格与换行符。 imageView2//w/ /h/ /format/ /interlace/ /q/ /colors/ /ignore-error/ 参数说明 参数名称 必填 说明 /mode 是 定义等比缩放、设定目标宽高缩放的多种不同方式，取值范围：[0,5]的整数，必填项。分为如下几种情况： mode=0，使用姿势：/0/w//h/1、限定缩略图的长边最多为，短边最多为，进行等比缩放，不裁剪。2、如果只指定 w 参数则表示限定长边（短边自适应），只指定 h 参数则表示限定短边（长边自适应）。 mode=1，使用姿势：/1/w//h/1、限定缩略图的宽最少为，高最少为，进行等比缩放，居中裁剪。2、转后的缩略图通常恰好是 x 的大小（有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分）。3、如果只指定 w 参数或只指定 h 参数，代表限定为长宽相等的正方图。 mode=2，使用姿势：/2/w//h/1、限定缩略图的长边最少为，短边最少为，进行等比缩放，不裁剪。2、如果只指定 w 参数则表示限定宽（高自适应），只指定 h 参数则表示限定高（宽自适应）。3、它和模式0类似，区别只是限定宽和高，不是限定长边和短边。从应用场景来说，模式0适合移动设备上做缩略图，模式2适合PC上做缩略图。 mode=3，使用姿势：/3/w//h/1、限定缩略图的长边最少为，短边最少为，进行等比缩放，不裁剪。2、如果只指定 w 参数或只指定 h 参数，代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。 mode=4，使用姿势：/4/w//h/1、限定缩略图的长边最少为，短边最少为，进行等比缩放，不裁剪。2、如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看（把这里的长边短边分别设为手机屏幕的分辨率即可），生成的图片尺寸刚好充满整个屏幕（某一个边可能会超出屏幕）。 mode=5，使用姿势：/5/w//h/1、限定缩略图的长边最少为，短边最少为，进行等比缩放，居中裁剪。2、如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。同上模式4，但超出限定的矩形部分会被裁剪。 /format/ 否 图片输出格式1、取值：copy，保持原图格式输出。2、取值：jpg，gif，png，webp等，参考支持转换的图片格式。3、取值：heic 或 avif ，属于 图片高级压缩 格式，按照图片高级压缩收费。注意：● 必须指定mode参数，否则不生效。● 当原图为heic 或 avif 时，设置format/copy 会保持原图格式不变，且不按照图片高级压缩收费；如果不指定 format 参数，将会输出jpeg 。 /colors/ 否 控制图片颜色数量● 源图片为 GIF 时，控制输出 GIF 中不同颜色的数量，取值可为2、4、8、16、32、64、128、256，不使用该参数时的默认值为128。● 输出图片为 PNG 时，控制输出 PNG 中不同颜色的数量，取值可为2、4、8、16、32、64、128、256，不使用该参数时默认关闭。注意：● 必须指定mode参数，否则不生效。● 如果只设置图片颜色数量，不做其他缩放处理，建议使用 图片高级处理-格式转换 /interlace/ 否 是否支持渐进显示取值范围：1 支持渐进显示，0不支持渐进显示(默认为0)。适用目标格式：jpg效果：网速慢时，图片显示由模糊到清晰。新图的输出格式，必须指定mode参数，否则不生效。注意：● 必须指定mode参数，否则不生效。● 如果只设置渐渐显示，不做其他缩放处理，建议使用 图片高级处理-渐进显示 /q/ 否 新图的图片质量● 取值范围是[1, 100]● 输入是 jpeg，且不强制指定质量条件下，七牛会根据原图质量算出一个修正值，取修正值和指定值中的小值。注意：● 必须指定mode参数，否则不生效。● 指定值后面可以增加 !，表示强制使用指定值，如100!。● heic：默认值35● avif：默认值50● 其他格式：默认值75● 如果只设置图片质量，不做其他缩放处理，建议使用 图片高级处理-质量变换 /ignore-error/ 否 主要针对图片兼容性的问题导致无法处理，取值为1时，则处理失败时返回原图；不设置此参数，默认处理失败时返回错误信息。注意：● 必须指定mode参数，否则不生效。注意： 所有模式都可以只指定w参数或只指定h参数，并获得合理结果。在w、h为限定最大值时，未指定某参数等价于将该参数设置为无穷大（自适应）；在w、h为限定最小值时，未指定参数等于给定的参数，也就限定的矩形是正方形。 新图的宽/高/长边/短边，不会比原图大，即本接口总是 缩小图片。 如果原图带有EXIF信息且包含Orientation字段且不能被识别出来，imageView2默认根据此字段的值进行自动旋转修正。 当一张含有透明区域的图片，转换成不支持透明的格式jpg,bmp等时，透明区域填充白色。 修正值算法： 原图 quality 90： 原图quality*sqrt（原图长宽乘积/结果图片长宽乘积) 示例原图
裁剪正中部分，等比缩小生成200x200缩略图： https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200
宽度固定为200px，高度等比缩小，生成200x133缩略图： https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/w/200
高度固定为200px，宽度等比缩小，生成300x200缩略图： https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/h/200
渐进显示图片： https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200/interlace/1
设置图片质量为55： https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageView2/1/w/200/h/200/q/55
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式，对图片进行处理，详情介绍请参见图片处理操作方式。 以上内容是否对您有帮助？ 文档反馈 (如有产品使用问题，请 提交工单) |
【本文地址】