---
title: hi_mpi_vpc_convert_color
description: "转换图片的格式。异步接口。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0971.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0971.html
indexId: 10fd8af78567573e96982ed564eac533dfacac818759285cc47eca568ba5ad54105
---
# hi_mpi_vpc_convert_color

#### 函数功能

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


#### 约束说明

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


#### 函数原型

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)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| chn | 输入 | 图片处理通道号。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 |
| source\_pic | 输入 | 原始图片信息的指针。 |
| dest\_pic | 输入 | 目标图片信息的指针。 需指定输出图片的宽、高、宽stride、高stride、内存地址、内存大小、格式等。 配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。 如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽stride、高stride，不同图片格式的对齐要求不同，请参见表2。 配置输出图片的宽stride、高stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见表2。 |
| task\_id | 输出 | 任务ID的指针，用来区分任务。 |
| milli\_sec | 输入 | 超时时间配置，单位是毫秒，取值范围如下： \-1：阻塞方式 0：非阻塞方式 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli\_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VPC图像处理返回码