2017-11-17 13:23:33 +00:00
|
|
|
.TH KVAZAAR "1" "November 2017" "kvazaar v1.2.0" "User Commands"
|
2016-02-04 05:41:18 +00:00
|
|
|
.SH NAME
|
|
|
|
kvazaar \- open source HEVC encoder
|
|
|
|
.SH SYNOPSIS
|
|
|
|
\fBkvazaar \fR\-i <input> \-\-input\-res <width>x<height> \-o <output>
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-i\fR, \fB\-\-input
|
|
|
|
Input file
|
|
|
|
.TP
|
|
|
|
\fB\-\-input\-res <res>
|
2016-10-26 23:45:24 +00:00
|
|
|
Input resolution [auto]
|
2016-11-04 13:30:58 +00:00
|
|
|
auto: detect from file name
|
|
|
|
<int>x<int>: width times height
|
2016-02-04 12:15:58 +00:00
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-o\fR, \fB\-\-output
|
|
|
|
Output file
|
|
|
|
|
|
|
|
.SS "Presets:"
|
|
|
|
.TP
|
|
|
|
\fB\-\-preset=<preset>
|
|
|
|
Set options to a preset [medium]
|
2016-11-04 13:30:58 +00:00
|
|
|
\- ultrafast, superfast, veryfast, faster,
|
|
|
|
fast, medium, slow, slower, veryslow
|
|
|
|
placebo
|
2016-10-26 23:45:24 +00:00
|
|
|
|
|
|
|
.SS "Input:"
|
2016-02-04 12:15:58 +00:00
|
|
|
.TP
|
2016-02-04 05:41:18 +00:00
|
|
|
\fB\-n\fR, \fB\-\-frames <integer>
|
|
|
|
Number of frames to code [all]
|
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-\-seek <integer>
|
2016-02-04 05:41:18 +00:00
|
|
|
First frame to code [0]
|
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-\-input\-fps <num>/<denom>
|
2016-02-04 05:41:18 +00:00
|
|
|
Framerate of the input video [25.0]
|
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-\-source\-scan\-type <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Set source scan type [progressive].
|
|
|
|
\- progressive: progressive scan
|
|
|
|
\- tff: top field first
|
|
|
|
\- bff: bottom field first
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-input\-format
|
|
|
|
P420 or P400
|
|
|
|
.TP
|
|
|
|
\fB\-\-input\-bitdepth
|
|
|
|
8\-16
|
|
|
|
.TP
|
|
|
|
\fB\-\-loop\-input
|
|
|
|
Re\-read input file forever
|
|
|
|
|
|
|
|
.SS "Options:"
|
|
|
|
.TP
|
|
|
|
\fB\-\-help
|
|
|
|
Print this help message and exit
|
|
|
|
.TP
|
|
|
|
\fB\-\-version
|
|
|
|
Print version information and exit
|
|
|
|
.TP
|
|
|
|
\fB\-\-aud
|
|
|
|
Use access unit delimiters
|
|
|
|
.TP
|
|
|
|
\fB\-\-debug <string>
|
|
|
|
Output encoders reconstruction.
|
|
|
|
.TP
|
|
|
|
\fB\-\-cpuid <integer>
|
|
|
|
Disable runtime cpu optimizations with value 0.
|
|
|
|
.TP
|
|
|
|
\fB\-\-hash
|
2016-11-04 13:30:58 +00:00
|
|
|
Decoded picture hash [checksum]
|
|
|
|
\- none: 0 bytes
|
|
|
|
\- checksum: 18 bytes
|
|
|
|
\- md5: 56 bytes
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-no\-psnr
|
|
|
|
Don't calculate PSNR for frames
|
|
|
|
.TP
|
|
|
|
\fB\-\-no\-info
|
2016-11-04 13:30:58 +00:00
|
|
|
Don't add encoder info SEI.
|
2016-10-26 23:45:24 +00:00
|
|
|
|
|
|
|
.SS "Video structure:"
|
|
|
|
.TP
|
2016-02-04 05:41:18 +00:00
|
|
|
\fB\-q\fR, \fB\-\-qp <integer>
|
|
|
|
Quantization Parameter [32]
|
|
|
|
.TP
|
|
|
|
\fB\-p\fR, \fB\-\-period <integer>
|
|
|
|
Period of intra pictures [0]
|
2016-11-04 13:30:58 +00:00
|
|
|
\- 0: only first picture is intra
|
|
|
|
\- 1: all pictures are intra
|
|
|
|
\- 2\-N: every Nth picture is intra
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-vps\-period <integer>
|
|
|
|
Specify how often the video parameter set is
|
|
|
|
re\-sent. [0]
|
2016-11-04 13:30:58 +00:00
|
|
|
\- 0: only send VPS with the first frame
|
|
|
|
\- N: send VPS with every Nth intra frame
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-r\fR, \fB\-\-ref <integer>
|
|
|
|
Reference frames, range 1..15 [3]
|
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-\-gop <string>
|
|
|
|
Definition of GOP structure [0]
|
2016-11-04 13:30:58 +00:00
|
|
|
\- 0: disabled
|
|
|
|
\- 8: B\-frame pyramid of length 8
|
|
|
|
\- lp\-<string>: lp\-gop definition
|
|
|
|
(e.g. lp\-g8d4t2, see README)
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-cqmfile <string>
|
|
|
|
Custom Quantization Matrices from a file
|
|
|
|
.TP
|
|
|
|
\fB\-\-bitrate <integer>
|
|
|
|
Target bitrate. [0]
|
2016-11-04 13:30:58 +00:00
|
|
|
\- 0: disable rate\-control
|
|
|
|
\- N: target N bits per second
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-lossless
|
|
|
|
Use lossless coding
|
|
|
|
.TP
|
|
|
|
\fB\-\-mv\-constraint
|
|
|
|
Constrain movement vectors
|
2016-11-04 13:30:58 +00:00
|
|
|
\- none: no constraint
|
|
|
|
\- frametile: constrain within the tile
|
|
|
|
\- frametilemargin: constrain even more
|
2017-01-31 14:30:40 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-roi <string>
|
|
|
|
Use a delta QP map for region of interest
|
|
|
|
Read an array of delta QP values from
|
|
|
|
a file, where the first two values are the
|
|
|
|
width and height, followed by width*height
|
|
|
|
delta QP values in raster order.
|
|
|
|
The delta QP map can be any size or aspect
|
|
|
|
ratio, and will be mapped to LCU's.
|
2017-04-19 12:47:47 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-(no\-)erp\-aqp
|
|
|
|
Use adaptive QP for 360 video with
|
|
|
|
equirectangular projection
|
2016-10-26 23:45:24 +00:00
|
|
|
|
|
|
|
.SS "Compression tools:"
|
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-deblock [<beta:tc>]
|
|
|
|
Deblocking
|
|
|
|
\- beta: between \-6 and 6
|
|
|
|
\- tc: between \-6 and 6
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)sao
|
|
|
|
Sample Adaptive Offset
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)rdoq
|
|
|
|
Rate\-Distortion Optimized Quantization
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)signhide
|
|
|
|
Sign Hiding
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)smp
|
|
|
|
Symmetric Motion Partition
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)amp
|
|
|
|
Asymmetric Motion Partition
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-rd <integer>
|
2016-11-04 13:30:58 +00:00
|
|
|
Intra mode search complexity
|
|
|
|
\- 0: skip intra if inter is good enough
|
|
|
|
\- 1: rough intra mode search with SATD
|
|
|
|
\- 2: refine intra mode search with SSE
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)mv\-rdo
|
|
|
|
Rate\-Distortion Optimized motion vector costs
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)full\-intra\-search
|
|
|
|
|
|
|
|
Try all intra modes during rough search.
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)transform\-skip
|
|
|
|
Transform skip
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-02-05 14:16:18 +00:00
|
|
|
\fB\-\-me <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Integer motion estimation
|
|
|
|
\- hexbs: Hexagon Based Search
|
|
|
|
\- tz: Test Zone Search
|
|
|
|
\- full: Full Search
|
|
|
|
\- full8, full16, full32, full64
|
2016-02-05 14:16:18 +00:00
|
|
|
.TP
|
2016-02-04 05:41:18 +00:00
|
|
|
\fB\-\-subme <integer>
|
2016-11-04 13:30:58 +00:00
|
|
|
Set fractional pixel motion estimation level
|
|
|
|
\- 0: only integer motion estimation
|
|
|
|
\- 1: + 1/2\-pixel horizontal and vertical
|
|
|
|
\- 2: + 1/2\-pixel diagonal
|
|
|
|
\- 3: + 1/4\-pixel horizontal and vertical
|
|
|
|
\- 4: + 1/4\-pixel diagonal
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-pu\-depth\-inter <int>\-<int>
|
2016-11-04 13:30:58 +00:00
|
|
|
|
|
|
|
Range for sizes for inter predictions
|
|
|
|
\- 0, 1, 2, 3: from 64x64 to 8x8
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-pu\-depth\-intra <int>\-<int>
|
2016-11-04 13:30:58 +00:00
|
|
|
Range for sizes for intra predictions
|
|
|
|
\- 0, 1, 2, 3, 4: from 64x64 to 4x4
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)bipred
|
|
|
|
Bi\-prediction
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)cu\-split\-termination
|
|
|
|
|
|
|
|
CU split search termination condition
|
|
|
|
\- off: Never terminate cu\-split search
|
|
|
|
\- zero: Terminate with zero residual
|
2016-08-03 04:27:02 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)me\-early\-termination
|
|
|
|
ME early termination condition
|
|
|
|
\- off: Don't terminate early
|
|
|
|
\- on: Terminate early
|
|
|
|
\- sensitive: Terminate even earlier
|
2016-05-26 07:38:45 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)implicit\-rdpcm
|
|
|
|
Implicit residual DPCM
|
|
|
|
Currently only supported with lossless coding.
|
2016-08-03 05:18:56 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)tmvp
|
|
|
|
Temporal Motion Vector Prediction
|
2016-08-26 09:15:28 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)rdoq\-skip
|
2016-09-10 18:04:45 +00:00
|
|
|
Skips RDOQ for 4x4 blocks
|
2016-10-26 23:45:24 +00:00
|
|
|
|
|
|
|
.SS "Parallel processing:"
|
2016-08-26 09:15:28 +00:00
|
|
|
.TP
|
2016-10-26 23:45:24 +00:00
|
|
|
\fB\-\-threads <integer>
|
2016-11-04 13:30:58 +00:00
|
|
|
Number of threads to use [auto]
|
|
|
|
\- 0: process everything with main thread
|
|
|
|
\- N: use N threads for encoding
|
|
|
|
\- auto: select based on number of cores
|
2016-08-26 09:15:28 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-owf <integer>
|
|
|
|
Frame parallelism [auto]
|
|
|
|
\- N: Process N\-1 frames at a time
|
|
|
|
\- auto: Select automatically
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
2016-11-04 13:30:58 +00:00
|
|
|
\fB\-\-(no\-)wpp
|
2016-10-26 23:45:24 +00:00
|
|
|
Wavefront parallel processing [enabled]
|
2016-11-04 13:30:58 +00:00
|
|
|
Enabling tiles automatically disables WPP.
|
|
|
|
To enable WPP with tiles, re\-enable it after
|
|
|
|
enabling tiles.
|
2016-10-26 23:45:24 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-tiles <int>x<int>
|
|
|
|
Split picture into width x height uniform tiles.
|
|
|
|
.TP
|
|
|
|
\fB\-\-tiles\-width\-split <string>|u<int>
|
|
|
|
Specifies a comma separated list of pixel
|
|
|
|
positions of tiles columns separation coordinates.
|
|
|
|
Can also be u followed by and a single int n,
|
|
|
|
in which case it produces columns of uniform width.
|
|
|
|
.TP
|
|
|
|
\fB\-\-tiles\-height\-split <string>|u<int>
|
|
|
|
Specifies a comma separated list of pixel
|
|
|
|
positions of tiles rows separation coordinates.
|
|
|
|
Can also be u followed by and a single int n,
|
|
|
|
in which case it produces rows of uniform height.
|
2017-01-31 14:30:40 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-slices <string>
|
|
|
|
Control how slices are used
|
|
|
|
\- tiles: put tiles in independent slices
|
|
|
|
\- wpp: put rows in dependent slices
|
|
|
|
\- tiles+wpp: do both
|
2016-02-04 05:41:18 +00:00
|
|
|
|
|
|
|
.SS "Video Usability Information:"
|
|
|
|
.TP
|
|
|
|
\fB\-\-sar <width:height>
|
|
|
|
Specify Sample Aspect Ratio
|
|
|
|
.TP
|
|
|
|
\fB\-\-overscan <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify crop overscan setting [undef]
|
|
|
|
\- undef, show, crop
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-videoformat <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify video format [undef]
|
|
|
|
\- component, pal, ntsc, secam, mac, undef
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-range <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify color range [tv]
|
|
|
|
\- tv, pc
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-colorprim <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify color primaries [undef]
|
|
|
|
\- undef, bt709, bt470m, bt470bg,
|
|
|
|
smpte170m, smpte240m, film, bt2020
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-transfer <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify transfer characteristics [undef]
|
|
|
|
\- undef, bt709, bt470m, bt470bg,
|
|
|
|
smpte170m, smpte240m, linear, log100,
|
|
|
|
log316, iec61966\-2\-4, bt1361e,
|
|
|
|
iec61966\-2\-1, bt2020\-10, bt2020\-12
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-colormatrix <string>
|
2016-11-04 13:30:58 +00:00
|
|
|
Specify color matrix setting [undef]
|
|
|
|
\- undef, bt709, fcc, bt470bg, smpte170m,
|
|
|
|
smpte240m, GBR, YCgCo, bt2020nc, bt2020c
|
2016-02-04 05:41:18 +00:00
|
|
|
.TP
|
|
|
|
\fB\-\-chromaloc <integer>
|
|
|
|
Specify chroma sample location (0 to 5) [0]
|