x264 settings map
x264's command line has a table of 168 long options. This page gathers 60 entries this course has explained, each on the page about the tool it controls: options, three values of --tune and one library parameter. They are arranged by the stage of the encoder each one acts on, with the value x264 starts from beside it and a link back to the explanation.
Browse a stage
Choose a stage to list its options. The stages follow the order of the course, from input and color through entropy coding and the in-loop filter to rate control and the stream. The defaults are x264's starting values at the commit linked, which are also the medium preset, before a tuning, your own options and x264's own checks are applied; some depend on the build or the input. They do not report what a particular encode ran with: under --preset veryfast an omitted --trellis starts at 0, not the 1 shown. An option that starts with --no- has the tool switched on as its default. "Set by presets" keeps only the options that at least one of the ten presets changes.
| Option and default | What it does |
|---|
x264_param_default; the descriptions are shortened from the pages they link to. cabac-idc is a library parameter with no command-line option.Where the options act
- Rate control has the most entries, 15, and no preset directly changes any of them. Presets do change the lookahead, adaptive quantization, macroblock-tree and coding tools, so a fixed rate factor need not give the same size or quality at two presets.
- Presets reach all 5 prediction options and 4 of the 8 for frame structure. There they set search effort and how far the lookahead sees.
- Of the 8 perceptual options, presets set 2: the fastest presets switch off adaptive quantization and macroblock-tree. The rest are left to tunings.
- No preset touches input and color, or measurement and stream.
Reading a default
- "Unset" in rate control means the mode is not in use. Constant rate factor at 23 is the mode unless
--qpor--bitrateis given. No buffer is modeled by default: the model needs a size and a fill rate, and in average bitrate mode x264 takes a missing fill rate from the target. - "Automatic" values are computed from other settings. The shortest keyframe distance comes from
--keyintand the frame rate; the profile and level come from the tools in use and the picture's size and rate. - "From the input" values describe the pictures to the decoder.
--colormatrixonly writes a label.--rangewrites one too, and the x264 program converts the samples when the input's range differs from it. - A tuning is applied after the preset and changes options no preset touches, such as the psychovisual strengths and the dead zones.
What the map leaves out
The options not listed are mostly outside the coding tools: threading and slices, interlacing, the labels that describe color and timing, input and output handling. A few coding options are not explained in this course and are named here because presets or x264's own checks touch them: --weightp and --weightb, --direct, --nr and --intra-refresh. How settings switch each other off is the subject of the interaction map, later in this unit.
Sources
Read 2026-11-15, at the commit linked.
- x264 at commit c24e06c (GitHub mirror):
x264_param_default, where every default in the table was read, the presets and the tunings incommon/base.c; the table of 168 long options inx264.c, with--intra-refresh,--direct,--weightpand--nr. Read 2026-11-16: the preset and tuning applied before other options, the fill rate taken from the target inencoder/encoder.c, and infilters/video/resize.cthe test for a range mismatch and the conversion to the output range. Each option's behavior is cited on the page it links to. - Not checked: the options this course does not explain, beyond their presence in the option list; how many of the 168 the 60 entries stand for, since three are values of one option, one is not in the table, and the table holds negative forms and aliases; the default of
--output-csp, which is set by the x264 program and was read for an earlier page; short options and aliases, which the count of 168 does not separate.