下载
中文
注册

Image

函数原型

Image()
Image(ndarray b, image_format format, tuple(Size, Size) imageSizeInfo = DEFAULT_IMAGE_SIZE_INFO)

函数功能

  • 构造一个空的Image对象。
  • 从Host侧的numpy的ndarray转为Image对象。

输入参数说明

参数名

类型

说明

b

ndarray

构造Image的numpy数组,各元素类型为np.uint8且形状为3维,依次表示图片的HWC(高、宽、通道数)。

format

image_format

图像色域格式,支持以下色域类型。

  • base.yuv_400
  • base.rgb
  • base.bgr
  • base.rgba
  • base.bgra
  • base.argb
  • base.abgr

“b”(输入ndarray)形状中的通道数(C)需要与色域类型一致,各色域类型对应通道数参见如下。

  • yuv_400为1。
  • bgr、rgb为3。
  • rgba、bgra、argb、abgr为4。

imageSizeInfo

tuple

图像有效宽高对齐后宽高的组合,有效宽、高应不超过对齐后的宽、高,输入方式参见如下。

tuple(有效宽高对齐后的宽高)
  • 有效宽、高取值范围为[6, 8192]。
  • 对齐后宽、高取值范围为[16, 8192],其中宽为16的倍数、高为2的倍数。
  • “b”(输入ndarray)形状中的高宽需要与有效宽高和对齐宽高其中之一保持一致。
  • 默认值为“DEFAULT_IMAGE_SIZE_INFO”,其中有效宽高对齐后宽高均为(0, 0),若该参数为默认值,则自动根据“b”的形状获取有效宽高和对齐宽高。
  1. 从opencv读取图片转换的ndarray,若形状为WHC(宽,高,通道数),需要进行转置为HWC(高,宽,通道数)之后进行构造。
  2. 从get_tensor/to_tensor/get_orginal_tensor接口获取的tensor,转换为ndarray后,形状为NHWC(个数,高,宽,通道数)或NHW(个数,高,宽),需要根据实际情况截取或扩展到HWC之后进行构造。

输出参数说明

Image对象。