hi_vb_src

hi_video_frame

说明

定义视频原始图像帧字典。

定义

hi_video_frame = {"width": width,
                  "height": height,
                  "field": hi_video_field,
                  "pixel_format": hi_pixel_format,
                  "video_format": hi_video_format,
                  "compress_mode": hi_compress_mode,
                  "dynamic_range": hi_dynamic_range,
                  "color_gamut": hi_color_gamut,
                  "header_stride": [header_stride, header_stride, header_stride],
                  "width_stride": [width_stride, width_stride, width_stride],
                  "height_stride": [height_stride, height_stride, height_stride],
                  "header_phys_addr": [header_phys_addr, header_phys_addr, header_phys_addr],
                  "phys_addr": [phys_addr, phys_addr, phys_addr],
                  "header_virt_addr:[header_virt_addr_list, header_virt_addr_list, header_virt_addr_list],
                  "virt_addr": [virt_addr, virt_addr, virt_addr],
                  "time_ref": time_ref,
                  "pts": pts,
                  "user_data": [user_data],
                  "frame_flag": frame_flag, # frame_flag, can be OR operation.
                  "supplement": hi_video_supplement}

成员

成员名称	描述
width	整型，图像宽度。
height	整型，图像高度。
field	整型，帧场模式。预留参数。
pixel_format	整型，视频图像像素格式。
video_format	整型，视频图像格式。
compress_mode	整型，视频压缩模式。
dynamic_range	整型，动态范围。预留参数。
color_gamut	整型，色域范围。预留参数。
header_stride	列表，图像压缩头跨距。预留参数。
width_stride	列表，输出图像分量的宽度数据跨距。YUV图像则为Y、U、V分量的数据跨距。RGB图像则为R、G、B分量的数据跨距。
height_stride	列表，输出图像分量的高度数据跨距。YUV图像则为Y、U、V分量的数据跨距。RGB图像则为R、G、B分量的数据跨距。 若涉及VENC视频编码、JPEGE图片编码功能时，该参数作为预留参数，暂不支持。
header_phys_addr	列表，压缩头物理地址。预留参数。
phys_addr	列表，物理地址。预留参数。
header_virt_addr	列表，压缩头虚拟地址。预留参数。
virt_addr	列表，图像在Device内存中的起始虚拟地址。 作为输入图像时，对于YUV图像，virt_addr[0]为图像起始地址，也是Y分量起始地址，virt_addr[1]为U分量起始地址，virt_addr[2]为V分量起始地址； 作为输出图像时，对于YUV和RGB图像，virt_addr[0]为图像在device上的起始地址，virt_addr[1]和virt_addr[2]为保留字段。
time_ref	整型，图像帧序列号。 解码场景下，该参数预留。 JPEGE编码场景下，该参数预留。 VENC编码场景下，针对每一帧设置该参数时，按照帧的顺序，该参数值需递增且为偶数，例如，第一帧时该参数值设置为2，第二帧时该参数值设置为4，以此类推。
pts	整型，图像时间戳。
user_data	列表，私有数据。预留参数。
frame_flag	整形。 - 在VDEC解码场景下，该参数表示该帧解码是否成功，不管成功或失败，用户都需及时释放输入、输出内存，对于解码失败的帧，系统不保证按照显示序或解码序按顺序输出，本参数取值范围： - 0：解码成功。 - 1：解码失败，可能由于输入码流异常、设置的码流格式与实际码流不一致等问题导致。 - 2：隔行码流场景下使用，隔行码流每帧发送两场，带两块输出内存；解码时其中一块内存无图像输出，属于正常现象，用户需及时释放内存；隔行码流的解码输出数据都在奇数场对应的输出buffer中。 - 3：参考帧个数设置错误导致解码失败。 - 4：VDEC解码帧存大小设置错误导致解码失败。 - 在JPEGD解码场景下，该参数表示该帧解码是否成功，不管成功或失败，用户都需及时释放输入、输出内存，本参数取值范围： - 0：解码成功。 - 1：解码失败，可能由于输入码流异常、设置的码流格式与实际码流不一致等问题导致。 - 4：JPEGD解码输出内存大小过小导致解码失败，可提前调用acl.himpi.vdec_get_jpegd_output_info接口获取输出内存大小。 - 5：仅JPEGD解码场景使用，表示JPEGD解码配置参数设置错误，例如，设置的宽高超出限制、设置的目标解码格式不支持等。 - 在VENC编码场景下，该参数表示是否使能slice_temporal_mvp_enabled_flag语法（表示帧间预测是否使用时域MV（MotionVector）预测），取值范围如下，但仅H265协议下该参数生效： - 0：slice_temporal_mvp_enabled_flag为True，表示使用时域MV预测。 - 1：slice_temporal_mvp_enabled_flag为False，表示不使用时域MV预测。 - 在JPEGE编码****场景下，取值0或1，但当前版本暂未使用该参数，参数值无效。
supplement	字典，图像的补充信息。 Atlas 200/500 A2推理产品上，该参数为透传参数。

注意事项

• 10bit 数据不压缩时在内存中的存储方式是是紧凑排列的。
• 10bit YUV 段压缩数据存储是前 8bit 和后 2bit 分开存储。
• 10bit tile 64x16 数据（即 VDH （video decoder hardware）解码之后的数据）不管是压缩还是非压缩，在内存中的存储方式都是前 8bit 和后 2bit 分开存储。

父主题： 公共

hi_video_frame_info

说明

定义视频图像帧信息字典。

定义

hi_video_frame_info = {"v_frame": hi_video_frame, "pool_id" pool_id, "mod_id": hi_mod_id}

成员

成员名称	描述
v_frame	字典，视频图像帧属性字典。
pool_id	整型，视频缓存池ID，预留参数。
mod_id	整型，DVPP内的子模块ID，预留参数。

父主题： 公共

hi_vb_src

说明

定义VB来源选择。

定义

HI_VB_SRC_COMMON  = 0 #公共VB
HI_VB_SRC_MOD     = 1 #模块VB
HI_VB_SRC_PRIVATE = 2 #私有VB
HI_VB_SRC_USER    = 3 #用户VB
HI_VB_SRC_BUTT    = 4

父主题： 公共

hi_mod_id

说明

定义模块ID类型。

定义

HI_ID_CMPI         = 0
HI_ID_VB           = 1
HI_ID_SYS          = 2
HI_ID_RGN          = 3
HI_ID_CHNL         = 4
HI_ID_VDEC         = 5
HI_ID_AVS          = 6
HI_ID_VPC          = 7
HI_ID_VENC         = 8
HI_ID_SVP          = 9
HI_ID_H264E        = 10
HI_ID_JPEGE        = 11
HI_ID_MPEG4E       = 12
HI_ID_H265E        = 13
HI_ID_JPEGD        = 14
HI_ID_VO           = 15
HI_ID_VI           = 16
HI_ID_DIS          = 17
HI_ID_VALG         = 18
HI_ID_RC           = 19
HI_ID_AIO          = 20
HI_ID_AI           = 21
HI_ID_AO           = 22
HI_ID_AENC         = 23
HI_ID_ADEC         = 24
HI_ID_VPU          = 25
HI_ID_PCIV         = 26
HI_ID_PCIVFMW      = 27
HI_ID_ISP          = 28
HI_ID_IVE          = 29
HI_ID_USER         = 30
HI_ID_DCCM         = 31
HI_ID_DCCS         = 32
HI_ID_PROC         = 33
HI_ID_LOG          = 34
HI_ID_VFMW         = 35
HI_ID_H264D        = 36
HI_ID_GDC          = 37
HI_ID_PHOTO        = 38
HI_ID_FB           = 39
HI_ID_HDMI         = 40
HI_ID_VOIE         = 41
HI_ID_TDE          = 42
HI_ID_HDR          = 43
HI_ID_PRORES       = 44
HI_ID_VGS          = 45
HI_ID_FD           = 47
HI_ID_ODT          = 48 # Object detection trace
HI_ID_VQA          = 49 # Video quality analysis
HI_ID_LPR          = 50 # Object detection trace
HI_ID_SVP_NNIE     = 51
HI_ID_SVP_DSP      = 52
HI_ID_DPU_RECT     = 53
HI_ID_DPU_MATCH    = 54
HI_ID_MOTIONSENSOR = 55
HI_ID_MOTIONFUSION = 56
HI_ID_GYRODIS      = 57
HI_ID_PM           = 58
HI_ID_SVP_ALG      = 59
HI_ID_IVP          = 60
HI_ID_MCF          = 61
HI_ID_VPSS         = 62
HI_ID_DRV_VPC      = 63
HI_ID_PNGD         = 64
HI_ID_BUTT         = 256

父主题： 公共

hi_data_bit_width

说明

定义数据比特位宽类型。

目前DVPP模块仅支持HI_DATA_BIT_WIDTH_8和HI_DATA_BIT_WIDTH_10两个数据位宽格式。

定义

HI_DATA_BIT_WIDTH_8    = 0
HI_DATA_BIT_WIDTH_10   = 1
HI_DATA_BIT_WIDTH_12   = 2
HI_DATA_BIT_WIDTH_14   = 3
HI_DATA_BIT_WIDTH_16   = 4
HI_DATA_BIT_WIDTH_BUTT = 5

父主题： 公共

hi_video_format

说明

定义视频格式。

定义

HI_VIDEO_FORMAT_LINEAR     = 0 # nature video line
HI_VIDEO_FORMAT_TILE_64x16 = 1 # tile cell: 64pixel x 16line
HI_VIDEO_FORMAT_BUTT       = 2

成员

成员名称	描述
HI_VIDEO_FORMAT_LINEAR	线性存储的视频格式。
HI_VIDEO_FORMAT_TILE_64x16	TILE 格式存储的视频格式，其中，tile的块大小为64像素宽，16行像素高，视频/图像编码暂不支持。
HI_VIDEO_FORMAT_BUTT	保留值。

父主题： 公共

在线提单