hi_mpi_vpc_lut_remap

产品支持情况

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

功能说明

基于输入像素位置重映射表的方式对图片进行Remap处理。异步接口。

函数原型

hi_s32 hi_mpi_vpc_lut_remap(hi_vpc_chn chn, hi_warp_transform_param *transform_param, hi_remap_lut *remap_lut, hi_u32 *task_id, hi_s32 milli_sec)

参数说明

参数名	输入/输出	说明
chn	输入	图片处理通道号。 Atlas A3 训练系列产品/Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，通道总数最多128。
transform_param	输入	Remap变换参数。
remap_lut	输入	像素位置重映射表信息。需提前调用以下get接口获取像素位置重映射表信息：hi_mpi_vpc_get_affine_lut、或hi_mpi_vpc_get_perspective_lut、或hi_mpi_vpc_get_remap_lut，但本接口的缩放算法需与get接口的缩放算法保持一致，否则可能导致remap结果不符合预期。
milli_sec	输入	超时时间配置，单位是毫秒，取值范围如下： -1：阻塞方式 0：非阻塞方式 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。
task_id	输出	任务ID的指针，用来区分任务。

返回值说明

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

约束说明

型号	约束
Atlas 200I/500 A2 推理产品	输入、输出图片分辨率的取值范围为：[106, 40968192]。支持如下输入图片格式： HI_PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit HI_PIXEL_FORMAT_RGB_888 = 12, // RGB888 HI_PIXEL_FORMAT_BGR_888 = 13, // BGR888 HI_PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444P 8bit HI_PIXEL_FORMAT_YVU_PACKED_444 = 58, // YVU444P 8bit 支持如下输出图片格式： HI_PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit HI_PIXEL_FORMAT_RGB_888 = 12, // RGB888 HI_PIXEL_FORMAT_BGR_888 = 13, // BGR888 HI_PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444P 8bit HI_PIXEL_FORMAT_YVU_PACKED_444 = 58, // YVU444P 8bit HI_PIXEL_FORMAT_YUYV_PACKED_422 = 7, // YUV422P YUYV 8bit HI_PIXEL_FORMAT_UYVY_PACKED_422 = 8, // YUV422P UYVY 8bit HI_PIXEL_FORMAT_YVYU_PACKED_422 = 9, // YUV422P YVYU 8bit HI_PIXEL_FORMAT_VYUY_PACKED_422 = 10, // YUV422P VYUY 8bit 关于图片宽高对齐、内存等约束，请参见约束说明。在任务执行过程中，需要临时缓存，因此每个通道第一次执行本接口前需先调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存。由于硬件约束，除YUV420SP NV12、YUV420SP NV21图片格式外，其它格式在输入与输出保持一致的情况下，无需调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存，达到节省内存的目的。单张1080P（19201080）的图像处理超时时间建议设置10ms，其他分辨率，按照图像尺寸进行近似的等价折算，例如，40964096分辨率的图像建议超时时间设置为40ms。由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，在配置边界填充类型时，建议设置为“边界复制模式”，避免输出图片边缘异常数据。
Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	输入、输出图片分辨率的取值范围为：[106, 40968192]。支持如下输入图片格式： HI_PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit HI_PIXEL_FORMAT_RGB_888 = 12, // RGB888 HI_PIXEL_FORMAT_BGR_888 = 13, // BGR888 HI_PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444P 8bit HI_PIXEL_FORMAT_YVU_PACKED_444 = 58, // YVU444P 8bit HI_PIXEL_FORMAT_YUV400_FP32 = 138, // YUV400 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致 HI_PIXEL_FORMAT_RGB_888_FP32 = 1012, // RGB888 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致 HI_PIXEL_FORMAT_BGR_888_FP32 = 1013, // BGR888 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致支持如下输出图片格式： HI_PIXEL_FORMAT_YUV_400 = 0, // YUV400 8bit HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit HI_PIXEL_FORMAT_RGB_888 = 12, // RGB888 HI_PIXEL_FORMAT_BGR_888 = 13, // BGR888 HI_PIXEL_FORMAT_YUV_PACKED_444 = 11, // YUV444P 8bit HI_PIXEL_FORMAT_YVU_PACKED_444 = 58, // YVU444P 8bit HI_PIXEL_FORMAT_YUYV_PACKED_422 = 7, // YUV422P YUYV 8bit HI_PIXEL_FORMAT_UYVY_PACKED_422 = 8, // YUV422P UYVY 8bit HI_PIXEL_FORMAT_YVYU_PACKED_422 = 9, // YUV422P YVYU 8bit HI_PIXEL_FORMAT_VYUY_PACKED_422 = 10, // YUV422P VYUY 8bit HI_PIXEL_FORMAT_YUV400_FP32 = 138, // YUV400 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致 HI_PIXEL_FORMAT_RGB_888_FP32 = 1012, // RGB888 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致 HI_PIXEL_FORMAT_BGR_888_FP32 = 1013, // BGR888 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致关于图片宽高对齐、内存等约束，请参见约束说明。在任务执行过程中，需要临时缓存，因此每个通道第一次执行本接口前需先调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存。由于硬件约束，除YUV420SP NV12、YUV420SP NV21图片格式外，其它格式在输入与输出保持一致的情况下，无需调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存，达到节省内存的目的。单张1080P（19201080）的图像处理超时时间建议设置10ms，其他分辨率，按照图像尺寸进行近似的等价折算，例如，40964096分辨率的图像建议超时时间设置为40ms。由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，在配置边界填充类型时，建议设置为“边界复制模式”，避免输出图片边缘异常数据。

型号

约束

Atlas 200I/500 A2 推理产品

输入、输出图片分辨率的取值范围为：[10*6, 4096*8192]。

支持如下输入图片格式：

HI_PIXEL_FORMAT_YUV_400 = 0,            // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit   
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit 
HI_PIXEL_FORMAT_RGB_888 = 12,           // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13,           // BGR888
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11,    // YUV444P 8bit
HI_PIXEL_FORMAT_YVU_PACKED_444 = 58,    // YVU444P 8bit

支持如下输出图片格式：

HI_PIXEL_FORMAT_YUV_400 = 0,            // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit   
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit 
HI_PIXEL_FORMAT_RGB_888 = 12,           // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13,           // BGR888
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11,    // YUV444P 8bit
HI_PIXEL_FORMAT_YVU_PACKED_444 = 58,    // YVU444P 8bit
HI_PIXEL_FORMAT_YUYV_PACKED_422 = 7,    // YUV422P YUYV 8bit 
HI_PIXEL_FORMAT_UYVY_PACKED_422 = 8,    // YUV422P UYVY 8bit
HI_PIXEL_FORMAT_YVYU_PACKED_422 = 9,    // YUV422P YVYU 8bit 
HI_PIXEL_FORMAT_VYUY_PACKED_422 = 10,   // YUV422P VYUY 8bit

关于图片宽高对齐、内存等约束，请参见约束说明。
在任务执行过程中，需要临时缓存，因此每个通道第一次执行本接口前需先调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存。
由于硬件约束，除YUV420SP NV12、YUV420SP NV21图片格式外，其它格式在输入与输出保持一致的情况下，无需调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存，达到节省内存的目的。
单张1080P（1920*1080）的图像处理超时时间建议设置10ms，其他分辨率，按照图像尺寸进行近似的等价折算，例如，4096*4096分辨率的图像建议超时时间设置为40ms。
由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，在配置边界填充类型时，建议设置为“边界复制模式”，避免输出图片边缘异常数据。

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

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

输入、输出图片分辨率的取值范围为：[10*6, 4096*8192]。

支持如下输入图片格式：

HI_PIXEL_FORMAT_YUV_400 = 0,            // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit   
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit 
HI_PIXEL_FORMAT_RGB_888 = 12,           // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13,           // BGR888
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11,    // YUV444P 8bit
HI_PIXEL_FORMAT_YVU_PACKED_444 = 58,    // YVU444P 8bit
HI_PIXEL_FORMAT_YUV400_FP32 = 138,      // YUV400 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致
HI_PIXEL_FORMAT_RGB_888_FP32 = 1012,    // RGB888 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致
HI_PIXEL_FORMAT_BGR_888_FP32 = 1013,    // BGR888 FP32，选择该输入图片格式，则输出图片格式必须与输入保持一致

支持如下输出图片格式：

HI_PIXEL_FORMAT_YUV_400 = 0,            // YUV400 8bit
HI_PIXEL_FORMAT_YUV_SEMIPLANAR_420 = 1, // YUV420SP NV12 8bit   
HI_PIXEL_FORMAT_YVU_SEMIPLANAR_420 = 2, // YUV420SP NV21 8bit 
HI_PIXEL_FORMAT_RGB_888 = 12,           // RGB888
HI_PIXEL_FORMAT_BGR_888 = 13,           // BGR888
HI_PIXEL_FORMAT_YUV_PACKED_444 = 11,    // YUV444P 8bit
HI_PIXEL_FORMAT_YVU_PACKED_444 = 58,    // YVU444P 8bit
HI_PIXEL_FORMAT_YUYV_PACKED_422 = 7,    // YUV422P YUYV 8bit 
HI_PIXEL_FORMAT_UYVY_PACKED_422 = 8,    // YUV422P UYVY 8bit
HI_PIXEL_FORMAT_YVYU_PACKED_422 = 9,    // YUV422P YVYU 8bit 
HI_PIXEL_FORMAT_VYUY_PACKED_422 = 10,   // YUV422P VYUY 8bit
HI_PIXEL_FORMAT_YUV400_FP32 = 138,      // YUV400 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致
HI_PIXEL_FORMAT_RGB_888_FP32 = 1012,    // RGB888 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致
HI_PIXEL_FORMAT_BGR_888_FP32 = 1013,    // BGR888 FP32，选择该输出图片格式，则输入图片格式必须与输出保持一致

关于图片宽高对齐、内存等约束，请参见约束说明。
在任务执行过程中，需要临时缓存，因此每个通道第一次执行本接口前需先调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存。
由于硬件约束，除YUV420SP NV12、YUV420SP NV21图片格式外，其它格式在输入与输出保持一致的情况下，无需调用hi_mpi_vpc_set_chn_workspace接口申请内部临时缓存，达到节省内存的目的。
单张1080P（1920*1080）的图像处理超时时间建议设置10ms，其他分辨率，按照图像尺寸进行近似的等价折算，例如，4096*4096分辨率的图像建议超时时间设置为40ms。
由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，在配置边界填充类型时，建议设置为“边界复制模式”，避免输出图片边缘异常数据。

父主题： VPC图像处理功能