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	整型，视频图像格式。在昇腾310 AI处理器上，使用VENC功能时，该参数为预留参数，暂不支持。
compress_mode	整型，视频压缩模式。在昇腾310 AI处理器上，使用VENC功能时，该参数为预留参数，暂不支持。 0：表示非压缩模式，当前仅支持该选项。 1：表示段压缩。 2：表示Tile压缩。 3：HFBC（HiSilicon frame buffer compression）压缩。
dynamic_range	整型，动态范围。预留参数。
color_gamut	整型，色域范围。预留参数。
header_stride	列表，图像压缩头跨距。预留参数。
width_stride	列表，输出图像分量的宽度数据跨距。YUV图像则为Y、U、V分量的数据跨距。RGB图像则为R、G、B分量的数据跨距。在昇腾310 AI处理器上，使用VENC功能时，该参数为预留参数，暂不支持。
height_stride	列表，输出图像分量的高度数据跨距。YUV图像则为Y、U、V分量的数据跨距。RGB图像则为R、G、B分量的数据跨距。在昇腾310 AI处理器上，使用VENC功能时，该参数为预留参数，暂不支持。
header_phys_addr	列表，压缩头物理地址。预留参数。
phys_addr	列表，物理地址。预留参数。
header_virt_addr	列表，压缩头虚拟地址。预留参数。
virt_addr	列表，图像在Device内存中的起始虚拟地址。
time_ref	整型，图像帧序列号。解码场景下，该参数预留。编码场景下，针对每一帧设置该参数时，按照帧的顺序，该参数值需递增且为偶数，例如，第一帧时该参数值设置为2，第二帧时该参数值设置为4，以此类推。
pts	整型，图像时间戳。
user_data	列表，私有数据。预留参数。
frame_flag	整形解码场景下，表示该帧解码是否成功，取值范围： 0：成功 1：失败，如果失败，用户需要及时释放内存 2：隔行码流场景下使用，隔行码流每帧发送两场，带两块输出内存；解码时其中一块内存无图像输出，属于正常现象，用户需及时释放内存；隔行码流的解码输出数据都在奇数场对应的输出buffer中。 3：失败，参考帧个数设置错误。 4：失败，VDEC解码帧存大小设置错误，JPEGD解码输出内存大小设置错误。 5：失败，JPEGD解码配置参数设置错误，例如，设置的宽高超出限制、设置的目标解码格式不支持等。在编码场景下，表示是否使能slice_temporal_mvp_enabled_flag语法（表示帧间预测是否使用时域MV（MotionVector）预测），仅支持H265协议，取值范围如下： 0：slice_temporal_mvp_enabled_flag 为 True，表示使用时域MV预测。 1：slice_temporal_mvp_enabled_flag 为 False，表示不使用时域MV预测。
supplement	字典，图像的补充信息。预留参数。

注意事项

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

父主题： 公共