Update README and manpage

This commit is contained in:
Ari Koivula 2016-10-27 02:45:24 +03:00
parent 5bf745460d
commit c7da5e981b
3 changed files with 192 additions and 169 deletions

135
README.md
View file

@ -18,14 +18,44 @@ http://ultravideo.cs.tut.fi/#encoder for more information.
Usage: Usage:
kvazaar -i <input> --input-res <width>x<height> -o <output> kvazaar -i <input> --input-res <width>x<height> -o <output>
Optional parameters: Required:
--help : Print this help message and exit -i, --input --input-res <res> : Input resolution [auto]
--version : Print version information and exit auto: detect from file name
<int>x<int>: width times height
-o, --output : Output file
Presets:
--preset=<preset> : Set options to a preset [medium]
ultrafast, superfast, veryfast, faster,
fast, medium, slow, slower, veryslow,
placebo
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-res <int>x<int> : Input resolution (width x height) or --input-fps <num>/<denom> : Framerate of the input video [25.0]
auto : try to detect from file name [auto] --source-scan-type <string> : Set source scan type ["progressive"].
--input-fps <num>/<denom> : Framerate of the input video [25.0] "progressive": progressive scan
"tff": top field first
"bff": bottom field first
--input-format : P420 or P400
--input-bitdepth : 8-16
--loop-input : Re-read input file forever
Options:
--help : Print this help message and exit
--version : Print version information and exit
--aud : Use access unit delimiters
--debug <string> : Output encoders reconstruction.
--cpuid <integer> : Disable runtime cpu optimizations with value 0.
--hash : Specify which decoded picture hash to use [checksum]
"none": 0 bytes
"checksum": 18 bytes
"md5": 56 bytes
--no-psnr : Don't calculate PSNR for frames
--no-info : Don't add information about the encoder to settings.
Video structure:
-q, --qp <integer> : Quantization Parameter [32] -q, --qp <integer> : Quantization Parameter [32]
-p, --period <integer> : Period of intra pictures [0] -p, --period <integer> : Period of intra pictures [0]
0: only first picture is intra 0: only first picture is intra
@ -37,6 +67,21 @@ Optional parameters:
1: send VPS with every intra frame 1: send VPS with every intra frame
N: send VPS with every Nth intra frame N: send VPS with every Nth intra frame
-r, --ref <integer> : Reference frames, range 1..15 [3] -r, --ref <integer> : Reference frames, range 1..15 [3]
--gop <string> : Definition of GOP structure [0]
"0": disabled
"8": B-frame pyramid of length 8
"lp-<string>": lp-gop definition (e.g. lp-g8d4r3t2)
--cqmfile <string> : Custom Quantization Matrices from a file
--bitrate <integer> : Target bitrate. [0]
0: disable rate-control
N: target N bits per second
--lossless : Use lossless coding
--mv-constraint : Constrain movement vectors
"none": no constraint
"frametile": constrain within the tile
"frametilemargin": constrain even more
Compression tools:
--no-deblock : Disable deblocking filter --no-deblock : Disable deblocking filter
--deblock <beta:tc> : Deblocking filter parameters --deblock <beta:tc> : Deblocking filter parameters
beta and tc range is -6..6 [0:0] beta and tc range is -6..6 [0:0]
@ -52,10 +97,6 @@ Optional parameters:
--mv-rdo : Enable Rate-Distortion Optimized motion vector costs --mv-rdo : Enable Rate-Distortion Optimized motion vector costs
--full-intra-search : Try all intra modes. --full-intra-search : Try all intra modes.
--no-transform-skip : Disable transform skip --no-transform-skip : Disable transform skip
--aud : Use access unit delimiters
--cqmfile <string> : Custom Quantization Matrices from a file
--debug <string> : Output encoders reconstruction.
--cpuid <integer> : Disable runtime cpu optimizations with value 0.
--me <string> : Set integer motion estimation algorithm ["hexbs"] --me <string> : Set integer motion estimation algorithm ["hexbs"]
"hexbs": Hexagon Based Search (faster) "hexbs": Hexagon Based Search (faster)
"tz": Test Zone Search (better quality) "tz": Test Zone Search (better quality)
@ -66,36 +107,11 @@ Optional parameters:
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
--source-scan-type <string> : Set source scan type ["progressive"].
"progressive": progressive scan
"tff": top field first
"bff": bottom field first
--pu-depth-inter <int>-<int> : Range for sizes of inter prediction units to try. --pu-depth-inter <int>-<int> : Range for sizes of inter prediction units to try.
0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8 0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8
--pu-depth-intra <int>-<int> : Range for sizes of intra prediction units to try. --pu-depth-intra <int>-<int> : Range for sizes of intra prediction units to try.
0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8, 4: 4x4 0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8, 4: 4x4
--no-info : Don't add information about the encoder to settings.
--gop <string> : Definition of GOP structure [0]
"0": disabled
"8": B-frame pyramid of length 8
"lp-<string>": lp-gop definition (e.g. lp-g8d4r3t2)
--bipred : Enable bi-prediction search --bipred : Enable bi-prediction search
--bitrate <integer> : Target bitrate. [0]
0: disable rate-control
N: target N bits per second
--preset <string> : Use preset. This will override previous options.
ultrafast, superfast, veryfast, faster,
fast, medium, slow, slower, veryslow, placebo
--no-psnr : Don't calculate PSNR for frames
--loop-input : Re-read input file forever
--mv-constraint : Constrain movement vectors
"none": no constraint
"frametile": constrain within the tile
"frametilemargin": constrain even more
--hash : Specify which decoded picture hash to use [checksum]
"none": 0 bytes
"checksum": 18 bytes
"md5": 56 bytes
--cu-split-termination : Specify the cu split termination behaviour --cu-split-termination : Specify the cu split termination behaviour
"zero": Terminate when splitting gives little "zero": Terminate when splitting gives little
improvement. improvement.
@ -104,15 +120,31 @@ Optional parameters:
"off": Early termination is off "off": Early termination is off
"on": Early termination is on "on": Early termination is on
"sensitive": Sensitive early termination is on "sensitive": Sensitive early termination is on
--lossless : Use lossless coding
--implicit-rdpcm : Enable implicit residual DPCM. Currently only supported --implicit-rdpcm : Enable implicit residual DPCM. Currently only supported
with lossless coding. with lossless coding.
--no-tmvp : Disable Temporal Motion Vector Prediction --no-tmvp : Disable Temporal Motion Vector Prediction
--rdoq-skip : Skips RDOQ for 4x4 blocks --rdoq-skip : Skips RDOQ for 4x4 blocks
--input-format : P420 or P400
--input-bitdepth : 8-16
Video Usability Information: Parallel processing:
--threads <integer> : Maximum number of threads to use.
Disable threads if set to 0.
--owf <integer>|auto : Number of parallel frames to process. 0 to disable.
--wpp, --no-wpp : Wavefront parallel processing [enabled]
Enabling tiles automatically disabled WPP. To enable
WPP with tiles, re-enable it after enabling tiles.
--tiles <int>x<int> : Split picture into width x height uniform tiles.
--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.
--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.
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
@ -133,28 +165,7 @@ Optional parameters:
smpte240m, GBR, YCgCo, bt2020nc, bt2020c smpte240m, GBR, YCgCo, bt2020nc, bt2020c
--chromaloc <integer> : Specify chroma sample location (0 to 5) [0] --chromaloc <integer> : Specify chroma sample location (0 to 5) [0]
Parallel processing: Deprecated parameters: (might be removed at some point)
--threads <integer> : Maximum number of threads to use.
Disable threads if set to 0.
Tiles:
--tiles <int>x<int> : Split picture into width x height uniform tiles.
--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.
--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.
Wpp:
--wpp : Enable wavefront parallel processing
--owf <integer>|auto : Number of parallel frames to process. 0 to disable.
Deprecated parameters: (might be removed at some point)
Use --input-res: Use --input-res:
-w, --width : Width of input in pixels -w, --width : Width of input in pixels
-h, --height : Height of input in pixels -h, --height : Height of input in pixels

View file

@ -1,30 +1,83 @@
.TH KVAZAAR "1" "October 2016" "kvazaar v0.8.3" "User Commands" .TH KVAZAAR "1" "October 2016" "kvazaar v1.0.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\-\-help \fB\-i\fR, \fB\-\-input \-\-input\-res <res>
Print this help message and exit Input resolution [auto]
auto: detect from file name
<int>x<int>: width times height
.TP .TP
\fB\-\-version \fB\-o\fR, \fB\-\-output
Print version information and exit Output file
.SS "Presets:"
.TP
\fB\-\-preset=<preset>
Set options to a preset [medium]
ultrafast, superfast, veryfast, faster,
fast, medium, slow, slower, veryslow,
placebo
.SS "Input:"
.TP .TP
\fB\-n\fR, \fB\-\-frames <integer> \fB\-n\fR, \fB\-\-frames <integer>
Number of frames to code [all] Number of frames to code [all]
.TP .TP
\fB\-\-seek <integer> \fB\-\-seek <integer>
First frame to code [0] First frame to code [0]
.TP .TP
\fB\-\-input\-res <int>x<int> \fB\-\-input\-fps <num>/<denom>
Input resolution (width x height) or
auto
try to detect from file name [auto]
.TP
\fB\-\-input\-fps <num>/<denom>
Framerate of the input video [25.0] Framerate of the input video [25.0]
.TP .TP
\fB\-\-source\-scan\-type <string>
Set source scan type ["progressive"].
"progressive": progressive scan
"tff": top field first
"bff": bottom field first
.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
Specify which decoded picture hash to use [checksum]
"none": 0 bytes
"checksum": 18 bytes
"md5": 56 bytes
.TP
\fB\-\-no\-psnr
Don't calculate PSNR for frames
.TP
\fB\-\-no\-info
Don't add information about the encoder to settings.
.SS "Video structure:"
.TP
\fB\-q\fR, \fB\-\-qp <integer> \fB\-q\fR, \fB\-\-qp <integer>
Quantization Parameter [32] Quantization Parameter [32]
.TP .TP
@ -44,6 +97,31 @@ re\-sent. [0]
\fB\-r\fR, \fB\-\-ref <integer> \fB\-r\fR, \fB\-\-ref <integer>
Reference frames, range 1..15 [3] Reference frames, range 1..15 [3]
.TP .TP
\fB\-\-gop <string>
Definition of GOP structure [0]
"0": disabled
"8": B\-frame pyramid of length 8
"lp\-<string>": lp\-gop definition (e.g. lp\-g8d4r3t2)
.TP
\fB\-\-cqmfile <string>
Custom Quantization Matrices from a file
.TP
\fB\-\-bitrate <integer>
Target bitrate. [0]
0: disable rate\-control
N: target N bits per second
.TP
\fB\-\-lossless
Use lossless coding
.TP
\fB\-\-mv\-constraint
Constrain movement vectors
"none": no constraint
"frametile": constrain within the tile
"frametilemargin": constrain even more
.SS "Compression tools:"
.TP
\fB\-\-no\-deblock \fB\-\-no\-deblock
Disable deblocking filter Disable deblocking filter
.TP .TP
@ -81,18 +159,6 @@ Try all intra modes.
\fB\-\-no\-transform\-skip \fB\-\-no\-transform\-skip
Disable transform skip Disable transform skip
.TP .TP
\fB\-\-aud
Use access unit delimiters
.TP
\fB\-\-cqmfile <string>
Custom Quantization Matrices from a file
.TP
\fB\-\-debug <string>
Output encoders reconstruction.
.TP
\fB\-\-cpuid <integer>
Disable runtime cpu optimizations with value 0.
.TP
\fB\-\-me <string> \fB\-\-me <string>
Set integer motion estimation algorithm ["hexbs"] Set integer motion estimation algorithm ["hexbs"]
"hexbs": Hexagon Based Search (faster) "hexbs": Hexagon Based Search (faster)
@ -107,12 +173,6 @@ Set fractional pixel motion estimation level [4].
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\-\-source\-scan\-type <string>
Set source scan type ["progressive"].
"progressive": progressive scan
"tff": top field first
"bff": bottom field first
.TP
\fB\-\-pu\-depth\-inter <int>\-<int> \fB\-\-pu\-depth\-inter <int>\-<int>
Range for sizes of inter prediction units to try. Range for sizes of inter prediction units to try.
0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8 0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8
@ -121,46 +181,9 @@ Range for sizes of inter prediction units to try.
Range for sizes of intra prediction units to try. Range for sizes of intra prediction units to try.
0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8, 4: 4x4 0: 64x64, 1: 32x32, 2: 16x16, 3: 8x8, 4: 4x4
.TP .TP
\fB\-\-no\-info
Don't add information about the encoder to settings.
.TP
\fB\-\-gop <string>
Definition of GOP structure [0]
"0": disabled
"8": B\-frame pyramid of length 8
"lp\-<string>": lp\-gop definition (e.g. lp\-g8d4r3t2)
.TP
\fB\-\-bipred \fB\-\-bipred
Enable bi\-prediction search Enable bi\-prediction search
.TP .TP
\fB\-\-bitrate <integer>
Target bitrate. [0]
0: disable rate\-control
N: target N bits per second
.TP
\fB\-\-preset <string>
Use preset. This will override previous options.
ultrafast, superfast, veryfast, faster,
fast, medium, slow, slower, veryslow, placebo
.TP
\fB\-\-no\-psnr
Don't calculate PSNR for frames
.TP
\fB\-\-loop\-input
Re\-read input file forever
.TP
\fB\-\-mv\-constraint
Constrain movement vectors
"none": no constraint
"frametile": constrain within the tile
"frametilemargin": constrain even more
.TP
\fB\-\-hash
Specify which decoded picture hash to use [checksum]
"none": 0 bytes
"checksum": 18 bytes
"md5": 56 bytes
.TP
\fB\-\-cu\-split\-termination \fB\-\-cu\-split\-termination
Specify the cu split termination behaviour Specify the cu split termination behaviour
"zero": Terminate when splitting gives little "zero": Terminate when splitting gives little
@ -173,9 +196,6 @@ Specify the me early termination behaviour
"on": Early termination is on "on": Early termination is on
"sensitive": Sensitive early termination is on "sensitive": Sensitive early termination is on
.TP .TP
\fB\-\-lossless
Use lossless coding
.TP
\fB\-\-implicit\-rdpcm \fB\-\-implicit\-rdpcm
Enable implicit residual DPCM. Currently only supported Enable implicit residual DPCM. Currently only supported
with lossless coding. with lossless coding.
@ -185,12 +205,35 @@ Disable Temporal Motion Vector Prediction
.TP .TP
\fB\-\-rdoq\-skip \fB\-\-rdoq\-skip
Skips RDOQ for 4x4 blocks Skips RDOQ for 4x4 blocks
.SS "Parallel processing:"
.TP .TP
\fB\-\-input\-format \fB\-\-threads <integer>
P420 or P400 Maximum number of threads to use.
Disable threads if set to 0.
.TP .TP
\fB\-\-input\-bitdepth \fB\-\-owf <integer>|auto
8\-16 Number of parallel frames to process. 0 to disable.
.TP
\fB\-\-wpp\fR, \fB\-\-no\-wpp
Wavefront parallel processing [enabled]
Enabling tiles automatically disabled WPP. To enable
WPP with tiles, re\-enable it after enabling tiles.
.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.
.SS "Video Usability Information:" .SS "Video Usability Information:"
.TP .TP
@ -229,34 +272,3 @@ Specify color matrix setting ["undef"]
\fB\-\-chromaloc <integer> \fB\-\-chromaloc <integer>
Specify chroma sample location (0 to 5) [0] Specify chroma sample location (0 to 5) [0]
.SS "Parallel processing:"
.TP
\fB\-\-threads <integer>
Maximum number of threads to use.
Disable threads if set to 0.
.SS "Tiles:"
.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.
.SS "Wpp:"
.TP
\fB\-\-wpp
Enable wavefront parallel processing
.TP
\fB\-\-owf <integer>|auto
Number of parallel frames to process. 0 to disable.

View file

@ -30,6 +30,6 @@ EOF
s|, \\-\\-|\\fR, \\fB\\-\\-|g;' \ s|, \\-\\-|\\fR, \\fB\\-\\-|g;' \
>> $manpage_file >> $manpage_file
for s in Slices Wpp Tiles "Parallel processing" "Video Usability Information"; do for s in Required Presets Input Options "Video structure" "Compression tools" "Parallel processing" "Video Usability Information"; do
sed -i "s|^ ${s}:|.SS \"${s}:\"|g" $manpage_file sed -i "s|^${s}:|.SS \"${s}:\"|g" $manpage_file
done done