---
title: hi_vpss_chn_attr
description: "定义VPSS物理通道的属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/dvpp/aclcppdevg_03_0973.html
sourcePath: /source/zh/canncommercial/900/API/dvpp/aclcppdevg_03_0973.html
indexId: 4c1550743731911843495eeaa5fd6491f5848c2caf790af4b5278182eaa7ece362
---
# hi_vpss_chn_attr

#### 说明

定义VPSS物理通道的属性。


#### 定义

```
typedef struct {
hi_bool
mirror_en;
hi_bool
flip_en;
hi_vpss_chn_mode
chn_mode;          /* RW; vpss channel's work mode. */
hi_u32
width;
hi_u32
height;
hi_video_format
video_format;      /* RW; video format of target image. */
hi_pixel_format
pixel_format;      /* RW; pixel format of target image. */
hi_dynamic_range
dynamic_range;     /* RW; dynamic_range of target image. */
hi_compress_mode
compress_mode;     /* RW; compression mode of the output. */
hi_frame_rate_ctrl
frame_rate;        /* frame rate control info */
hi_u32
depth;           /* RW; range: [0, 8]; user get list depth. */
hi_aspect_ratio
aspect_ratio;      /* aspect ratio info. */
hi_u32
reserved[10];
} hi_vpss_chn_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| mirror\_en | 预留参数，当前版本不支持。 需要用户手动设置为0，避免后续版本的兼容性问题。 |
| flip\_en | 预留参数，当前版本不支持。 需要用户手动设置为0，避免后续版本的兼容性问题。 |
| chn\_mode | 通道工作模式。 |
| width | 目标图像宽度。 VPSS Group ID在[0,256)范围内，通道0和通道1都支持放大和缩小。 VPSS Group ID在[256,264)范围内，不同通道支持的功能不同，约束也不同，如下： 通道0仅支持放大，最大支持16倍放大。当缩放前图像宽度小于4096时，输出宽度不允许超过8192；当缩放前图像宽度大于4096时，最大放大倍数为2。 通道1仅支持缩小，最大支持15倍缩小。 |
| height | 目标图像高度。 VPSS Group ID在[0,256)范围内，通道0和通道1都支持放大和缩小 VPSS Group ID在[256,264)范围内，不同通道支持的功能不同，约束也不同，如下： 通道0仅支持放大，最大支持16倍放大。 通道1仅支持缩小，最大支持15倍缩小。 |
| video\_format | 视频格式，仅支持HI\_VIDEO\_FORMAT\_LINEAR。 |
| pixel\_format | 目标图像像素格式。 VPSS Group ID在[0,256)范围内，支持以下格式： 支持HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_420、HI\_PIXEL\_FORMAT\_YUV\_SEMIPLANAR\_420。 如果开启鱼眼矫正，则只支持HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_420。 VPSS Group ID在[256,264)范围内，支持以下格式： 支持HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_422、HI\_PIXEL\_FORMAT\_YUV\_SEMIPLANAR\_422、HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_420、HI\_PIXEL\_FORMAT\_YUV\_SEMIPLANAR\_420、HI\_PIXEL\_FORMAT\_YUV\_400。 如果开启鱼眼矫正，则不支持HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_422、HI\_PIXEL\_FORMAT\_YUV\_SEMIPLANAR\_422、HI\_PIXEL\_FORMAT\_YUV\_SEMIPLANAR\_420。 支持semi\-planar 422转semi\-planar 420，支持通过设置通道输出像素格式实现UV反转。 |
| dynamic\_range | 预留参数。 |
| compress\_mode | 仅支持不压缩HI\_COMPRESS\_MODE\_NONE。 |
| frame\_rate | 帧率控制信息。 源帧率与目标帧率都为\-1，则不进行帧率控制，在通道AUTO模式下通道帧率控制不生效。 目标帧率不能大于源帧率。 |
| depth | 用户获取通道图像的队列长度。若队列长度为0，HI\_VPSS\_CHN\_MODE\_USER模式下用户无法获取图像。 开启鱼眼矫正功能时，需要额外多分配1个图像内存资源。 取值范围：[0, 8]。 |
| aspect\_ratio | 幅形比参数。幅形比处理时，先做缩放，再加黑边，缩放比例越大，AI处理器处理时间越长，可能会导致帧率下降。 开启幅形比后，非视频区域的填充颜色，值不大于 0xFFFFFF。 如果输出图像存在缩放，则图像会缩放至幅形比视频区域的大小，缩放比例不能超过VPSS支持的缩放比例。 ASPECT\_RATIO\_MANUAL模式下，坐标值必须满足x：大于等于 0，小于通道图像宽；y：大于等于0，小于通道图像高；宽高满足w：大于等于64，小于等于通道图像宽度；h：大于等于64，小于等于通道图像高度，并且x+w不大于通道图像宽，y+h 不大于通道图像高。 |
| reserved | 预留参数，为保证后续版本兼容性，请务必使用memset结构体方式进行清零初始化，在代码中必须避免显式对reserved字段进行访问。 |