---
title: hi_mpi_vpss_set_chn_fisheye
description: "设置VPSS物理通道鱼眼属性。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0900.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0900.html
indexId: fee62b96e9aedefd3634c17c836e2420287be8619acb009d319395dd059467a1105
---
# hi_mpi_vpss_set_chn_fisheye

#### 函数功能

设置VPSS物理通道鱼眼属性。


#### 约束说明

- VPSS组必须已创建，请参见  hi_mpi_vpss_create_grp
接口。

- 调用本接口配置鱼眼属性前必须先调用  hi_mpi_vpss_set_chn_attr
接口配置对应物理通道的属性。
- 物理通道如果需要开启鱼眼矫正，建议在启用通道前配置鱼眼属性。
- 动态改变鱼眼属性时，鱼眼矫正后的输出图像大小应小于启用通道前配置的大小，如果未进行配置则应小于对应通道的宽高属性
- 物理通道开启了鱼眼矫正后，不支持动态改变通道Crop属性以及通道宽高属性。
- 输出图像的非校正区域是随机数据，可能会出现异常图像。
- 通道输出VIDEO_FORMAT_TILE_16x8格式时，不支持鱼眼。
- 如果在本接口中，hi_fisheye_attr属性开启了LMF参数功能，则必须调用VPSS的  hi_mpi_vpss_set_grp_fisheye_cfg
设置LMF（Lens Map Function）参数，否则进行鱼眼处理时会因为获取不到用户配置的LMF参数而报错。


#### 函数原型

hi_s32 hi_mpi_vpss_set_chn_fisheye(hi_vpss_grp grp, hi_vpss_chn chn, const hi_fisheye_correction_attr *correction_attr);


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| grp | 输入 | VPSS组ID。 取值范围：[0, 264)。 |
| chn | 输入 | VPSS 通道号。 取值范围：[0, 2)。 |
| correction\_attr | 输入 | VPSS物理通道的鱼眼属性结构体指针。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  6.10.7-VPSS视频处理子系统返回码


#### 参考资源

接口调用流程，参见视频数据获取和处理功能（Camera场景）。