全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取图像基本信息

最近更新时间:2023-01-04 10:04:51

接口

imageInfo

描述

获取图像基本信息包括图像格式、图像大小、图像宽和高、色彩模型、图像帧数,结果采用JSON格式进行返回。

  • 图像格式是计算机存储图像的格式,常见的存储的格式有bmp、jpg、tiff、gif、pcx、tga、exif、fpx、svg、psd、cdr、pcd、dxf、ufo、eps、ai、raw等。

  • 图像大小指图像所占存储空间的大小,单位以B\KB\MB进行表示。超过1024B会转化为KB;超过1024KB会转化为MB。

  • 图像宽和高采用像素作为单位进行表示。

  • 色彩模型也称为色彩模式,是数字世界中表示颜色的一种算法。在数字世界中,为了表示各种颜色,人们通常将颜色划分为若干分量。由于成色原理的不同,决定了显示器、投影仪、扫描仪这类靠色光直接合成颜色的颜色设备和打印机、印刷机这类靠使用颜料的印刷设备在生成颜色方式上的区别。通常有HSB、RGB、Lab和CMYK集中模型。

  • 图像帧数就是指组成一张GIF图的静态图像数。

权限

该接口操作需要具备GetObject权限,假如获取对象不存在,你可能存在以下两种返回:

  • 假如用户具有该对象所在Bucket的ListBucket权限,会返回状态码404错误
  • 假如用户不具备该对象所在Bucket的ListBucket权限,会返回状态码403错误。

请求

语法

    https://BucketName.${bucket所在region的域名}/object@base@tag=imageInfo  HTTP/1.1
    Host: BucketName.${bucket所在region的域名}

请求参数

该请求不需要设置参数。

请求头部

该请求不需要设置特殊的头部。

响应

响应头部

头部名称 必填 说明
Content-Type MIME类型,固定为application/json

响应内容

字段名称 说明
format 图像格式,如png、jpg、gif、bmp等
size 图像所占存储空间的大小,单位以Bi\Ki\Mi进行表示
width 图像宽度,单位:像素
height 图像高度,单位:像素
colorModel 色彩模型,通常有HSB、RGB、Lab和CMYK集中模型
frameNumber 帧数,gif图像会返回此项

特殊错误

HTTP状态码 含义
400 请求报文格式错误
404 资源不存在
403 访问拒绝
500 服务端操作失败。

示例

1、在Web浏览器中输入以下请求:
https://ks3.ks3-cn-beijing.ksyuncs.com/image_deal/kssyun.png@base@tag=imageInfo

2、获取返回结果
{
    "colorModel":"TrueColor",
    "format":"JPEG",
    "height":2448,
    "size":"1.8Mi",
    "width":3264
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈