vpc_convert_color

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	x
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	x

功能说明

转换图片的格式。异步接口。

函数原型

C函数原型

hi_s32 hi_mpi_vpc_convert_color (hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_u32 *task_id, hi_s32 milli_sec);

python函数

task_id, ret = acl.himpi.vpc_convert_color(chn, source_pic, dest_pic, milli_sec)

参数说明

参数名	说明
chn	int，图片处理通道号。 Atlas 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 Atlas A3 训练系列产品/Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。
source_pic	dict，原始图片信息，具体请参见hi_vpc_pic_info，相关约束请参见约束说明。
dest_pic	dict，目标图片信息，具体请参见hi_vpc_pic_info。需指定输出图片的宽、高、宽Stride、高Stride、内存地址、内存大小、格式等。配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽Stride、高Stride，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。配置输出图片的宽Stride、高Stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。
milli_sec	int，超时时间配置，单位是毫秒，取值范围如下。 “-1”：阻塞方式。 “0”：非阻塞方式。 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

返回值说明

返回值	说明
task_id	int，任务分配的ID，用来区分任务。
ret	int，错误码。返回0表示成功。返回非0表示失败，参见VPC图像处理返回码。

约束说明

版本	约束
Atlas 推理系列产品	输入、输出图片分辨率：10 * 6 ~ 4096 * 4096（包括4096 * 4096）。输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。当输入格式是YUV400时，输出格式只能是YUV400。
Atlas 200I/500 A2 推理产品 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件 Atlas A3 训练系列产品/Atlas A3 推理系列产品	输入、输出图片分辨率为10 * 6 ~ 4096 * 8192（包括4096 * 8192）。输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。

版本

约束

Atlas 推理系列产品

输入、输出图片分辨率：10 * 6 ~ 4096 * 4096（包括4096 * 4096）。
输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。当输入格式是YUV400时，输出格式只能是YUV400。

Atlas 200I/500 A2 推理产品

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas A3 训练系列产品/Atlas A3 推理系列产品

输入、输出图片分辨率为10 * 6 ~ 4096 * 8192（包括4096 * 8192）。
输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。

父主题： VPC图像处理接口