Add tune for still image compression
[x262.git] / x264.c
1 /*****************************************************************************
2  * x264: h264 encoder testing program.
3  *****************************************************************************
4  * Copyright (C) 2003-2008 x264 project
5  *
6  * Authors: Loren Merritt <lorenm@u.washington.edu>
7  *          Laurent Aimar <fenrir@via.ecp.fr>
8  *          Steven Walters <kemuri9@gmail.com>
9  *          Kieran Kunhya <kieran@kunhya.com>
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111, USA.
24  *****************************************************************************/
25
26 #include <stdlib.h>
27 #include <math.h>
28
29 #include <signal.h>
30 #define _GNU_SOURCE
31 #include <getopt.h>
32
33 #include "common/common.h"
34 #include "common/cpu.h"
35 #include "x264.h"
36 #include "muxers.h"
37
38 #ifdef _WIN32
39 #include <windows.h>
40 #else
41 #define SetConsoleTitle(t)
42 #endif
43
44 /* Ctrl-C handler */
45 static int     b_ctrl_c = 0;
46 static int     b_exit_on_ctrl_c = 0;
47 static void    SigIntHandler( int a )
48 {
49     if( b_exit_on_ctrl_c )
50         exit(0);
51     b_ctrl_c = 1;
52 }
53
54 typedef struct {
55     int b_progress;
56     int i_seek;
57     hnd_t hin;
58     hnd_t hout;
59     FILE *qpfile;
60     FILE *tcfile_out;
61     double timebase_convert_multiplier;
62     int i_pulldown;
63 } cli_opt_t;
64
65 /* i/o file operation function pointer structs */
66 cli_input_t input;
67 static cli_output_t output;
68
69 static const char * const demuxer_names[] =
70 {
71     "auto",
72     "yuv",
73     "y4m",
74 #ifdef AVS_INPUT
75     "avs",
76 #endif
77 #ifdef LAVF_INPUT
78     "lavf",
79 #endif
80 #ifdef FFMS_INPUT
81     "ffms",
82 #endif
83     0
84 };
85
86 static const char * const muxer_names[] =
87 {
88     "auto",
89     "raw",
90     "mkv",
91     "flv",
92 #ifdef MP4_OUTPUT
93     "mp4",
94 #endif
95     0
96 };
97
98 static const char * const pulldown_names[] = { "none", "22", "32", "64", "double", "triple", "euro", 0 };
99
100 typedef struct{
101     int mod;
102     uint8_t pattern[24];
103     float fps_factor;
104 } cli_pulldown_t;
105
106 enum pulldown_type_e
107 {
108     X264_PULLDOWN_22 = 1,
109     X264_PULLDOWN_32,
110     X264_PULLDOWN_64,
111     X264_PULLDOWN_DOUBLE,
112     X264_PULLDOWN_TRIPLE,
113     X264_PULLDOWN_EURO
114 };
115
116 #define TB  PIC_STRUCT_TOP_BOTTOM
117 #define BT  PIC_STRUCT_BOTTOM_TOP
118 #define TBT PIC_STRUCT_TOP_BOTTOM_TOP
119 #define BTB PIC_STRUCT_BOTTOM_TOP_BOTTOM
120
121 static const cli_pulldown_t pulldown_values[] =
122 {
123     [X264_PULLDOWN_22]     = {1,  {TB},                                   2.0},
124     [X264_PULLDOWN_32]     = {4,  {TBT, BT, BTB, TB},                     1.25},
125     [X264_PULLDOWN_64]     = {2,  {PIC_STRUCT_DOUBLE, PIC_STRUCT_TRIPLE}, 1.0},
126     [X264_PULLDOWN_DOUBLE] = {1,  {PIC_STRUCT_DOUBLE},                    2.0},
127     [X264_PULLDOWN_TRIPLE] = {1,  {PIC_STRUCT_TRIPLE},                    3.0},
128     [X264_PULLDOWN_EURO]   = {24, {TBT, BT, BT, BT, BT, BT, BT, BT, BT, BT, BT, BT,
129                                    BTB, TB, TB, TB, TB, TB, TB, TB, TB, TB, TB, TB}, 25.0/24.0}
130 };
131
132 #undef TB
133 #undef BT
134 #undef TBT
135 #undef BTB
136
137 // indexed by pic_struct enum
138 static const float pulldown_frame_duration[10] = { 0.0, 1, 0.5, 0.5, 1, 1, 1.5, 1.5, 2, 3 };
139
140 static void Help( x264_param_t *defaults, int longhelp );
141 static int  Parse( int argc, char **argv, x264_param_t *param, cli_opt_t *opt );
142 static int  Encode( x264_param_t *param, cli_opt_t *opt );
143
144 /****************************************************************************
145  * main:
146  ****************************************************************************/
147 int main( int argc, char **argv )
148 {
149     x264_param_t param;
150     cli_opt_t opt;
151     int ret;
152
153 #ifdef PTW32_STATIC_LIB
154     pthread_win32_process_attach_np();
155     pthread_win32_thread_attach_np();
156 #endif
157
158 #ifdef _WIN32
159     _setmode(_fileno(stdin), _O_BINARY);
160     _setmode(_fileno(stdout), _O_BINARY);
161 #endif
162
163     /* Parse command line */
164     if( Parse( argc, argv, &param, &opt ) < 0 )
165         return -1;
166
167     /* Control-C handler */
168     signal( SIGINT, SigIntHandler );
169
170     ret = Encode( &param, &opt );
171
172 #ifdef PTW32_STATIC_LIB
173     pthread_win32_thread_detach_np();
174     pthread_win32_process_detach_np();
175 #endif
176
177     return ret;
178 }
179
180 static char const *strtable_lookup( const char * const table[], int index )
181 {
182     int i = 0; while( table[i] ) i++;
183     return ( ( index >= 0 && index < i ) ? table[ index ] : "???" );
184 }
185
186 static char *stringify_names( char *buf, const char * const names[] )
187 {
188     int i = 0;
189     char *p = buf;
190     for( p[0] = 0; names[i]; i++ )
191     {
192         p += sprintf( p, "%s", names[i] );
193         if( names[i+1] )
194             p += sprintf( p, ", " );
195     }
196     return buf;
197 }
198
199 /*****************************************************************************
200  * Help:
201  *****************************************************************************/
202 static void Help( x264_param_t *defaults, int longhelp )
203 {
204     char buf[50];
205 #define H0 printf
206 #define H1 if(longhelp>=1) printf
207 #define H2 if(longhelp==2) printf
208     H0( "x264 core:%d%s\n"
209         "Syntax: x264 [options] -o outfile infile [widthxheight]\n"
210         "\n"
211         "Infile can be raw YUV 4:2:0 (in which case resolution is required),\n"
212         "  or YUV4MPEG 4:2:0 (*.y4m),\n"
213         "  or Avisynth if compiled with support (%s).\n"
214         "  or libav* formats if compiled with lavf support (%s) or ffms support (%s).\n"
215         "Outfile type is selected by filename:\n"
216         " .264 -> Raw bytestream\n"
217         " .mkv -> Matroska\n"
218         " .flv -> Flash Video\n"
219         " .mp4 -> MP4 if compiled with GPAC support (%s)\n"
220         "\n"
221         "Options:\n"
222         "\n"
223         "  -h, --help                  List basic options\n"
224         "      --longhelp              List more options\n"
225         "      --fullhelp              List all options\n"
226         "\n",
227         X264_BUILD, X264_VERSION,
228 #ifdef AVS_INPUT
229         "yes",
230 #else
231         "no",
232 #endif
233 #ifdef LAVF_INPUT
234         "yes",
235 #else
236         "no",
237 #endif
238 #ifdef FFMS_INPUT
239         "yes",
240 #else
241         "no",
242 #endif
243 #ifdef MP4_OUTPUT
244         "yes"
245 #else
246         "no"
247 #endif
248       );
249     H0( "Example usage:\n" );
250     H0( "\n" );
251     H0( "      Constant quality mode:\n" );
252     H0( "            x264 --crf 24 -o <output> <input>\n" );
253     H0( "\n" );
254     H0( "      Two-pass with a bitrate of 1000kbps:\n" );
255     H0( "            x264 --pass 1 --bitrate 1000 -o <output> <input>\n" );
256     H0( "            x264 --pass 2 --bitrate 1000 -o <output> <input>\n" );
257     H0( "\n" );
258     H0( "      Lossless:\n" );
259     H0( "            x264 --crf 0 -o <output> <input>\n" );
260     H0( "\n" );
261     H0( "      Maximum PSNR at the cost of speed and visual quality:\n" );
262     H0( "            x264 --preset placebo --tune psnr -o <output> <input>\n" );
263     H0( "\n" );
264     H0( "      Constant bitrate at 1000kbps with a 2 second-buffer:\n");
265     H0( "            x264 --vbv-bufsize 2000 --bitrate 1000 -o <output> <input>\n" );
266     H0( "\n" );
267     H0( "Presets:\n" );
268     H0( "\n" );
269     H0( "      --profile               Force the limits of an H.264 profile [high]\n"
270         "                                  Overrides all settings.\n" );
271     H2( "                                  - baseline:\n"
272         "                                    --no-8x8dct --bframes 0 --no-cabac\n"
273         "                                    --cqm flat --weightp 0\n"
274         "                                    No interlaced.\n"
275         "                                    No lossless.\n"
276         "                                  - main:\n"
277         "                                    --no-8x8dct --cqm flat\n"
278         "                                    No lossless.\n"
279         "                                  - high:\n"
280         "                                    No lossless.\n" );
281         else H0( "                                  - baseline,main,high\n" );
282     H0( "      --preset                Use a preset to select encoding settings [medium]\n"
283         "                                  Overridden by user settings.\n" );
284     H2( "                                  - ultrafast:\n"
285         "                                    --no-8x8dct --aq-mode 0 --b-adapt 0\n"
286         "                                    --bframes 0 --no-cabac --no-deblock\n"
287         "                                    --no-mbtree --me dia --no-mixed-refs\n"
288         "                                    --partitions none --ref 1 --scenecut 0\n"
289         "                                    --subme 0 --trellis 0 --no-weightb\n"
290         "                                    --weightp 0\n"
291         "                                  - veryfast:\n"
292         "                                    --no-mbtree --me dia --no-mixed-refs\n"
293         "                                    --partitions i8x8,i4x4 --ref 1\n"
294         "                                    --subme 1 --trellis 0 --weightp 0\n"
295         "                                  - faster:\n"
296         "                                    --no-mbtree --no-mixed-refs --ref 2\n"
297         "                                    --subme 4 --weightp 1\n"
298         "                                  - fast:\n"
299         "                                    --rc-lookahead 30 --ref 2 --subme 6\n"
300         "                                  - medium:\n"
301         "                                    Default settings apply.\n"
302         "                                  - slow:\n"
303         "                                    --b-adapt 2 --direct auto --me umh\n"
304         "                                    --rc-lookahead 50 --ref 5 --subme 8\n"
305         "                                  - slower:\n"
306         "                                    --b-adapt 2 --direct auto --me umh\n"
307         "                                    --partitions all --rc-lookahead 60\n"
308         "                                    --ref 8 --subme 9 --trellis 2\n"
309         "                                  - veryslow:\n"
310         "                                    --b-adapt 2 --bframes 8 --direct auto\n"
311         "                                    --me umh --merange 24 --partitions all\n"
312         "                                    --ref 16 --subme 10 --trellis 2\n"
313         "                                    --rc-lookahead 60\n"
314         "                                  - placebo:\n"
315         "                                    --bframes 16 --b-adapt 2 --direct auto\n"
316         "                                    --slow-firstpass --no-fast-pskip\n"
317         "                                    --me tesa --merange 24 --partitions all\n"
318         "                                    --rc-lookahead 60 --ref 16 --subme 10\n"
319         "                                    --trellis 2\n" );
320     else H0( "                                  - ultrafast,veryfast,faster,fast,medium\n"
321              "                                  - slow,slower,veryslow,placebo\n" );
322     H0( "      --tune                  Tune the settings for a particular type of source\n"
323         "                              or situation\n"
324         "                                  Overridden by user settings.\n"
325         "                                  Multiple tunings are separated by commas.\n"
326         "                                  Only one psy tuning can be used at a time.\n" );
327     H2( "                                  - film (psy tuning):\n"
328         "                                    --deblock -1:-1 --psy-rd <unset>:0.15\n"
329         "                                  - animation (psy tuning):\n"
330         "                                    --bframes {+2} --deblock 1:1\n"
331         "                                    --psy-rd 0.4:<unset> --aq-strength 0.6\n"
332         "                                    --ref {Double if >1 else 1}\n"
333         "                                  - grain (psy tuning):\n"
334         "                                    --aq-strength 0.5 --no-dct-decimate\n"
335         "                                    --deadzone-inter 6 --deadzone-intra 6\n"
336         "                                    --deblock -2:-2 --ipratio 1.1 \n"
337         "                                    --pbratio 1.1 --psy-rd <unset>:0.25\n"
338         "                                    --qcomp 0.8\n"
339         "                                  - stillimage (psy tuning):\n"
340         "                                    --aq-strength 1.2 --deblock -3:-3\n"
341         "                                    --psy-rd 2.0:0.7\n"
342         "                                  - psnr (psy tuning):\n"
343         "                                    --aq-mode 0 --no-psy\n"
344         "                                  - ssim (psy tuning):\n"
345         "                                    --aq-mode 2 --no-psy\n"
346         "                                  - fastdecode:\n"
347         "                                    --no-cabac --no-deblock --no-weightb\n"
348         "                                    --weightp 0\n"
349         "                                  - zerolatency:\n"
350         "                                    --bframes 0 --force-cfr --rc-lookahead 0\n"
351         "                                    --sync-lookahead 0 --sliced-threads\n" );
352     else H0( "                                  - psy tunings: film,animation,grain,\n"
353              "                                                 stillimage,psnr,ssim\n"
354              "                                  - other tunings: fastdecode,zerolatency\n" );
355     H2( "      --slow-firstpass        Don't force these faster settings with --pass 1:\n"
356         "                                  --no-8x8dct --me dia --partitions none --ref 1\n"
357         "                                  --subme {2 if >2 else unchanged} --trellis 0\n" );
358     else H1( "      --slow-firstpass        Don't force faster settings with --pass 1\n" );
359     H0( "\n" );
360     H0( "Frame-type options:\n" );
361     H0( "\n" );
362     H0( "  -I, --keyint <integer>      Maximum GOP size [%d]\n", defaults->i_keyint_max );
363     H2( "  -i, --min-keyint <integer>  Minimum GOP size [%d]\n", defaults->i_keyint_min );
364     H2( "      --no-scenecut           Disable adaptive I-frame decision\n" );
365     H2( "      --scenecut <integer>    How aggressively to insert extra I-frames [%d]\n", defaults->i_scenecut_threshold );
366     H2( "      --intra-refresh         Use Periodic Intra Refresh instead of IDR frames\n" );
367     H1( "  -b, --bframes <integer>     Number of B-frames between I and P [%d]\n", defaults->i_bframe );
368     H1( "      --b-adapt <integer>     Adaptive B-frame decision method [%d]\n"
369         "                                  Higher values may lower threading efficiency.\n"
370         "                                  - 0: Disabled\n"
371         "                                  - 1: Fast\n"
372         "                                  - 2: Optimal (slow with high --bframes)\n", defaults->i_bframe_adaptive );
373     H2( "      --b-bias <integer>      Influences how often B-frames are used [%d]\n", defaults->i_bframe_bias );
374     H1( "      --b-pyramid <string>    Keep some B-frames as references [%s]\n"
375         "                                  - none: Disabled\n"
376         "                                  - strict: Strictly hierarchical pyramid\n"
377         "                                  - normal: Non-strict (not Blu-ray compatible)\n",
378         strtable_lookup( x264_b_pyramid_names, defaults->i_bframe_pyramid ) );
379     H1( "      --no-cabac              Disable CABAC\n" );
380     H1( "  -r, --ref <integer>         Number of reference frames [%d]\n", defaults->i_frame_reference );
381     H1( "      --no-deblock            Disable loop filter\n" );
382     H1( "  -f, --deblock <alpha:beta>  Loop filter parameters [%d:%d]\n",
383                                        defaults->i_deblocking_filter_alphac0, defaults->i_deblocking_filter_beta );
384     H2( "      --slices <integer>      Number of slices per frame; forces rectangular\n"
385         "                              slices and is overridden by other slicing options\n" );
386     else H1( "      --slices <integer>      Number of slices per frame\n" );
387     H2( "      --slice-max-size <integer> Limit the size of each slice in bytes\n");
388     H2( "      --slice-max-mbs <integer> Limit the size of each slice in macroblocks\n");
389     H0( "      --tff                   Enable interlaced mode (top field first)\n" );
390     H0( "      --bff                   Enable interlaced mode (bottom field first)\n" );
391     H2( "      --constrained-intra     Enable constrained intra prediction.\n" );
392     H0( "\n" );
393     H0( "Ratecontrol:\n" );
394     H0( "\n" );
395     H1( "  -q, --qp <integer>          Force constant QP (0-51, 0=lossless)\n" );
396     H0( "  -B, --bitrate <integer>     Set bitrate (kbit/s)\n" );
397     H0( "      --crf <float>           Quality-based VBR (0-51, 0=lossless) [%.1f]\n", defaults->rc.f_rf_constant );
398     H1( "      --rc-lookahead <integer> Number of frames for frametype lookahead [%d]\n", defaults->rc.i_lookahead );
399     H0( "      --vbv-maxrate <integer> Max local bitrate (kbit/s) [%d]\n", defaults->rc.i_vbv_max_bitrate );
400     H0( "      --vbv-bufsize <integer> Set size of the VBV buffer (kbit) [%d]\n", defaults->rc.i_vbv_buffer_size );
401     H2( "      --vbv-init <float>      Initial VBV buffer occupancy [%.1f]\n", defaults->rc.f_vbv_buffer_init );
402     H2( "      --crf-max <float>       With CRF+VBV, limit RF to this value\n"
403         "                                  May cause VBV underflows!\n" );
404     H2( "      --qpmin <integer>       Set min QP [%d]\n", defaults->rc.i_qp_min );
405     H2( "      --qpmax <integer>       Set max QP [%d]\n", defaults->rc.i_qp_max );
406     H2( "      --qpstep <integer>      Set max QP step [%d]\n", defaults->rc.i_qp_step );
407     H2( "      --ratetol <float>       Tolerance of ABR ratecontrol and VBV [%.1f]\n", defaults->rc.f_rate_tolerance );
408     H2( "      --ipratio <float>       QP factor between I and P [%.2f]\n", defaults->rc.f_ip_factor );
409     H2( "      --pbratio <float>       QP factor between P and B [%.2f]\n", defaults->rc.f_pb_factor );
410     H2( "      --chroma-qp-offset <integer>  QP difference between chroma and luma [%d]\n", defaults->analyse.i_chroma_qp_offset );
411     H2( "      --aq-mode <integer>     AQ method [%d]\n"
412         "                                  - 0: Disabled\n"
413         "                                  - 1: Variance AQ (complexity mask)\n"
414         "                                  - 2: Auto-variance AQ (experimental)\n", defaults->rc.i_aq_mode );
415     H1( "      --aq-strength <float>   Reduces blocking and blurring in flat and\n"
416         "                              textured areas. [%.1f]\n", defaults->rc.f_aq_strength );
417     H1( "\n" );
418     H0( "  -p, --pass <integer>        Enable multipass ratecontrol\n"
419         "                                  - 1: First pass, creates stats file\n"
420         "                                  - 2: Last pass, does not overwrite stats file\n" );
421     H2( "                                  - 3: Nth pass, overwrites stats file\n" );
422     H1( "      --stats <string>        Filename for 2 pass stats [\"%s\"]\n", defaults->rc.psz_stat_out );
423     H2( "      --no-mbtree             Disable mb-tree ratecontrol.\n");
424     H2( "      --qcomp <float>         QP curve compression [%.2f]\n", defaults->rc.f_qcompress );
425     H2( "      --cplxblur <float>      Reduce fluctuations in QP (before curve compression) [%.1f]\n", defaults->rc.f_complexity_blur );
426     H2( "      --qblur <float>         Reduce fluctuations in QP (after curve compression) [%.1f]\n", defaults->rc.f_qblur );
427     H2( "      --zones <zone0>/<zone1>/...  Tweak the bitrate of regions of the video\n" );
428     H2( "                              Each zone is of the form\n"
429         "                                  <start frame>,<end frame>,<option>\n"
430         "                                  where <option> is either\n"
431         "                                      q=<integer> (force QP)\n"
432         "                                  or  b=<float> (bitrate multiplier)\n" );
433     H2( "      --qpfile <string>       Force frametypes and QPs for some or all frames\n"
434         "                              Format of each line: framenumber frametype QP\n"
435         "                              QP of -1 lets x264 choose. Frametypes: I,i,P,B,b.\n"
436         "                              QPs are restricted by qpmin/qpmax.\n" );
437     H1( "\n" );
438     H1( "Analysis:\n" );
439     H1( "\n" );
440     H1( "  -A, --partitions <string>   Partitions to consider [\"p8x8,b8x8,i8x8,i4x4\"]\n"
441         "                                  - p8x8, p4x4, b8x8, i8x8, i4x4\n"
442         "                                  - none, all\n"
443         "                                  (p4x4 requires p8x8. i8x8 requires --8x8dct.)\n" );
444     H1( "      --direct <string>       Direct MV prediction mode [\"%s\"]\n"
445         "                                  - none, spatial, temporal, auto\n",
446                                        strtable_lookup( x264_direct_pred_names, defaults->analyse.i_direct_mv_pred ) );
447     H2( "      --no-weightb            Disable weighted prediction for B-frames\n" );
448     H1( "      --weightp <integer>     Weighted prediction for P-frames [%d]\n"
449         "                                  - 0: Disabled\n"
450         "                                  - 1: Blind offset\n"
451         "                                  - 2: Smart analysis\n", defaults->analyse.i_weighted_pred );
452     H1( "      --me <string>           Integer pixel motion estimation method [\"%s\"]\n",
453                                        strtable_lookup( x264_motion_est_names, defaults->analyse.i_me_method ) );
454     H2( "                                  - dia: diamond search, radius 1 (fast)\n"
455         "                                  - hex: hexagonal search, radius 2\n"
456         "                                  - umh: uneven multi-hexagon search\n"
457         "                                  - esa: exhaustive search\n"
458         "                                  - tesa: hadamard exhaustive search (slow)\n" );
459     else H1( "                                  - dia, hex, umh\n" );
460     H2( "      --merange <integer>     Maximum motion vector search range [%d]\n", defaults->analyse.i_me_range );
461     H2( "      --mvrange <integer>     Maximum motion vector length [-1 (auto)]\n" );
462     H2( "      --mvrange-thread <int>  Minimum buffer between threads [-1 (auto)]\n" );
463     H1( "  -m, --subme <integer>       Subpixel motion estimation and mode decision [%d]\n", defaults->analyse.i_subpel_refine );
464     H2( "                                  - 0: fullpel only (not recommended)\n"
465         "                                  - 1: SAD mode decision, one qpel iteration\n"
466         "                                  - 2: SATD mode decision\n"
467         "                                  - 3-5: Progressively more qpel\n"
468         "                                  - 6: RD mode decision for I/P-frames\n"
469         "                                  - 7: RD mode decision for all frames\n"
470         "                                  - 8: RD refinement for I/P-frames\n"
471         "                                  - 9: RD refinement for all frames\n"
472         "                                  - 10: QP-RD - requires trellis=2, aq-mode>0\n" );
473     else H1( "                                  decision quality: 1=fast, 10=best.\n"  );
474     H1( "      --psy-rd                Strength of psychovisual optimization [\"%.1f:%.1f\"]\n"
475         "                                  #1: RD (requires subme>=6)\n"
476         "                                  #2: Trellis (requires trellis, experimental)\n",
477                                        defaults->analyse.f_psy_rd, defaults->analyse.f_psy_trellis );
478     H2( "      --no-psy                Disable all visual optimizations that worsen\n"
479         "                              both PSNR and SSIM.\n" );
480     H2( "      --no-mixed-refs         Don't decide references on a per partition basis\n" );
481     H2( "      --no-chroma-me          Ignore chroma in motion estimation\n" );
482     H1( "      --no-8x8dct             Disable adaptive spatial transform size\n" );
483     H1( "  -t, --trellis <integer>     Trellis RD quantization. Requires CABAC. [%d]\n"
484         "                                  - 0: disabled\n"
485         "                                  - 1: enabled only on the final encode of a MB\n"
486         "                                  - 2: enabled on all mode decisions\n", defaults->analyse.i_trellis );
487     H2( "      --no-fast-pskip         Disables early SKIP detection on P-frames\n" );
488     H2( "      --no-dct-decimate       Disables coefficient thresholding on P-frames\n" );
489     H1( "      --nr <integer>          Noise reduction [%d]\n", defaults->analyse.i_noise_reduction );
490     H2( "\n" );
491     H2( "      --deadzone-inter <int>  Set the size of the inter luma quantization deadzone [%d]\n", defaults->analyse.i_luma_deadzone[0] );
492     H2( "      --deadzone-intra <int>  Set the size of the intra luma quantization deadzone [%d]\n", defaults->analyse.i_luma_deadzone[1] );
493     H2( "                                  Deadzones should be in the range 0 - 32.\n" );
494     H2( "      --cqm <string>          Preset quant matrices [\"flat\"]\n"
495         "                                  - jvt, flat\n" );
496     H1( "      --cqmfile <string>      Read custom quant matrices from a JM-compatible file\n" );
497     H2( "                                  Overrides any other --cqm* options.\n" );
498     H2( "      --cqm4 <list>           Set all 4x4 quant matrices\n"
499         "                                  Takes a comma-separated list of 16 integers.\n" );
500     H2( "      --cqm8 <list>           Set all 8x8 quant matrices\n"
501         "                                  Takes a comma-separated list of 64 integers.\n" );
502     H2( "      --cqm4i, --cqm4p, --cqm8i, --cqm8p\n"
503         "                              Set both luma and chroma quant matrices\n" );
504     H2( "      --cqm4iy, --cqm4ic, --cqm4py, --cqm4pc\n"
505         "                              Set individual quant matrices\n" );
506     H2( "\n" );
507     H2( "Video Usability Info (Annex E):\n" );
508     H2( "The VUI settings are not used by the encoder but are merely suggestions to\n" );
509     H2( "the playback equipment. See doc/vui.txt for details. Use at your own risk.\n" );
510     H2( "\n" );
511     H2( "      --overscan <string>     Specify crop overscan setting [\"%s\"]\n"
512         "                                  - undef, show, crop\n",
513                                        strtable_lookup( x264_overscan_names, defaults->vui.i_overscan ) );
514     H2( "      --videoformat <string>  Specify video format [\"%s\"]\n"
515         "                                  - component, pal, ntsc, secam, mac, undef\n",
516                                        strtable_lookup( x264_vidformat_names, defaults->vui.i_vidformat ) );
517     H2( "      --fullrange <string>    Specify full range samples setting [\"%s\"]\n"
518         "                                  - off, on\n",
519                                        strtable_lookup( x264_fullrange_names, defaults->vui.b_fullrange ) );
520     H2( "      --colorprim <string>    Specify color primaries [\"%s\"]\n"
521         "                                  - undef, bt709, bt470m, bt470bg\n"
522         "                                    smpte170m, smpte240m, film\n",
523                                        strtable_lookup( x264_colorprim_names, defaults->vui.i_colorprim ) );
524     H2( "      --transfer <string>     Specify transfer characteristics [\"%s\"]\n"
525         "                                  - undef, bt709, bt470m, bt470bg, linear,\n"
526         "                                    log100, log316, smpte170m, smpte240m\n",
527                                        strtable_lookup( x264_transfer_names, defaults->vui.i_transfer ) );
528     H2( "      --colormatrix <string>  Specify color matrix setting [\"%s\"]\n"
529         "                                  - undef, bt709, fcc, bt470bg\n"
530         "                                    smpte170m, smpte240m, GBR, YCgCo\n",
531                                        strtable_lookup( x264_colmatrix_names, defaults->vui.i_colmatrix ) );
532     H2( "      --chromaloc <integer>   Specify chroma sample location (0 to 5) [%d]\n",
533                                        defaults->vui.i_chroma_loc );
534
535     H2( "      --nal-hrd <string>      Signal HRD information (requires vbv-bufsize)\n"
536         "                                  - none, vbr, cbr (cbr not allowed in .mp4)\n" );
537     H2( "      --pic-struct            Force pic_struct in Picture Timing SEI\n" );
538
539     H0( "\n" );
540     H0( "Input/Output:\n" );
541     H0( "\n" );
542     H0( "  -o, --output                Specify output file\n" );
543     H1( "      --muxer <string>        Specify output container format [\"%s\"]\n"
544         "                                  - %s\n", muxer_names[0], stringify_names( buf, muxer_names ) );
545     H1( "      --demuxer <string>      Specify input container format [\"%s\"]\n"
546         "                                  - %s\n", demuxer_names[0], stringify_names( buf, demuxer_names ) );
547     H1( "      --index <string>        Filename for input index file\n" );
548     H0( "      --sar width:height      Specify Sample Aspect Ratio\n" );
549     H0( "      --fps <float|rational>  Specify framerate\n" );
550     H0( "      --seek <integer>        First frame to encode\n" );
551     H0( "      --frames <integer>      Maximum number of frames to encode\n" );
552     H0( "      --level <string>        Specify level (as defined by Annex A)\n" );
553     H1( "\n" );
554     H1( "  -v, --verbose               Print stats for each frame\n" );
555     H1( "      --no-progress           Don't show the progress indicator while encoding\n" );
556     H0( "      --quiet                 Quiet Mode\n" );
557     H1( "      --psnr                  Enable PSNR computation\n" );
558     H1( "      --ssim                  Enable SSIM computation\n" );
559     H1( "      --threads <integer>     Force a specific number of threads\n" );
560     H2( "      --sliced-threads        Low-latency but lower-efficiency threading\n" );
561     H2( "      --thread-input          Run Avisynth in its own thread\n" );
562     H2( "      --sync-lookahead <integer> Number of buffer frames for threaded lookahead\n" );
563     H2( "      --non-deterministic     Slightly improve quality of SMP, at the cost of repeatability\n" );
564     H2( "      --asm <integer>         Override CPU detection\n" );
565     H2( "      --no-asm                Disable all CPU optimizations\n" );
566     H2( "      --visualize             Show MB types overlayed on the encoded video\n" );
567     H2( "      --dump-yuv <string>     Save reconstructed frames\n" );
568     H2( "      --sps-id <integer>      Set SPS and PPS id numbers [%d]\n", defaults->i_sps_id );
569     H2( "      --aud                   Use access unit delimiters\n" );
570     H2( "      --force-cfr             Force constant framerate timestamp generation\n" );
571     H2( "      --tcfile-in <string>    Force timestamp generation with timecode file\n" );
572     H2( "      --tcfile-out <string>   Output timecode v2 file from input timestamps\n" );
573     H2( "      --timebase <int/int>    Specify timebase numerator and denominator\n"
574         "                 <integer>    Specify timebase numerator for input timecode file\n"
575         "                              or specify timebase denominator for other input\n" );
576     H0( "      --pulldown <string>     Use soft pulldown to change frame rate\n"
577         "                                  - none, 22, 32, 64, double, triple, euro (requires cfr input)\n" );
578     H0( "\n" );
579 }
580
581 #define OPT_FRAMES 256
582 #define OPT_SEEK 257
583 #define OPT_QPFILE 258
584 #define OPT_THREAD_INPUT 259
585 #define OPT_QUIET 260
586 #define OPT_NOPROGRESS 261
587 #define OPT_VISUALIZE 262
588 #define OPT_LONGHELP 263
589 #define OPT_PROFILE 264
590 #define OPT_PRESET 265
591 #define OPT_TUNE 266
592 #define OPT_SLOWFIRSTPASS 267
593 #define OPT_FULLHELP 268
594 #define OPT_FPS 269
595 #define OPT_MUXER 270
596 #define OPT_DEMUXER 271
597 #define OPT_INDEX 272
598 #define OPT_INTERLACED 273
599 #define OPT_TCFILE_IN 274
600 #define OPT_TCFILE_OUT 275
601 #define OPT_TIMEBASE 276
602 #define OPT_PULLDOWN 277
603
604 static char short_options[] = "8A:B:b:f:hI:i:m:o:p:q:r:t:Vvw";
605 static struct option long_options[] =
606 {
607     { "help",              no_argument, NULL, 'h' },
608     { "longhelp",          no_argument, NULL, OPT_LONGHELP },
609     { "fullhelp",          no_argument, NULL, OPT_FULLHELP },
610     { "version",           no_argument, NULL, 'V' },
611     { "profile",     required_argument, NULL, OPT_PROFILE },
612     { "preset",      required_argument, NULL, OPT_PRESET },
613     { "tune",        required_argument, NULL, OPT_TUNE },
614     { "slow-firstpass",    no_argument, NULL, OPT_SLOWFIRSTPASS },
615     { "bitrate",     required_argument, NULL, 'B' },
616     { "bframes",     required_argument, NULL, 'b' },
617     { "b-adapt",     required_argument, NULL, 0 },
618     { "no-b-adapt",        no_argument, NULL, 0 },
619     { "b-bias",      required_argument, NULL, 0 },
620     { "b-pyramid",   required_argument, NULL, 0 },
621     { "min-keyint",  required_argument, NULL, 'i' },
622     { "keyint",      required_argument, NULL, 'I' },
623     { "intra-refresh",     no_argument, NULL, 0 },
624     { "scenecut",    required_argument, NULL, 0 },
625     { "no-scenecut",       no_argument, NULL, 0 },
626     { "nf",                no_argument, NULL, 0 },
627     { "no-deblock",        no_argument, NULL, 0 },
628     { "filter",      required_argument, NULL, 0 },
629     { "deblock",     required_argument, NULL, 'f' },
630     { "interlaced",        no_argument, NULL, OPT_INTERLACED },
631     { "tff",               no_argument, NULL, OPT_INTERLACED },
632     { "bff",               no_argument, NULL, OPT_INTERLACED },
633     { "no-interlaced",     no_argument, NULL, OPT_INTERLACED },
634     { "constrained-intra", no_argument, NULL, 0 },
635     { "cabac",             no_argument, NULL, 0 },
636     { "no-cabac",          no_argument, NULL, 0 },
637     { "qp",          required_argument, NULL, 'q' },
638     { "qpmin",       required_argument, NULL, 0 },
639     { "qpmax",       required_argument, NULL, 0 },
640     { "qpstep",      required_argument, NULL, 0 },
641     { "crf",         required_argument, NULL, 0 },
642     { "rc-lookahead",required_argument, NULL, 0 },
643     { "ref",         required_argument, NULL, 'r' },
644     { "asm",         required_argument, NULL, 0 },
645     { "no-asm",            no_argument, NULL, 0 },
646     { "sar",         required_argument, NULL, 0 },
647     { "fps",         required_argument, NULL, OPT_FPS },
648     { "frames",      required_argument, NULL, OPT_FRAMES },
649     { "seek",        required_argument, NULL, OPT_SEEK },
650     { "output",      required_argument, NULL, 'o' },
651     { "muxer",       required_argument, NULL, OPT_MUXER },
652     { "demuxer",     required_argument, NULL, OPT_DEMUXER },
653     { "stdout",      required_argument, NULL, OPT_MUXER },
654     { "stdin",       required_argument, NULL, OPT_DEMUXER },
655     { "index",       required_argument, NULL, OPT_INDEX },
656     { "analyse",     required_argument, NULL, 0 },
657     { "partitions",  required_argument, NULL, 'A' },
658     { "direct",      required_argument, NULL, 0 },
659     { "weightb",           no_argument, NULL, 'w' },
660     { "no-weightb",        no_argument, NULL, 0 },
661     { "weightp",     required_argument, NULL, 0 },
662     { "me",          required_argument, NULL, 0 },
663     { "merange",     required_argument, NULL, 0 },
664     { "mvrange",     required_argument, NULL, 0 },
665     { "mvrange-thread", required_argument, NULL, 0 },
666     { "subme",       required_argument, NULL, 'm' },
667     { "psy-rd",      required_argument, NULL, 0 },
668     { "no-psy",            no_argument, NULL, 0 },
669     { "psy",               no_argument, NULL, 0 },
670     { "mixed-refs",        no_argument, NULL, 0 },
671     { "no-mixed-refs",     no_argument, NULL, 0 },
672     { "no-chroma-me",      no_argument, NULL, 0 },
673     { "8x8dct",            no_argument, NULL, 0 },
674     { "no-8x8dct",         no_argument, NULL, 0 },
675     { "trellis",     required_argument, NULL, 't' },
676     { "fast-pskip",        no_argument, NULL, 0 },
677     { "no-fast-pskip",     no_argument, NULL, 0 },
678     { "no-dct-decimate",   no_argument, NULL, 0 },
679     { "aq-strength", required_argument, NULL, 0 },
680     { "aq-mode",     required_argument, NULL, 0 },
681     { "deadzone-inter", required_argument, NULL, '0' },
682     { "deadzone-intra", required_argument, NULL, '0' },
683     { "level",       required_argument, NULL, 0 },
684     { "ratetol",     required_argument, NULL, 0 },
685     { "vbv-maxrate", required_argument, NULL, 0 },
686     { "vbv-bufsize", required_argument, NULL, 0 },
687     { "vbv-init",    required_argument, NULL, 0 },
688     { "crf-max",     required_argument, NULL, 0 },
689     { "ipratio",     required_argument, NULL, 0 },
690     { "pbratio",     required_argument, NULL, 0 },
691     { "chroma-qp-offset", required_argument, NULL, 0 },
692     { "pass",        required_argument, NULL, 'p' },
693     { "stats",       required_argument, NULL, 0 },
694     { "qcomp",       required_argument, NULL, 0 },
695     { "mbtree",            no_argument, NULL, 0 },
696     { "no-mbtree",         no_argument, NULL, 0 },
697     { "qblur",       required_argument, NULL, 0 },
698     { "cplxblur",    required_argument, NULL, 0 },
699     { "zones",       required_argument, NULL, 0 },
700     { "qpfile",      required_argument, NULL, OPT_QPFILE },
701     { "threads",     required_argument, NULL, 0 },
702     { "sliced-threads",    no_argument, NULL, 0 },
703     { "no-sliced-threads", no_argument, NULL, 0 },
704     { "slice-max-size",    required_argument, NULL, 0 },
705     { "slice-max-mbs",     required_argument, NULL, 0 },
706     { "slices",            required_argument, NULL, 0 },
707     { "thread-input",      no_argument, NULL, OPT_THREAD_INPUT },
708     { "sync-lookahead",    required_argument, NULL, 0 },
709     { "non-deterministic", no_argument, NULL, 0 },
710     { "psnr",              no_argument, NULL, 0 },
711     { "ssim",              no_argument, NULL, 0 },
712     { "quiet",             no_argument, NULL, OPT_QUIET },
713     { "verbose",           no_argument, NULL, 'v' },
714     { "no-progress",       no_argument, NULL, OPT_NOPROGRESS },
715     { "visualize",         no_argument, NULL, OPT_VISUALIZE },
716     { "dump-yuv",    required_argument, NULL, 0 },
717     { "sps-id",      required_argument, NULL, 0 },
718     { "aud",               no_argument, NULL, 0 },
719     { "nr",          required_argument, NULL, 0 },
720     { "cqm",         required_argument, NULL, 0 },
721     { "cqmfile",     required_argument, NULL, 0 },
722     { "cqm4",        required_argument, NULL, 0 },
723     { "cqm4i",       required_argument, NULL, 0 },
724     { "cqm4iy",      required_argument, NULL, 0 },
725     { "cqm4ic",      required_argument, NULL, 0 },
726     { "cqm4p",       required_argument, NULL, 0 },
727     { "cqm4py",      required_argument, NULL, 0 },
728     { "cqm4pc",      required_argument, NULL, 0 },
729     { "cqm8",        required_argument, NULL, 0 },
730     { "cqm8i",       required_argument, NULL, 0 },
731     { "cqm8p",       required_argument, NULL, 0 },
732     { "overscan",    required_argument, NULL, 0 },
733     { "videoformat", required_argument, NULL, 0 },
734     { "fullrange",   required_argument, NULL, 0 },
735     { "colorprim",   required_argument, NULL, 0 },
736     { "transfer",    required_argument, NULL, 0 },
737     { "colormatrix", required_argument, NULL, 0 },
738     { "chromaloc",   required_argument, NULL, 0 },
739     { "force-cfr",         no_argument, NULL, 0 },
740     { "tcfile-in",   required_argument, NULL, OPT_TCFILE_IN },
741     { "tcfile-out",  required_argument, NULL, OPT_TCFILE_OUT },
742     { "timebase",    required_argument, NULL, OPT_TIMEBASE },
743     { "pic-struct",        no_argument, NULL, 0 },
744     { "nal-hrd",     required_argument, NULL, 0 },
745     { "pulldown",    required_argument, NULL, OPT_PULLDOWN },
746     {0, 0, 0, 0}
747 };
748
749 static int select_output( const char *muxer, char *filename, x264_param_t *param )
750 {
751     const char *ext = get_filename_extension( filename );
752     if( !strcmp( filename, "-" ) || strcasecmp( muxer, "auto" ) )
753         ext = muxer;
754
755     if( !strcasecmp( ext, "mp4" ) )
756     {
757 #ifdef MP4_OUTPUT
758         output = mp4_output;
759         param->b_annexb = 0;
760         param->b_dts_compress = 0;
761         param->b_repeat_headers = 0;
762         if( param->i_nal_hrd == X264_NAL_HRD_CBR )
763         {
764             fprintf( stderr, "x264 [warning]: cbr nal-hrd is not compatible with mp4\n" );
765             param->i_nal_hrd = X264_NAL_HRD_VBR;
766         }
767 #else
768         fprintf( stderr, "x264 [error]: not compiled with MP4 output support\n" );
769         return -1;
770 #endif
771     }
772     else if( !strcasecmp( ext, "mkv" ) )
773     {
774         output = mkv_output;
775         param->b_annexb = 0;
776         param->b_dts_compress = 0;
777         param->b_repeat_headers = 0;
778     }
779     else if( !strcasecmp( ext, "flv" ) )
780     {
781         output = flv_output;
782         param->b_annexb = 0;
783         param->b_dts_compress = 1;
784         param->b_repeat_headers = 0;
785     }
786     else
787         output = raw_output;
788     return 0;
789 }
790
791 static int select_input( const char *demuxer, char *used_demuxer, char *filename,
792                          hnd_t *p_handle, video_info_t *info, cli_input_opt_t *opt )
793 {
794     const char *ext = get_filename_extension( filename );
795     int b_regular = strcmp( filename, "-" );
796     int b_auto = !strcasecmp( demuxer, "auto" );
797     if( !b_regular && b_auto )
798         ext = "yuv";
799     if( b_regular )
800     {
801         FILE *f = fopen( filename, "r" );
802         if( f )
803         {
804             b_regular = x264_is_regular_file( f );
805             fclose( f );
806         }
807     }
808     const char *module = b_auto ? ext : demuxer;
809
810     if( !strcasecmp( module, "avs" ) || !strcasecmp( ext, "d2v" ) || !strcasecmp( ext, "dga" ) )
811     {
812 #ifdef AVS_INPUT
813         input = avs_input;
814         module = "avs";
815 #else
816         fprintf( stderr, "x264 [error]: not compiled with AVS input support\n" );
817         return -1;
818 #endif
819     }
820     else if( !strcasecmp( module, "y4m" ) )
821         input = y4m_input;
822     else if( !strcasecmp( module, "yuv" ) )
823         input = yuv_input;
824     else
825     {
826 #ifdef FFMS_INPUT
827         if( b_regular && (b_auto || !strcasecmp( demuxer, "ffms" )) &&
828             !ffms_input.open_file( filename, p_handle, info, opt ) )
829         {
830             module = "ffms";
831             b_auto = 0;
832             input = ffms_input;
833         }
834 #endif
835 #ifdef LAVF_INPUT
836         if( (b_auto || !strcasecmp( demuxer, "lavf" )) &&
837             !lavf_input.open_file( filename, p_handle, info, opt ) )
838         {
839             module = "lavf";
840             b_auto = 0;
841             input = lavf_input;
842         }
843 #endif
844 #ifdef AVS_INPUT
845         if( b_regular && (b_auto || !strcasecmp( demuxer, "avs" )) &&
846             !avs_input.open_file( filename, p_handle, info, opt ) )
847         {
848             module = "avs";
849             b_auto = 0;
850             input = avs_input;
851         }
852 #endif
853         if( b_auto && !yuv_input.open_file( filename, p_handle, info, opt ) )
854         {
855             module = "yuv";
856             b_auto = 0;
857             input = yuv_input;
858         }
859
860         if( !(*p_handle) )
861         {
862             fprintf( stderr, "x264 [error]: could not open input file `%s' via any method!\n", filename );
863             return -1;
864         }
865     }
866     strcpy( used_demuxer, module );
867
868     return 0;
869 }
870
871 /*****************************************************************************
872  * Parse:
873  *****************************************************************************/
874 static int Parse( int argc, char **argv, x264_param_t *param, cli_opt_t *opt )
875 {
876     char *input_filename = NULL;
877     const char *demuxer = demuxer_names[0];
878     char *output_filename = NULL;
879     const char *muxer = muxer_names[0];
880     char *tcfile_name = NULL;
881     x264_param_t defaults;
882     char *profile = NULL;
883     int b_thread_input = 0;
884     int b_turbo = 1;
885     int b_user_ref = 0;
886     int b_user_fps = 0;
887     int b_user_interlaced = 0;
888     int i;
889     cli_input_opt_t input_opt;
890     char *preset = NULL;
891     char *tune = NULL;
892
893     x264_param_default( &defaults );
894
895     memset( opt, 0, sizeof(cli_opt_t) );
896     memset( &input_opt, 0, sizeof(cli_input_opt_t) );
897     opt->b_progress = 1;
898
899     /* Presets are applied before all other options. */
900     for( optind = 0;; )
901     {
902         int c = getopt_long( argc, argv, short_options, long_options, NULL );
903         if( c == -1 )
904             break;
905         if( c == OPT_PRESET )
906             preset = optarg;
907         if( c == OPT_TUNE )
908             tune = optarg;
909         else if( c == '?' )
910             return -1;
911     }
912
913     if( preset && !strcasecmp( preset, "placebo" ) )
914         b_turbo = 0;
915
916     if( x264_param_default_preset( param, preset, tune ) < 0 )
917         return -1;
918
919     /* Parse command line options */
920     for( optind = 0;; )
921     {
922         int b_error = 0;
923         int long_options_index = -1;
924
925         int c = getopt_long( argc, argv, short_options, long_options, &long_options_index );
926
927         if( c == -1 )
928         {
929             break;
930         }
931
932         switch( c )
933         {
934             case 'h':
935                 Help( &defaults, 0 );
936                 exit(0);
937             case OPT_LONGHELP:
938                 Help( &defaults, 1 );
939                 exit(0);
940             case OPT_FULLHELP:
941                 Help( &defaults, 2 );
942                 exit(0);
943             case 'V':
944 #ifdef X264_POINTVER
945                 printf( "x264 "X264_POINTVER"\n" );
946 #else
947                 printf( "x264 0.%d.X\n", X264_BUILD );
948 #endif
949                 printf( "built on " __DATE__ ", " );
950 #ifdef __GNUC__
951                 printf( "gcc: " __VERSION__ "\n" );
952 #else
953                 printf( "using a non-gcc compiler\n" );
954 #endif
955                 exit(0);
956             case OPT_FRAMES:
957                 param->i_frame_total = X264_MAX( atoi( optarg ), 0 );
958                 break;
959             case OPT_SEEK:
960                 opt->i_seek = input_opt.seek = X264_MAX( atoi( optarg ), 0 );
961                 break;
962             case 'o':
963                 output_filename = optarg;
964                 break;
965             case OPT_MUXER:
966                 for( i = 0; muxer_names[i] && strcasecmp( muxer_names[i], optarg ); )
967                     i++;
968                 if( !muxer_names[i] )
969                 {
970                     fprintf( stderr, "x264 [error]: invalid muxer '%s'\n", optarg );
971                     return -1;
972                 }
973                 muxer = optarg;
974                 break;
975             case OPT_DEMUXER:
976                 for( i = 0; demuxer_names[i] && strcasecmp( demuxer_names[i], optarg ); )
977                     i++;
978                 if( !demuxer_names[i] )
979                 {
980                     fprintf( stderr, "x264 [error]: invalid demuxer '%s'\n", optarg );
981                     return -1;
982                 }
983                 demuxer = optarg;
984                 break;
985             case OPT_INDEX:
986                 input_opt.index = optarg;
987                 break;
988             case OPT_QPFILE:
989                 opt->qpfile = fopen( optarg, "rb" );
990                 if( !opt->qpfile )
991                 {
992                     fprintf( stderr, "x264 [error]: can't open qpfile `%s'\n", optarg );
993                     return -1;
994                 }
995                 else if( !x264_is_regular_file( opt->qpfile ) )
996                 {
997                     fprintf( stderr, "x264 [error]: qpfile incompatible with non-regular file `%s'\n", optarg );
998                     fclose( opt->qpfile );
999                     return -1;
1000                 }
1001                 break;
1002             case OPT_THREAD_INPUT:
1003                 b_thread_input = 1;
1004                 break;
1005             case OPT_QUIET:
1006                 param->i_log_level = X264_LOG_NONE;
1007                 break;
1008             case 'v':
1009                 param->i_log_level = X264_LOG_DEBUG;
1010                 break;
1011             case OPT_NOPROGRESS:
1012                 opt->b_progress = 0;
1013                 break;
1014             case OPT_VISUALIZE:
1015 #ifdef VISUALIZE
1016                 param->b_visualize = 1;
1017                 b_exit_on_ctrl_c = 1;
1018 #else
1019                 fprintf( stderr, "x264 [warning]: not compiled with visualization support\n" );
1020 #endif
1021                 break;
1022             case OPT_TUNE:
1023             case OPT_PRESET:
1024                 break;
1025             case OPT_PROFILE:
1026                 profile = optarg;
1027                 break;
1028             case OPT_SLOWFIRSTPASS:
1029                 b_turbo = 0;
1030                 break;
1031             case 'r':
1032                 b_user_ref = 1;
1033                 goto generic_option;
1034             case OPT_FPS:
1035                 b_user_fps = 1;
1036                 param->b_vfr_input = 0;
1037                 goto generic_option;
1038             case OPT_INTERLACED:
1039                 b_user_interlaced = 1;
1040                 goto generic_option;
1041             case OPT_TCFILE_IN:
1042                 tcfile_name = optarg;
1043                 break;
1044             case OPT_TCFILE_OUT:
1045                 opt->tcfile_out = fopen( optarg, "wb" );
1046                 if( !opt->tcfile_out )
1047                 {
1048                     fprintf( stderr, "x264 [error]: can't open `%s'\n", optarg );
1049                     return -1;
1050                 }
1051                 break;
1052             case OPT_TIMEBASE:
1053                 input_opt.timebase = optarg;
1054                 break;
1055             case OPT_PULLDOWN:
1056                 for( i = 0; pulldown_names[i] && strcasecmp( pulldown_names[i], optarg ); )
1057                     i++;
1058                 if( !pulldown_names[i] )
1059                 {
1060                     fprintf( stderr, "x264 [error]: invalid pulldown '%s'\n", optarg );
1061                     return -1;
1062                 }
1063                 opt->i_pulldown = i;
1064                 break;
1065             default:
1066 generic_option:
1067             {
1068                 int i;
1069                 if( long_options_index < 0 )
1070                 {
1071                     for( i = 0; long_options[i].name; i++ )
1072                         if( long_options[i].val == c )
1073                         {
1074                             long_options_index = i;
1075                             break;
1076                         }
1077                     if( long_options_index < 0 )
1078                     {
1079                         /* getopt_long already printed an error message */
1080                         return -1;
1081                     }
1082                 }
1083
1084                 b_error |= x264_param_parse( param, long_options[long_options_index].name, optarg );
1085             }
1086         }
1087
1088         if( b_error )
1089         {
1090             const char *name = long_options_index > 0 ? long_options[long_options_index].name : argv[optind-2];
1091             fprintf( stderr, "x264 [error]: invalid argument: %s = %s\n", name, optarg );
1092             return -1;
1093         }
1094     }
1095
1096     /* If first pass mode is used, apply faster settings. */
1097     if( b_turbo )
1098         x264_param_apply_fastfirstpass( param );
1099
1100     /* Apply profile restrictions. */
1101     if( x264_param_apply_profile( param, profile ) < 0 )
1102         return -1;
1103
1104     /* Get the file name */
1105     if( optind > argc - 1 || !output_filename )
1106     {
1107         fprintf( stderr, "x264 [error]: No %s file. Run x264 --help for a list of options.\n",
1108                  optind > argc - 1 ? "input" : "output" );
1109         return -1;
1110     }
1111
1112     if( select_output( muxer, output_filename, param ) )
1113         return -1;
1114     if( output.open_file( output_filename, &opt->hout ) )
1115     {
1116         fprintf( stderr, "x264 [error]: could not open output file `%s'\n", output_filename );
1117         return -1;
1118     }
1119
1120     input_filename = argv[optind++];
1121     input_opt.resolution = optind < argc ? argv[optind++] : NULL;
1122     video_info_t info = {0};
1123     char demuxername[5];
1124
1125     /* set info flags to param flags to be overwritten by demuxer as necessary. */
1126     info.csp        = param->i_csp;
1127     info.fps_num    = param->i_fps_num;
1128     info.fps_den    = param->i_fps_den;
1129     info.interlaced = param->b_interlaced;
1130     info.sar_width  = param->vui.i_sar_width;
1131     info.sar_height = param->vui.i_sar_height;
1132     info.vfr        = param->b_vfr_input;
1133
1134     if( select_input( demuxer, demuxername, input_filename, &opt->hin, &info, &input_opt ) )
1135         return -1;
1136
1137     if( !opt->hin && input.open_file( input_filename, &opt->hin, &info, &input_opt ) )
1138     {
1139         fprintf( stderr, "x264 [error]: could not open input file `%s'\n", input_filename );
1140         return -1;
1141     }
1142
1143     x264_reduce_fraction( &info.sar_width, &info.sar_height );
1144     x264_reduce_fraction( &info.fps_num, &info.fps_den );
1145     if( param->i_log_level >= X264_LOG_INFO )
1146         fprintf( stderr, "%s [info]: %dx%d%c %d:%d @ %d/%d fps (%cfr)\n", demuxername, info.width,
1147                  info.height, info.interlaced ? 'i' : 'p', info.sar_width, info.sar_height,
1148                  info.fps_num, info.fps_den, info.vfr ? 'v' : 'c' );
1149
1150     if( tcfile_name )
1151     {
1152         if( b_user_fps )
1153         {
1154             fprintf( stderr, "x264 [error]: --fps + --tcfile-in is incompatible.\n" );
1155             return -1;
1156         }
1157         if( timecode_input.open_file( tcfile_name, &opt->hin, &info, &input_opt ) )
1158         {
1159             fprintf( stderr, "x264 [error]: timecode input failed\n" );
1160             return -1;
1161         }
1162         else
1163             input = timecode_input;
1164     }
1165     else if( !info.vfr && input_opt.timebase )
1166     {
1167         fprintf( stderr, "x264 [error]: --timebase is incompatible with cfr input\n" );
1168         return -1;
1169     }
1170
1171     /* set param flags from the info flags as necessary */
1172     param->i_csp       = info.csp;
1173     param->i_height    = info.height;
1174     param->b_vfr_input = info.vfr;
1175     param->i_width     = info.width;
1176     if( !b_user_interlaced && info.interlaced )
1177     {
1178         fprintf( stderr, "x264 [warning]: input appears to be interlaced, enabling interlaced mode.\n"
1179                          "                If you want otherwise, use --no-interlaced\n" );
1180         param->b_interlaced = 1;
1181     }
1182     if( !b_user_fps )
1183     {
1184         param->i_fps_num = info.fps_num;
1185         param->i_fps_den = info.fps_den;
1186     }
1187     if( param->b_vfr_input )
1188     {
1189         param->i_timebase_num = info.timebase_num;
1190         param->i_timebase_den = info.timebase_den;
1191     }
1192     else
1193     {
1194         param->i_timebase_num = param->i_fps_den;
1195         param->i_timebase_den = param->i_fps_num;
1196     }
1197     if( !tcfile_name && input_opt.timebase )
1198     {
1199         int i_user_timebase_num;
1200         int i_user_timebase_den;
1201         int ret = sscanf( input_opt.timebase, "%d/%d", &i_user_timebase_num, &i_user_timebase_den );
1202         if( !ret )
1203         {
1204             fprintf( stderr, "x264 [error]: invalid argument: timebase = %s\n", input_opt.timebase );
1205             return -1;
1206         }
1207         else if( ret == 1 )
1208         {
1209             i_user_timebase_num = param->i_timebase_num;
1210             i_user_timebase_den = atoi( input_opt.timebase );
1211         }
1212         opt->timebase_convert_multiplier = ((double)i_user_timebase_den / param->i_timebase_den)
1213                                          * ((double)param->i_timebase_num / i_user_timebase_num);
1214         if( opt->timebase_convert_multiplier < 1 )
1215         {
1216             fprintf( stderr, "x264 [error]: timebase you specified will generate nonmonotonic pts: %d/%d\n",
1217                      i_user_timebase_num, i_user_timebase_den );
1218             return -1;
1219         }
1220         param->i_timebase_num = i_user_timebase_num;
1221         param->i_timebase_den = i_user_timebase_den;
1222         param->b_vfr_input = 1;
1223     }
1224     if( !param->vui.i_sar_width || !param->vui.i_sar_height )
1225     {
1226         param->vui.i_sar_width  = info.sar_width;
1227         param->vui.i_sar_height = info.sar_height;
1228     }
1229
1230 #ifdef HAVE_PTHREAD
1231     if( b_thread_input || param->i_threads > 1
1232         || (param->i_threads == X264_THREADS_AUTO && x264_cpu_num_processors() > 1) )
1233     {
1234         if( thread_input.open_file( NULL, &opt->hin, &info, NULL ) )
1235         {
1236             fprintf( stderr, "x264 [error]: threaded input failed\n" );
1237             return -1;
1238         }
1239         else
1240             input = thread_input;
1241     }
1242 #endif
1243
1244
1245     /* Automatically reduce reference frame count to match the user's target level
1246      * if the user didn't explicitly set a reference frame count. */
1247     if( !b_user_ref )
1248     {
1249         int mbs = (((param->i_width)+15)>>4) * (((param->i_height)+15)>>4);
1250         int i;
1251         for( i = 0; x264_levels[i].level_idc != 0; i++ )
1252             if( param->i_level_idc == x264_levels[i].level_idc )
1253             {
1254                 while( mbs * 384 * param->i_frame_reference > x264_levels[i].dpb
1255                        && param->i_frame_reference > 1 )
1256                 {
1257                     param->i_frame_reference--;
1258                 }
1259                 break;
1260             }
1261     }
1262
1263
1264     return 0;
1265 }
1266
1267 static void parse_qpfile( cli_opt_t *opt, x264_picture_t *pic, int i_frame )
1268 {
1269     int num = -1, qp, ret;
1270     char type;
1271     uint64_t file_pos;
1272     while( num < i_frame )
1273     {
1274         file_pos = ftell( opt->qpfile );
1275         ret = fscanf( opt->qpfile, "%d %c %d\n", &num, &type, &qp );
1276         if( num > i_frame || ret == EOF )
1277         {
1278             pic->i_type = X264_TYPE_AUTO;
1279             pic->i_qpplus1 = 0;
1280             fseek( opt->qpfile, file_pos, SEEK_SET );
1281             break;
1282         }
1283         if( num < i_frame && ret == 3 )
1284             continue;
1285         pic->i_qpplus1 = qp+1;
1286         if     ( type == 'I' ) pic->i_type = X264_TYPE_IDR;
1287         else if( type == 'i' ) pic->i_type = X264_TYPE_I;
1288         else if( type == 'P' ) pic->i_type = X264_TYPE_P;
1289         else if( type == 'B' ) pic->i_type = X264_TYPE_BREF;
1290         else if( type == 'b' ) pic->i_type = X264_TYPE_B;
1291         else ret = 0;
1292         if( ret != 3 || qp < -1 || qp > 51 )
1293         {
1294             fprintf( stderr, "x264 [error]: can't parse qpfile for frame %d\n", i_frame );
1295             fclose( opt->qpfile );
1296             opt->qpfile = NULL;
1297             pic->i_type = X264_TYPE_AUTO;
1298             pic->i_qpplus1 = 0;
1299             break;
1300         }
1301     }
1302 }
1303
1304 /*****************************************************************************
1305  * Encode:
1306  *****************************************************************************/
1307
1308 static int  Encode_frame( x264_t *h, hnd_t hout, x264_picture_t *pic, int64_t *last_pts )
1309 {
1310     x264_picture_t pic_out;
1311     x264_nal_t *nal;
1312     int i_nal;
1313     int i_frame_size = 0;
1314
1315     i_frame_size = x264_encoder_encode( h, &nal, &i_nal, pic, &pic_out );
1316
1317     if( i_frame_size < 0 )
1318     {
1319         fprintf( stderr, "x264 [error]: x264_encoder_encode failed\n" );
1320         return -1;
1321     }
1322
1323     if( i_frame_size )
1324     {
1325         i_frame_size = output.write_frame( hout, nal[0].p_payload, i_frame_size, &pic_out );
1326         *last_pts = pic_out.i_pts;
1327     }
1328
1329     return i_frame_size;
1330 }
1331
1332 static void Print_status( int64_t i_start, int i_frame, int i_frame_total, int64_t i_file, x264_param_t *param, int64_t last_pts )
1333 {
1334     char    buf[200];
1335     int64_t i_elapsed = x264_mdate() - i_start;
1336     double fps = i_elapsed > 0 ? i_frame * 1000000. / i_elapsed : 0;
1337     double bitrate = (double) i_file * 8 / ( (double) last_pts * 1000 * param->i_timebase_num / param->i_timebase_den );
1338     if( i_frame_total )
1339     {
1340         int eta = i_elapsed * (i_frame_total - i_frame) / ((int64_t)i_frame * 1000000);
1341         sprintf( buf, "x264 [%.1f%%] %d/%d frames, %.2f fps, %.2f kb/s, eta %d:%02d:%02d",
1342                  100. * i_frame / i_frame_total, i_frame, i_frame_total, fps, bitrate,
1343                  eta/3600, (eta/60)%60, eta%60 );
1344     }
1345     else
1346     {
1347         sprintf( buf, "x264 %d frames: %.2f fps, %.2f kb/s", i_frame, fps, bitrate );
1348     }
1349     fprintf( stderr, "%s  \r", buf+5 );
1350     SetConsoleTitle( buf );
1351     fflush( stderr ); // needed in windows
1352 }
1353
1354 static int  Encode( x264_param_t *param, cli_opt_t *opt )
1355 {
1356     x264_t *h;
1357     x264_picture_t pic;
1358     const cli_pulldown_t *pulldown = NULL; // shut up gcc
1359
1360     int     i_frame, i_frame_total, i_frame_output;
1361     int64_t i_start, i_end;
1362     int64_t i_file = 0;
1363     int     i_frame_size;
1364     int     i_update_interval;
1365     int64_t last_pts = 0;
1366 #   define  MAX_PTS_WARNING 3 /* arbitrary */
1367     int     pts_warning_cnt = 0;
1368     int64_t largest_pts = -1;
1369     int64_t second_largest_pts = -1;
1370     int64_t ticks_per_frame;
1371     double  duration;
1372     int     prev_timebase_den = param->i_timebase_den / gcd( param->i_timebase_num, param->i_timebase_den );
1373     int     dts_compress_multiplier;
1374     double  pulldown_pts = 0;
1375
1376     opt->b_progress &= param->i_log_level < X264_LOG_DEBUG;
1377     i_frame_total = input.get_frame_total( opt->hin );
1378     i_frame_total = X264_MAX( i_frame_total - opt->i_seek, 0 );
1379     if( ( i_frame_total == 0 || param->i_frame_total < i_frame_total )
1380         && param->i_frame_total > 0 )
1381         i_frame_total = param->i_frame_total;
1382     param->i_frame_total = i_frame_total;
1383     i_update_interval = i_frame_total ? x264_clip3( i_frame_total / 1000, 1, 10 ) : 10;
1384
1385     /* set up pulldown */
1386     if( opt->i_pulldown && !param->b_vfr_input )
1387     {
1388         param->b_pic_struct = 1;
1389         pulldown = &pulldown_values[opt->i_pulldown];
1390         param->i_timebase_num = param->i_fps_den;
1391         if( fmod( param->i_fps_num * pulldown->fps_factor, 1 ) )
1392         {
1393             fprintf( stderr, "x264 [error]: unsupported framerate for chosen pulldown\n" );
1394             return -1;
1395         }
1396         param->i_timebase_den = param->i_fps_num * pulldown->fps_factor;
1397     }
1398
1399     if( ( h = x264_encoder_open( param ) ) == NULL )
1400     {
1401         fprintf( stderr, "x264 [error]: x264_encoder_open failed\n" );
1402         input.close_file( opt->hin );
1403         return -1;
1404     }
1405
1406     x264_encoder_parameters( h, param );
1407
1408     dts_compress_multiplier = param->i_timebase_den / prev_timebase_den;
1409
1410     if( output.set_param( opt->hout, param ) )
1411     {
1412         fprintf( stderr, "x264 [error]: can't set outfile param\n" );
1413         input.close_file( opt->hin );
1414         output.close_file( opt->hout, largest_pts, second_largest_pts );
1415         return -1;
1416     }
1417
1418     /* Create a new pic */
1419     if( input.picture_alloc( &pic, param->i_csp, param->i_width, param->i_height ) )
1420     {
1421         fprintf( stderr, "x264 [error]: malloc failed\n" );
1422         return -1;
1423     }
1424
1425     i_start = x264_mdate();
1426     /* ticks/frame = ticks/second / frames/second */
1427     ticks_per_frame = (int64_t)param->i_timebase_den * param->i_fps_den / param->i_timebase_num / param->i_fps_num;
1428     if( ticks_per_frame < 1 )
1429     {
1430         fprintf( stderr, "x264 [error]: ticks_per_frame invalid: %"PRId64"\n", ticks_per_frame );
1431         return -1;
1432     }
1433
1434     if( !param->b_repeat_headers )
1435     {
1436         // Write SPS/PPS/SEI
1437         x264_nal_t *headers;
1438         int i_nal;
1439
1440         if( x264_encoder_headers( h, &headers, &i_nal ) < 0 )
1441         {
1442             fprintf( stderr, "x264 [error]: x264_encoder_headers failed\n" );
1443             return -1;
1444         }
1445
1446         if( (i_file = output.write_headers( opt->hout, headers )) < 0 )
1447             return -1;
1448     }
1449
1450     if( opt->tcfile_out )
1451         fprintf( opt->tcfile_out, "# timecode format v2\n" );
1452
1453     /* Encode frames */
1454     for( i_frame = 0, i_frame_output = 0; b_ctrl_c == 0 && (i_frame < i_frame_total || i_frame_total == 0); )
1455     {
1456         if( input.read_frame( &pic, opt->hin, i_frame + opt->i_seek ) )
1457             break;
1458
1459         if( !param->b_vfr_input )
1460             pic.i_pts = i_frame;
1461
1462         if( opt->i_pulldown && !param->b_vfr_input )
1463         {
1464             pic.i_pic_struct = pulldown->pattern[ i_frame % pulldown->mod ];
1465             pic.i_pts = (int64_t)( pulldown_pts + 0.5 );
1466             pulldown_pts += pulldown_frame_duration[pic.i_pic_struct];
1467         }
1468         else if( opt->timebase_convert_multiplier )
1469             pic.i_pts = (int64_t)( pic.i_pts * opt->timebase_convert_multiplier + 0.5 );
1470
1471         int64_t output_pts = pic.i_pts * dts_compress_multiplier;   /* pts libx264 returns */
1472
1473         if( pic.i_pts <= largest_pts )
1474         {
1475             if( param->i_log_level >= X264_LOG_WARNING )
1476             {
1477                 if( param->i_log_level >= X264_LOG_DEBUG || pts_warning_cnt < MAX_PTS_WARNING )
1478                     fprintf( stderr, "x264 [warning]: non-strictly-monotonic pts at frame %d (%"PRId64" <= %"PRId64")\n",
1479                              i_frame, output_pts, largest_pts * dts_compress_multiplier );
1480                 else if( pts_warning_cnt == MAX_PTS_WARNING )
1481                     fprintf( stderr, "x264 [warning]: too many nonmonotonic pts warnings, suppressing further ones\n" );
1482                 pts_warning_cnt++;
1483             }
1484             pic.i_pts = largest_pts + ticks_per_frame;
1485             output_pts = pic.i_pts * dts_compress_multiplier;
1486         }
1487
1488         second_largest_pts = largest_pts;
1489         largest_pts = pic.i_pts;
1490         if( opt->tcfile_out )
1491             fprintf( opt->tcfile_out, "%.6f\n", output_pts * ((double)param->i_timebase_num / param->i_timebase_den) * 1e3 );
1492
1493         if( opt->qpfile )
1494             parse_qpfile( opt, &pic, i_frame + opt->i_seek );
1495         else
1496         {
1497             /* Do not force any parameters */
1498             pic.i_type = X264_TYPE_AUTO;
1499             pic.i_qpplus1 = 0;
1500         }
1501
1502         i_frame_size = Encode_frame( h, opt->hout, &pic, &last_pts );
1503         if( i_frame_size < 0 )
1504             return -1;
1505         i_file += i_frame_size;
1506         if( i_frame_size )
1507             i_frame_output++;
1508
1509         i_frame++;
1510
1511         if( input.release_frame && input.release_frame( &pic, opt->hin ) )
1512             break;
1513
1514         /* update status line (up to 1000 times per input file) */
1515         if( opt->b_progress && i_frame_output % i_update_interval == 0 && i_frame_output )
1516             Print_status( i_start, i_frame_output, i_frame_total, i_file, param, last_pts );
1517     }
1518     /* Flush delayed frames */
1519     while( !b_ctrl_c && x264_encoder_delayed_frames( h ) )
1520     {
1521         i_frame_size = Encode_frame( h, opt->hout, NULL, &last_pts );
1522         if( i_frame_size < 0 )
1523             return -1;
1524         i_file += i_frame_size;
1525         if( i_frame_size )
1526             i_frame_output++;
1527         if( opt->b_progress && i_frame_output % i_update_interval == 0 && i_frame_output )
1528             Print_status( i_start, i_frame_output, i_frame_total, i_file, param, last_pts );
1529     }
1530     if( pts_warning_cnt >= MAX_PTS_WARNING && param->i_log_level < X264_LOG_DEBUG )
1531         fprintf( stderr, "x264 [warning]: %d suppressed nonmonotonic pts warnings\n", pts_warning_cnt-MAX_PTS_WARNING );
1532
1533     /* duration algorithm fails when only 1 frame is output */
1534     if( i_frame_output == 1 )
1535         duration = (double)param->i_fps_den / param->i_fps_num;
1536     else
1537         duration = (double)(2 * largest_pts - second_largest_pts) * param->i_timebase_num / param->i_timebase_den;
1538     if( !(opt->i_pulldown && !param->b_vfr_input) )
1539         duration *= dts_compress_multiplier;
1540
1541     i_end = x264_mdate();
1542     input.picture_clean( &pic );
1543     /* Erase progress indicator before printing encoding stats. */
1544     if( opt->b_progress )
1545         fprintf( stderr, "                                                                               \r" );
1546     x264_encoder_close( h );
1547     fprintf( stderr, "\n" );
1548
1549     if( b_ctrl_c )
1550         fprintf( stderr, "aborted at input frame %d, output frame %d\n", opt->i_seek + i_frame, i_frame_output );
1551
1552     if( opt->tcfile_out )
1553     {
1554         fclose( opt->tcfile_out );
1555         opt->tcfile_out = NULL;
1556     }
1557
1558     input.close_file( opt->hin );
1559     output.close_file( opt->hout, largest_pts, second_largest_pts );
1560
1561     if( i_frame_output > 0 )
1562     {
1563         double fps = (double)i_frame_output * (double)1000000 /
1564                      (double)( i_end - i_start );
1565
1566         fprintf( stderr, "encoded %d frames, %.2f fps, %.2f kb/s\n", i_frame_output, fps,
1567                  (double) i_file * 8 / ( 1000 * duration ) );
1568     }
1569
1570     return 0;
1571 }