~ubuntu-branches/ubuntu/natty/x264/natty

/*****************************************************************************

 * x264: top-level x264cli functions

 *****************************************************************************

 * Copyright (C) 2003-2010 x264 project

 *

 * Authors: Loren Merritt <lorenm@u.washington.edu>

 *          Laurent Aimar <fenrir@via.ecp.fr>

 *          Steven Walters <kemuri9@gmail.com>

 *          Jason Garrett-Glaser <darkshikari@gmail.com>

 *          Kieran Kunhya <kieran@kunhya.com>

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111, USA.

 *

 * This program is also available under a commercial proprietary license.

 * For more information, contact us at licensing@x264.com.

 *****************************************************************************/

#include <stdlib.h>

#include <math.h>

#include <signal.h>

#define _GNU_SOURCE

#include <getopt.h>

#include "common/common.h"

#include "x264cli.h"

#include "input/input.h"

#include "output/output.h"

#include "filters/filters.h"

#define FAIL_IF_ERROR( cond, ... ) FAIL_IF_ERR( cond, "x264", __VA_ARGS__ )

#ifdef _WIN32

#include <windows.h>

#else

#define SetConsoleTitle(t)

#endif

#if HAVE_LAVF

#undef DECLARE_ALIGNED

#include <libavformat/avformat.h>

#include <libavutil/pixfmt.h>

#include <libavutil/pixdesc.h>

#endif

/* Ctrl-C handler */

static volatile int b_ctrl_c = 0;

static int          b_exit_on_ctrl_c = 0;

static void sigint_handler( int a )

{

    if( b_exit_on_ctrl_c )

        exit(0);

    b_ctrl_c = 1;

}

typedef struct {

    int b_progress;

    int i_seek;

    hnd_t hin;

    hnd_t hout;

    FILE *qpfile;

    FILE *tcfile_out;

    double timebase_convert_multiplier;

    int i_pulldown;

} cli_opt_t;

/* file i/o operation structs */

cli_input_t input;

static cli_output_t output;

/* video filter operation struct */

static cli_vid_filter_t filter;

static const char * const demuxer_names[] =

{

    "auto",

    "raw",

    "y4m",

#if HAVE_AVS

    "avs",

#endif

#if HAVE_LAVF

    "lavf",

#endif

#if HAVE_FFMS

    "ffms",

#endif

    0

};

static const char * const muxer_names[] =

{

    "auto",

    "raw",

    "mkv",

    "flv",

#if HAVE_GPAC

    "mp4",

#endif

    0

};

static const char * const pulldown_names[] = { "none", "22", "32", "64", "double", "triple", "euro", 0 };

static const char * const log_level_names[] = { "none", "error", "warning", "info", "debug", 0 };

typedef struct{

    int mod;

    uint8_t pattern[24];

    float fps_factor;

} cli_pulldown_t;

enum pulldown_type_e

{

    X264_PULLDOWN_22 = 1,

    X264_PULLDOWN_32,

    X264_PULLDOWN_64,

    X264_PULLDOWN_DOUBLE,

    X264_PULLDOWN_TRIPLE,

    X264_PULLDOWN_EURO

};

#define TB  PIC_STRUCT_TOP_BOTTOM

#define BT  PIC_STRUCT_BOTTOM_TOP

#define TBT PIC_STRUCT_TOP_BOTTOM_TOP

#define BTB PIC_STRUCT_BOTTOM_TOP_BOTTOM

static const cli_pulldown_t pulldown_values[] =

{

    [X264_PULLDOWN_22]     = {1,  {TB},                                   1.0},

    [X264_PULLDOWN_32]     = {4,  {TBT, BT, BTB, TB},                     1.25},

    [X264_PULLDOWN_64]     = {2,  {PIC_STRUCT_DOUBLE, PIC_STRUCT_TRIPLE}, 1.0},

    [X264_PULLDOWN_DOUBLE] = {1,  {PIC_STRUCT_DOUBLE},                    2.0},

    [X264_PULLDOWN_TRIPLE] = {1,  {PIC_STRUCT_TRIPLE},                    3.0},

    [X264_PULLDOWN_EURO]   = {24, {TBT, BT, BT, BT, BT, BT, BT, BT, BT, BT, BT, BT,

                                   BTB, TB, TB, TB, TB, TB, TB, TB, TB, TB, TB, TB}, 25.0/24.0}

};

#undef TB

#undef BT

#undef TBT

#undef BTB

// indexed by pic_struct enum

static const float pulldown_frame_duration[10] = { 0.0, 1, 0.5, 0.5, 1, 1, 1.5, 1.5, 2, 3 };

static void help( x264_param_t *defaults, int longhelp );

static int  parse( int argc, char **argv, x264_param_t *param, cli_opt_t *opt );

static int  encode( x264_param_t *param, cli_opt_t *opt );

/* logging and printing for within the cli system */

static int cli_log_level;

void x264_cli_log( const char *name, int i_level, const char *fmt, ... )

{

    if( i_level > cli_log_level )

        return;

    char *s_level;

    switch( i_level )

    {

        case X264_LOG_ERROR:

            s_level = "error";

            break;

        case X264_LOG_WARNING:

            s_level = "warning";

            break;

        case X264_LOG_INFO:

            s_level = "info";

            break;

        case X264_LOG_DEBUG:

            s_level = "debug";

            break;

        default:

            s_level = "unknown";

            break;

    }

    fprintf( stderr, "%s [%s]: ", name, s_level );

    va_list arg;

    va_start( arg, fmt );

    vfprintf( stderr, fmt, arg );

    va_end( arg );

}

void x264_cli_printf( int i_level, const char *fmt, ... )

{

    if( i_level > cli_log_level )

        return;

    va_list arg;

    va_start( arg, fmt );

    vfprintf( stderr, fmt, arg );

    va_end( arg );

}

static void print_version_info()

{

#ifdef X264_POINTVER

    printf( "x264 "X264_POINTVER"\n" );

#else

    printf( "x264 0.%d.X\n", X264_BUILD );

#endif

    printf( "built on " __DATE__ ", " );

#ifdef __GNUC__

    printf( "gcc: " __VERSION__ "\n" );

#else

    printf( "using a non-gcc compiler\n" );

#endif

    printf( "configuration: --bit-depth=%d\n", x264_bit_depth );

    printf( "x264 license: " );

#if HAVE_GPL

    printf( "GPL version 2 or later\n" );

#else

    printf( "Non-GPL commercial\n" );

#endif

#if HAVE_LAVF

    const char *license = avformat_license();

    printf( "libavformat license: %s\n", license );

    if( !strcmp( license, "nonfree and unredistributable" ) ||

       (!HAVE_GPL && (!strcmp( license, "GPL version 2 or later" )

                  ||  !strcmp( license, "GPL version 3 or later" ))))

        printf( "WARNING: This binary is unredistributable!\n" );

#endif

}

int main( int argc, char **argv )

{

    x264_param_t param;

    cli_opt_t opt;

    int ret;

#if PTW32_STATIC_LIB

    pthread_win32_process_attach_np();

    pthread_win32_thread_attach_np();

#endif

#ifdef _WIN32

    _setmode(_fileno(stdin), _O_BINARY);

    _setmode(_fileno(stdout), _O_BINARY);

#endif

    /* Parse command line */

    if( parse( argc, argv, &param, &opt ) < 0 )

        return -1;

    /* Control-C handler */

    signal( SIGINT, sigint_handler );

    ret = encode( &param, &opt );

#if PTW32_STATIC_LIB

    pthread_win32_thread_detach_np();

    pthread_win32_process_detach_np();

#endif

    return ret;

}

static char const *strtable_lookup( const char * const table[], int idx )

{

    int i = 0; while( table[i] ) i++;

    return ( ( idx >= 0 && idx < i ) ? table[ idx ] : "???" );

}

static char *stringify_names( char *buf, const char * const names[] )

{

    int i = 0;

    char *p = buf;

    for( p[0] = 0; names[i]; i++ )

    {

        p += sprintf( p, "%s", names[i] );

        if( names[i+1] )

            p += sprintf( p, ", " );

    }

    return buf;

}

static void print_csp_names( int longhelp )

{

    if( longhelp < 2 )

        return;

#   define INDENT "                                "

    printf( "                              - valid csps for `raw' demuxer:\n" );

    printf( INDENT );

    for( int i = X264_CSP_NONE+1; i < X264_CSP_CLI_MAX; i++ )

    {

        printf( "%s", x264_cli_csps[i].name );

        if( i+1 < X264_CSP_CLI_MAX )

            printf( ", " );

    }

#if HAVE_LAVF

    printf( "\n" );

    printf( "                              - valid csps for `lavf' demuxer:\n" );

    printf( INDENT );

    int line_len = strlen( INDENT );

    for( enum PixelFormat i = PIX_FMT_NONE+1; i < PIX_FMT_NB; i++ )

    {

        const char *pfname = av_pix_fmt_descriptors[i].name;

        int name_len = strlen( pfname );

        if( line_len + name_len > (80 - strlen( ", " )) )

        {

            printf( "\n" INDENT );

            line_len = strlen( INDENT );

        }

        printf( "%s", pfname );

        line_len += name_len;

        if( i+1 < PIX_FMT_NB )

        {

            printf( ", " );

            line_len += 2;

        }

    }

#endif

    printf( "\n" );

}

static void help( x264_param_t *defaults, int longhelp )

{

    char buf[50];

#define H0 printf

#define H1 if(longhelp>=1) printf

#define H2 if(longhelp==2) printf

    H0( "x264 core:%d%s\n"

        "Syntax: x264 [options] -o outfile infile\n"

        "\n"

        "Infile can be raw (in which case resolution is required),\n"

        "  or YUV4MPEG (*.y4m),\n"

        "  or Avisynth if compiled with support (%s).\n"

        "  or libav* formats if compiled with lavf support (%s) or ffms support (%s).\n"

        "Outfile type is selected by filename:\n"

        " .264 -> Raw bytestream\n"

        " .mkv -> Matroska\n"

        " .flv -> Flash Video\n"

        " .mp4 -> MP4 if compiled with GPAC support (%s)\n"

        "Output bit depth: %d (configured at compile time)\n"

        "\n"

        "Options:\n"

        "\n"

        "  -h, --help                  List basic options\n"

        "      --longhelp              List more options\n"

        "      --fullhelp              List all options\n"

        "\n",

        X264_BUILD, X264_VERSION,

#if HAVE_AVS

        "yes",

#else

        "no",

#endif

#if HAVE_LAVF

        "yes",

#else

        "no",

#endif

#if HAVE_FFMS

        "yes",

#else

        "no",

#endif

#if HAVE_GPAC

        "yes",

#else

        "no",

#endif

        x264_bit_depth

      );

    H0( "Example usage:\n" );

    H0( "\n" );

    H0( "      Constant quality mode:\n" );

    H0( "            x264 --crf 24 -o <output> <input>\n" );

    H0( "\n" );

    H0( "      Two-pass with a bitrate of 1000kbps:\n" );

    H0( "            x264 --pass 1 --bitrate 1000 -o <output> <input>\n" );

    H0( "            x264 --pass 2 --bitrate 1000 -o <output> <input>\n" );

    H0( "\n" );

    H0( "      Lossless:\n" );

    H0( "            x264 --crf 0 -o <output> <input>\n" );

    H0( "\n" );

    H0( "      Maximum PSNR at the cost of speed and visual quality:\n" );

    H0( "            x264 --preset placebo --tune psnr -o <output> <input>\n" );

    H0( "\n" );

    H0( "      Constant bitrate at 1000kbps with a 2 second-buffer:\n");

    H0( "            x264 --vbv-bufsize 2000 --bitrate 1000 -o <output> <input>\n" );

    H0( "\n" );

    H0( "Presets:\n" );

    H0( "\n" );

    H0( "      --profile               Force the limits of an H.264 profile\n"

        "                                  Overrides all settings.\n" );

    H2( "                                  - baseline:\n"

        "                                    --no-8x8dct --bframes 0 --no-cabac\n"

        "                                    --cqm flat --weightp 0\n"

        "                                    No interlaced.\n"

        "                                    No lossless.\n"

        "                                  - main:\n"

        "                                    --no-8x8dct --cqm flat\n"

        "                                    No lossless.\n"

        "                                  - high:\n"

        "                                    No lossless.\n"

        "                                  - high10:\n"

        "                                    No lossless.\n"

        "                                    Support for bit depth 8-10.\n" );

        else H0( "                                  - baseline,main,high,high10\n" );

    H0( "      --preset                Use a preset to select encoding settings [medium]\n"

        "                                  Overridden by user settings.\n" );

    H2( "                                  - ultrafast:\n"

        "                                    --no-8x8dct --aq-mode 0 --b-adapt 0\n"

        "                                    --bframes 0 --no-cabac --no-deblock\n"

        "                                    --no-mbtree --me dia --no-mixed-refs\n"

        "                                    --partitions none --rc-lookahead 0 --ref 1\n"

        "                                    --scenecut 0 --subme 0 --trellis 0\n"

        "                                    --no-weightb --weightp 0\n"

        "                                  - superfast:\n"

        "                                    --no-mbtree --me dia --no-mixed-refs\n"

        "                                    --partitions i8x8,i4x4 --rc-lookahead 0\n"

        "                                    --ref 1 --subme 1 --trellis 0 --weightp 0\n"

        "                                  - veryfast:\n"

        "                                    --no-mixed-refs --rc-lookahead 10\n"

        "                                    --ref 1 --subme 2 --trellis 0 --weightp 0\n"

        "                                  - faster:\n"

        "                                    --no-mixed-refs --rc-lookahead 20\n"

        "                                    --ref 2 --subme 4 --weightp 1\n"

        "                                  - fast:\n"

        "                                    --rc-lookahead 30 --ref 2 --subme 6\n"

        "                                  - medium:\n"

        "                                    Default settings apply.\n"

        "                                  - slow:\n"

        "                                    --b-adapt 2 --direct auto --me umh\n"

        "                                    --rc-lookahead 50 --ref 5 --subme 8\n"

        "                                  - slower:\n"

        "                                    --b-adapt 2 --direct auto --me umh\n"

        "                                    --partitions all --rc-lookahead 60\n"

        "                                    --ref 8 --subme 9 --trellis 2\n"

        "                                  - veryslow:\n"

        "                                    --b-adapt 2 --bframes 8 --direct auto\n"

        "                                    --me umh --merange 24 --partitions all\n"

        "                                    --ref 16 --subme 10 --trellis 2\n"

        "                                    --rc-lookahead 60\n"

        "                                  - placebo:\n"

        "                                    --bframes 16 --b-adapt 2 --direct auto\n"

        "                                    --slow-firstpass --no-fast-pskip\n"

        "                                    --me tesa --merange 24 --partitions all\n"

        "                                    --rc-lookahead 60 --ref 16 --subme 10\n"

        "                                    --trellis 2\n" );

    else H0( "                                  - ultrafast,superfast,veryfast,faster,fast\n"

             "                                  - medium,slow,slower,veryslow,placebo\n" );

    H0( "      --tune                  Tune the settings for a particular type of source\n"

        "                              or situation\n"

        "                                  Overridden by user settings.\n"

        "                                  Multiple tunings are separated by commas.\n"

        "                                  Only one psy tuning can be used at a time.\n" );

    H2( "                                  - film (psy tuning):\n"

        "                                    --deblock -1:-1 --psy-rd <unset>:0.15\n"

        "                                  - animation (psy tuning):\n"

        "                                    --bframes {+2} --deblock 1:1\n"

        "                                    --psy-rd 0.4:<unset> --aq-strength 0.6\n"

        "                                    --ref {Double if >1 else 1}\n"

        "                                  - grain (psy tuning):\n"

        "                                    --aq-strength 0.5 --no-dct-decimate\n"

        "                                    --deadzone-inter 6 --deadzone-intra 6\n"

        "                                    --deblock -2:-2 --ipratio 1.1 \n"

        "                                    --pbratio 1.1 --psy-rd <unset>:0.25\n"

        "                                    --qcomp 0.8\n"

        "                                  - stillimage (psy tuning):\n"

        "                                    --aq-strength 1.2 --deblock -3:-3\n"

        "                                    --psy-rd 2.0:0.7\n"

        "                                  - psnr (psy tuning):\n"

        "                                    --aq-mode 0 --no-psy\n"

        "                                  - ssim (psy tuning):\n"

        "                                    --aq-mode 2 --no-psy\n"

        "                                  - fastdecode:\n"

        "                                    --no-cabac --no-deblock --no-weightb\n"

        "                                    --weightp 0\n"

        "                                  - zerolatency:\n"

        "                                    --bframes 0 --force-cfr --no-mbtree\n"

        "                                    --sync-lookahead 0 --sliced-threads\n"

        "                                    --rc-lookahead 0\n" );

    else H0( "                                  - psy tunings: film,animation,grain,\n"

             "                                                 stillimage,psnr,ssim\n"

             "                                  - other tunings: fastdecode,zerolatency\n" );

    H2( "      --slow-firstpass        Don't force these faster settings with --pass 1:\n"

        "                                  --no-8x8dct --me dia --partitions none\n"

        "                                  --ref 1 --subme {2 if >2 else unchanged}\n"

        "                                  --trellis 0 --fast-pskip\n" );

    else H1( "      --slow-firstpass        Don't force faster settings with --pass 1\n" );

    H0( "\n" );

    H0( "Frame-type options:\n" );

    H0( "\n" );

    H0( "  -I, --keyint <integer or \"infinite\"> Maximum GOP size [%d]\n", defaults->i_keyint_max );

    H2( "  -i, --min-keyint <integer>  Minimum GOP size [auto]\n" );

    H2( "      --no-scenecut           Disable adaptive I-frame decision\n" );

    H2( "      --scenecut <integer>    How aggressively to insert extra I-frames [%d]\n", defaults->i_scenecut_threshold );

    H2( "      --intra-refresh         Use Periodic Intra Refresh instead of IDR frames\n" );

    H1( "  -b, --bframes <integer>     Number of B-frames between I and P [%d]\n", defaults->i_bframe );

    H1( "      --b-adapt <integer>     Adaptive B-frame decision method [%d]\n"

        "                                  Higher values may lower threading efficiency.\n"

        "                                  - 0: Disabled\n"

        "                                  - 1: Fast\n"

        "                                  - 2: Optimal (slow with high --bframes)\n", defaults->i_bframe_adaptive );

    H2( "      --b-bias <integer>      Influences how often B-frames are used [%d]\n", defaults->i_bframe_bias );

    H1( "      --b-pyramid <string>    Keep some B-frames as references [%s]\n"

        "                                  - none: Disabled\n"

        "                                  - strict: Strictly hierarchical pyramid\n"

        "                                  - normal: Non-strict (not Blu-ray compatible)\n",

        strtable_lookup( x264_b_pyramid_names, defaults->i_bframe_pyramid ) );

    H1( "      --open-gop <string>     Use recovery points to close GOPs [none]\n"

        "                                  - none: closed GOPs only\n"

        "                                  - normal: standard open GOPs\n"

        "                                            (not Blu-ray compatible)\n"

        "                                  - bluray: Blu-ray-compatible open GOPs\n"

        "                              Only available with b-frames\n" );

    H1( "      --no-cabac              Disable CABAC\n" );

    H1( "  -r, --ref <integer>         Number of reference frames [%d]\n", defaults->i_frame_reference );

    H1( "      --no-deblock            Disable loop filter\n" );

    H1( "  -f, --deblock <alpha:beta>  Loop filter parameters [%d:%d]\n",

                                       defaults->i_deblocking_filter_alphac0, defaults->i_deblocking_filter_beta );

    H2( "      --slices <integer>      Number of slices per frame; forces rectangular\n"

        "                              slices and is overridden by other slicing options\n" );

    else H1( "      --slices <integer>      Number of slices per frame\n" );

    H2( "      --slice-max-size <integer> Limit the size of each slice in bytes\n");

    H2( "      --slice-max-mbs <integer> Limit the size of each slice in macroblocks\n");

    H0( "      --tff                   Enable interlaced mode (top field first)\n" );

    H0( "      --bff                   Enable interlaced mode (bottom field first)\n" );

    H2( "      --constrained-intra     Enable constrained intra prediction.\n" );

    H0( "      --pulldown <string>     Use soft pulldown to change frame rate\n"

        "                                  - none, 22, 32, 64, double, triple, euro (requires cfr input)\n" );

    H2( "      --fake-interlaced       Flag stream as interlaced but encode progressive.\n"

        "                              Makes it possible to encode 25p and 30p Blu-Ray\n"

        "                              streams. Ignored in interlaced mode.\n" );

    H0( "\n" );

    H0( "Ratecontrol:\n" );

    H0( "\n" );

    H1( "  -q, --qp <integer>          Force constant QP (0-%d, 0=lossless)\n", QP_MAX );

    H0( "  -B, --bitrate <integer>     Set bitrate (kbit/s)\n" );

    H0( "      --crf <float>           Quality-based VBR (0-%d, 0=lossless) [%.1f]\n", QP_MAX, defaults->rc.f_rf_constant );

    H1( "      --rc-lookahead <integer> Number of frames for frametype lookahead [%d]\n", defaults->rc.i_lookahead );

    H0( "      --vbv-maxrate <integer> Max local bitrate (kbit/s) [%d]\n", defaults->rc.i_vbv_max_bitrate );

    H0( "      --vbv-bufsize <integer> Set size of the VBV buffer (kbit) [%d]\n", defaults->rc.i_vbv_buffer_size );

    H2( "      --vbv-init <float>      Initial VBV buffer occupancy [%.1f]\n", defaults->rc.f_vbv_buffer_init );

    H2( "      --crf-max <float>       With CRF+VBV, limit RF to this value\n"

        "                                  May cause VBV underflows!\n" );

    H2( "      --qpmin <integer>       Set min QP [%d]\n", defaults->rc.i_qp_min );

    H2( "      --qpmax <integer>       Set max QP [%d]\n", defaults->rc.i_qp_max );

    H2( "      --qpstep <integer>      Set max QP step [%d]\n", defaults->rc.i_qp_step );

    H2( "      --ratetol <float>       Tolerance of ABR ratecontrol and VBV [%.1f]\n", defaults->rc.f_rate_tolerance );

    H2( "      --ipratio <float>       QP factor between I and P [%.2f]\n", defaults->rc.f_ip_factor );

    H2( "      --pbratio <float>       QP factor between P and B [%.2f]\n", defaults->rc.f_pb_factor );

    H2( "      --chroma-qp-offset <integer>  QP difference between chroma and luma [%d]\n", defaults->analyse.i_chroma_qp_offset );

    H2( "      --aq-mode <integer>     AQ method [%d]\n"

        "                                  - 0: Disabled\n"

        "                                  - 1: Variance AQ (complexity mask)\n"

        "                                  - 2: Auto-variance AQ (experimental)\n", defaults->rc.i_aq_mode );

    H1( "      --aq-strength <float>   Reduces blocking and blurring in flat and\n"

        "                              textured areas. [%.1f]\n", defaults->rc.f_aq_strength );

    H1( "\n" );

    H0( "  -p, --pass <integer>        Enable multipass ratecontrol\n"

        "                                  - 1: First pass, creates stats file\n"

        "                                  - 2: Last pass, does not overwrite stats file\n" );

    H2( "                                  - 3: Nth pass, overwrites stats file\n" );

    H1( "      --stats <string>        Filename for 2 pass stats [\"%s\"]\n", defaults->rc.psz_stat_out );

    H2( "      --no-mbtree             Disable mb-tree ratecontrol.\n");

    H2( "      --qcomp <float>         QP curve compression [%.2f]\n", defaults->rc.f_qcompress );

    H2( "      --cplxblur <float>      Reduce fluctuations in QP (before curve compression) [%.1f]\n", defaults->rc.f_complexity_blur );

    H2( "      --qblur <float>         Reduce fluctuations in QP (after curve compression) [%.1f]\n", defaults->rc.f_qblur );

    H2( "      --zones <zone0>/<zone1>/...  Tweak the bitrate of regions of the video\n" );

    H2( "                              Each zone is of the form\n"

        "                                  <start frame>,<end frame>,<option>\n"

        "                                  where <option> is either\n"

        "                                      q=<integer> (force QP)\n"

        "                                  or  b=<float> (bitrate multiplier)\n" );

    H2( "      --qpfile <string>       Force frametypes and QPs for some or all frames\n"

        "                              Format of each line: framenumber frametype QP\n"

        "                              QP of -1 lets x264 choose. Frametypes: I,i,K,P,B,b.\n"

        "                                  K=<I or i> depending on open-gop setting\n"

        "                              QPs are restricted by qpmin/qpmax.\n" );

    H1( "\n" );

    H1( "Analysis:\n" );

    H1( "\n" );

    H1( "  -A, --partitions <string>   Partitions to consider [\"p8x8,b8x8,i8x8,i4x4\"]\n"

        "                                  - p8x8, p4x4, b8x8, i8x8, i4x4\n"

        "                                  - none, all\n"

        "                                  (p4x4 requires p8x8. i8x8 requires --8x8dct.)\n" );

    H1( "      --direct <string>       Direct MV prediction mode [\"%s\"]\n"

        "                                  - none, spatial, temporal, auto\n",

                                       strtable_lookup( x264_direct_pred_names, defaults->analyse.i_direct_mv_pred ) );

    H2( "      --no-weightb            Disable weighted prediction for B-frames\n" );

    H1( "      --weightp <integer>     Weighted prediction for P-frames [%d]\n"

        "                                  - 0: Disabled\n"

        "                                  - 1: Blind offset\n"

        "                                  - 2: Smart analysis\n", defaults->analyse.i_weighted_pred );

    H1( "      --me <string>           Integer pixel motion estimation method [\"%s\"]\n",

                                       strtable_lookup( x264_motion_est_names, defaults->analyse.i_me_method ) );

    H2( "                                  - dia: diamond search, radius 1 (fast)\n"

        "                                  - hex: hexagonal search, radius 2\n"

        "                                  - umh: uneven multi-hexagon search\n"

        "                                  - esa: exhaustive search\n"

        "                                  - tesa: hadamard exhaustive search (slow)\n" );

    else H1( "                                  - dia, hex, umh\n" );

    H2( "      --merange <integer>     Maximum motion vector search range [%d]\n", defaults->analyse.i_me_range );

    H2( "      --mvrange <integer>     Maximum motion vector length [-1 (auto)]\n" );

    H2( "      --mvrange-thread <int>  Minimum buffer between threads [-1 (auto)]\n" );

    H1( "  -m, --subme <integer>       Subpixel motion estimation and mode decision [%d]\n", defaults->analyse.i_subpel_refine );

    H2( "                                  - 0: fullpel only (not recommended)\n"

        "                                  - 1: SAD mode decision, one qpel iteration\n"

        "                                  - 2: SATD mode decision\n"

        "                                  - 3-5: Progressively more qpel\n"

        "                                  - 6: RD mode decision for I/P-frames\n"

        "                                  - 7: RD mode decision for all frames\n"

        "                                  - 8: RD refinement for I/P-frames\n"

        "                                  - 9: RD refinement for all frames\n"

        "                                  - 10: QP-RD - requires trellis=2, aq-mode>0\n" );

    else H1( "                                  decision quality: 1=fast, 10=best.\n"  );

    H1( "      --psy-rd                Strength of psychovisual optimization [\"%.1f:%.1f\"]\n"

        "                                  #1: RD (requires subme>=6)\n"

        "                                  #2: Trellis (requires trellis, experimental)\n",

                                       defaults->analyse.f_psy_rd, defaults->analyse.f_psy_trellis );

    H2( "      --no-psy                Disable all visual optimizations that worsen\n"

        "                              both PSNR and SSIM.\n" );

    H2( "      --no-mixed-refs         Don't decide references on a per partition basis\n" );

    H2( "      --no-chroma-me          Ignore chroma in motion estimation\n" );

    H1( "      --no-8x8dct             Disable adaptive spatial transform size\n" );

    H1( "  -t, --trellis <integer>     Trellis RD quantization. [%d]\n"

        "                                  - 0: disabled\n"

        "                                  - 1: enabled only on the final encode of a MB\n"

        "                                  - 2: enabled on all mode decisions\n", defaults->analyse.i_trellis );

    H2( "      --no-fast-pskip         Disables early SKIP detection on P-frames\n" );

    H2( "      --no-dct-decimate       Disables coefficient thresholding on P-frames\n" );

    H1( "      --nr <integer>          Noise reduction [%d]\n", defaults->analyse.i_noise_reduction );

    H2( "\n" );

    H2( "      --deadzone-inter <int>  Set the size of the inter luma quantization deadzone [%d]\n", defaults->analyse.i_luma_deadzone[0] );

    H2( "      --deadzone-intra <int>  Set the size of the intra luma quantization deadzone [%d]\n", defaults->analyse.i_luma_deadzone[1] );

    H2( "                                  Deadzones should be in the range 0 - 32.\n" );

    H2( "      --cqm <string>          Preset quant matrices [\"flat\"]\n"

        "                                  - jvt, flat\n" );

    H1( "      --cqmfile <string>      Read custom quant matrices from a JM-compatible file\n" );

    H2( "                                  Overrides any other --cqm* options.\n" );

    H2( "      --cqm4 <list>           Set all 4x4 quant matrices\n"

        "                                  Takes a comma-separated list of 16 integers.\n" );

    H2( "      --cqm8 <list>           Set all 8x8 quant matrices\n"

        "                                  Takes a comma-separated list of 64 integers.\n" );

    H2( "      --cqm4i, --cqm4p, --cqm8i, --cqm8p\n"

        "                              Set both luma and chroma quant matrices\n" );

    H2( "      --cqm4iy, --cqm4ic, --cqm4py, --cqm4pc\n"

        "                              Set individual quant matrices\n" );

    H2( "\n" );

    H2( "Video Usability Info (Annex E):\n" );

    H2( "The VUI settings are not used by the encoder but are merely suggestions to\n" );

    H2( "the playback equipment. See doc/vui.txt for details. Use at your own risk.\n" );

    H2( "\n" );

    H2( "      --overscan <string>     Specify crop overscan setting [\"%s\"]\n"

        "                                  - undef, show, crop\n",

                                       strtable_lookup( x264_overscan_names, defaults->vui.i_overscan ) );

    H2( "      --videoformat <string>  Specify video format [\"%s\"]\n"

        "                                  - component, pal, ntsc, secam, mac, undef\n",

                                       strtable_lookup( x264_vidformat_names, defaults->vui.i_vidformat ) );

    H2( "      --fullrange <string>    Specify full range samples setting [\"%s\"]\n"

        "                                  - off, on\n",

                                       strtable_lookup( x264_fullrange_names, defaults->vui.b_fullrange ) );

    H2( "      --colorprim <string>    Specify color primaries [\"%s\"]\n"

        "                                  - undef, bt709, bt470m, bt470bg\n"

        "                                    smpte170m, smpte240m, film\n",

                                       strtable_lookup( x264_colorprim_names, defaults->vui.i_colorprim ) );

    H2( "      --transfer <string>     Specify transfer characteristics [\"%s\"]\n"

        "                                  - undef, bt709, bt470m, bt470bg, linear,\n"

        "                                    log100, log316, smpte170m, smpte240m\n",

                                       strtable_lookup( x264_transfer_names, defaults->vui.i_transfer ) );