x264中重要结构体说明

首先解释一下cli_opt_t的这个_t代表结构体可能是type的意思。同时还有很多i_ b_等作为前缀的变量，其中的i_表示int类型的变量，b_表示bool类型的。依次类推。 正式进入主题。 (A)typedef struct {     int b_progress;     int i_seek;     hnd_t hin;     hnd_t hout;     FILE *qpfile; } cli_opt_t; 此结构体是记录一些与编码关系较小的设置信息的opt=option。结构体内部的变量都可以通过读取main()的参数获得。也就是argv。 b_progress表示一个bool类型的变量，看参数帮助 也就是x264--help你会知道，他是用来控制是否显示编码进度的一个东西。取值为0,1. i_seek 整数类型 表示开始从哪一帧编码。因为不一定从这个文件的第一帧开始编码，这是可以控制的。 hnd_t(hnd=handle)是一个空指针，void *在C语言里空指针是有几个特性的，他是一个一般化指针，可以指向任何一种类型，但却不能解引用，需要解引用的时候，需要进行强制转换。采用空指针的策略，应该是为了声明变量的简便和统一。 hin 指向输入yuv文件的指针。 hout 指向编码过后生成的文件的指针。 qpfile 是一个指向文件类型的指针，它是文本文件，其每一行的格式是framenum，frametype，qp。用于强制指定某些帧或者全部帧的帧类型和QP(quant param量化参数)的值。 (B)typedef struct x264_param_t {     /* CPU 标志位 */     unsigned int cpu;     int         i_threads;       /* 并行编码多帧 */     int         b_deterministic; /*是否允许非确定性时线程优化*/     int         i_sync_lookahead; /* 线程超前缓冲 */     /* 视频属性 */     int         i_width; /* 宽度*/     int         i_height; /* 高度*/     int         i_csp;  /* 编码比特流的CSP,仅支持i420，色彩空间设置 */     int         i_level_idc; /* level值的设置*/     int         i_frame_total; /* 编码帧的总数, 默认 0 */ /*Vui参数集视频可用性信息视频标准化选项 */     struct     {         /* they will be reduced to be 0 < x <= 65535 and prime */         int         i_sar_height;         int         i_sar_width; /* 设置长宽比 */         int         i_overscan;    /* 0=undef, 1=no overscan, 2=overscan 过扫描线，默认"undef"(不设置)，可选项：show(观看)/crop(去除)*/         /*见以下的值h264附件E */         Int       i_vidformat;/* 视频格式，默认"undef"，component/pal/ntsc/secam/mac/undef*/         int       b_fullrange; /*Specify full range samples setting，默认"off"，可选项：off/on*/         int       i_colorprim; /*原始色度格式，默认"undef"，可选项：undef/bt709/bt470m/bt470bg，smpte170m/smpte240m/film*/         int   i_transfer; /*转换方式，默认"undef"，可选项：undef/bt709/bt470m/bt470bg/linear,log100/log316/smpte170m/smpte240m*/         int  i_colmatrix; /*色度矩阵设置，默认"undef",undef/bt709/fcc/bt470bg,smpte170m/smpte240m/GBR/YCgCo*/         int         i_chroma_loc;    /* both top & bottom色度样本指定，范围0~5，默认0 */     } vui;     int         i_fps_num;     int         i_fps_den; /*这两个参数是由fps帧率确定的，赋值的过程见下： {        float fps;        if( sscanf( value, "%d/%d", &p->i_fps_num, &p->i_fps_den ) == 2 )             ;         else if( sscanf( value, "%f", &fps ) )         {             p->i_fps_num = (int)(fps * 1000 + .5);             p->i_fps_den = 1000;         }         else             b_error = 1;     } Value的值就是fps。*/     /*流参数 */     int         i_frame_reference;  /* 参考帧最大数目 */     int         i_keyint_max;       /* 在此间隔设置IDR关键帧(每过多少帧设置一个IDR帧) */     int         i_keyint_min;       /*  场景切换少于此值编码为I帧, 而不是 IDR. */     int         i_scenecut_threshold; /*控制怎样插入I帧 */     int         i_bframe;   /*两个参考帧间B帧的数目 */     int         i_bframe_adaptive; /*自适应B帧判定*/     int         i_bframe_bias; /*控制插入B帧判定，范围-100~+100，越高越容易插入B帧，默认0*/     int         b_bframe_pyramid;   /*允许部分B为参考帧 */ /*去块滤波器需要的参数，alpha和beta是去方块滤波器的参数*/     int         b_deblocking_filter;     int         i_deblocking_filter_alphac0;    /* [-6, 6] -6 light filter, 6 strong */     int         i_deblocking_filter_beta;       /* [-6, 6]  idem */     /*熵编码 */     int         b_cabac;     int         i_cabac_init_idc;     int         b_interlaced; /* 隔行扫描 */ /*量化 */      int         i_cqm_preset;         /*自定义量化矩阵(CQM),初始化量化模式为flat*/     char        *psz_cqm_file;      /* JM format读取JM格式的外部量化矩阵文件，自动忽略其他—cqm 选项*/     uint8_t     cqm_4iy[16];        /* used only if i_cqm_preset == X264_CQM_CUSTOM */     uint8_t     cqm_4ic[16];     uint8_t     cqm_4py[16];     uint8_t     cqm_4pc[16];     uint8_t     cqm_8iy[64];     uint8_t     cqm_8py[64];     /* 日志 */     void        (*pf_log)( void *, int i_level, const char *psz, va_list );     void        *p_log_private;     int         i_log_level;     int         b_visualize;     char        *psz_dump_yuv;  /* 重建帧的名字 */     /* 编码分析参数*/     struct     {         unsigned int intra;     /* 帧间分区*/         unsigned int inter;     /* 帧内分区 */         int          b_transform_8x8; /* 帧间分区*/         int          b_weighted_bipred; /*为b帧隐式加权 */         int          i_direct_mv_pred; /*时间空间队运动预测 */         int          i_chroma_qp_offset; /*色度量化步长偏移量 */         int          i_me_method; /* 运动估计算法 (X264_ME_*) */         int          i_me_range; /* 整像素运动估计搜索范围 (from predicted mv) */         int          i_mv_range; /* 运动矢量最大长度(in pixels). -1 = auto, based on level */         int          i_mv_range_thread; /* 线程之间的最小空间. -1 = auto, based on number of threads. */         int          i_subpel_refine; /* 亚像素运动估计质量 */         int          b_chroma_me; /* 亚像素色度运动估计和P帧的模式选择 */         int          b_mixed_references; /*允许每个宏块的分区在P帧有它自己的参考号*/         int          i_trellis;  /* Trellis量化，对每个8x8的块寻找合适的量化值，需要CABAC，默认0 0：关闭1：只在最后编码时 使用2：一直使用*/          int          b_fast_pskip; /*快速P帧跳过检测*/         int          b_dct_decimate; /* 在P-frames转换参数域 */         int          i_noise_reduction; /*自适应伪盲区 */         float        f_psy_rd; /* Psy RD strength */         float        f_psy_trellis; /* Psy trellis strength */         int          b_psy; /* Toggle all psy optimizations */         /*，亮度量化中使用的无效区大小*/         int          i_luma_deadzone[2]; /* {帧间, 帧内} */         int          b_psnr;    /* 计算和打印PSNR信息 */         int          b_ssim;    /*计算和打印SSIM信息*/     } analyse;     /* 码率控制参数 */     struct     {         int         i_rc_method;    /* X264_RC_* */         int         i_qp_constant;  /* 0-51 */         int         i_qp_min;       /*允许的最小量化值 */         int         i_qp_max;       /*允许的最大量化值*/         int         i_qp_step;      /*帧间最大量化步长 */         int         i_bitrate;  /*设置平均码率 */         float       f_rf_constant;  /* 1pass VBR, nominal QP */         float       f_rate_tolerance;         int         i_vbv_max_bitrate; /*平均码率模式下，最大瞬时码率，默认0(与-B设置相同) */         int         i_vbv_buffer_size; /*码率控制缓冲区的大小，单位kbit，默认0 */         float       f_vbv_buffer_init; /* <=1: fraction of buffer_size. >1: kbit码率控制缓冲区数据保留的最大数据量与缓冲区大小之比，范围0~1.0，默认0.9*/         float       f_ip_factor;         float       f_pb_factor;         int         i_aq_mode;      /* psy adaptive QP. (X264_AQ_*) */         float       f_aq_strength;         int         b_mb_tree;      /* Macroblock-tree ratecontrol. */         int         i_lookahead;         /* 2pass 多次压缩码率控制 */         int         b_stat_write;   /* Enable stat writing in psz_stat_out */         char        *psz_stat_out;         int         b_stat_read;    /* Read stat from psz_stat_in and use it */         char        *psz_stat_in;         /* 2pass params (same as ffmpeg ones) */         float       f_qcompress;    /* 0.0 => cbr, 1.0 => constant qp */         float       f_qblur;        /*时间上模糊量化 */         float       f_complexity_blur; /* 时间上模糊复杂性 */         x264_zone_t *zones;         /* 码率控制覆盖 */         int         i_zones;        /* number of zone_t's */         char        *psz_zones;     /*指定区的另一种方法*/     } rc;      /* Muxing parameters */     int b_aud;                  /*生成访问单元分隔符*/     int b_repeat_headers;       /* 在每个关键帧前放置SPS/PPS*/     int i_sps_id;               /* SPS 和 PPS id 号 */     /*切片（像条）参数 */     int i_slice_max_size;    /* 每片字节的最大数，包括预计的NAL开销. */     int i_slice_max_mbs;     /* 每片宏块的最大数，重写 i_slice_count */     int i_slice_count;       /* 每帧的像条数目: 设置矩形像条. */     /* Optional callback for freeing this x264_param_t when it is done being used.      * Only used when the x264_param_t sits in memory for an indefinite period of time,      * i.e. when an x264_param_t is passed to x264_t in an x264_picture_t or in zones.      * Not used when x264_encoder_reconfig is called directly. */     void (*param_free)( void* ); } x264_param_t;

 

void    x264_param_default( x264_param_t *param )//这部分设置编码参数的缺省值,与上面相对应

{

    /*初始化内存空间*/

    memset( param, 0, sizeof( x264_param_t ) );

    /* CPU autodetect */

    param->cpu = x264_cpu_detect();

    param->i_threads = 1;

    /* 视频属性 */

    param->i_csp           = X264_CSP_I420;

    param->i_width         = 0;

    param->i_height        = 0;

    param->vui.i_sar_width = 0;

    param->vui.i_sar_height= 0;

    param->vui.i_overscan  = 0;  /* undef */

    param->vui.i_vidformat = 5;  /* undef */

    param->vui.b_fullrange = 0;  /* off */

    param->vui.i_colorprim = 2;  /* undef */

    param->vui.i_transfer  = 2;  /* undef */

    param->vui.i_colmatrix = 2;  /* undef */

    param->vui.i_chroma_loc= 0;  /* left center */

    param->i_fps_num       = 25;

    param->i_fps_den       = 1;

    param->i_level_idc     = 51; /* as close to "unrestricted" as we can get */

    /* (编码参数)Encoder parameters */

    param->i_frame_reference = 1; /* 参考帧最大数目 */

    param->i_keyint_max = 250;

    param->i_keyint_min = 25;

    param->i_bframe = 0;

    param->i_scenecut_threshold = 40;

    param->b_bframe_adaptive = 1;

    param->i_bframe_bias = 0;

    param->b_bframe_pyramid = 0;

    param->b_deblocking_filter = 1;

    param->i_deblocking_filter_alphac0 = 0;

    param->i_deblocking_filter_beta = 0;

    param->b_cabac = 1;

    param->i_cabac_init_idc = 0;

/*码率控制*/

    param->rc.i_rc_method = X264_RC_CQP; /*恒定码率*/

    param->rc.i_bitrate = 0; /*设置平均码率大小*/

    param->rc.f_rate_tolerance = 1.0;

    param->rc.i_vbv_max_bitrate = 0; /*平均码率模式下，最大瞬时码率，默认0(与-B设置相同) */

    param->rc.i_vbv_buffer_size = 0; /*码率控制缓冲区的大小，单位kbit，默认0 */

    param->rc.f_vbv_buffer_init = 0.9; /* <=1: fraction of buffer_size. >1: kbit码率控制缓冲区数据保留的最大数据量与缓冲区大小之比，范围0~1.0，默认0.9*/

    param->rc.i_qp_constant = 26; /*最小qp值*/

    param->rc.i_rf_constant = 0;

    param->rc.i_qp_min = 10; /*允许的最小量化值 */

    param->rc.i_qp_max = 51; /*允许的最大量化值*/

    param->rc.i_qp_step = 4; /*帧间最大量化步长 */

    param->rc.f_ip_factor = 1.4;

    param->rc.f_pb_factor = 1.3;

    param->rc.b_stat_write = 0;

    param->rc.psz_stat_out = "x264_2pass.log";

    param->rc.b_stat_read = 0;

    param->rc.psz_stat_in = "x264_2pass.log";

    param->rc.psz_rc_eq = "blurCplx^(1-qComp)";

    param->rc.f_qcompress = 0.6;

    param->rc.f_qblur = 0.5; /*时间上模糊量化 */

    param->rc.f_complexity_blur = 20; /* 时间上模糊复杂性 */

    param->rc.i_zones = 0;

    /* 日志 */

    param->pf_log = x264_log_default;

    param->p_log_private = NULL;

    param->i_log_level = X264_LOG_INFO;

    /* 分析 */

    param->analyse.intra = X264_ANALYSE_I4x4 | X264_ANALYSE_I8x8;

    param->analyse.inter = X264_ANALYSE_I4x4 | X264_ANALYSE_I8x8

                         | X264_ANALYSE_PSUB16x16 | X264_ANALYSE_BSUB16x16;

    param->analyse.i_direct_mv_pred = X264_DIRECT_PRED_SPATIAL;

    param->analyse.i_me_method = X264_ME_HEX;

    param->analyse.i_me_range = 16;

    param->analyse.i_subpel_refine = 5;

    param->analyse.b_chroma_me = 1;

    param->analyse.i_mv_range = -1; // set from level_idc

    param->analyse.i_chroma_qp_offset = 0;

    param->analyse.b_fast_pskip = 1;

    param->analyse.b_dct_decimate = 1; /*是否显示PSNR*/

    param->analyse.b_psnr = 1; /*是否显示SSIM*/

/*量化*/

    param->i_cqm_preset = X264_CQM_FLAT; /*自定义量化矩阵(CQM),初始化量化模式为flat 0*/

    memset( param->cqm_4iy, 16, 16 );

    memset( param->cqm_4ic, 16, 16 );

    memset( param->cqm_4py, 16, 16 );

    memset( param->cqm_4pc, 16, 16 );

    memset( param->cqm_8iy, 16, 64 );

    memset( param->cqm_8py, 16, 64 ); /*开辟空间*/

    /*muxing*/

    param->b_repeat_headers = 1; /* 在每个关键帧前放置SPS/PPS*/

    param->b_aud = 0; /*生成访问单元分隔符*/

}

(C) typedef struct

{

    int     i_type;

    int     i_qpplus1;

    int64_t    i_pts;

    x264_image_t  img;

} x264_picture_t;

i_type 指明被编码图像的类型，有X264_TYPE_AUTO ,X264_TYPE_IDR,X264_TYPE_I ,X264_TYPE_P, X264_TYPE_BREF, X264_TYPE_B可供选择，初始化为AUTO，说明由x264在编码过程中自行控制。

i_qpplus1 ：此参数减1代表当前画面的量化参数值。

i_pts ：program time stamp 程序时间戳，指示这幅画面编码的时间戳。

img :存放真正一副图像的原始数据。

(D)typedef struct

{

    int     i_csp;

    int     i_plane;

    int     i_stride[4];

    uint8_t *plane[4];

} x264_image_t;

csp: color space parameter 色彩空间参数 X264只支持i420

i_plane 代表色彩空间的个数。一般为3，YUV，初始化为