hi_venc_h264_cbr_param

hi_venc_prores_attr

说明

定义PRORES属性结构体，暂不支持。

定义

typedef enum &#123;
    HI_VENC_PRORES_FRAME_RATE_UNKNOWN = 0,
    HI_VENC_PRORES_FRAME_RATE_23_976,
    HI_VENC_PRORES_FRAME_RATE_24,
    HI_VENC_PRORES_FRAME_RATE_25,
    HI_VENC_PRORES_FRAME_RATE_29_97,
    HI_VENC_PRORES_FRAME_RATE_30,
    HI_VENC_PRORES_FRAME_RATE_50,
    HI_VENC_PRORES_FRAME_RATE_59_94,
    HI_VENC_PRORES_FRAME_RATE_60,
    HI_VENC_PRORES_FRAME_RATE_100,
    HI_VENC_PRORES_FRAME_RATE_119_88,
    HI_VENC_PRORES_FRAME_RATE_120,
    HI_VENC_PRORES_FRAME_RATE_BUTT
&#125; hi_venc_prores_frame_rate;

// the aspect ratio of PRORES
typedef enum &#123;
    HI_VENC_PRORES_ASPECT_RATIO_UNKNOWN = 0,
    HI_VENC_PRORES_ASPECT_RATIO_SQUARE,
    HI_VENC_PRORES_ASPECT_RATIO_4_3,
    HI_VENC_PRORES_ASPECT_RATIO_16_9,
    HI_VENC_PRORES_ASPECT_RATIO_BUTT
&#125; hi_venc_prores_aspect_ratio;

// the attribute of PRORES
typedef struct &#123;
    hi_char identifier[HI_VENC_PRORES_MAX_ID_CHAR_NUM];
    hi_venc_prores_frame_rate frame_rate_code;
    hi_venc_prores_aspect_ratio aspect_ratio;
&#125; hi_venc_prores_attr;

父主题： VENC视频/JPEGE图像编码

hi_venc_scene_mode

说明

定义编码模式场景。

定义

typedef enum &#123;
    HI_VENC_SCENE_0 = 0,  // 摄像机不运动或周期性连续运动的场景，支持h.264/h.265
    HI_VENC_SCENE_1 = 1,  // 高码率下运动场景，支持h.265
    HI_VENC_SCENE_2 = 2,  // 暂不支持
    HI_VENC_SCENE_BUTT
&#125;hi_venc_scene_mode;

安防场景配置为HI_VENC_SCENE_0；自动驾驶、直播、游戏、动画、电影配置为HI_VENC_SCENE_1。

父主题： VENC视频/JPEGE图像编码

hi_venc_rc_param

说明

定义编码通道码率控制器的高级参数。

定义

typedef struct &#123;
    hi_u32 threshold_i[HI_VENC_TEXTURE_THRESHOLD_SIZE];
    hi_u32 threshold_p[HI_VENC_TEXTURE_THRESHOLD_SIZE];
    hi_u32 threshold_b[HI_VENC_TEXTURE_THRESHOLD_SIZE];
    hi_u32 direction;
    hi_u32 row_qp_delta;
    hi_s32 first_frame_start_qp;
    hi_venc_scene_chg_detect scene_chg_detect;
    union &#123;
        hi_venc_h264_cbr_param h264_cbr_param;
        hi_venc_h264_vbr_param h264_vbr_param;
        hi_venc_h264_avbr_param h264_avbr_param;
        hi_venc_h264_qvbr_param h264_qvbr_param;
        hi_venc_h264_cvbr_param h264_cvbr_param;
        hi_venc_h265_cbr_param h265_cbr_param;
        hi_venc_h265_vbr_param h265_vbr_param;
        hi_venc_h265_avbr_param h265_avbr_param;
        hi_venc_h265_qvbr_param h265_qvbr_param;
        hi_venc_h265_cvbr_param h265_cvbr_param;
        hi_venc_mjpeg_cbr_param mjpeg_cbr_param;
        hi_venc_mjpeg_vbr_param mjpeg_vbr_param;
     &#125;;
&#125;hi_venc_rc_param;

成员

成员名称	描述
threshold_i	I帧宏块级码率控制的Madi（用于度量当前帧的空域纹理复杂度）门限。取值范围：[0, 255]。默认值：[0,0,0,0,3,3,5,5,8,8,8,15,15,20,25,25]。减方向的数值设置为0，表示关闭当前级；加方向的数值设置为255，表示关闭当前级。
threshold_p	P帧宏块级码率控制的Madi门限。取值范围：[0, 255]。默认值：[0,0,0,0,3,3,5,5,8,8,8,15,15,20,25,25]。减方向的数值设置为0，表示关闭当前级；加方向的数值设置为255，表示关闭当前级。
threshold_b	B帧宏块级码率控制的Madi门限。取值范围：[0, 255]。默认值：[0,0,0,0,3,3,5,5,8,8,8,15,15,20,25,25]。减方向的数值设置为0，表示关闭当前级；加方向的数值设置为255，表示关闭当前级。
direction	在基于纹理宏块级码率控制时，用于控制加减方向。取值范围：[0, 16]。默认值：8。举例，direction=7 表示threshold_i、threshold_p、threshold_b的前7个参数用于 QP减方向；后9个参数用于QP加方向。
row_qp_delta	行级码率控制调节幅度是一帧内行级调节的最大范围，其中行级以宏块行为单位。调节幅度越大，允许行级调整的QP范围越大，码率越平稳。对于图像复杂度分布不均匀的场景，行级码率控制调节幅度设置过大会带来图像质量不均匀。取值范围：[0, 10]，设置为0表示关闭基于行的宏块级码率控制。默认值：1。
first_frame_start_qp	设置第一帧的起始Qp值，CBR/VBR/AVBR/QVBR/CVBR模式下，该参数有效。此处第一帧的含义是：通道创建，GOP模式切换，RC模式切换，或分辨率切换后，序列的第一个IDR帧。需要注意如果第一帧编码完成后判定为重编，重编的帧不是第一帧，不受 first_frame_start_qp的约束。取值范围：[MinIQP, MaxIQP]和-1。MinIQP参数值、MaxIQP参数值在码率控制模式的高级参数结构体内设置。默认值：-1。如果为-1，则第一帧的起始QP由编码器内部计算，如果为其它合法值则由用户通过该参数设置第一帧的起始QP。在低码率、少量运动场景下，如果编码效果不好，可以通过降低该参数值来提升图像质量和效果，例如，在“352*288分辨率，帧率25fps，GOP=50”场景下，将first_frame_start_qp设置为32，同时将max_reencode_times参数设置为0（表示不重编码，该参数是以下码率控制模式高级参数之一）。
scene_chg_detect	场景检测相关的控制参数，自适应检测当前编码场景是否发生变化，使能后会改善场景切换时的码率波动，VBR/AVBR/QVBR/CVBR 有效。使能场景切换检测时可使能自适应插入IDR帧，在场景切换时编码IDR帧，需要注意关闭重编后检测场景切换会失效。该参数建议与编码场景模式的SCENE_0模式配合使用。
h264_cbr_param	H.264通道CBR（Constant Bit Rate）码率控制模式高级参数。
h264_vbr_param	H.264通道VBR（Variable Bit Rate）码率控制模式高级参数。
h264_avbr_param	H.264通道AVBR（Adaptive Variable Bit Rate）码率控制模式高级参数。
h264_qvbr_param	H.264通道QVBR (Quality Variable Bit Rate)码率控制模式高级参数。
h264_cvbr_param	H.264通道CVBR (Constrained Variable Bit Rate)码率控制模式高级参数。
h265_cbr_param	H.265通道CBR（Constant Bit Rate）码率控制模式高级参数。
h265_vbr_param	H.265通道VBR（Variable Bit Rate）码率控制模式高级参数。
h265_avbr_param	H.265通道AVBR（Adaptive Variable Bit Rate）码率控制模式高级参数。
h265_qvbr_param	H.265通道QVBR (Quality Variable Bit Rate)码率控制模式高级参数。
h265_cvbr_param	H.265通道CVBR (Constrained Variable Bit Rate)码率控制模式高级参数。
mjpeg_cbr_param	MJPEG通道CBR（Constant Bit Rate）码率控制模式高级参数。预留参数，暂不支持。
mjpeg_vbr_param	MJPEG通道VBR（Variable Bit Rate）码率控制模式高级参数。预留参数，暂不支持。

父主题： VENC视频/JPEGE图像编码

hi_venc_h264_cbr_param

说明

定义H264协议编码通道CBR码率控制模式的高级参数。

定义

typedef struct &#123;
    hi_u32 max_i_proportion;
    hi_u32 min_i_proportion;
    hi_u32 max_qp;
    hi_u32 min_qp;
    hi_u32 max_i_qp;
    hi_u32 min_i_qp;
    hi_s32 max_reencode_times;
    hi_bool qpmap_en;
&#125;hi_venc_h264_cbr_param;

成员

成员名称	描述
min_i_proportion	最小IP帧比例，预留参数，暂不支持。
max_i_proportion	最大IP帧比例。取值范围：[1, 100]。该参数默认值为100。
max_qp	帧最大QP，用于钳位质量。取值范围：[0, 51]。默认值：51。
min_qp	帧最小QP，用于钳位码率波动。取值范围：[0, max_qp]。默认值：10。
min_i_qp	I帧的最小QP。用于控制I帧的最大bits数。取值范围：[0, max_i_qp]。默认值：10。
max_i_qp	I帧的最大QP。用于控制I帧的最小bits数。取值范围：[0, 51]。默认值：51。
max_reencode_times	每帧重编码次数。0表示不进行重编码。取值范围：[0, 3]。默认值：2。
qpmap_en	预留参数，暂不支持。

父主题： VENC视频/JPEGE图像编码

hi_venc_h264_vbr_param

说明

定义H264协议编码通道VBR码率控制模式的高级参数。

定义

typedef struct &#123;
    hi_s32 chg_pos;
    hi_u32 max_i_proportion;
    hi_u32 min_i_proportion;
    hi_s32 max_reencode_times;
    hi_bool qpmap_en;
    hi_u32 max_qp;
    hi_u32 min_qp;
    hi_u32 max_i_qp;
    hi_u32 min_i_qp;
&#125; hi_venc_h264_vbr_param;

成员

max_qp、min_qp用于控制图像的质量范围，max_bit_rate用于钳位码率统计时间内的最大编码码率，chg_pos用于控制开始调整QP的码率基准线。

当编码码率大于max_bit_rate*chg_pos时，图像QP会逐步向max_qp调整，如果图像QP达到max_qp，QP会被钳位到最大值，max_bit_rate的钳位效果失效，编码码率有可能会超出max_bit_rate。

当编码码率小于max_bit_rate*chg_pos时，图像QP会逐步向min_qp调整，如果图像QP达到min_qp，此时编码的码率已经达到最大值，而且图像质量最好。

:::note 说明 max_bit_rate参数在创建VENC通道时设置，是hi_venc_chn_attr.rc_attr结构体内的成员变量。 :::

成员名称	描述
chg_pos	VBR开始调整Qp时的码率相对于最大码率的比例。取值范围：[50, 100]。默认值：90。
min_i_proportion	预留参数，暂不支持。
max_i_proportion	最大IP帧码率的比值。取值范围：[1,100]。该参数默认值为100。
max_reencode_times	每帧重编码次数。0 表示不进行重编码。取值范围：[0, 3]。默认值：2。
qpmap_en	预留参数，暂不支持。
max_qp	P、B帧的最大QP。取值范围：[0, 51]。默认值：51。
min_qp	P、B帧的最小QP。取值范围：[0, max_qp]。默认值：24。
max_i_qp	I帧的最大QP。取值范围：[0, 51]。默认值：51。
min_i_qp	I帧的最小QP。取值范围：[0, max_i_qp]。默认值：24。

父主题： VENC视频/JPEGE图像编码

hi_venc_h264_avbr_param

说明

定义H264协议编码通道AVBR码率控制模式的高级参数。

定义

typedef struct &#123;
    hi_s32 chg_pos;
    hi_u32 max_i_proportion;
    hi_u32 min_i_proportion;
    hi_s32 max_reencode_times;
    hi_bool qpmap_en;
    hi_s32 min_still_percent;
    hi_u32 max_still_qp;
    hi_u32 min_still_psnr;
    hi_u32 max_qp;
    hi_u32 min_qp;
    hi_u32 max_i_qp;
    hi_u32 min_i_qp;
    hi_u32 min_qp_delta;
    hi_u32 motion_sensitivity;
    hi_bool save_bitrate_en;
&#125;hi_venc_h264_avbr_param;

成员

max_bit_rate表示运动场景下的最大码率，max_bit_rate*chg_pos*min_still_percent 表示静止情况下的最小码率。

根据运动程度的不同，目标码率会在最大码率和最小码率间调整。max_qp，min_qp用于控制图像的质量范围，码率控制以QP钳位为最高优先级，超出min_qp，max_qp范围内码率控制将失效。

:::note 说明 max_bit_rate参数在创建VENC通道时设置，是hi_venc_chn_attr.rc_attr结构体内的成员变量。 :::

成员名称	描述
chg_pos	AVBR开始调整Qp时的码率相对于最大码率的比例。取值范围：[50, 100]。默认值：65。
min_i_proportion	预留参数，暂不支持。
max_i_proportion	最大IP帧码率的比值。取值范围：[1,100]。默认值：100。
max_reencode_times	每帧重编码次数。0 表示不进行重编码。取值范围：[0, 3]。默认值：2。
qpmap_en	预留参数，暂不支持。
min_still_percent	静止状态下目标码率的最小百分比。此变量设置为100，AVBR将不会在判别为静止时主动调低目标码率。取值范围：[5, 100]。默认值：25。
max_still_qp	静止场景I帧QP的最大值。取值范围：[min_i_qp, max_i_qp]。默认值：35。
min_still_psnr	预留参数，暂不支持。
max_qp	P、B帧的最大QP。取值范围：[0, 51]。默认值：51。
min_qp	P、B帧的最小QP。取值范围：[0, max_qp]。默认值：24。
max_i_qp	I帧的最大QP。取值范围：[0, 51]。默认值：51。
min_i_qp	I帧的最小QP。取值范围：[0, max_i_qp]。默认值：24。
min_qp_delta	帧级QP最小值和CU级QP最小值的差值。 I帧，帧级QP最小值= min_qp_delta + min_i_qp P、B帧，帧级QP最小值= min_qp_delta+min_qp 取值范围：[0, 4]；默认值：0。
motion_sensitivity	运动敏感度。取值范围：[0, 100]。默认值：100。
save_bitrate_en	预留参数，暂不支持。

父主题： VENC视频/JPEGE图像编码

hi_venc_h264_qvbr_param

说明

定义H264协议编码通道QVBR码率控制模式的高级参数。

定义

typedef struct &#123;
    hi_u32 max_i_proportion;
    hi_u32 min_i_proportion;
    hi_s32 max_reencode_times;
    hi_bool qpmap_en;
    hi_u32 max_qp;
    hi_u32 min_qp;
    hi_u32 max_i_qp;
    hi_u32 min_i_qp;
    hi_s32 max_bit_percent;
    hi_s32 min_bit_percent;
    hi_s32 max_psnr_fluctuate;
    hi_s32 min_psnr_fluctuate;
&#125; hi_venc_h264_qvbr_param;

成员

当实时统计的PSNR小于max_psnr_fluctuate时，适当增加目标码率，最大码率=target_bit_rate* max_bit_percent。

当实时统计的PSNR大于max_psnr_fluctuate时，适当减小目标码率，最小码率=target_bit_rate* min_bit_percent。

根据当前PSNR的不同，目标码率会在最大码率和最小码率间调整，当PSNR值范围超过[min_psnr_fluctuate-4,max_psnr_fluctuate+4]∩[20,40]时，PSNR不再起作用，码率会在最大码率和最小码率间调整。

max_qp，min_qp用于控制图像的质量范围，码率控制以QP钳位为最高优先级，超出min_qp，max_qp范围内码率控制将失效。

码率浮动上下限的优先级高于PSNR的优先级，例如，当码率浮动到上限依然不能满足PSNR要求，则码率不会再继续上调。

:::note 说明 target_bit_rate参数在创建VENC通道时设置，是hi_venc_chn_attr.rc_attr结构体内的成员变量。 :::

成员名称	描述
min_i_proportion	预留参数，暂不支持。
max_i_proportion	最大IP帧码率的比值。取值范围：[1,100]。默认值：100。
max_reencode_times	每帧重编码次数。0表示不进行重编码。取值范围：[0, 3]。默认值：2。
qpmap_en	预留参数，暂不支持。
max_qp	P、B帧的最大QP。取值范围：[min_qp, 51]。默认值：51。
min_qp	P、B帧的最小QP。取值范围：[0, 51]。默认值：16。
max_i_qp	I帧的最大QP。取值范围：[min_i_qp, 51]。默认值：51。
min_i_qp	I帧的最小QP。取值范围：[0, 51]。默认值：16。
max_bit_percent	码率百分比上限。取值范围：[min_bit_percent, 180]。默认值：110。
min_bit_percent	码率百分比下限。取值范围：[30, 180]。默认值：45。
max_psnr_fluctuate	Psnr上限。取值范围：[min_psnr_fluctuate, 40]。默认值：40。
min_psnr_fluctuate	Psnr下限。取值范围：[18, 40]。默认值：23。

父主题： VENC视频/JPEGE图像编码

在线提单

hi_venc_prores_attr​

说明​

定义​

hi_venc_scene_mode​

说明​

定义​

hi_venc_rc_param​

说明​

定义​

成员​

hi_venc_h264_cbr_param​

说明​

定义​

成员​

hi_venc_h264_vbr_param​

说明​

定义​

成员​

hi_venc_h264_avbr_param​

说明​

定义​

成员​

hi_venc_h264_qvbr_param​

说明​

定义​

成员​

hi_venc_prores_attr

说明

定义

hi_venc_scene_mode

说明

定义

hi_venc_rc_param

说明

定义

成员

hi_venc_h264_cbr_param

说明

定义

成员

hi_venc_h264_vbr_param

说明

定义

成员

hi_venc_h264_avbr_param

说明

定义

成员

hi_venc_h264_qvbr_param

说明

定义

成员