x264.c 57.7 KB
Newer Older
1 2 3
/*****************************************************************************
 * x264.c: h264 video encoder
 *****************************************************************************
4
 * Copyright (C) 2004-2010 the VideoLAN team
5
 * $Id$
6 7
 *
 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8
 *          Ilkka Ollakka <ileoo (at)videolan org>
9 10 11 12 13 14 15 16 17 18 19 20 21
 *
 * 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
Antoine Cellerier's avatar
Antoine Cellerier committed
22
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 24 25 26 27
 *****************************************************************************/

/*****************************************************************************
 * Preamble
 *****************************************************************************/
28 29 30 31
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif

32
#include <vlc_common.h>
33
#include <vlc_plugin.h>
Clément Stenac's avatar
Clément Stenac committed
34 35
#include <vlc_sout.h>
#include <vlc_codec.h>
36
#include <vlc_charset.h>
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
37
#include <vlc_cpu.h>
38
#include <math.h>
39

Benjamin Pracht's avatar
 
Benjamin Pracht committed
40 41 42
#ifdef PTW32_STATIC_LIB
#include <pthread.h>
#endif
43 44
#include <x264.h>

45 46
#include <assert.h>

47 48 49
#ifdef MODULE_NAME_IS_x26410b
#define SOUT_CFG_PREFIX "sout-x26410b-"
#else
50
#define SOUT_CFG_PREFIX "sout-x264-"
51
#endif
52

53 54 55 56 57
/*****************************************************************************
 * Module descriptor
 *****************************************************************************/
static int  Open ( vlc_object_t * );
static void Close( vlc_object_t * );
58
static void x264_log( void *, int i_level, const char *psz, va_list );
59

60
/* Frame-type options */
61

62 63
#define KEYINT_TEXT N_("Maximum GOP size")
#define KEYINT_LONGTEXT N_( "Sets maximum interval between IDR-frames." \
64
    "Larger values save bits, thus improving quality for a given bitrate at " \
65
    "the cost of seeking precision. Use -1 for infinite." )
66

67 68 69 70
#define MIN_KEYINT_TEXT N_("Minimum GOP size")
#define MIN_KEYINT_LONGTEXT N_( "Sets minimum interval between IDR-frames. " \
    "In H.264, I-frames do not necessarily bound a closed GOP because it is " \
    "allowable for a P-frame to be predicted from more frames than just the " \
71 72 73
    "one frame before it (also see reference frame option). Therefore, " \
    "I-frames are not necessarily seekable. IDR-frames restrict subsequent " \
    "P-frames from referring to any frame prior to the IDR-frame. \n" \
74 75 76
    "If scenecuts appear within this interval, they are still encoded as " \
    "I-frames, but do not start a new GOP." )

77
#define OPENGOP_TEXT N_("Use recovery points to close GOPs")
78
#if X264_BUILD < 115
79 80 81
#define OPENGOP_LONGTEXT N_("none: use closed GOPs only\n"\
    "normal: use standard open GOPs\n" \
    "bluray: use Blu-ray compatible open GOPs" )
82 83 84 85 86 87 88
#else
#define OPENGOP_LONGTEXT N_("use open GOP, for bluray compatibility use also bluray-compat option")
#endif

#define BLURAY_TEXT N_("Enable compatibility hacks for Blu-ray support")
#define BLURAY_LONGTEXT N_("Enable hacks for Blu-ray support, this doesn't enforce every aspect of Blu-ray compatibility\n" \
    "e.g. resolution, framerate, level" )
89

90
#define SCENE_TEXT N_("Extra I-frames aggressivity" )
Clément Stenac's avatar
Clément Stenac committed
91 92 93 94 95 96
#define SCENE_LONGTEXT N_( "Scene-cut detection. Controls how " \
    "aggressively to insert extra I-frames. With small values of " \
    "scenecut, the codec often has " \
    "to force an I-frame when it would exceed keyint. " \
    "Good values of scenecut may find a better location for the " \
    "I-frame. Large values use more I-frames " \
97
    "than necessary, thus wasting bits. -1 disables scene-cut detection, so " \
98 99
    "I-frames are inserted only every other keyint frames, which probably " \
    "leads to ugly encoding artifacts. Range 1 to 100." )
100

101

Clément Stenac's avatar
Clément Stenac committed
102
#define BFRAMES_TEXT N_("B-frames between I and P")
103
#define BFRAMES_LONGTEXT N_( "Number of consecutive B-frames between I and " \
104
    "P-frames. Range 1 to 16." )
105 106

#define B_ADAPT_TEXT N_("Adaptive B-frame decision")
107 108 109
#define B_ADAPT_LONGTEXT N_( "Force the specified number of " \
    "consecutive B-frames to be used, except possibly before an I-frame." \
    "Range 0 to 2." )
110

111
#define B_BIAS_TEXT N_("Influence (bias) B-frames usage")
112
#define B_BIAS_LONGTEXT N_( "Bias the choice to use B-frames. Positive values " \
113
    "cause more B-frames, negative values cause less B-frames." )
114

115

116
#define BPYRAMID_TEXT N_("Keep some B-frames as references")
117 118 119 120 121 122 123
#define BPYRAMID_LONGTEXT N_( "Allows B-frames to be used as references for " \
    "predicting other frames. Keeps the middle of 2+ consecutive B-frames " \
    "as a reference, and reorders frame appropriately.\n" \
    " - none: Disabled\n" \
    " - strict: Strictly hierarchical pyramid\n" \
    " - normal: Non-strict (not Blu-ray compatible)\n"\
    )
124

125 126 127 128
#define FULLRANGE_TEXT N_("Use fullrange instead of TV colorrange")
#define FULLRANGE_LONGTEXT N_("TV-range is usually used colorrange, defining this to true " \
                              "will enable libx264 to use full colorrange on encoding")

129 130
#define CABAC_TEXT N_("CABAC")
#define CABAC_LONGTEXT N_( "CABAC (Context-Adaptive Binary Arithmetic "\
131
    "Coding). Slightly slows down encoding and decoding, but should save " \
132 133
    "10 to 15% bitrate." )

Clément Stenac's avatar
Clément Stenac committed
134
#define REF_TEXT N_("Number of reference frames")
135 136 137
#define REF_LONGTEXT N_( "Number of previous frames used as predictors. " \
    "This is effective in Anime, but seems to make little difference in " \
    "live-action source material. Some decoders are unable to deal with " \
138
    "large frameref values. Range 1 to 16." )
139

140 141
#define NF_TEXT N_("Skip loop filter")
#define NF_LONGTEXT N_( "Deactivate the deblocking loop filter (decreases quality).")
142

143 144 145 146
#define FILTER_TEXT N_("Loop filter AlphaC0 and Beta parameters alpha:beta")
#define FILTER_LONGTEXT N_( "Loop filter AlphaC0 and Beta parameters. " \
    "Range -6 to 6 for both alpha and beta parameters. -6 means light " \
    "filter, 6 means strong.")
Kaarlo Raiha's avatar
Kaarlo Raiha committed
147

148 149 150 151
#define LEVEL_TEXT N_("H.264 level")
#define LEVEL_LONGTEXT N_( "Specify H.264 level (as defined by Annex A " \
    "of the standard). Levels are not enforced; it's up to the user to select " \
    "a level compatible with the rest of the encoding options. Range 1 to 5.1 " \
152
    "(10 to 51 is also allowed). Set to 0 for letting x264 set level.")
153

154
#define PROFILE_TEXT N_("H.264 profile")
Kaarlo Raiha's avatar
Kaarlo Raiha committed
155
#define PROFILE_LONGTEXT N_("Specify H.264 profile which limits are enforced over " \
156 157
        "other settings" )

158 159 160 161 162 163
/* In order to play an interlaced output stream encoded by x264, a decoder needs
   mbaff support. r570 is using the 'mb' part and not 'aff' yet; so it's really
   'pure-interlaced' mode */
#define INTERLACED_TEXT N_("Interlaced mode")
#define INTERLACED_LONGTEXT N_( "Pure-interlaced mode.")

164 165 166 167 168 169 170 171 172
#define FRAMEPACKING_TEXT N_("Frame packing")
#define FRAMEPACKING_LONGTEXT N_( "For stereoscopic videos define frame arrangement:\n" \
    " 0: checkerboard - pixels are alternatively from L and R\n" \
    " 1: column alternation - L and R are interlaced by column\n" \
    " 2: row alternation - L and R are interlaced by row\n" \
    " 3: side by side - L is on the left, R on the right\n" \
    " 4: top bottom - L is on top, R on bottom\n" \
    " 5: frame alternation - one view per frame" )

173 174 175 176 177
#define INTRAREFRESH_TEXT N_("Use Periodic Intra Refresh")
#define INTRAREFRESH_LONGTEXT N_("Use Periodic Intra Refresh instead of IDR frames")

#define MBTREE_TEXT N_("Use mb-tree ratecontrol")
#define MBTREE_LONGTEXT N_("You can disable use of Macroblock-tree on ratecontrol")
178 179

#define SLICE_COUNT N_("Force number of slices per frame")
Kaarlo Raiha's avatar
Kaarlo Raiha committed
180
#define SLICE_COUNT_LONGTEXT N_("Force rectangular slices and is overridden by other slicing options")
181 182 183 184 185 186

#define SLICE_MAX_SIZE N_("Limit the size of each slice in bytes")
#define SLICE_MAX_SIZE_LONGTEXT N_("Sets a maximum slice size in bytes, Includes NAL overhead in size")

#define SLICE_MAX_MBS N_("Limit the size of each slice in macroblocks")
#define SLICE_MAX_MBS_LONGTEXT N_("Sets a maximum number of macroblocks per slice")
187 188
/* Ratecontrol */

Clément Stenac's avatar
Clément Stenac committed
189
#define QP_TEXT N_("Set QP")
190 191
#define QP_LONGTEXT N_( "This selects the quantizer to use. " \
    "Lower values result in better fidelity, but higher bitrates. 26 is a " \
192
    "good default value. Range 0 (lossless) to 51." )
193

Clément Stenac's avatar
Clément Stenac committed
194
#define CRF_TEXT N_("Quality-based VBR")
195
#define CRF_LONGTEXT N_( "1-pass Quality-based VBR. Range 0 to 51." )
196

Clément Stenac's avatar
Clément Stenac committed
197
#define QPMIN_TEXT N_("Min QP")
198 199
#define QPMIN_LONGTEXT N_( "Minimum quantizer parameter. 15 to 35 seems to " \
    "be a useful range." )
200

Christophe Mutricy's avatar
typo  
Christophe Mutricy committed
201
#define QPMAX_TEXT N_("Max QP")
202 203
#define QPMAX_LONGTEXT N_( "Maximum quantizer parameter." )

Christophe Mutricy's avatar
typo  
Christophe Mutricy committed
204
#define QPSTEP_TEXT N_("Max QP step")
205 206
#define QPSTEP_LONGTEXT N_( "Max QP step between frames.")

207
#define RATETOL_TEXT N_("Average bitrate tolerance")
208
#define RATETOL_LONGTEXT N_( "Allowed variance in average " \
209
    "bitrate (in kbits/s).")
210

211
#define VBV_MAXRATE_TEXT N_("Max local bitrate")
212
#define VBV_MAXRATE_LONGTEXT N_( "Sets a maximum local bitrate (in kbits/s).")
213

214 215
#define VBV_BUFSIZE_TEXT N_("VBV buffer")
#define VBV_BUFSIZE_LONGTEXT N_( "Averaging period for the maximum " \
216
    "local bitrate (in kbits).")
217

218
#define VBV_INIT_TEXT N_("Initial VBV buffer occupancy")
219
#define VBV_INIT_LONGTEXT N_( "Sets the initial buffer occupancy as a " \
220
    "fraction of the buffer size. Range 0.0 to 1.0.")
221

222
#define AQ_MODE_TEXT N_("How AQ distributes bits")
223
#define AQ_MODE_LONGTEXT N_("Defines bitdistribution mode for AQ, default 1\n" \
224
        " - 0: Disabled\n"\
225 226
        " - 1: Current x264 default mode\n"\
        " - 2: uses log(var)^2 instead of log(var) and attempts to adapt strength per frame")
227 228 229

#define AQ_STRENGTH_TEXT N_("Strength of AQ")
#define AQ_STRENGTH_LONGTEXT N_("Strength to reduce blocking and blurring in flat\n"\
230
        "and textured areas, default 1.0 recommended to be between 0..2\n"\
231 232 233
        " - 0.5: weak AQ\n"\
        " - 1.5: strong AQ")

234
/* IP Ratio < 1 is technically valid but should never improve quality */
235
#define IPRATIO_TEXT N_("QP factor between I and P")
236
#define IPRATIO_LONGTEXT N_( "QP factor between I and P. Range 1.0 to 2.0.")
237

238
/* PB ratio < 1 is not valid and breaks ratecontrol */
239
#define PBRATIO_TEXT N_("QP factor between P and B")
240
#define PBRATIO_LONGTEXT N_( "QP factor between P and B. Range 1.0 to 2.0.")
241

242 243 244
#define CHROMA_QP_OFFSET_TEXT N_("QP difference between chroma and luma")
#define CHROMA_QP_OFFSET_LONGTEXT N_( "QP difference between chroma and luma.")

245 246 247 248 249 250
#define PASS_TEXT N_("Multipass ratecontrol")
#define PASS_LONGTEXT N_( "Multipass ratecontrol:\n" \
    " - 1: First pass, creates stats file\n" \
    " - 2: Last pass, does not overwrite stats file\n" \
    " - 3: Nth pass, overwrites stats file\n" )

251
#define QCOMP_TEXT N_("QP curve compression")
252
#define QCOMP_LONGTEXT N_( "QP curve compression. Range 0.0 (CBR) to 1.0 (QCP).")
253

Clément Stenac's avatar
Clément Stenac committed
254 255
#define CPLXBLUR_TEXT N_("Reduce fluctuations in QP")
#define CPLXBLUR_LONGTEXT N_( "This reduces the fluctuations in QP " \
256
    "before curve compression. Temporally blurs complexity.")
257

Clément Stenac's avatar
Clément Stenac committed
258
#define QBLUR_TEXT N_("Reduce fluctuations in QP")
259
#define QBLUR_LONGTEXT N_( "This reduces the fluctuations in QP " \
260
    "after curve compression. Temporally blurs quants.")
261 262 263 264 265 266 267 268 269 270 271 272 273

/* Analysis */

#define ANALYSE_TEXT N_("Partitions to consider")
#define ANALYSE_LONGTEXT N_( "Partitions to consider in analyse mode: \n" \
    " - none  : \n" \
    " - fast  : i4x4\n" \
    " - normal: i4x4,p8x8,(i8x8)\n" \
    " - slow  : i4x4,p8x8,(i8x8),b8x8\n" \
    " - all   : i4x4,p8x8,(i8x8),b8x8,p4x4\n" \
    "(p4x4 requires p8x8. i8x8 requires 8x8dct).")

#define DIRECT_PRED_TEXT N_("Direct MV prediction mode")
274
#define DIRECT_PRED_LONGTEXT N_( "Direct MV prediction mode.")
Clément Stenac's avatar
Clément Stenac committed
275

276 277 278 279 280 281
#define DIRECT_PRED_SIZE_TEXT N_("Direct prediction size")
#define DIRECT_PRED_SIZE_LONGTEXT N_( "Direct prediction size: "\
    " -  0: 4x4\n" \
    " -  1: 8x8\n" \
    " - -1: smallest possible according to level\n" )

282 283 284
#define WEIGHTB_TEXT N_("Weighted prediction for B-frames")
#define WEIGHTB_LONGTEXT N_( "Weighted prediction for B-frames.")

285 286 287 288 289 290
#define WEIGHTP_TEXT N_("Weighted prediction for P-frames")
#define WEIGHTP_LONGTEXT N_(" Weighted prediction for P-frames: "\
    " - 0: Disabled\n"\
    " - 1: Blind offset\n"\
    " - 2: Smart analysis\n" )

291
#define ME_TEXT N_("Integer pixel motion estimation method")
292 293 294 295 296 297
#define ME_LONGTEXT N_( "Selects the motion estimation algorithm: "\
    " - dia: diamond search, radius 1 (fast)\n" \
    " - hex: hexagonal search, radius 2\n" \
    " - umh: uneven multi-hexagon search (better but slower)\n" \
    " - esa: exhaustive search (extremely slow, primarily for testing)\n" \
    " - tesa: hadamard exhaustive search (extremely slow, primarily for testing)\n" )
298

Clément Stenac's avatar
Clément Stenac committed
299 300 301
#define MERANGE_TEXT N_("Maximum motion vector search range")
#define MERANGE_LONGTEXT N_( "Maximum distance to search for " \
    "motion estimation, measured from predicted position(s). " \
302 303
    "Default of 16 is good for most footage, high motion sequences may " \
    "benefit from settings between 24 and 32. Range 0 to 64." )
304

305 306 307
#define MVRANGE_TEXT N_("Maximum motion vector length")
#define MVRANGE_LONGTEXT N_( "Maximum motion vector length in pixels. " \
    "-1 is automatic, based on level." )
308 309 310 311

#define MVRANGE_THREAD_TEXT N_("Minimum buffer space between threads")
#define MVRANGE_THREAD_LONGTEXT N_( "Minimum buffer space between threads. " \
    "-1 is automatic, based on number of threads." )
312

313
#define PSY_RD_TEXT N_( "Strength of psychovisual optimization, default is \"1.0:0.0\"")
Jean-Baptiste Kempf's avatar
Jean-Baptiste Kempf committed
314 315
#define PSY_RD_LONGTEXT N_( "First parameter controls if RD is on (subme>=6) or off.\n"\
        "Second parameter controls if Trellis is used on psychovisual optimization, " \
316 317
        "default off")

318
#define SUBME_TEXT N_("Subpixel motion estimation and partition decision " \
Clément Stenac's avatar
Clément Stenac committed
319
    "quality")
320 321 322
#define SUBME_LONGTEXT N_( "This parameter controls quality versus speed " \
    "tradeoffs involved in the motion estimation decision process " \
    "(lower = quicker and higher = better quality). Range 1 to 9." )
323

Clément Stenac's avatar
Clément Stenac committed
324
#define B_RDO_LONGTEXT N_( "RD based mode decision for B-frames. This " \
325
    "requires subme 6 (or higher).")
326

327
#define MIXED_REFS_TEXT N_("Decide references on a per partition basis")
Clément Stenac's avatar
Clément Stenac committed
328
#define MIXED_REFS_LONGTEXT N_( "Allows each 8x8 or 16x8 partition to " \
329 330
    "independently select a reference frame, as opposed to only one ref " \
    "per macroblock." )
331

332
#define CHROMA_ME_TEXT N_("Chroma in motion estimation")
Clément Stenac's avatar
Clément Stenac committed
333
#define CHROMA_ME_LONGTEXT N_( "Chroma ME for subpel and mode decision in " \
334
    "P-frames.")
335

336 337 338
#define BIME_LONGTEXT N_( "Joint bidirectional motion refinement.")

#define TRANSFORM_8X8DCT_TEXT N_("Adaptive spatial transform size")
Clément Stenac's avatar
Clément Stenac committed
339
#define TRANSFORM_8X8DCT_LONGTEXT N_( \
340
    "SATD-based decision for 8x8 transform in inter-MBs.")
341

Clément Stenac's avatar
Clément Stenac committed
342
#define TRELLIS_TEXT N_("Trellis RD quantization" )
343
#define TRELLIS_LONGTEXT N_( "Trellis RD quantization: \n" \
344 345 346 347
    " - 0: disabled\n" \
    " - 1: enabled only on the final encode of a MB\n" \
    " - 2: enabled on all mode decisions\n" \
    "This requires CABAC." )
348

349 350
#define FAST_PSKIP_TEXT N_("Early SKIP detection on P-frames")
#define FAST_PSKIP_LONGTEXT N_( "Early SKIP detection on P-frames.")
351

352 353 354 355
#define DCT_DECIMATE_TEXT N_("Coefficient thresholding on P-frames")
#define DCT_DECIMATE_LONGTEXT N_( "Coefficient thresholding on P-frames." \
    "Eliminate dct blocks containing only a small single coefficient.")

356 357 358
#define PSY_TEXT N_("Use Psy-optimizations")
#define PSY_LONGTEXT N_("Use all visual optimizations that can worsen both PSNR and SSIM")

359
/* Noise reduction 1 is too weak to measure, suggest at least 10 */
360
#define NR_TEXT N_("Noise reduction")
361 362
#define NR_LONGTEXT N_( "Dct-domain noise reduction. Adaptive pseudo-deadzone. " \
    "10 to 1000 seems to be a useful range." )
363

364 365 366 367 368 369 370 371
#define DEADZONE_INTER_TEXT N_("Inter luma quantization deadzone")
#define DEADZONE_INTER_LONGTEXT N_( "Set the size of the inter luma quantization deadzone. " \
    "Range 0 to 32." )

#define DEADZONE_INTRA_TEXT N_("Intra luma quantization deadzone")
#define DEADZONE_INTRA_LONGTEXT N_( "Set the size of the intra luma quantization deadzone. " \
    "Range 0 to 32." )

372
/* Input/Output */
373

374 375 376 377
#define NON_DETERMINISTIC_TEXT N_("Non-deterministic optimizations when threaded")
#define NON_DETERMINISTIC_LONGTEXT N_( "Slightly improve quality of SMP, " \
    "at the cost of repeatability.")

378
#define ASM_TEXT N_("CPU optimizations")
379
#define ASM_LONGTEXT N_( "Use assembler CPU optimizations.")
380

381 382
#define STATS_TEXT N_("Filename for 2 pass stats file")
#define STATS_LONGTEXT N_( "Filename for 2 pass stats file for multi-pass encoding.")
383

384 385 386 387 388 389 390
#define PSNR_TEXT N_("PSNR computation")
#define PSNR_LONGTEXT N_( "Compute and print PSNR stats. This has no effect on " \
    "the actual encoding quality." )

#define SSIM_TEXT N_("SSIM computation")
#define SSIM_LONGTEXT N_( "Compute and print SSIM stats. This has no effect on " \
    "the actual encoding quality." )
391

392 393
#define QUIET_TEXT N_("Quiet mode")

Clément Stenac's avatar
Clément Stenac committed
394
#define VERBOSE_TEXT N_("Statistics")
395 396
#define VERBOSE_LONGTEXT N_( "Print stats for each frame.")

397 398 399 400 401 402 403
#define SPS_ID_TEXT N_("SPS and PPS id numbers")
#define SPS_ID_LONGTEXT N_( "Set SPS and PPS id numbers to allow concatenating " \
    "streams with different settings.")

#define AUD_TEXT N_("Access unit delimiters")
#define AUD_LONGTEXT N_( "Generate access unit delimiter NAL units.")

404 405
#define LOOKAHEAD_TEXT N_("Framecount to use on frametype lookahead")
#define LOOKAHEAD_LONGTEXT N_("Framecount to use on frametype lookahead. " \
406
    "Currently default can cause sync-issues on unmuxable output, like rtsp-output without ts-mux" )
407

Ilkka Ollakka's avatar
Ilkka Ollakka committed
408
#define HRD_TEXT N_("HRD-timing information")
409 410
#define TUNE_TEXT N_("Default tune setting used" )
#define PRESET_TEXT N_("Default preset setting used" )
411

412 413 414
#define X264_OPTIONS_TEXT N_("x264 advanced options.")
#define X264_OPTIONS_LONGTEXT N_("x264 advanced options, in the form {opt=val,op2=val2} .")

415
static const char *const enc_me_list[] =
416
  { "dia", "hex", "umh", "esa", "tesa" };
417
static const char *const enc_me_list_text[] =
418 419
  { N_("dia"), N_("hex"), N_("umh"), N_("esa"), N_("tesa") };

420 421 422
static const char *const profile_list[] =
  { "baseline", "main", "high" };

423 424 425
static const char *const bpyramid_list[] =
  { "none", "strict", "normal" };

426
static const char *const enc_analyse_list[] =
427
  { "none", "fast", "normal", "slow", "all" };
428
static const char *const enc_analyse_list_text[] =
429
  { N_("None"), N_("Fast"), N_("Normal"), N_("Slow"), N_("All") };
430

431
static const char *const direct_pred_list[] =
432
  { "none", "spatial", "temporal", "auto" };
433
static const char *const direct_pred_list_text[] =
434
  { N_("None"), N_("Spatial"), N_("Temporal"), N_("Auto") };
Laurent Aimar's avatar
Laurent Aimar committed
435

436 437 438 439 440
static const int const framepacking_list[] =
  { -1, 0, 1, 2, 3, 4, 5 };
static const char *const framepacking_list_text[] =
  { "", N_("checkerboard"), N_("column alternation"), N_("row alternation"), N_("side by side"), N_("top bottom"), N_("frame alternation") };

441
vlc_module_begin ()
442
#ifdef MODULE_NAME_IS_x26410b
443
    set_description( N_("H.264/MPEG-4 Part 10/AVC encoder (x264 10-bit)"))
444 445
    set_capability( "encoder", 0 )
#else
446
    set_description( N_("H.264/MPEG-4 Part 10/AVC encoder (x264)"))
447
    set_capability( "encoder", 200 )
448
#endif
449 450 451
    set_callbacks( Open, Close )
    set_category( CAT_INPUT )
    set_subcategory( SUBCAT_INPUT_VCODEC )
Jean-Paul Saman's avatar
Jean-Paul Saman committed
452

453 454
/* Frame-type options */

455
    add_integer( SOUT_CFG_PREFIX "keyint", 250, KEYINT_TEXT,
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
456
                 KEYINT_LONGTEXT, false )
457

458
    add_integer( SOUT_CFG_PREFIX "min-keyint", 25, MIN_KEYINT_TEXT,
459
                 MIN_KEYINT_LONGTEXT, true )
460

461
#if X264_BUILD >= 102 && X264_BUILD <= 114
462
    add_string( SOUT_CFG_PREFIX "opengop", "none", OPENGOP_TEXT,
463
               OPENGOP_LONGTEXT, true )
464
        change_string_list( x264_open_gop_names, x264_open_gop_names )
465 466 467 468 469
#elif X264_BUILD > 114
    add_bool( SOUT_CFG_PREFIX "opengop", false, OPENGOP_TEXT,
               OPENGOP_LONGTEXT, true )
    add_bool( SOUT_CFG_PREFIX "bluray-compat", false, BLURAY_TEXT,
               BLURAY_LONGTEXT, true )
470
#endif
471

472
    add_integer( SOUT_CFG_PREFIX "scenecut", 40, SCENE_TEXT,
473
                 SCENE_LONGTEXT, true )
474
        change_integer_range( -1, 100 )
475

476
    add_obsolete_bool( SOUT_CFG_PREFIX "pre-scenecut" )
477

478
    add_integer( SOUT_CFG_PREFIX "bframes", 3, BFRAMES_TEXT,
479
                 BFRAMES_LONGTEXT, true )
480
        change_integer_range( 0, 16 )
481

482
    add_integer( SOUT_CFG_PREFIX "b-adapt", 1, B_ADAPT_TEXT,
483
                 B_ADAPT_LONGTEXT, true )
484
        change_integer_range( 0, 2 )
485

486
    add_integer( SOUT_CFG_PREFIX "b-bias", 0, B_BIAS_TEXT,
487
                 B_BIAS_LONGTEXT, true )
488
        change_integer_range( -100, 100 )
489

490
#if X264_BUILD >= 87
491
    add_string( SOUT_CFG_PREFIX "bpyramid", "normal", BPYRAMID_TEXT,
492
              BPYRAMID_LONGTEXT, true )
493
#else
494
    add_string( SOUT_CFG_PREFIX "bpyramid", "none", BPYRAMID_TEXT,
495
              BPYRAMID_LONGTEXT, true )
496
#endif
497
        change_string_list( bpyramid_list, bpyramid_list )
498

499
    add_bool( SOUT_CFG_PREFIX "cabac", true, CABAC_TEXT, CABAC_LONGTEXT,
500
              true )
501

502 503 504
    add_bool( SOUT_CFG_PREFIX "fullrange", false, FULLRANGE_TEXT, FULLRANGE_LONGTEXT,
              true )

505
    add_integer( SOUT_CFG_PREFIX "ref", 3, REF_TEXT,
506
                 REF_LONGTEXT, true )
507
        change_integer_range( 1, 16 )
508

509
    add_bool( SOUT_CFG_PREFIX "nf", false, NF_TEXT,
510
              NF_LONGTEXT, true )
511

512
    add_string( SOUT_CFG_PREFIX "deblock", "0:0", FILTER_TEXT,
513
                 FILTER_LONGTEXT, true )
514

515
    add_string( SOUT_CFG_PREFIX "psy-rd", "1.0:0.0", PSY_RD_TEXT,
516
                PSY_RD_LONGTEXT, true )
517

518
    add_bool( SOUT_CFG_PREFIX "psy", true, PSY_TEXT, PSY_LONGTEXT, true )
519

520
    add_string( SOUT_CFG_PREFIX "level", "0", LEVEL_TEXT,
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
521
               LEVEL_LONGTEXT, false )
522

523
    add_string( SOUT_CFG_PREFIX "profile", "high", PROFILE_TEXT,
524
               PROFILE_LONGTEXT, false )
525 526 527 528
        vlc_config_set (VLC_CONFIG_LIST,
            (sizeof(x264_profile_names) / sizeof (char*)) - 1,
            x264_profile_names, x264_profile_names);

529

530
    add_bool( SOUT_CFG_PREFIX "interlaced", false, INTERLACED_TEXT, INTERLACED_LONGTEXT,
531
              true )
532

533 534
#if X264_BUILD >= 111
    add_integer( SOUT_CFG_PREFIX "frame-packing", -1, FRAMEPACKING_TEXT, FRAMEPACKING_LONGTEXT, true )
535
        change_integer_list( framepacking_list, framepacking_list_text )
536 537 538
        change_integer_range( -1, 5)
#endif

539 540 541
    add_integer( SOUT_CFG_PREFIX "slices", 0, SLICE_COUNT, SLICE_COUNT_LONGTEXT, true )
    add_integer( SOUT_CFG_PREFIX "slice-max-size", 0, SLICE_MAX_SIZE, SLICE_MAX_SIZE_LONGTEXT, true )
    add_integer( SOUT_CFG_PREFIX "slice-max-mbs", 0, SLICE_MAX_MBS, SLICE_MAX_MBS_LONGTEXT, true )
542

543
#if X264_BUILD >= 89
544
    add_string( SOUT_CFG_PREFIX "hrd", "none", HRD_TEXT, HRD_TEXT, true )
545 546 547
        vlc_config_set (VLC_CONFIG_LIST,
            (sizeof(x264_nal_hrd_names) / sizeof (char*)) - 1,
            x264_nal_hrd_names, x264_nal_hrd_names);
Ilkka Ollakka's avatar
Ilkka Ollakka committed
548 549
#endif

550

551 552
/* Ratecontrol */

553
    add_integer( SOUT_CFG_PREFIX "qp", -1, QP_TEXT, QP_LONGTEXT,
554
                 true )
555
        change_integer_range( -1, 51 ) /* QP 0 -> lossless encoding */
556

557
    add_integer( SOUT_CFG_PREFIX "crf", 23, CRF_TEXT,
558
                 CRF_LONGTEXT, true )
559
        change_integer_range( 0, 51 )
560

561
    add_integer( SOUT_CFG_PREFIX "qpmin", 10, QPMIN_TEXT,
562
                 QPMIN_LONGTEXT, true )
563
        change_integer_range( 0, 51 )
564

565
    add_integer( SOUT_CFG_PREFIX "qpmax", 51, QPMAX_TEXT,
566
                 QPMAX_LONGTEXT, true )
567
        change_integer_range( 0, 51 )
Laurent Aimar's avatar
Laurent Aimar committed
568

569
    add_integer( SOUT_CFG_PREFIX "qpstep", 4, QPSTEP_TEXT,
570
                 QPSTEP_LONGTEXT, true )
571
        change_integer_range( 0, 51 )
572

573
    add_float( SOUT_CFG_PREFIX "ratetol", 1.0, RATETOL_TEXT,
574
               RATETOL_LONGTEXT, true )
575
        change_float_range( 0, 100 )
576

577
    add_integer( SOUT_CFG_PREFIX "vbv-maxrate", 0, VBV_MAXRATE_TEXT,
578
                 VBV_MAXRATE_LONGTEXT, true )
579

580
    add_integer( SOUT_CFG_PREFIX "vbv-bufsize", 0, VBV_BUFSIZE_TEXT,
581
                 VBV_BUFSIZE_LONGTEXT, true )
582

583
    add_float( SOUT_CFG_PREFIX "vbv-init", 0.9, VBV_INIT_TEXT,
584
               VBV_INIT_LONGTEXT, true )
585
        change_float_range( 0, 1 )
586

587
    add_float( SOUT_CFG_PREFIX "ipratio", 1.40, IPRATIO_TEXT,
588
               IPRATIO_LONGTEXT, true )
589
        change_float_range( 1, 2 )
590

591
    add_float( SOUT_CFG_PREFIX "pbratio", 1.30, PBRATIO_TEXT,
592
               PBRATIO_LONGTEXT, true )
593
        change_float_range( 1, 2 )
594

595
    add_integer( SOUT_CFG_PREFIX "chroma-qp-offset", 0, CHROMA_QP_OFFSET_TEXT,
596
                 CHROMA_QP_OFFSET_LONGTEXT, true )
597

598
    add_integer( SOUT_CFG_PREFIX "pass", 0, PASS_TEXT,
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
599
                 PASS_LONGTEXT, false )
600
        change_integer_range( 0, 3 )
601

602
    add_float( SOUT_CFG_PREFIX "qcomp", 0.60, QCOMP_TEXT,
603
               QCOMP_LONGTEXT, true )
604
        change_float_range( 0, 1 )
605

606
    add_float( SOUT_CFG_PREFIX "cplxblur", 20.0, CPLXBLUR_TEXT,
607
               CPLXBLUR_LONGTEXT, true )
608

609
    add_float( SOUT_CFG_PREFIX "qblur", 0.5, QBLUR_TEXT,
610
               QBLUR_LONGTEXT, true )
611

612
    add_integer( SOUT_CFG_PREFIX "aq-mode", X264_AQ_VARIANCE, AQ_MODE_TEXT,
613
                 AQ_MODE_LONGTEXT, true )
614
         change_integer_range( 0, 2 )
615
    add_float( SOUT_CFG_PREFIX "aq-strength", 1.0, AQ_STRENGTH_TEXT,
616
               AQ_STRENGTH_LONGTEXT, true )
617

618 619
/* Analysis */

620
    /* x264 partitions = none (default). set at least "normal" mode. */
621
    add_string( SOUT_CFG_PREFIX "partitions", "normal", ANALYSE_TEXT,
622
                ANALYSE_LONGTEXT, true )
623
        change_string_list( enc_analyse_list, enc_analyse_list_text )
624

625
    add_string( SOUT_CFG_PREFIX "direct", "spatial", DIRECT_PRED_TEXT,
626
                DIRECT_PRED_LONGTEXT, true )
627
        change_string_list( direct_pred_list, direct_pred_list_text )
628

629
    add_integer( SOUT_CFG_PREFIX "direct-8x8", 1, DIRECT_PRED_SIZE_TEXT,
630
                 DIRECT_PRED_SIZE_LONGTEXT, true )
631
        change_integer_range( -1, 1 )
632

633
    add_bool( SOUT_CFG_PREFIX "weightb", true, WEIGHTB_TEXT,
634
              WEIGHTB_LONGTEXT, true )
635

636
    add_integer( SOUT_CFG_PREFIX "weightp", 2, WEIGHTP_TEXT,
637
              WEIGHTP_LONGTEXT, true )
638 639
        change_integer_range( 0, 2 )

640
    add_string( SOUT_CFG_PREFIX "me", "hex", ME_TEXT,
641
                ME_LONGTEXT, true )
642
        change_string_list( enc_me_list, enc_me_list_text )
643

644
    add_integer( SOUT_CFG_PREFIX "merange", 16, MERANGE_TEXT,
645
                 MERANGE_LONGTEXT, true )
646
        change_integer_range( 1, 64 )
647

648
    add_integer( SOUT_CFG_PREFIX "mvrange", -1, MVRANGE_TEXT,
649
                 MVRANGE_LONGTEXT, true )
650

651
    add_integer( SOUT_CFG_PREFIX "mvrange-thread", -1, MVRANGE_THREAD_TEXT,
652
                 MVRANGE_THREAD_LONGTEXT, true )
653

654
    add_integer( SOUT_CFG_PREFIX "subme", 7, SUBME_TEXT,
655
                 SUBME_LONGTEXT, true )
656

657
    add_obsolete_bool( SOUT_CFG_PREFIX "b-rdo" )
658

659
    add_bool( SOUT_CFG_PREFIX "mixed-refs", true, MIXED_REFS_TEXT,
660
              MIXED_REFS_LONGTEXT, true )
661

662
    add_bool( SOUT_CFG_PREFIX "chroma-me", true, CHROMA_ME_TEXT,
663
              CHROMA_ME_LONGTEXT, true )
664

665
    add_obsolete_bool( SOUT_CFG_PREFIX "bime" )
666

667
    add_bool( SOUT_CFG_PREFIX "8x8dct", true, TRANSFORM_8X8DCT_TEXT,
668
              TRANSFORM_8X8DCT_LONGTEXT, true )
669

670
    add_integer( SOUT_CFG_PREFIX "trellis", 1, TRELLIS_TEXT,
671
                 TRELLIS_LONGTEXT, true )
672
        change_integer_range( 0, 2 )
673

674
    add_integer( SOUT_CFG_PREFIX "lookahead", 40, LOOKAHEAD_TEXT,
675
                 LOOKAHEAD_LONGTEXT, true )
676 677
        change_integer_range( 0, 60 )

678
    add_bool( SOUT_CFG_PREFIX "intra-refresh", false, INTRAREFRESH_TEXT,
679
              INTRAREFRESH_LONGTEXT, true )
680

681
    add_bool( SOUT_CFG_PREFIX "mbtree", true, MBTREE_TEXT, MBTREE_LONGTEXT, true )
682

683
    add_bool( SOUT_CFG_PREFIX "fast-pskip", true, FAST_PSKIP_TEXT,
684
              FAST_PSKIP_LONGTEXT, true )
685

686
    add_bool( SOUT_CFG_PREFIX "dct-decimate", true, DCT_DECIMATE_TEXT,
687
              DCT_DECIMATE_LONGTEXT, true )
688

689
    add_integer( SOUT_CFG_PREFIX "nr", 0, NR_TEXT,
690
                 NR_LONGTEXT, true )
691
        change_integer_range( 0, 1000 )
692

693
    add_integer( SOUT_CFG_PREFIX "deadzone-inter", 21, DEADZONE_INTER_TEXT,
694
                 DEADZONE_INTRA_LONGTEXT, true )
695
        change_integer_range( 0, 32 )
696

697
    add_integer( SOUT_CFG_PREFIX "deadzone-intra", 11, DEADZONE_INTRA_TEXT,
698
                 DEADZONE_INTRA_LONGTEXT, true )
699
        change_integer_range( 0, 32 )
700

701 702
/* Input/Output */

703
    add_bool( SOUT_CFG_PREFIX "non-deterministic", false, NON_DETERMINISTIC_TEXT,
704
              NON_DETERMINISTIC_LONGTEXT, true )
705

706
    add_bool( SOUT_CFG_PREFIX "asm", true, ASM_TEXT,
707
              ASM_LONGTEXT, true )
708

709
    /* x264 psnr = 1 (default). disable PSNR computation for speed. */
710
    add_bool( SOUT_CFG_PREFIX "psnr", false, PSNR_TEXT,
711
              PSNR_LONGTEXT, true )
712

713
    /* x264 ssim = 1 (default). disable SSIM computation for speed. */
714
    add_bool( SOUT_CFG_PREFIX "ssim", false, SSIM_TEXT,
715
              SSIM_LONGTEXT, true )
716

717
    add_bool( SOUT_CFG_PREFIX "quiet", false, QUIET_TEXT,
718
              QUIET_TEXT, true )
719

720
    add_integer( SOUT_CFG_PREFIX "sps-id", 0, SPS_ID_TEXT,
721
                 SPS_ID_LONGTEXT, true )
722

723
    add_bool( SOUT_CFG_PREFIX "aud", false, AUD_TEXT,
724
              AUD_LONGTEXT, true )
725

726
    add_bool( SOUT_CFG_PREFIX "verbose", false, VERBOSE_TEXT,
727
              VERBOSE_LONGTEXT, true )
728

729
    add_string( SOUT_CFG_PREFIX "stats", "x264_2pass.log", STATS_TEXT,
730
                STATS_LONGTEXT, true )
731

732
    add_string( SOUT_CFG_PREFIX "preset", NULL , PRESET_TEXT , PRESET_TEXT, false )
733 734 735
        vlc_config_set (VLC_CONFIG_LIST,
            (sizeof(x264_preset_names) / sizeof (char*)) - 1,
            x264_preset_names, x264_preset_names);
736
    add_string( SOUT_CFG_PREFIX "tune", NULL , TUNE_TEXT, TUNE_TEXT, false )
737 738 739
        vlc_config_set (VLC_CONFIG_LIST,
            (sizeof(x264_tune_names) / sizeof (char*)) - 1,
            x264_tune_names, x264_tune_names);
740

741 742 743
    add_string( SOUT_CFG_PREFIX "options", NULL, X264_OPTIONS_TEXT,
                X264_OPTIONS_LONGTEXT, true )

744
vlc_module_end ()
745 746 747 748

/*****************************************************************************
 * Local prototypes
 *****************************************************************************/
749
static const char *const ppsz_sout_options[] = {
750
    "8x8dct", "asm", "aud", "bframes", "bime", "bpyramid",
751 752
    "b-adapt", "b-bias", "b-rdo", "cabac", "chroma-me", "chroma-qp-offset",
    "cplxblur", "crf", "dct-decimate", "deadzone-inter", "deadzone-intra",
753 754
    "deblock", "direct", "direct-8x8", "fast-pskip",
    "interlaced", "ipratio", "keyint", "level",
755 756 757
    "me", "merange", "min-keyint", "mixed-refs", "mvrange", "mvrange-thread",
    "nf", "non-deterministic", "nr", "partitions", "pass", "pbratio",
    "pre-scenecut", "psnr", "qblur", "qp", "qcomp", "qpstep", "qpmax",
758 759
    "qpmin", "quiet", "ratetol", "ref", "scenecut",
    "sps-id", "ssim", "stats", "subme", "trellis",
760 761
    "verbose", "vbv-bufsize", "vbv-init", "vbv-maxrate", "weightb", "weightp",
    "aq-mode", "aq-strength", "psy-rd", "psy", "profile", "lookahead", "slices",
762
    "slice-max-size", "slice-max-mbs", "intra-refresh", "mbtree", "hrd",
763
    "tune","preset", "opengop", "bluray-compat", "frame-packing", "options",
764
    "fullrange",
765
    NULL
Laurent Aimar's avatar
Laurent Aimar committed
766 767
};

768 769 770 771 772 773 774
static block_t *Encode( encoder_t *, picture_t * );

struct encoder_sys_t
{
    x264_t          *h;
    x264_param_t    param;

775
    mtime_t         i_initial_delay;
Laurent Aimar's avatar
Laurent Aimar committed
776

777
    char            *psz_stat_name;
778
    int             i_sei_size;
779
    uint32_t         i_colorspace;
780
    uint8_t         *p_sei;
781 782
};

783 784 785 786 787
#ifdef PTW32_STATIC_LIB
static vlc_mutex_t pthread_win32_mutex = VLC_STATIC_MUTEX;
static int pthread_win32_count = 0;
#endif

788 789 790 791 792 793 794
/*****************************************************************************
 * Open: probe the encoder
 *****************************************************************************/
static int  Open ( vlc_object_t *p_this )
{
    encoder_t     *p_enc = (encoder_t *)p_this;
    encoder_sys_t *p_sys;
795 796
    int i_val;
    char *psz_val;
797
    int i_qmin = 0, i_qmax = 0;
798 799
    x264_nal_t    *nal;
    int i, i_nal;
800
    bool fullrange = false;
801

802
    if( p_enc->fmt_out.i_codec != VLC_CODEC_H264 &&
803
        !p_enc->b_force )
804 805 806
    {
        return VLC_EGENERIC;
    }
807 808
    /* X264_POINTVER or X264_VERSION are not available */
    msg_Dbg ( p_enc, "version x264 0.%d.X", X264_BUILD );
809 </