mirror of
https://github.com/ultravideo/uvg266.git
synced 2024-11-27 11:24:05 +00:00
Update command line help
- Adds missing default values. - Adds help for --crypto and --key. - Adds help for --rd=3. - Adds help for --sao options. - Some changes to help wording.
This commit is contained in:
parent
3606860504
commit
7185519a1b
266
README.md
266
README.md
|
@ -53,14 +53,14 @@ Usage:
|
||||||
kvazaar -i <input> --input-res <width>x<height> -o <output>
|
kvazaar -i <input> --input-res <width>x<height> -o <output>
|
||||||
|
|
||||||
Required:
|
Required:
|
||||||
-i, --input : Input file
|
-i, --input <filename> : Input file
|
||||||
--input-res <res> : Input resolution [auto]
|
--input-res <res> : Input resolution [auto]
|
||||||
auto: detect from file name
|
- auto: Detect from file name.
|
||||||
<int>x<int>: width times height
|
- <int>x<int>: width times height
|
||||||
-o, --output : Output file
|
-o, --output <filename> : Output file
|
||||||
|
|
||||||
Presets:
|
Presets:
|
||||||
--preset=<preset> : Set options to a preset [medium]
|
--preset <preset> : Set options to a preset [medium]
|
||||||
- ultrafast, superfast, veryfast, faster,
|
- ultrafast, superfast, veryfast, faster,
|
||||||
fast, medium, slow, slower, veryslow
|
fast, medium, slow, slower, veryslow
|
||||||
placebo
|
placebo
|
||||||
|
@ -68,160 +68,170 @@ Presets:
|
||||||
Input:
|
Input:
|
||||||
-n, --frames <integer> : Number of frames to code [all]
|
-n, --frames <integer> : Number of frames to code [all]
|
||||||
--seek <integer> : First frame to code [0]
|
--seek <integer> : First frame to code [0]
|
||||||
--input-fps <num>[/<denom>] : Framerate of the input video [25.0]
|
--input-fps <num>[/<denom>] : Frame rate of the input video [25]
|
||||||
--source-scan-type <string> : Set source scan type [progressive].
|
--source-scan-type <string> : Source scan type [progressive]
|
||||||
- progressive: progressive scan
|
- progressive: Progressive scan
|
||||||
- tff: top field first
|
- tff: Top field first
|
||||||
- bff: bottom field first
|
- bff: Bottom field first
|
||||||
--input-format : P420 or P400
|
--input-format <string> : P420 or P400 [P420]
|
||||||
--input-bitdepth : 8-16
|
--input-bitdepth <int> : 8-16 [8]
|
||||||
--loop-input : Re-read input file forever
|
--loop-input : Re-read input file forever.
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
--help : Print this help message and exit
|
--help : Print this help message and exit.
|
||||||
--version : Print version information and exit
|
--version : Print version information and exit.
|
||||||
--aud : Use access unit delimiters
|
--(no-)aud : Use access unit delimiters. [disabled]
|
||||||
--debug <string> : Output encoders reconstruction.
|
--debug <filename> : Output internal reconstruction.
|
||||||
--cpuid <integer> : Disable runtime cpu optimizations with value 0.
|
--(no-)cpuid : Enable runtime CPU optimizations. [enabled]
|
||||||
--hash : Decoded picture hash [checksum]
|
--hash <string> : Decoded picture hash [checksum]
|
||||||
- none: 0 bytes
|
- none: 0 bytes
|
||||||
- checksum: 18 bytes
|
- checksum: 18 bytes
|
||||||
- md5: 56 bytes
|
- md5: 56 bytes
|
||||||
--no-psnr : Don't calculate PSNR for frames
|
--(no-)psnr : Calculate PSNR for frames. [enabled]
|
||||||
--no-info : Don't add encoder info SEI.
|
--(no-)info : Add encoder info SEI. [enabled]
|
||||||
|
--crypto <string> : Selective encryption. Crypto support must be
|
||||||
|
enabled at compile-time. Can be 'on' or 'off' or
|
||||||
|
a list of features separated with a '+'. [off]
|
||||||
|
- on: Enable all encryption features.
|
||||||
|
- off: Disable selective encryption.
|
||||||
|
- mvs: Motion vector magnitudes.
|
||||||
|
- mv_signs: Motion vector signs.
|
||||||
|
- trans_coeffs: Coefficient magnitudes.
|
||||||
|
- trans_coeff_signs: Coefficient signs.
|
||||||
|
- intra_pred_modes: Intra prediction modes.
|
||||||
|
--key <string> : Encryption key [16,213,27,56,255,127,242,112,
|
||||||
|
97,126,197,204,25,59,38,30]
|
||||||
|
|
||||||
Video structure:
|
Video structure:
|
||||||
-q, --qp <integer> : Quantization Parameter [32]
|
-q, --qp <integer> : Quantization parameter [22]
|
||||||
-p, --period <integer> : Period of intra pictures [0]
|
-p, --period <integer> : Period of intra pictures [64]
|
||||||
- 0: only first picture is intra
|
- 0: Only first picture is intra.
|
||||||
- 1: all pictures are intra
|
- 1: All pictures are intra.
|
||||||
- 2-N: every Nth picture is intra
|
- N: Every Nth picture is intra.
|
||||||
--vps-period <integer> : Specify how often the video parameter set is
|
--vps-period <integer> : How often the video parameter set is re-sent [0]
|
||||||
re-sent. [0]
|
- 0: Only send VPS with the first frame.
|
||||||
- 0: only send VPS with the first frame
|
- N: Send VPS with every Nth intra frame.
|
||||||
- N: send VPS with every Nth intra frame
|
-r, --ref <integer> : Number of reference frames, in range 1..15 [1]
|
||||||
-r, --ref <integer> : Reference frames, range 1..15 [3]
|
--gop <string> : GOP structure [lp-g4d3t1]
|
||||||
--gop <string> : Definition of GOP structure [0]
|
- 0: Disabled
|
||||||
- 0: disabled
|
|
||||||
- 8: B-frame pyramid of length 8
|
- 8: B-frame pyramid of length 8
|
||||||
- lp-<string>: lp-gop definition
|
- lp-<string>: Low-delay P-frame GOP
|
||||||
(e.g. lp-g8d4t2, see README)
|
(e.g. lp-g8d4t2, see README)
|
||||||
--cqmfile <string> : Custom Quantization Matrices from a file
|
--cqmfile <filename> : Read custom quantization matrices from a file.
|
||||||
--bitrate <integer> : Target bitrate. [0]
|
--bitrate <integer> : Target bitrate [0]
|
||||||
- 0: disable rate-control
|
- 0: Disable rate control.
|
||||||
- N: target N bits per second
|
- N: Target N bits per second.
|
||||||
--lossless : Use lossless coding
|
--(no-)lossless : Use lossless coding. [disabled]
|
||||||
--mv-constraint : Constrain movement vectors
|
--mv-constraint <string> : Constrain movement vectors. [none]
|
||||||
- none: no constraint
|
- none: No constraint
|
||||||
- frametile: constrain within the tile
|
- frametile: Constrain within the tile.
|
||||||
- frametilemargin: constrain even more
|
- frametilemargin: Constrain even more.
|
||||||
--roi <string> : Use a delta QP map for region of interest
|
--roi <filename> : Use a delta QP map for region of interest.
|
||||||
Read an array of delta QP values from
|
Reads an array of delta QP values from a text
|
||||||
a file, where the first two values are the
|
file. The file format is: width and height of
|
||||||
width and height, followed by width*height
|
the QP delta map followed by width*height delta
|
||||||
delta QP values in raster order.
|
QP values in raster order. The map can be of any
|
||||||
The delta QP map can be any size or aspect
|
size and will be scaled to the video size.
|
||||||
ratio, and will be mapped to LCU's.
|
--(no-)erp-aqp : Use adaptive QP for 360 degree video with
|
||||||
--(no-)erp-aqp : Use adaptive QP for 360 video with
|
equirectangular projection. [disabled]
|
||||||
equirectangular projection
|
|
||||||
--level <number> : Use the given HEVC level in the output and give
|
--level <number> : Use the given HEVC level in the output and give
|
||||||
an error if the input doesn't fit to it's
|
an error if level limits are exceeded. [6.2]
|
||||||
limits [6.2]
|
- 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6,
|
||||||
Allowed values are 1, 2, 2.1, 3, 3.1, 4, 4.1
|
6.1, 6.2
|
||||||
5, 5.1, 5.2, 6, 6.1 and 6.2. The dot is
|
--force-level <number> : Same as --level but warnings instead of errors.
|
||||||
optional.
|
--high-tier : Used with --level. Use high tier bitrate limits
|
||||||
--force-level <number> : Same as --level, except instead of errors you
|
instead of the main tier limits during encoding.
|
||||||
get warnings
|
|
||||||
--high-tier : Used with --level. Tells the encoder to use
|
|
||||||
high-tier bitrate limits instead of the
|
|
||||||
main-tier limits during encoding.
|
|
||||||
|
|
||||||
Compression tools:
|
Compression tools:
|
||||||
--deblock [<beta:tc>] : Deblocking
|
--(no-)deblock <beta:tc> : Deblocking filter. [0:0]
|
||||||
- beta: between -6 and 6
|
- beta: Between -6 and 6
|
||||||
- tc: between -6 and 6
|
- tc: Between -6 and 6
|
||||||
--(no-)sao : Sample Adaptive Offset
|
--sao <string> : Sample Adaptive Offset [full]
|
||||||
--(no-)rdoq : Rate-Distortion Optimized Quantization
|
- off: SAO disabled
|
||||||
--(no-)signhide : Sign Hiding
|
- band: Band offset only
|
||||||
--(no-)smp : Symmetric Motion Partition
|
- edge: Edge offset only
|
||||||
--(no-)amp : Asymmetric Motion Partition
|
- full: Full SAO
|
||||||
--rd <integer> : Intra mode search complexity
|
--(no-)rdoq : Rate-distortion optimized quantization [enabled]
|
||||||
- 0: skip intra if inter is good enough
|
--(no-)rdoq-skip : Skip RDOQ for 4x4 blocks. [enabled]
|
||||||
- 1: rough intra mode search with SATD
|
--(no-)signhide : Sign hiding [disabled]
|
||||||
- 2: refine intra mode search with SSE
|
--(no-)smp : Symmetric motion partition [disabled]
|
||||||
--(no-)mv-rdo : Rate-Distortion Optimized motion vector costs
|
--(no-)amp : Asymmetric motion partition [disabled]
|
||||||
--(no-)full-intra-search
|
--rd <integer> : Intra mode search complexity [1]
|
||||||
: Try all intra modes during rough search.
|
- 0: Skip intra if inter is good enough.
|
||||||
--(no-)transform-skip : Transform skip
|
- 1: Rough intra mode search with SATD.
|
||||||
--me <string> : Integer motion estimation
|
- 2: Refine intra mode search with SSE.
|
||||||
|
- 3: Try all intra modes and enable intra
|
||||||
|
chroma mode search.
|
||||||
|
--(no-)mv-rdo : Rate-distortion optimized motion vector costs
|
||||||
|
[disabled]
|
||||||
|
--(no-)full-intra-search : Try all intra modes during rough search.
|
||||||
|
[disabled]
|
||||||
|
--(no-)transform-skip : Try transform skip [disabled]
|
||||||
|
--me <string> : Integer motion estimation algorithm [hexbs]
|
||||||
- hexbs: Hexagon Based Search
|
- hexbs: Hexagon Based Search
|
||||||
- tz: Test Zone Search
|
- tz: Test Zone Search
|
||||||
- full: Full Search
|
- full: Full Search
|
||||||
- full8, full16, full32, full64
|
- full8, full16, full32, full64
|
||||||
- dia: Diamond Search
|
- dia: Diamond Search
|
||||||
--me-steps <integer> : How many search steps does the motion estimation
|
--me-steps <integer> : Motion estimation search step limit. Only
|
||||||
do before cutting off [-1]
|
affects 'hexbs' and 'dia'. [-1]
|
||||||
Has effect only for 'hexbs' and 'dia'
|
--subme <integer> : Fractional pixel motion estimation level [4]
|
||||||
--subme <integer> : Set fractional pixel motion estimation level
|
- 0: Integer motion estimation only
|
||||||
- 0: only integer motion estimation
|
|
||||||
- 1: + 1/2-pixel horizontal and vertical
|
- 1: + 1/2-pixel horizontal and vertical
|
||||||
- 2: + 1/2-pixel diagonal
|
- 2: + 1/2-pixel diagonal
|
||||||
- 3: + 1/4-pixel horizontal and vertical
|
- 3: + 1/4-pixel horizontal and vertical
|
||||||
- 4: + 1/4-pixel diagonal
|
- 4: + 1/4-pixel diagonal
|
||||||
--pu-depth-inter <int>-<int>
|
--pu-depth-inter <int>-<int> : Inter prediction units sizes [1-3]
|
||||||
: Range for sizes for inter predictions
|
|
||||||
- 0, 1, 2, 3: from 64x64 to 8x8
|
- 0, 1, 2, 3: from 64x64 to 8x8
|
||||||
--pu-depth-intra <int>-<int> : Range for sizes for intra predictions
|
--pu-depth-intra <int>-<int> : Intra prediction units sizes [1-3]
|
||||||
- 0, 1, 2, 3, 4: from 64x64 to 4x4
|
- 0, 1, 2, 3, 4: from 64x64 to 4x4
|
||||||
--(no-)bipred : Bi-prediction
|
--tr-depth-intra <int> : Transform split depth for intra blocks [0]
|
||||||
--(no-)cu-split-termination
|
--(no-)bipred : Bi-prediction [disabled]
|
||||||
: CU split search termination condition
|
--cu-split-termination <string> : CU split search termination [zero]
|
||||||
- off: Never terminate cu-split search
|
- off: Don't terminate early.
|
||||||
- zero: Terminate with zero residual
|
- zero: Terminate when residual is zero.
|
||||||
--(no-)me-early-termination : ME early termination condition
|
--me-early-termination <string> : Motion estimation termination [on]
|
||||||
- off: Don't terminate early
|
- off: Don't terminate early.
|
||||||
- on: Terminate early
|
- on: Terminate early.
|
||||||
- sensitive: Terminate even earlier
|
- sensitive: Terminate even earlier.
|
||||||
--(no-)implicit-rdpcm : Implicit residual DPCM
|
--(no-)implicit-rdpcm : Implicit residual DPCM. Currently only supported
|
||||||
Currently only supported with lossless coding.
|
with lossless coding. [disabled]
|
||||||
--(no-)tmvp : Temporal Motion Vector Prediction
|
--(no-)tmvp : Temporal motion vector prediction [enabled]
|
||||||
--(no-)rdoq-skip : Skips RDOQ for 4x4 blocks
|
|
||||||
|
|
||||||
Parallel processing:
|
Parallel processing:
|
||||||
--threads <integer> : Number of threads to use [auto]
|
--threads <integer> : Number of threads to use [auto]
|
||||||
- 0: process everything with main thread
|
- 0: Process everything with main thread.
|
||||||
- N: use N threads for encoding
|
- N: Use N threads for encoding.
|
||||||
- auto: select based on number of cores
|
- auto: Select automatically.
|
||||||
--owf <integer> : Frame parallelism [auto]
|
--owf <integer> : Frame-level parallelism [auto]
|
||||||
- N: Process N-1 frames at a time
|
- N: Process N-1 frames at a time.
|
||||||
- auto: Select automatically
|
- auto: Select automatically.
|
||||||
--(no-)wpp : Wavefront parallel processing [enabled]
|
--(no-)wpp : Wavefront parallel processing.
|
||||||
Enabling tiles automatically disables WPP.
|
Enabling tiles automatically disables WPP. To
|
||||||
To enable WPP with tiles, re-enable it after
|
enable WPP with tiles, re-enable it after
|
||||||
enabling tiles.
|
enabling tiles. [enabled]
|
||||||
--tiles <int>x<int> : Split picture into width x height uniform tiles.
|
--tiles <int>x<int> : Split picture into width x height uniform tiles.
|
||||||
--tiles-width-split <string>|u<int> :
|
--tiles-width-split <string>|u<int> :
|
||||||
Specifies a comma separated list of pixel
|
- <string>: A comma-separated list of tile
|
||||||
positions of tiles columns separation
|
column pixel coordinates.
|
||||||
coordinates.
|
- u<int>: Number of tile columns of uniform
|
||||||
Can also be u, followed by a single int n, in
|
width.
|
||||||
which case it produces columns of uniform width.
|
|
||||||
--tiles-height-split <string>|u<int> :
|
--tiles-height-split <string>|u<int> :
|
||||||
Specifies a comma separated list of pixel
|
- <string>: A comma-separated list of tile row
|
||||||
positions of tiles rows separation coordinates.
|
column pixel coordinates.
|
||||||
Can also be u followed by and a single int n, in
|
- u<int>: Number of tile rows of uniform
|
||||||
which case it produces rows of uniform height.
|
height.
|
||||||
--slices <string> : Control how slices are used
|
--slices <string> : Control how slices are used.
|
||||||
- tiles: put tiles in independent slices
|
- tiles: Put tiles in independent slices.
|
||||||
- wpp: put rows in dependent slices
|
- wpp: Put rows in dependent slices.
|
||||||
- tiles+wpp: do both
|
- tiles+wpp: Do both.
|
||||||
|
|
||||||
Video Usability Information:
|
Video Usability Information:
|
||||||
--sar <width:height> : Specify Sample Aspect Ratio
|
--sar <width:height> : Specify sample aspect ratio
|
||||||
--overscan <string> : Specify crop overscan setting [undef]
|
--overscan <string> : Specify crop overscan setting [undef]
|
||||||
- undef, show, crop
|
- undef, show, crop
|
||||||
--videoformat <string> : Specify video format [undef]
|
--videoformat <string> : Specify video format [undef]
|
||||||
- component, pal, ntsc, secam, mac, undef
|
- undef, component, pal, ntsc, secam, mac
|
||||||
--range <string> : Specify color range [tv]
|
--range <string> : Specify color range [tv]
|
||||||
- tv, pc
|
- tv, pc
|
||||||
--colorprim <string> : Specify color primaries [undef]
|
--colorprim <string> : Specify color primaries [undef]
|
||||||
|
@ -238,8 +248,8 @@ Video Usability Information:
|
||||||
--chromaloc <integer> : Specify chroma sample location (0 to 5) [0]
|
--chromaloc <integer> : Specify chroma sample location (0 to 5) [0]
|
||||||
|
|
||||||
Deprecated parameters: (might be removed at some point)
|
Deprecated parameters: (might be removed at some point)
|
||||||
-w, --width : Use --input-res
|
-w, --width <integer> : Use --input-res.
|
||||||
-h, --height : Use --input-res
|
-h, --height <integer> : Use --input-res.
|
||||||
```
|
```
|
||||||
[comment]: # (END KVAZAAR HELP MESSAGE)
|
[comment]: # (END KVAZAAR HELP MESSAGE)
|
||||||
|
|
||||||
|
|
300
doc/kvazaar.1
300
doc/kvazaar.1
|
@ -1,24 +1,24 @@
|
||||||
.TH KVAZAAR "1" "November 2017" "kvazaar v1.2.0" "User Commands"
|
.TH KVAZAAR "1" "March 2018" "kvazaar v1.2.0" "User Commands"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
kvazaar \- open source HEVC encoder
|
kvazaar \- open source HEVC encoder
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
\fBkvazaar \fR\-i <input> \-\-input\-res <width>x<height> \-o <output>
|
\fBkvazaar \fR\-i <input> \-\-input\-res <width>x<height> \-o <output>
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.TP
|
.TP
|
||||||
\fB\-i\fR, \fB\-\-input
|
\fB\-i\fR, \fB\-\-input <filename>
|
||||||
Input file
|
Input file
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-input\-res <res>
|
\fB\-\-input\-res <res>
|
||||||
Input resolution [auto]
|
Input resolution [auto]
|
||||||
auto: detect from file name
|
\- auto: Detect from file name.
|
||||||
<int>x<int>: width times height
|
\- <int>x<int>: width times height
|
||||||
.TP
|
.TP
|
||||||
\fB\-o\fR, \fB\-\-output
|
\fB\-o\fR, \fB\-\-output <filename>
|
||||||
Output file
|
Output file
|
||||||
|
|
||||||
.SS "Presets:"
|
.SS "Presets:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-preset=<preset>
|
\fB\-\-preset <preset>
|
||||||
Set options to a preset [medium]
|
Set options to a preset [medium]
|
||||||
\- ultrafast, superfast, veryfast, faster,
|
\- ultrafast, superfast, veryfast, faster,
|
||||||
fast, medium, slow, slower, veryslow
|
fast, medium, slow, slower, veryslow
|
||||||
|
@ -32,241 +32,281 @@ Number of frames to code [all]
|
||||||
\fB\-\-seek <integer>
|
\fB\-\-seek <integer>
|
||||||
First frame to code [0]
|
First frame to code [0]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-input\-fps <num>/<denom>
|
\fB\-\-input\-fps <num>[/<denom>]
|
||||||
Framerate of the input video [25.0]
|
Frame rate of the input video [25]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-source\-scan\-type <string>
|
\fB\-\-source\-scan\-type <string>
|
||||||
Set source scan type [progressive].
|
Source scan type [progressive]
|
||||||
\- progressive: progressive scan
|
\- progressive: Progressive scan
|
||||||
\- tff: top field first
|
\- tff: Top field first
|
||||||
\- bff: bottom field first
|
\- bff: Bottom field first
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-input\-format
|
\fB\-\-input\-format <string>
|
||||||
P420 or P400
|
P420 or P400 [P420]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-input\-bitdepth
|
\fB\-\-input\-bitdepth <int>
|
||||||
8\-16
|
8\-16 [8]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-loop\-input
|
\fB\-\-loop\-input
|
||||||
Re\-read input file forever
|
Re\-read input file forever.
|
||||||
|
|
||||||
.SS "Options:"
|
.SS "Options:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-help
|
\fB\-\-help
|
||||||
Print this help message and exit
|
Print this help message and exit.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-version
|
\fB\-\-version
|
||||||
Print version information and exit
|
Print version information and exit.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-aud
|
\fB\-\-(no\-)aud
|
||||||
Use access unit delimiters
|
Use access unit delimiters. [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-debug <string>
|
\fB\-\-debug <filename>
|
||||||
Output encoders reconstruction.
|
Output internal reconstruction.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-cpuid <integer>
|
\fB\-\-(no\-)cpuid
|
||||||
Disable runtime cpu optimizations with value 0.
|
Enable runtime CPU optimizations. [enabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-hash
|
\fB\-\-hash <string>
|
||||||
Decoded picture hash [checksum]
|
Decoded picture hash [checksum]
|
||||||
\- none: 0 bytes
|
\- none: 0 bytes
|
||||||
\- checksum: 18 bytes
|
\- checksum: 18 bytes
|
||||||
\- md5: 56 bytes
|
\- md5: 56 bytes
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-no\-psnr
|
\fB\-\-(no\-)psnr
|
||||||
Don't calculate PSNR for frames
|
Calculate PSNR for frames. [enabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-no\-info
|
\fB\-\-(no\-)info
|
||||||
Don't add encoder info SEI.
|
Add encoder info SEI. [enabled]
|
||||||
|
.TP
|
||||||
|
\fB\-\-crypto <string>
|
||||||
|
Selective encryption. Crypto support must be
|
||||||
|
enabled at compile\-time. Can be 'on' or 'off' or
|
||||||
|
a list of features separated with a '+'. [off]
|
||||||
|
\- on: Enable all encryption features.
|
||||||
|
\- off: Disable selective encryption.
|
||||||
|
\- mvs: Motion vector magnitudes.
|
||||||
|
\- mv_signs: Motion vector signs.
|
||||||
|
\- trans_coeffs: Coefficient magnitudes.
|
||||||
|
\- trans_coeff_signs: Coefficient signs.
|
||||||
|
\- intra_pred_modes: Intra prediction modes.
|
||||||
|
.TP
|
||||||
|
\fB\-\-key <string>
|
||||||
|
Encryption key [16,213,27,56,255,127,242,112,
|
||||||
|
97,126,197,204,25,59,38,30]
|
||||||
|
|
||||||
.SS "Video structure:"
|
.SS "Video structure:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-q\fR, \fB\-\-qp <integer>
|
\fB\-q\fR, \fB\-\-qp <integer>
|
||||||
Quantization Parameter [32]
|
Quantization parameter [22]
|
||||||
.TP
|
.TP
|
||||||
\fB\-p\fR, \fB\-\-period <integer>
|
\fB\-p\fR, \fB\-\-period <integer>
|
||||||
Period of intra pictures [0]
|
Period of intra pictures [64]
|
||||||
\- 0: only first picture is intra
|
\- 0: Only first picture is intra.
|
||||||
\- 1: all pictures are intra
|
\- 1: All pictures are intra.
|
||||||
\- 2\-N: every Nth picture is intra
|
\- N: Every Nth picture is intra.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-vps\-period <integer>
|
\fB\-\-vps\-period <integer>
|
||||||
Specify how often the video parameter set is
|
How often the video parameter set is re\-sent [0]
|
||||||
re\-sent. [0]
|
\- 0: Only send VPS with the first frame.
|
||||||
\- 0: only send VPS with the first frame
|
\- N: Send VPS with every Nth intra frame.
|
||||||
\- N: send VPS with every Nth intra frame
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-r\fR, \fB\-\-ref <integer>
|
\fB\-r\fR, \fB\-\-ref <integer>
|
||||||
Reference frames, range 1..15 [3]
|
Number of reference frames, in range 1..15 [1]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-gop <string>
|
\fB\-\-gop <string>
|
||||||
Definition of GOP structure [0]
|
GOP structure [lp\-g4d3t1]
|
||||||
\- 0: disabled
|
\- 0: Disabled
|
||||||
\- 8: B\-frame pyramid of length 8
|
\- 8: B\-frame pyramid of length 8
|
||||||
\- lp\-<string>: lp\-gop definition
|
\- lp\-<string>: Low\-delay P\-frame GOP
|
||||||
(e.g. lp\-g8d4t2, see README)
|
(e.g. lp\-g8d4t2, see README)
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-cqmfile <string>
|
\fB\-\-cqmfile <filename>
|
||||||
Custom Quantization Matrices from a file
|
Read custom quantization matrices from a file.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-bitrate <integer>
|
\fB\-\-bitrate <integer>
|
||||||
Target bitrate. [0]
|
Target bitrate [0]
|
||||||
\- 0: disable rate\-control
|
\- 0: Disable rate control.
|
||||||
\- N: target N bits per second
|
\- N: Target N bits per second.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-lossless
|
\fB\-\-(no\-)lossless
|
||||||
Use lossless coding
|
Use lossless coding. [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-mv\-constraint
|
\fB\-\-mv\-constraint <string>
|
||||||
Constrain movement vectors
|
Constrain movement vectors. [none]
|
||||||
\- none: no constraint
|
\- none: No constraint
|
||||||
\- frametile: constrain within the tile
|
\- frametile: Constrain within the tile.
|
||||||
\- frametilemargin: constrain even more
|
\- frametilemargin: Constrain even more.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-roi <string>
|
\fB\-\-roi <filename>
|
||||||
Use a delta QP map for region of interest
|
Use a delta QP map for region of interest.
|
||||||
Read an array of delta QP values from
|
Reads an array of delta QP values from a text
|
||||||
a file, where the first two values are the
|
file. The file format is: width and height of
|
||||||
width and height, followed by width*height
|
the QP delta map followed by width*height delta
|
||||||
delta QP values in raster order.
|
QP values in raster order. The map can be of any
|
||||||
The delta QP map can be any size or aspect
|
size and will be scaled to the video size.
|
||||||
ratio, and will be mapped to LCU's.
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)erp\-aqp
|
\fB\-\-(no\-)erp\-aqp
|
||||||
Use adaptive QP for 360 video with
|
Use adaptive QP for 360 degree video with
|
||||||
equirectangular projection
|
equirectangular projection. [disabled]
|
||||||
|
.TP
|
||||||
|
\fB\-\-level <number>
|
||||||
|
Use the given HEVC level in the output and give
|
||||||
|
an error if level limits are exceeded. [6.2]
|
||||||
|
\- 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6,
|
||||||
|
6.1, 6.2
|
||||||
|
.TP
|
||||||
|
\fB\-\-force\-level <number>
|
||||||
|
Same as \-\-level but warnings instead of errors.
|
||||||
|
.TP
|
||||||
|
\fB\-\-high\-tier
|
||||||
|
Used with \-\-level. Use high tier bitrate limits
|
||||||
|
instead of the main tier limits during encoding.
|
||||||
|
|
||||||
.SS "Compression tools:"
|
.SS "Compression tools:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-deblock [<beta:tc>]
|
\fB\-\-(no\-)deblock <beta:tc>
|
||||||
Deblocking
|
Deblocking filter. [0:0]
|
||||||
\- beta: between \-6 and 6
|
\- beta: Between \-6 and 6
|
||||||
\- tc: between \-6 and 6
|
\- tc: Between \-6 and 6
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)sao
|
\fB\-\-sao <string>
|
||||||
Sample Adaptive Offset
|
Sample Adaptive Offset [full]
|
||||||
|
\- off: SAO disabled
|
||||||
|
\- band: Band offset only
|
||||||
|
\- edge: Edge offset only
|
||||||
|
\- full: Full SAO
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)rdoq
|
\fB\-\-(no\-)rdoq
|
||||||
Rate\-Distortion Optimized Quantization
|
Rate\-distortion optimized quantization [enabled]
|
||||||
|
.TP
|
||||||
|
\fB\-\-(no\-)rdoq\-skip
|
||||||
|
Skip RDOQ for 4x4 blocks. [enabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)signhide
|
\fB\-\-(no\-)signhide
|
||||||
Sign Hiding
|
Sign hiding [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)smp
|
\fB\-\-(no\-)smp
|
||||||
Symmetric Motion Partition
|
Symmetric motion partition [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)amp
|
\fB\-\-(no\-)amp
|
||||||
Asymmetric Motion Partition
|
Asymmetric motion partition [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-rd <integer>
|
\fB\-\-rd <integer>
|
||||||
Intra mode search complexity
|
Intra mode search complexity [1]
|
||||||
\- 0: skip intra if inter is good enough
|
\- 0: Skip intra if inter is good enough.
|
||||||
\- 1: rough intra mode search with SATD
|
\- 1: Rough intra mode search with SATD.
|
||||||
\- 2: refine intra mode search with SSE
|
\- 2: Refine intra mode search with SSE.
|
||||||
|
\- 3: Try all intra modes and enable intra
|
||||||
|
chroma mode search.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)mv\-rdo
|
\fB\-\-(no\-)mv\-rdo
|
||||||
Rate\-Distortion Optimized motion vector costs
|
Rate\-distortion optimized motion vector costs
|
||||||
|
[disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)full\-intra\-search
|
\fB\-\-(no\-)full\-intra\-search
|
||||||
|
|
||||||
Try all intra modes during rough search.
|
Try all intra modes during rough search.
|
||||||
|
[disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)transform\-skip
|
\fB\-\-(no\-)transform\-skip
|
||||||
Transform skip
|
Try transform skip [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-me <string>
|
\fB\-\-me <string>
|
||||||
Integer motion estimation
|
Integer motion estimation algorithm [hexbs]
|
||||||
\- hexbs: Hexagon Based Search
|
\- hexbs: Hexagon Based Search
|
||||||
\- tz: Test Zone Search
|
\- tz: Test Zone Search
|
||||||
\- full: Full Search
|
\- full: Full Search
|
||||||
\- full8, full16, full32, full64
|
\- full8, full16, full32, full64
|
||||||
|
\- dia: Diamond Search
|
||||||
|
.TP
|
||||||
|
\fB\-\-me\-steps <integer>
|
||||||
|
Motion estimation search step limit. Only
|
||||||
|
affects 'hexbs' and 'dia'. [\-1]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-subme <integer>
|
\fB\-\-subme <integer>
|
||||||
Set fractional pixel motion estimation level
|
Fractional pixel motion estimation level [4]
|
||||||
\- 0: only integer motion estimation
|
\- 0: Integer motion estimation only
|
||||||
\- 1: + 1/2\-pixel horizontal and vertical
|
\- 1: + 1/2\-pixel horizontal and vertical
|
||||||
\- 2: + 1/2\-pixel diagonal
|
\- 2: + 1/2\-pixel diagonal
|
||||||
\- 3: + 1/4\-pixel horizontal and vertical
|
\- 3: + 1/4\-pixel horizontal and vertical
|
||||||
\- 4: + 1/4\-pixel diagonal
|
\- 4: + 1/4\-pixel diagonal
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-pu\-depth\-inter <int>\-<int>
|
\fB\-\-pu\-depth\-inter <int>\-<int>
|
||||||
|
Inter prediction units sizes [1\-3]
|
||||||
Range for sizes for inter predictions
|
|
||||||
\- 0, 1, 2, 3: from 64x64 to 8x8
|
\- 0, 1, 2, 3: from 64x64 to 8x8
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-pu\-depth\-intra <int>\-<int>
|
\fB\-\-pu\-depth\-intra <int>\-<int>
|
||||||
Range for sizes for intra predictions
|
Intra prediction units sizes [1\-3]
|
||||||
\- 0, 1, 2, 3, 4: from 64x64 to 4x4
|
\- 0, 1, 2, 3, 4: from 64x64 to 4x4
|
||||||
.TP
|
.TP
|
||||||
|
\fB\-\-tr\-depth\-intra <int>
|
||||||
|
Transform split depth for intra blocks [0]
|
||||||
|
.TP
|
||||||
\fB\-\-(no\-)bipred
|
\fB\-\-(no\-)bipred
|
||||||
Bi\-prediction
|
Bi\-prediction [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)cu\-split\-termination
|
\fB\-\-cu\-split\-termination <string>
|
||||||
|
CU split search termination [zero]
|
||||||
CU split search termination condition
|
\- off: Don't terminate early.
|
||||||
\- off: Never terminate cu\-split search
|
\- zero: Terminate when residual is zero.
|
||||||
\- zero: Terminate with zero residual
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)me\-early\-termination
|
\fB\-\-me\-early\-termination <string>
|
||||||
ME early termination condition
|
Motion estimation termination [on]
|
||||||
\- off: Don't terminate early
|
\- off: Don't terminate early.
|
||||||
\- on: Terminate early
|
\- on: Terminate early.
|
||||||
\- sensitive: Terminate even earlier
|
\- sensitive: Terminate even earlier.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)implicit\-rdpcm
|
\fB\-\-(no\-)implicit\-rdpcm
|
||||||
Implicit residual DPCM
|
Implicit residual DPCM. Currently only supported
|
||||||
Currently only supported with lossless coding.
|
with lossless coding. [disabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)tmvp
|
\fB\-\-(no\-)tmvp
|
||||||
Temporal Motion Vector Prediction
|
Temporal motion vector prediction [enabled]
|
||||||
.TP
|
|
||||||
\fB\-\-(no\-)rdoq\-skip
|
|
||||||
Skips RDOQ for 4x4 blocks
|
|
||||||
|
|
||||||
.SS "Parallel processing:"
|
.SS "Parallel processing:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-threads <integer>
|
\fB\-\-threads <integer>
|
||||||
Number of threads to use [auto]
|
Number of threads to use [auto]
|
||||||
\- 0: process everything with main thread
|
\- 0: Process everything with main thread.
|
||||||
\- N: use N threads for encoding
|
\- N: Use N threads for encoding.
|
||||||
\- auto: select based on number of cores
|
\- auto: Select automatically.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-owf <integer>
|
\fB\-\-owf <integer>
|
||||||
Frame parallelism [auto]
|
Frame\-level parallelism [auto]
|
||||||
\- N: Process N\-1 frames at a time
|
\- N: Process N\-1 frames at a time.
|
||||||
\- auto: Select automatically
|
\- auto: Select automatically.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-(no\-)wpp
|
\fB\-\-(no\-)wpp
|
||||||
Wavefront parallel processing [enabled]
|
Wavefront parallel processing.
|
||||||
Enabling tiles automatically disables WPP.
|
Enabling tiles automatically disables WPP. To
|
||||||
To enable WPP with tiles, re\-enable it after
|
enable WPP with tiles, re\-enable it after
|
||||||
enabling tiles.
|
enabling tiles. [enabled]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-tiles <int>x<int>
|
\fB\-\-tiles <int>x<int>
|
||||||
Split picture into width x height uniform tiles.
|
Split picture into width x height uniform tiles.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-tiles\-width\-split <string>|u<int>
|
\fB\-\-tiles\-width\-split <string>|u<int>
|
||||||
Specifies a comma separated list of pixel
|
\- <string>: A comma\-separated list of tile
|
||||||
positions of tiles columns separation coordinates.
|
column pixel coordinates.
|
||||||
Can also be u followed by and a single int n,
|
\- u<int>: Number of tile columns of uniform
|
||||||
in which case it produces columns of uniform width.
|
width.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-tiles\-height\-split <string>|u<int>
|
\fB\-\-tiles\-height\-split <string>|u<int>
|
||||||
Specifies a comma separated list of pixel
|
\- <string>: A comma\-separated list of tile row
|
||||||
positions of tiles rows separation coordinates.
|
column pixel coordinates.
|
||||||
Can also be u followed by and a single int n,
|
\- u<int>: Number of tile rows of uniform
|
||||||
in which case it produces rows of uniform height.
|
height.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-slices <string>
|
\fB\-\-slices <string>
|
||||||
Control how slices are used
|
Control how slices are used.
|
||||||
\- tiles: put tiles in independent slices
|
\- tiles: Put tiles in independent slices.
|
||||||
\- wpp: put rows in dependent slices
|
\- wpp: Put rows in dependent slices.
|
||||||
\- tiles+wpp: do both
|
\- tiles+wpp: Do both.
|
||||||
|
|
||||||
.SS "Video Usability Information:"
|
.SS "Video Usability Information:"
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-sar <width:height>
|
\fB\-\-sar <width:height>
|
||||||
Specify Sample Aspect Ratio
|
Specify sample aspect ratio
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-overscan <string>
|
\fB\-\-overscan <string>
|
||||||
Specify crop overscan setting [undef]
|
Specify crop overscan setting [undef]
|
||||||
|
@ -274,7 +314,7 @@ Specify crop overscan setting [undef]
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-videoformat <string>
|
\fB\-\-videoformat <string>
|
||||||
Specify video format [undef]
|
Specify video format [undef]
|
||||||
\- component, pal, ntsc, secam, mac, undef
|
\- undef, component, pal, ntsc, secam, mac
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-range <string>
|
\fB\-\-range <string>
|
||||||
Specify color range [tv]
|
Specify color range [tv]
|
||||||
|
|
267
src/cli.c
267
src/cli.c
|
@ -36,9 +36,9 @@ static const struct option long_options[] = {
|
||||||
{ "input", required_argument, NULL, 'i' },
|
{ "input", required_argument, NULL, 'i' },
|
||||||
{ "output", required_argument, NULL, 'o' },
|
{ "output", required_argument, NULL, 'o' },
|
||||||
{ "debug", required_argument, NULL, 'd' },
|
{ "debug", required_argument, NULL, 'd' },
|
||||||
{ "width", required_argument, NULL, 'w' },
|
{ "width", required_argument, NULL, 'w' }, // deprecated
|
||||||
{ "height", required_argument, NULL, 'h' }, // deprecated
|
{ "height", required_argument, NULL, 'h' }, // deprecated
|
||||||
{ "frames", required_argument, NULL, 'n' }, // deprecated
|
{ "frames", required_argument, NULL, 'n' },
|
||||||
{ "qp", required_argument, NULL, 'q' },
|
{ "qp", required_argument, NULL, 'q' },
|
||||||
{ "period", required_argument, NULL, 'p' },
|
{ "period", required_argument, NULL, 'p' },
|
||||||
{ "ref", required_argument, NULL, 'r' },
|
{ "ref", required_argument, NULL, 'r' },
|
||||||
|
@ -323,15 +323,15 @@ void print_help(void)
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Required:\n"
|
"Required:\n"
|
||||||
" -i, --input : Input file\n"
|
" -i, --input <filename> : Input file\n"
|
||||||
" --input-res <res> : Input resolution [auto]\n"
|
" --input-res <res> : Input resolution [auto]\n"
|
||||||
" auto: detect from file name\n"
|
" - auto: Detect from file name.\n"
|
||||||
" <int>x<int>: width times height\n"
|
" - <int>x<int>: width times height\n"
|
||||||
" -o, --output : Output file\n"
|
" -o, --output <filename> : Output file\n"
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Presets:\n"
|
"Presets:\n"
|
||||||
" --preset=<preset> : Set options to a preset [medium]\n"
|
" --preset <preset> : Set options to a preset [medium]\n"
|
||||||
" - ultrafast, superfast, veryfast, faster,\n"
|
" - ultrafast, superfast, veryfast, faster,\n"
|
||||||
" fast, medium, slow, slower, veryslow\n"
|
" fast, medium, slow, slower, veryslow\n"
|
||||||
" placebo\n"
|
" placebo\n"
|
||||||
|
@ -340,160 +340,171 @@ void print_help(void)
|
||||||
"Input:\n"
|
"Input:\n"
|
||||||
" -n, --frames <integer> : Number of frames to code [all]\n"
|
" -n, --frames <integer> : Number of frames to code [all]\n"
|
||||||
" --seek <integer> : First frame to code [0]\n"
|
" --seek <integer> : First frame to code [0]\n"
|
||||||
" --input-fps <num>[/<denom>] : Framerate of the input video [25.0]\n"
|
" --input-fps <num>[/<denom>] : Frame rate of the input video [25]\n"
|
||||||
" --source-scan-type <string> : Set source scan type [progressive].\n"
|
" --source-scan-type <string> : Source scan type [progressive]\n"
|
||||||
" - progressive: progressive scan\n"
|
" - progressive: Progressive scan\n"
|
||||||
" - tff: top field first\n"
|
" - tff: Top field first\n"
|
||||||
" - bff: bottom field first\n"
|
" - bff: Bottom field first\n"
|
||||||
" --input-format : P420 or P400\n"
|
" --input-format <string> : P420 or P400 [P420]\n"
|
||||||
" --input-bitdepth : 8-16\n"
|
" --input-bitdepth <int> : 8-16 [8]\n"
|
||||||
" --loop-input : Re-read input file forever\n"
|
" --loop-input : Re-read input file forever.\n"
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Options:\n"
|
"Options:\n"
|
||||||
" --help : Print this help message and exit\n"
|
" --help : Print this help message and exit.\n"
|
||||||
" --version : Print version information and exit\n"
|
" --version : Print version information and exit.\n"
|
||||||
" --aud : Use access unit delimiters\n"
|
" --(no-)aud : Use access unit delimiters. [disabled]\n"
|
||||||
" --debug <string> : Output encoders reconstruction.\n"
|
" --debug <filename> : Output internal reconstruction.\n"
|
||||||
" --cpuid <integer> : Disable runtime cpu optimizations with value 0.\n"
|
" --(no-)cpuid : Enable runtime CPU optimizations. [enabled]\n"
|
||||||
" --hash : Decoded picture hash [checksum]\n"
|
" --hash <string> : Decoded picture hash [checksum]\n"
|
||||||
" - none: 0 bytes\n"
|
" - none: 0 bytes\n"
|
||||||
" - checksum: 18 bytes\n"
|
" - checksum: 18 bytes\n"
|
||||||
" - md5: 56 bytes\n"
|
" - md5: 56 bytes\n"
|
||||||
" --no-psnr : Don't calculate PSNR for frames\n"
|
" --(no-)psnr : Calculate PSNR for frames. [enabled]\n"
|
||||||
" --no-info : Don't add encoder info SEI.\n"
|
" --(no-)info : Add encoder info SEI. [enabled]\n"
|
||||||
|
" --crypto <string> : Selective encryption. Crypto support must be\n"
|
||||||
|
" enabled at compile-time. Can be 'on' or 'off' or\n"
|
||||||
|
" a list of features separated with a '+'. [off]\n"
|
||||||
|
" - on: Enable all encryption features.\n"
|
||||||
|
" - off: Disable selective encryption.\n"
|
||||||
|
" - mvs: Motion vector magnitudes.\n"
|
||||||
|
" - mv_signs: Motion vector signs.\n"
|
||||||
|
" - trans_coeffs: Coefficient magnitudes.\n"
|
||||||
|
" - trans_coeff_signs: Coefficient signs.\n"
|
||||||
|
" - intra_pred_modes: Intra prediction modes.\n"
|
||||||
|
" --key <string> : Encryption key [16,213,27,56,255,127,242,112,\n"
|
||||||
|
" 97,126,197,204,25,59,38,30]\n"
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Video structure:\n"
|
"Video structure:\n"
|
||||||
" -q, --qp <integer> : Quantization Parameter [32]\n"
|
" -q, --qp <integer> : Quantization parameter [22]\n"
|
||||||
" -p, --period <integer> : Period of intra pictures [0]\n"
|
" -p, --period <integer> : Period of intra pictures [64]\n"
|
||||||
" - 0: only first picture is intra\n"
|
" - 0: Only first picture is intra.\n"
|
||||||
" - 1: all pictures are intra\n"
|
" - 1: All pictures are intra.\n"
|
||||||
" - 2-N: every Nth picture is intra\n"
|
" - N: Every Nth picture is intra.\n"
|
||||||
" --vps-period <integer> : Specify how often the video parameter set is\n"
|
" --vps-period <integer> : How often the video parameter set is re-sent [0]\n"
|
||||||
" re-sent. [0]\n"
|
" - 0: Only send VPS with the first frame.\n"
|
||||||
" - 0: only send VPS with the first frame\n"
|
" - N: Send VPS with every Nth intra frame.\n"
|
||||||
" - N: send VPS with every Nth intra frame\n"
|
" -r, --ref <integer> : Number of reference frames, in range 1..15 [1]\n"
|
||||||
" -r, --ref <integer> : Reference frames, range 1..15 [3]\n"
|
" --gop <string> : GOP structure [lp-g4d3t1]\n"
|
||||||
" --gop <string> : Definition of GOP structure [0]\n"
|
" - 0: Disabled\n"
|
||||||
" - 0: disabled\n"
|
|
||||||
" - 8: B-frame pyramid of length 8\n"
|
" - 8: B-frame pyramid of length 8\n"
|
||||||
" - lp-<string>: lp-gop definition\n"
|
" - lp-<string>: Low-delay P-frame GOP\n"
|
||||||
" (e.g. lp-g8d4t2, see README)\n"
|
" (e.g. lp-g8d4t2, see README)\n"
|
||||||
" --cqmfile <string> : Custom Quantization Matrices from a file\n"
|
" --cqmfile <filename> : Read custom quantization matrices from a file.\n"
|
||||||
" --bitrate <integer> : Target bitrate. [0]\n"
|
" --bitrate <integer> : Target bitrate [0]\n"
|
||||||
" - 0: disable rate-control\n"
|
" - 0: Disable rate control.\n"
|
||||||
" - N: target N bits per second\n"
|
" - N: Target N bits per second.\n"
|
||||||
" --lossless : Use lossless coding\n"
|
" --(no-)lossless : Use lossless coding. [disabled]\n"
|
||||||
" --mv-constraint : Constrain movement vectors\n"
|
" --mv-constraint <string> : Constrain movement vectors. [none]\n"
|
||||||
" - none: no constraint\n"
|
" - none: No constraint\n"
|
||||||
" - frametile: constrain within the tile\n"
|
" - frametile: Constrain within the tile.\n"
|
||||||
" - frametilemargin: constrain even more\n"
|
" - frametilemargin: Constrain even more.\n"
|
||||||
" --roi <string> : Use a delta QP map for region of interest\n"
|
" --roi <filename> : Use a delta QP map for region of interest.\n"
|
||||||
" Read an array of delta QP values from\n"
|
" Reads an array of delta QP values from a text\n"
|
||||||
" a file, where the first two values are the\n"
|
" file. The file format is: width and height of\n"
|
||||||
" width and height, followed by width*height\n"
|
" the QP delta map followed by width*height delta\n"
|
||||||
" delta QP values in raster order.\n"
|
" QP values in raster order. The map can be of any\n"
|
||||||
" The delta QP map can be any size or aspect\n"
|
" size and will be scaled to the video size.\n"
|
||||||
" ratio, and will be mapped to LCU's.\n"
|
" --(no-)erp-aqp : Use adaptive QP for 360 degree video with\n"
|
||||||
" --(no-)erp-aqp : Use adaptive QP for 360 video with\n"
|
" equirectangular projection. [disabled]\n"
|
||||||
" equirectangular projection\n"
|
|
||||||
" --level <number> : Use the given HEVC level in the output and give\n"
|
" --level <number> : Use the given HEVC level in the output and give\n"
|
||||||
" an error if the input doesn't fit to it's\n"
|
" an error if level limits are exceeded. [6.2]\n"
|
||||||
" limits [6.2]\n"
|
" - 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6,\n"
|
||||||
" Allowed values are 1, 2, 2.1, 3, 3.1, 4, 4.1\n"
|
" 6.1, 6.2\n"
|
||||||
" 5, 5.1, 5.2, 6, 6.1 and 6.2. The dot is\n"
|
" --force-level <number> : Same as --level but warnings instead of errors.\n"
|
||||||
" optional.\n"
|
" --high-tier : Used with --level. Use high tier bitrate limits\n"
|
||||||
" --force-level <number> : Same as --level, except instead of errors you\n"
|
" instead of the main tier limits during encoding.\n"
|
||||||
" get warnings\n"
|
|
||||||
" --high-tier : Used with --level. Use high-tier bitrate limits\n"
|
|
||||||
" instead of the main-tier limits during encoding.\n"
|
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Compression tools:\n"
|
"Compression tools:\n"
|
||||||
" --deblock [<beta:tc>] : Deblocking\n"
|
" --(no-)deblock <beta:tc> : Deblocking filter. [0:0]\n"
|
||||||
" - beta: between -6 and 6\n"
|
" - beta: Between -6 and 6\n"
|
||||||
" - tc: between -6 and 6\n"
|
" - tc: Between -6 and 6\n"
|
||||||
" --(no-)sao : Sample Adaptive Offset\n"
|
" --sao <string> : Sample Adaptive Offset [full]\n"
|
||||||
" --(no-)rdoq : Rate-Distortion Optimized Quantization\n"
|
" - off: SAO disabled\n"
|
||||||
" --(no-)signhide : Sign Hiding\n"
|
" - band: Band offset only\n"
|
||||||
" --(no-)smp : Symmetric Motion Partition\n"
|
" - edge: Edge offset only\n"
|
||||||
" --(no-)amp : Asymmetric Motion Partition\n"
|
" - full: Full SAO\n"
|
||||||
" --rd <integer> : Intra mode search complexity\n"
|
" --(no-)rdoq : Rate-distortion optimized quantization [enabled]\n"
|
||||||
" - 0: skip intra if inter is good enough\n"
|
" --(no-)rdoq-skip : Skip RDOQ for 4x4 blocks. [enabled]\n"
|
||||||
" - 1: rough intra mode search with SATD\n"
|
" --(no-)signhide : Sign hiding [disabled]\n"
|
||||||
" - 2: refine intra mode search with SSE\n"
|
" --(no-)smp : Symmetric motion partition [disabled]\n"
|
||||||
" --(no-)mv-rdo : Rate-Distortion Optimized motion vector costs\n"
|
" --(no-)amp : Asymmetric motion partition [disabled]\n"
|
||||||
" --(no-)full-intra-search\n"
|
" --rd <integer> : Intra mode search complexity [1]\n"
|
||||||
" : Try all intra modes during rough search.\n"
|
" - 0: Skip intra if inter is good enough.\n"
|
||||||
" --(no-)transform-skip : Transform skip\n"
|
" - 1: Rough intra mode search with SATD.\n"
|
||||||
" --me <string> : Integer motion estimation\n"
|
" - 2: Refine intra mode search with SSE.\n"
|
||||||
|
" - 3: Try all intra modes and enable intra\n"
|
||||||
|
" chroma mode search.\n"
|
||||||
|
" --(no-)mv-rdo : Rate-distortion optimized motion vector costs\n"
|
||||||
|
" [disabled]\n"
|
||||||
|
" --(no-)full-intra-search : Try all intra modes during rough search.\n"
|
||||||
|
" [disabled]\n"
|
||||||
|
" --(no-)transform-skip : Try transform skip [disabled]\n"
|
||||||
|
" --me <string> : Integer motion estimation algorithm [hexbs]\n"
|
||||||
" - hexbs: Hexagon Based Search\n"
|
" - hexbs: Hexagon Based Search\n"
|
||||||
" - tz: Test Zone Search\n"
|
" - tz: Test Zone Search\n"
|
||||||
" - full: Full Search\n"
|
" - full: Full Search\n"
|
||||||
" - full8, full16, full32, full64\n"
|
" - full8, full16, full32, full64\n"
|
||||||
" - dia: Diamond Search\n"
|
" - dia: Diamond Search\n"
|
||||||
" --me-steps <integer> : How many search steps does the motion estimation\n"
|
" --me-steps <integer> : Motion estimation search step limit. Only\n"
|
||||||
" do before cutting off [-1]\n"
|
" affects 'hexbs' and 'dia'. [-1]\n"
|
||||||
" Has effect only for 'hexbs' and 'dia'\n"
|
" --subme <integer> : Fractional pixel motion estimation level [4]\n"
|
||||||
" --subme <integer> : Set fractional pixel motion estimation level\n"
|
" - 0: Integer motion estimation only\n"
|
||||||
" - 0: only integer motion estimation\n"
|
|
||||||
" - 1: + 1/2-pixel horizontal and vertical\n"
|
" - 1: + 1/2-pixel horizontal and vertical\n"
|
||||||
" - 2: + 1/2-pixel diagonal\n"
|
" - 2: + 1/2-pixel diagonal\n"
|
||||||
" - 3: + 1/4-pixel horizontal and vertical\n"
|
" - 3: + 1/4-pixel horizontal and vertical\n"
|
||||||
" - 4: + 1/4-pixel diagonal\n"
|
" - 4: + 1/4-pixel diagonal\n"
|
||||||
" --pu-depth-inter <int>-<int>\n"
|
" --pu-depth-inter <int>-<int> : Inter prediction units sizes [1-3]\n"
|
||||||
" : Range for sizes for inter predictions\n"
|
|
||||||
" - 0, 1, 2, 3: from 64x64 to 8x8\n"
|
" - 0, 1, 2, 3: from 64x64 to 8x8\n"
|
||||||
" --pu-depth-intra <int>-<int> : Range for sizes for intra predictions\n"
|
" --pu-depth-intra <int>-<int> : Intra prediction units sizes [1-3]\n"
|
||||||
" - 0, 1, 2, 3, 4: from 64x64 to 4x4\n"
|
" - 0, 1, 2, 3, 4: from 64x64 to 4x4\n"
|
||||||
" --(no-)bipred : Bi-prediction\n"
|
" --tr-depth-intra <int> : Transform split depth for intra blocks [0]\n"
|
||||||
" --(no-)cu-split-termination\n"
|
" --(no-)bipred : Bi-prediction [disabled]\n"
|
||||||
" : CU split search termination condition\n"
|
" --cu-split-termination <string> : CU split search termination [zero]\n"
|
||||||
" - off: Never terminate cu-split search\n"
|
" - off: Don't terminate early.\n"
|
||||||
" - zero: Terminate with zero residual\n"
|
" - zero: Terminate when residual is zero.\n"
|
||||||
" --(no-)me-early-termination : ME early termination condition\n"
|
" --me-early-termination <string> : Motion estimation termination [on]\n"
|
||||||
" - off: Don't terminate early\n"
|
" - off: Don't terminate early.\n"
|
||||||
" - on: Terminate early\n"
|
" - on: Terminate early.\n"
|
||||||
" - sensitive: Terminate even earlier\n"
|
" - sensitive: Terminate even earlier.\n"
|
||||||
" --(no-)implicit-rdpcm : Implicit residual DPCM\n"
|
" --(no-)implicit-rdpcm : Implicit residual DPCM. Currently only supported\n"
|
||||||
" Currently only supported with lossless coding.\n"
|
" with lossless coding. [disabled]\n"
|
||||||
" --(no-)tmvp : Temporal Motion Vector Prediction\n"
|
" --(no-)tmvp : Temporal motion vector prediction [enabled]\n"
|
||||||
" --(no-)rdoq-skip : Skips RDOQ for 4x4 blocks\n"
|
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Parallel processing:\n"
|
"Parallel processing:\n"
|
||||||
" --threads <integer> : Number of threads to use [auto]\n"
|
" --threads <integer> : Number of threads to use [auto]\n"
|
||||||
" - 0: process everything with main thread\n"
|
" - 0: Process everything with main thread.\n"
|
||||||
" - N: use N threads for encoding\n"
|
" - N: Use N threads for encoding.\n"
|
||||||
" - auto: select based on number of cores\n"
|
" - auto: Select automatically.\n"
|
||||||
" --owf <integer> : Frame parallelism [auto]\n"
|
" --owf <integer> : Frame-level parallelism [auto]\n"
|
||||||
" - N: Process N-1 frames at a time\n"
|
" - N: Process N-1 frames at a time.\n"
|
||||||
" - auto: Select automatically\n"
|
" - auto: Select automatically.\n"
|
||||||
" --(no-)wpp : Wavefront parallel processing [enabled]\n"
|
" --(no-)wpp : Wavefront parallel processing.\n"
|
||||||
" Enabling tiles automatically disables WPP.\n"
|
" Enabling tiles automatically disables WPP. To\n"
|
||||||
" To enable WPP with tiles, re-enable it after\n"
|
" enable WPP with tiles, re-enable it after\n"
|
||||||
" enabling tiles.\n"
|
" enabling tiles. [enabled]\n"
|
||||||
" --tiles <int>x<int> : Split picture into width x height uniform tiles.\n"
|
" --tiles <int>x<int> : Split picture into width x height uniform tiles.\n"
|
||||||
" --tiles-width-split <string>|u<int> :\n"
|
" --tiles-width-split <string>|u<int> :\n"
|
||||||
" Specifies a comma separated list of pixel\n"
|
" - <string>: A comma-separated list of tile\n"
|
||||||
" positions of tiles columns separation\n"
|
" column pixel coordinates.\n"
|
||||||
" coordinates.\n"
|
" - u<int>: Number of tile columns of uniform\n"
|
||||||
" Can also be u, followed by a single int n, in\n"
|
" width.\n"
|
||||||
" which case it produces columns of uniform width.\n"
|
|
||||||
" --tiles-height-split <string>|u<int> :\n"
|
" --tiles-height-split <string>|u<int> :\n"
|
||||||
" Specifies a comma separated list of pixel\n"
|
" - <string>: A comma-separated list of tile row\n"
|
||||||
" positions of tiles rows separation coordinates.\n"
|
" column pixel coordinates.\n"
|
||||||
" Can also be u followed by and a single int n, in\n"
|
" - u<int>: Number of tile rows of uniform\n"
|
||||||
" which case it produces rows of uniform height.\n"
|
" height.\n"
|
||||||
" --slices <string> : Control how slices are used\n"
|
" --slices <string> : Control how slices are used.\n"
|
||||||
" - tiles: put tiles in independent slices\n"
|
" - tiles: Put tiles in independent slices.\n"
|
||||||
" - wpp: put rows in dependent slices\n"
|
" - wpp: Put rows in dependent slices.\n"
|
||||||
" - tiles+wpp: do both\n"
|
" - tiles+wpp: Do both.\n"
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Video Usability Information:\n"
|
"Video Usability Information:\n"
|
||||||
" --sar <width:height> : Specify Sample Aspect Ratio\n"
|
" --sar <width:height> : Specify sample aspect ratio\n"
|
||||||
" --overscan <string> : Specify crop overscan setting [undef]\n"
|
" --overscan <string> : Specify crop overscan setting [undef]\n"
|
||||||
" - undef, show, crop\n"
|
" - undef, show, crop\n"
|
||||||
" --videoformat <string> : Specify video format [undef]\n"
|
" --videoformat <string> : Specify video format [undef]\n"
|
||||||
|
@ -515,8 +526,8 @@ void print_help(void)
|
||||||
"\n"
|
"\n"
|
||||||
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
||||||
"Deprecated parameters: (might be removed at some point)\n"
|
"Deprecated parameters: (might be removed at some point)\n"
|
||||||
" -w, --width : Use --input-res\n"
|
" -w, --width <integer> : Use --input-res.\n"
|
||||||
" -h, --height : Use --input-res\n");
|
" -h, --height <integer> : Use --input-res.\n");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue