x264_param_t结构体参数分析

转自：http://blog.chinaunix.net/uid-17053077-id-1987955.html

参考网上的一些资料，结合个人的理解，对x264中x264_param_t结构体作了初步的分析，不保证正确。对x264熟悉的朋友可以在这基础上修改添加

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;
    /** num除以den即帧率*/
　　/*这两个参数是由fps(Frame Per Second)帧率确定的，赋值的过程见下：
　　{        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         b_intra_refresh;    　　//用周期帧内刷新替代IDR （这貌似是个新参数，对周期帧内刷新不甚理解，知道的朋友可否指点一下）
 
　　int         i_bframe;   　　　　　　　/*在两个参考帧之间B帧的数目 */
　　int         i_bframe_adaptive; 　　 /*自适应B帧判定*/
　　int         i_bframe_bias; 　　　　  /*控制插入B帧判定，范围-100~+100，越高越容易插入B帧，默认0*/
　　int         b_bframe_pyramid;   　　/*允许部分B为参考帧,可选值为0，1，2 */
 
　　/*去方块滤波器需要的参数，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         b_constrained_intra;
 
/*量化 */
int         i_cqm_preset;         /*自定义量化矩阵(CQM),初始化量化模式为flat*/
char        *psz_cqm_file;      /* JM format读取JM格式的外部量化矩阵文件，自动忽略其他—cqm 选项*/
uint8_t     cqm_4iy[];        /* used only if i_cqm_preset == X264_CQM_CUSTOM */
uint8_t     cqm_4ic[];
uint8_t     cqm_4py[];
uint8_t     cqm_4pc[];
uint8_t     cqm_8iy[];
uint8_t     cqm_8py[];
 
/* 日志 */
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          i_weighted_pred;  //p帧加权预测
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帧的转换参数阈值 */
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[]; /* {帧间, 帧内} */
 
int          b_psnr;    /* 计算和打印PSNR信息 */
int          b_ssim;    /*计算和打印SSIM信息*/
} analyse;
 
　　/* 码率控制参数 */
　　struct
　　{
　　　　　　int         i_rc_method;    /* X264_RC_* */   //码率控制方法：
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　//CQP（恒定质量），CRF(恒定码率)、ABR（平均码率）
　　　　　　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;  //In CRF mode,maximum CRF as caused by VBV,这是源文件的注释，对码率控制不熟悉，不知道具体意思
　　　　　　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 b_annexb;            //如果设置了该项，则在每个NAL单元前加一个四字节的前缀符
int i_sps_id;               /* SPS 和 PPS id 号 */
 
 int b_vfr_input;     //VFR输入
uint32_t i_fps_num;
uint32_t i_fps_den;
uint32_t i_timebase_num;
uint32_t i_timebase_den;
 
int b_dts_compress;
 
 int b_tff; 
 
int b_pic_struct;
int b_fake_interlaced; 
 
/*切片（像条）参数 */
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;