acl.himpi.vpc_convert_color_v2

hi_s32 hi_mpi_vpc_convert_color_v2(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_csc_conf *conf, hi_u32 *task_id, hi_s32 milli_sec)

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

转换图片的格式，在acl.himpi.vpc_convert_color接口的基础上扩展功能，支持设置RGBA格式图片的透明度。异步接口。

• chn：int，图片处理通道号。

  该参数的取值范围：[0, 128)，通道总数最多128。

• source_pic：原始图片信息。输入分辨率为10*6~4096*4096（包括4096）。
• dest_pic：目标图片信息。

  需指定输出图片的宽、高、宽stride、高stride、内存地址、内存大小、格式等。

  • 配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。

    如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽stride、高stride，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。

  • 配置输出图片的宽stride、高stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。
• conf：输出图片透明度值。

  透明度只针对以下图像格式有效：

  PIXEL_FORMAT_ARGB_8888 = 14,
  PIXEL_FORMAT_ABGR_8888 = 15,
  PIXEL_FORMAT_RGBA_8888 = 16,
  PIXEL_FORMAT_BGRA_8888 = 17,

• milli_sec：超时时间配置，单位是毫秒，取值范围如下。
  • “-1”：阻塞方式。
  • “0”：非阻塞方式。
  • >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

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

输入、输出图片的格式请参见图片格式、宽高对齐、内存约束。当输入格式是YUV400时，输出格式只能是YUV400。