---
title: acl.himpi.vpc_convert_color_v2
description: "| c函数原型 | 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) |"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgp/aclpythondevg_01_0426.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgp/aclpythondevg_01_0426.html
indexId: 9ae82174627deb0abbe742d324fab9192e68763eeb8efae3ff75b1e5a46f5e5f108
---
# acl.himpi.vpc_convert_color_v2

| c函数原型 | 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) |
| --- | --- |
| Python函数 | 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，图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 source\_pic：原始图片信息，相关约束请参见约束说明。 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，用来区分任务。 |


#### 约束说明

| 版本 | 约束 |
| --- | --- |
| Atlas 200/500 A2推理产品 | 输入、输出图片分辨率为10\*6~4096\*8192（包括4096\*8192）。 输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。 |