Q 版用法说明

veImageX 当前支持您通过自定义访问 URL 的方式使用 Q 版图片处理能力。您可以在源地址访问 URL 后拼接不同处理能力以及对应取值，以实现不同的图片处理效果。具体已支持能力、配置说明及相关访问示例如下所示。

图片基本处理（imageView）

imageView/<mode>
         /w/<width>
         /h/<height>
         /q/<quality>
         /format/<format>

图像基础处理（imageView2）

图像基础处理能力包含了图片缩放、指定输出格式、渐进式加载和压缩质量参数。

imageView2/<mode>/w/<LongEdge>  
                 /h/<ShortEdge>  
                 /format/<Format>  
                 /interlace/<Interlace>  
                 /q/<Quality>

缩放

格式转换

压缩质量参数

图像高级处理（imageMogr2）

图像高级处理能力包含了缩放、裁剪、渐进式加载、旋转、高斯模糊功能。

imageMogr2/thumbnail/!<Scale>p   
          /thumbnail/!<Scale>px
          /thumbnail/!x<Scale>p
          /thumbnail/<Width>x
          /thumbnail/x<Height>
          /thumbnail/<Width>x<Height>
          /thumbnail/!<Width>x<Height>r
          /thumbnail/<Width>x<Height>!
          /thumbnail/<Width>x<Height>>
          /thumbnail/<Width>x<Height><
          /thumbnail/<Area>@
 imageMogr2/corp/crop/<Width>x        
            /crop/x<Height>
            /crop/<Width>x<Height>
            /crop/!{cropsize}a<dx>a<dy>
            /crop/!{cropsize}-<dx>a<dy>
            /crop/!{cropsize}a<dx>-<dy>
            /crop/!{cropsize}-<dx>-<dy>
imageMogr2/gravity/<Gravity>
imageMogr2/format/<Format>        
imageMogr2/interlace/<Interlace>       
imageMogr2/quality/<Quality>         
imageMogr2/rotate/<rotate>              
imageMogr2/blur/<blur>                  

缩放

裁剪

格式转换

渐进式加载

旋转

高斯模糊

图文水印（watermark）

图片水印：
watermark/1
         /image/<encodedImageURL>
         /dissolve/<dissolve>
         /gravity/<gravity>
         /dx/<distanceX>
         /dy/<distanceY>
         /ws/<watermarkScale>
         /wst/<watermarkScaleType>
文字水印：
watermark/2
         /text/<encodedText>
         /font/<encodedFontName> 
         /fontsize/<fontSize>
         /fontstyle/<fontStyle>
         /fill/<encodedTextColor>
         /dissolve/<dissolve>
         /gravity/<gravity>
         /dx/<distanceX>
         /dy/<distanceY>

图片水印

文字水印

图文水印指定位置示意图

图片圆角（roundPic）

roundPic/radius/<radius>
        /radiusx/<radiusx>
        /radiusy/<radiusy>

imageInfo

查询图片基本信息，包含图片格式、图片大小和色彩模型等。暂不支持获取处理后配置信息。您可通过在源文件访问地址后添加?imageInfo获取具体参数。

访问示例：https://imagexdemo.volcimagextest.com/imagexdemo.jpeg?imageInfo

具体返回参数如下所示：

{ 
"size": 63859,  //文件大小，单位为 Byte
"format": "jpeg", //图片格式
"width": 1023,  //宽度，单位为 px
"height": 683,   //高度，单位为 px
"orientation": "Top-left"  //记录图片拍摄的相机的旋转信息
}

exif

查询数码相机的照片设定的可交换图像文件格式。您可通过在源文件访问地址后添加?exif获取具体参数。

• 缩略图等经过云处理的新图片不支持 EXIF。

• 原图格式为avif、heif不支持 EXIF。

• 原图只支持 20MB 以内的图片。

访问示例：https://imagexdemo.volcimagextest.com/imagexdemo.jpeg?exif

具体返回参数如下所示：

{
   "Artist":{
      "val":"Pedro Salaverria"
   },
   "ColorSpace":{
      "val":"sRGB"
   },
   "Contrast":{
      "val":"Normal"
   },
   "Copyright":{
      "val":"Pedro Salaverria (Photographer) - [None] (Editor)"
   },
   "CustomRendered":{
      "val":"Normal process"
   },
   "DateTime":{
      "val":"2016:04:14 16:24:38"
   },
   "DateTimeDigitized":{
      "val":"2016:04:14 16:24:38"
   },
   "DateTimeOriginal":{
      "val":"2016:04:14 16:24:38"
   },
   "DigitalZoomRatio":{
      "val":" 1"
   },
   "ExifVersion":{
      "val":"Exif Version 2.1"
   },
   "ExposureBiasValue":{
      "val":"0.00 EV"
   },
   "ExposureMode":{
      "val":"Manual exposure"
   },
   "ExposureProgram":{
      "val":"Manual"
   },
   "ExposureTime":{
      "val":"1/500 sec."
   },
   "FNumber":{
      "val":"f/8.0"
   },
   "FileSource":{
      "val":"DSC"
   },
   "Flash":{
      "val":"Flash did not fire, compulsory flash mode"
   },
   ...后续内容已省略...
}