2015-05-13 09:45:11 +00:00
|
|
|
/*****************************************************************************
|
|
|
|
* This file is part of Kvazaar HEVC encoder.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2013-2015 Tampere University of Technology and others (see
|
|
|
|
* COPYING file).
|
|
|
|
*
|
|
|
|
* Kvazaar is free software: you can redistribute it and/or modify it under
|
|
|
|
* the terms of the GNU Lesser General Public License as published by the
|
|
|
|
* Free Software Foundation; either version 2.1 of the License, or (at your
|
|
|
|
* option) any later version.
|
|
|
|
*
|
|
|
|
* Kvazaar 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 Lesser General Public License for
|
|
|
|
* more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
* with Kvazaar. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* \file
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2015-07-03 12:04:36 +00:00
|
|
|
#include "cli.h"
|
2015-05-13 09:45:11 +00:00
|
|
|
|
|
|
|
#include <stdio.h>
|
2015-07-03 12:04:36 +00:00
|
|
|
#include <stdlib.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <getopt.h>
|
2015-07-29 16:07:27 +00:00
|
|
|
#include <ctype.h>
|
2015-05-13 09:45:11 +00:00
|
|
|
|
2015-07-03 12:04:36 +00:00
|
|
|
static const char short_options[] = "i:o:d:w:h:n:q:p:r:";
|
|
|
|
static const struct option long_options[] = {
|
|
|
|
{ "input", required_argument, NULL, 'i' },
|
|
|
|
{ "output", required_argument, NULL, 'o' },
|
|
|
|
{ "debug", required_argument, NULL, 'd' },
|
2018-03-23 10:33:06 +00:00
|
|
|
{ "width", required_argument, NULL, 'w' }, // deprecated
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "height", required_argument, NULL, 'h' }, // deprecated
|
2018-03-23 10:33:06 +00:00
|
|
|
{ "frames", required_argument, NULL, 'n' },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "qp", required_argument, NULL, 'q' },
|
|
|
|
{ "period", required_argument, NULL, 'p' },
|
|
|
|
{ "ref", required_argument, NULL, 'r' },
|
|
|
|
{ "vps-period", required_argument, NULL, 0 },
|
|
|
|
{ "input-res", required_argument, NULL, 0 },
|
|
|
|
{ "input-fps", required_argument, NULL, 0 },
|
2015-11-13 12:20:27 +00:00
|
|
|
{ "deblock", required_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-deblock", no_argument, NULL, 0 },
|
2017-08-11 10:12:22 +00:00
|
|
|
{ "sao", optional_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-sao", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "rdoq", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-rdoq", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "signhide", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-signhide", no_argument, NULL, 0 },
|
2015-12-15 05:57:38 +00:00
|
|
|
{ "smp", no_argument, NULL, 0 },
|
|
|
|
{ "no-smp", no_argument, NULL, 0 },
|
2015-12-01 12:37:58 +00:00
|
|
|
{ "amp", no_argument, NULL, 0 },
|
|
|
|
{ "no-amp", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "rd", required_argument, NULL, 0 },
|
|
|
|
{ "full-intra-search", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "no-full-intra-search", no_argument, NULL, 0 },
|
|
|
|
{ "transform-skip", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-transform-skip", no_argument, NULL, 0 },
|
|
|
|
{ "tr-depth-intra", required_argument, NULL, 0 },
|
|
|
|
{ "me", required_argument, NULL, 0 },
|
|
|
|
{ "subme", required_argument, NULL, 0 },
|
2015-08-13 09:53:14 +00:00
|
|
|
{ "source-scan-type", required_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "sar", required_argument, NULL, 0 },
|
|
|
|
{ "overscan", required_argument, NULL, 0 },
|
|
|
|
{ "videoformat", required_argument, NULL, 0 },
|
|
|
|
{ "range", required_argument, NULL, 0 },
|
|
|
|
{ "colorprim", required_argument, NULL, 0 },
|
|
|
|
{ "transfer", required_argument, NULL, 0 },
|
|
|
|
{ "colormatrix", required_argument, NULL, 0 },
|
|
|
|
{ "chromaloc", required_argument, NULL, 0 },
|
|
|
|
{ "aud", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "no-aud", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "cqmfile", required_argument, NULL, 0 },
|
|
|
|
{ "seek", required_argument, NULL, 0 },
|
2016-03-07 13:54:35 +00:00
|
|
|
{ "tiles", required_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "tiles-width-split", required_argument, NULL, 0 },
|
|
|
|
{ "tiles-height-split", required_argument, NULL, 0 },
|
|
|
|
{ "wpp", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "no-wpp", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "owf", required_argument, NULL, 0 },
|
2017-01-31 13:44:23 +00:00
|
|
|
{ "slices", required_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "threads", required_argument, NULL, 0 },
|
2018-03-23 10:32:27 +00:00
|
|
|
{ "cpuid", optional_argument, NULL, 0 },
|
|
|
|
{ "no-cpuid", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "pu-depth-inter", required_argument, NULL, 0 },
|
|
|
|
{ "pu-depth-intra", required_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "info", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "no-info", no_argument, NULL, 0 },
|
|
|
|
{ "gop", required_argument, NULL, 0 },
|
|
|
|
{ "bipred", no_argument, NULL, 0 },
|
2015-11-03 15:30:16 +00:00
|
|
|
{ "no-bipred", no_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{ "bitrate", required_argument, NULL, 0 },
|
2015-11-03 10:04:22 +00:00
|
|
|
{ "preset", required_argument, NULL, 0 },
|
2015-11-05 11:59:30 +00:00
|
|
|
{ "mv-rdo", no_argument, NULL, 0 },
|
|
|
|
{ "no-mv-rdo", no_argument, NULL, 0 },
|
2016-01-21 13:08:34 +00:00
|
|
|
{ "psnr", no_argument, NULL, 0 },
|
|
|
|
{ "no-psnr", no_argument, NULL, 0 },
|
2016-02-04 11:22:17 +00:00
|
|
|
{ "version", no_argument, NULL, 0 },
|
|
|
|
{ "help", no_argument, NULL, 0 },
|
2016-02-18 17:27:14 +00:00
|
|
|
{ "loop-input", no_argument, NULL, 0 },
|
2016-02-24 10:10:51 +00:00
|
|
|
{ "mv-constraint", required_argument, NULL, 0 },
|
2016-03-17 15:00:43 +00:00
|
|
|
{ "hash", required_argument, NULL, 0 },
|
2016-05-10 11:15:41 +00:00
|
|
|
{"cu-split-termination",required_argument, NULL, 0 },
|
2016-06-07 07:55:26 +00:00
|
|
|
{ "crypto", required_argument, NULL, 0 },
|
2017-08-28 15:15:13 +00:00
|
|
|
{ "key", required_argument, NULL, 0 },
|
2016-06-06 12:47:31 +00:00
|
|
|
{ "me-early-termination",required_argument, NULL, 0 },
|
2016-05-26 07:38:45 +00:00
|
|
|
{ "lossless", no_argument, NULL, 0 },
|
|
|
|
{ "no-lossless", no_argument, NULL, 0 },
|
2016-08-10 08:58:15 +00:00
|
|
|
{ "tmvp", no_argument, NULL, 0 },
|
|
|
|
{ "no-tmvp", no_argument, NULL, 0 },
|
2016-08-17 07:07:40 +00:00
|
|
|
{ "rdoq-skip", no_argument, NULL, 0 },
|
2016-09-11 08:40:16 +00:00
|
|
|
{ "no-rdoq-skip", no_argument, NULL, 0 },
|
2016-08-16 16:03:21 +00:00
|
|
|
{ "input-bitdepth", required_argument, NULL, 0 },
|
|
|
|
{ "input-format", required_argument, NULL, 0 },
|
2016-08-03 05:18:56 +00:00
|
|
|
{ "implicit-rdpcm", no_argument, NULL, 0 },
|
|
|
|
{ "no-implicit-rdpcm", no_argument, NULL, 0 },
|
2017-01-16 06:47:21 +00:00
|
|
|
{ "roi", required_argument, NULL, 0 },
|
2017-04-19 12:47:47 +00:00
|
|
|
{ "erp-aqp", no_argument, NULL, 0 },
|
|
|
|
{ "no-erp-aqp", no_argument, NULL, 0 },
|
2017-11-03 11:04:05 +00:00
|
|
|
{ "level", required_argument, NULL, 0 },
|
2017-11-03 13:47:35 +00:00
|
|
|
{ "force-level", required_argument, NULL, 0 },
|
2017-11-20 14:05:28 +00:00
|
|
|
{ "high-tier", no_argument, NULL, 0 },
|
2017-12-22 10:10:41 +00:00
|
|
|
{ "me-steps", required_argument, NULL, 0 },
|
2015-07-03 12:04:36 +00:00
|
|
|
{0, 0, 0, 0}
|
|
|
|
};
|
|
|
|
|
2015-07-29 16:07:27 +00:00
|
|
|
/**
|
|
|
|
* \brief Try to detect resolution from file name automatically
|
|
|
|
*
|
|
|
|
* \param file_name file name to get dimensions from
|
|
|
|
* \param out_width detected width
|
|
|
|
* \param out_height detected height
|
|
|
|
* \return 1 if the resolution is set, 0 on fail
|
|
|
|
*/
|
|
|
|
static int select_input_res_auto(const char *file_name, int32_t *out_width, int32_t *out_height)
|
|
|
|
{
|
|
|
|
if (!file_name) return 0;
|
|
|
|
|
|
|
|
// Find the last delimiter char ( / or \ ). Hope the other kind is not used in the name.
|
|
|
|
// If delim is not found, set pointer to the beginning.
|
2015-07-31 15:44:36 +00:00
|
|
|
unsigned char* sub_str = (unsigned char*)MAX(strrchr(file_name, '/'), strrchr(file_name, '\\'));
|
|
|
|
if (!sub_str) sub_str = (unsigned char*)file_name;
|
2015-07-29 16:07:27 +00:00
|
|
|
|
|
|
|
int success = 0;
|
|
|
|
// Try if the substring starts with "<int>x<int>" without either of them being 0
|
|
|
|
do {
|
2015-07-31 15:44:36 +00:00
|
|
|
success = (sscanf((char*)sub_str, "%dx%d%*s", out_width, out_height) == 2);
|
2015-07-29 16:07:27 +00:00
|
|
|
success &= (*out_width > 0 && *out_height > 0);
|
|
|
|
// Move to the next char until a digit is found or the string ends
|
|
|
|
do{
|
|
|
|
++sub_str;
|
|
|
|
} while (*sub_str != 0 && !isdigit(*sub_str));
|
|
|
|
// Continue until "<int>x<int>" is found or the string ends
|
|
|
|
} while (*sub_str != 0 && !success);
|
|
|
|
|
|
|
|
return success;
|
|
|
|
}
|
|
|
|
|
2015-07-03 12:04:36 +00:00
|
|
|
/**
|
|
|
|
* \brief Parse command line arguments.
|
|
|
|
* \param argc Number of arguments
|
|
|
|
* \param argv Argument list
|
|
|
|
* \return Pointer to the parsed options, or NULL on failure.
|
|
|
|
*/
|
|
|
|
cmdline_opts_t* cmdline_opts_parse(const kvz_api *const api, int argc, char *argv[])
|
|
|
|
{
|
|
|
|
int ok = 1;
|
|
|
|
cmdline_opts_t *opts = calloc(1, sizeof(cmdline_opts_t));
|
|
|
|
if (!opts) {
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
|
|
|
opts->config = api->config_alloc();
|
|
|
|
if (!opts->config || !api->config_init(opts->config)) {
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Parse command line options
|
|
|
|
for (optind = 0;;) {
|
|
|
|
int long_options_index = -1;
|
|
|
|
|
|
|
|
int c = getopt_long(argc, argv, short_options, long_options, &long_options_index);
|
|
|
|
if (c == -1)
|
|
|
|
break;
|
|
|
|
|
|
|
|
if (long_options_index < 0) {
|
|
|
|
int i;
|
|
|
|
for (i = 0; long_options[i].name; i++)
|
|
|
|
if (long_options[i].val == c) {
|
|
|
|
long_options_index = i;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
if (long_options_index < 0) {
|
|
|
|
// getopt_long already printed an error message
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
const char* name = long_options[long_options_index].name;
|
|
|
|
if (!strcmp(name, "input")) {
|
|
|
|
if (opts->input) {
|
|
|
|
fprintf(stderr, "Input error: More than one input file given.\n");
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
opts->input = strdup(optarg);
|
|
|
|
} else if (!strcmp(name, "output")) {
|
|
|
|
if (opts->output) {
|
|
|
|
fprintf(stderr, "Input error: More than one output file given.\n");
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
opts->output = strdup(optarg);
|
|
|
|
} else if (!strcmp(name, "debug")) {
|
|
|
|
if (opts->debug) {
|
|
|
|
fprintf(stderr, "Input error: More than one debug output file given.\n");
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
opts->debug = strdup(optarg);
|
|
|
|
} else if (!strcmp(name, "seek")) {
|
|
|
|
opts->seek = atoi(optarg);
|
|
|
|
} else if (!strcmp(name, "frames")) {
|
|
|
|
opts->frames = atoi(optarg);
|
2016-02-04 11:22:17 +00:00
|
|
|
} else if (!strcmp(name, "version")) {
|
|
|
|
opts->version = true;
|
|
|
|
goto done;
|
|
|
|
} else if (!strcmp(name, "help")) {
|
|
|
|
opts->help = true;
|
|
|
|
goto done;
|
2016-02-18 17:27:14 +00:00
|
|
|
} else if (!strcmp(name, "loop-input")) {
|
|
|
|
opts->loop_input = true;
|
2015-11-09 11:57:28 +00:00
|
|
|
} else if (!api->config_parse(opts->config, name, optarg)) {
|
2015-07-03 12:04:36 +00:00
|
|
|
fprintf(stderr, "invalid argument: %s=%s\n", name, optarg);
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-11-13 11:55:23 +00:00
|
|
|
// Check for extra arguments.
|
|
|
|
if (argc - optind > 0) {
|
|
|
|
fprintf(stderr, "Input error: Extra argument found: \"%s\"\n", argv[optind]);
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
2015-07-03 12:04:36 +00:00
|
|
|
// Check that the required files were defined
|
|
|
|
if (opts->input == NULL || opts->output == NULL) {
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
2015-10-15 12:23:40 +00:00
|
|
|
if (opts->config->vps_period < 0) {
|
|
|
|
// Disabling parameter sets is only possible when using Kvazaar as
|
|
|
|
// a library.
|
|
|
|
fprintf(stderr, "Input error: vps_period must be non-negative\n");
|
|
|
|
ok = 0;
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
2015-07-29 16:07:27 +00:00
|
|
|
// Set resolution automatically if necessary
|
2016-06-20 05:16:58 +00:00
|
|
|
if (opts->config->width == 0 && opts->config->height == 0) {
|
2015-07-29 16:07:27 +00:00
|
|
|
ok = select_input_res_auto(opts->input, &opts->config->width, &opts->config->height);
|
|
|
|
goto done;
|
|
|
|
}
|
|
|
|
|
2015-07-03 12:04:36 +00:00
|
|
|
done:
|
|
|
|
if (!ok) {
|
|
|
|
cmdline_opts_free(api, opts);
|
|
|
|
opts = NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
return opts;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \brief Deallocate a cmdline_opts_t structure.
|
|
|
|
*/
|
|
|
|
void cmdline_opts_free(const kvz_api *const api, cmdline_opts_t *opts)
|
|
|
|
{
|
|
|
|
if (opts) {
|
|
|
|
FREE_POINTER(opts->input);
|
|
|
|
FREE_POINTER(opts->output);
|
|
|
|
FREE_POINTER(opts->debug);
|
|
|
|
api->config_destroy(opts->config);
|
|
|
|
opts->config = NULL;
|
|
|
|
}
|
|
|
|
FREE_POINTER(opts);
|
|
|
|
}
|
2015-05-14 15:33:57 +00:00
|
|
|
|
2015-05-13 09:45:11 +00:00
|
|
|
|
2016-02-04 11:22:17 +00:00
|
|
|
void print_usage(void)
|
|
|
|
{
|
|
|
|
fprintf(stdout,
|
|
|
|
"Kvazaar usage: -i and --input-res to set input, -o to set output\n"
|
|
|
|
" --help for more information\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2015-05-13 09:45:11 +00:00
|
|
|
void print_version(void)
|
|
|
|
{
|
2016-02-04 11:22:17 +00:00
|
|
|
fprintf(stdout,
|
|
|
|
"Kvazaar " VERSION_STRING "\n"
|
|
|
|
"Kvazaar license: LGPL version 2\n");
|
2015-05-13 09:45:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
void print_help(void)
|
|
|
|
{
|
2016-02-04 11:22:17 +00:00
|
|
|
fprintf(stdout,
|
2015-05-13 09:45:11 +00:00
|
|
|
"Usage:\n"
|
|
|
|
"kvazaar -i <input> --input-res <width>x<height> -o <output>\n"
|
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Required:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" -i, --input <filename> : Input file\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --input-res <res> : Input resolution [auto]\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" - auto: Detect from file name.\n"
|
|
|
|
" - <int>x<int>: width times height\n"
|
|
|
|
" -o, --output <filename> : Output file\n"
|
2016-10-26 23:33:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Presets:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --preset <preset> : Set options to a preset [medium]\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - ultrafast, superfast, veryfast, faster,\n"
|
|
|
|
" fast, medium, slow, slower, veryslow\n"
|
2016-10-26 23:33:11 +00:00
|
|
|
" placebo\n"
|
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Input:\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" -n, --frames <integer> : Number of frames to code [all]\n"
|
|
|
|
" --seek <integer> : First frame to code [0]\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --input-fps <num>[/<denom>] : Frame rate of the input video [25]\n"
|
|
|
|
" --source-scan-type <string> : Source scan type [progressive]\n"
|
|
|
|
" - progressive: Progressive scan\n"
|
|
|
|
" - tff: Top field first\n"
|
|
|
|
" - bff: Bottom field first\n"
|
|
|
|
" --input-format <string> : P420 or P400 [P420]\n"
|
|
|
|
" --input-bitdepth <int> : 8-16 [8]\n"
|
|
|
|
" --loop-input : Re-read input file forever.\n"
|
2016-10-26 23:33:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Options:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --help : Print this help message and exit.\n"
|
|
|
|
" --version : Print version information and exit.\n"
|
|
|
|
" --(no-)aud : Use access unit delimiters. [disabled]\n"
|
|
|
|
" --debug <filename> : Output internal reconstruction.\n"
|
|
|
|
" --(no-)cpuid : Enable runtime CPU optimizations. [enabled]\n"
|
|
|
|
" --hash <string> : Decoded picture hash [checksum]\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - none: 0 bytes\n"
|
|
|
|
" - checksum: 18 bytes\n"
|
|
|
|
" - md5: 56 bytes\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --(no-)psnr : Calculate PSNR for frames. [enabled]\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"
|
2016-10-26 23:33:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Video structure:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" -q, --qp <integer> : Quantization parameter [22]\n"
|
|
|
|
" -p, --period <integer> : Period of intra pictures [64]\n"
|
|
|
|
" - 0: Only first picture is intra.\n"
|
|
|
|
" - 1: All pictures are intra.\n"
|
|
|
|
" - N: Every Nth picture is intra.\n"
|
|
|
|
" --vps-period <integer> : How often the video parameter set is re-sent [0]\n"
|
|
|
|
" - 0: Only send VPS with the first frame.\n"
|
|
|
|
" - N: Send VPS with every Nth intra frame.\n"
|
|
|
|
" -r, --ref <integer> : Number of reference frames, in range 1..15 [1]\n"
|
|
|
|
" --gop <string> : GOP structure [lp-g4d3t1]\n"
|
|
|
|
" - 0: Disabled\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - 8: B-frame pyramid of length 8\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" - lp-<string>: Low-delay P-frame GOP\n"
|
|
|
|
" (e.g. lp-g8d4t2, see README)\n"
|
|
|
|
" --cqmfile <filename> : Read custom quantization matrices from a file.\n"
|
|
|
|
" --bitrate <integer> : Target bitrate [0]\n"
|
|
|
|
" - 0: Disable rate control.\n"
|
|
|
|
" - N: Target N bits per second.\n"
|
|
|
|
" --(no-)lossless : Use lossless coding. [disabled]\n"
|
|
|
|
" --mv-constraint <string> : Constrain movement vectors. [none]\n"
|
|
|
|
" - none: No constraint\n"
|
|
|
|
" - frametile: Constrain within the tile.\n"
|
|
|
|
" - frametilemargin: Constrain even more.\n"
|
|
|
|
" --roi <filename> : Use a delta QP map for region of interest.\n"
|
|
|
|
" Reads an array of delta QP values from a text\n"
|
|
|
|
" file. The file format is: width and height of\n"
|
|
|
|
" the QP delta map followed by width*height delta\n"
|
|
|
|
" QP values in raster order. The map can be of any\n"
|
|
|
|
" size and will be scaled to the video size.\n"
|
|
|
|
" --(no-)erp-aqp : Use adaptive QP for 360 degree video with\n"
|
|
|
|
" equirectangular projection. [disabled]\n"
|
2017-11-09 14:53:31 +00:00
|
|
|
" --level <number> : Use the given HEVC level in the output and give\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" an error if level limits are exceeded. [6.2]\n"
|
|
|
|
" - 1, 2, 2.1, 3, 3.1, 4, 4.1, 5, 5.1, 5.2, 6,\n"
|
|
|
|
" 6.1, 6.2\n"
|
|
|
|
" --force-level <number> : Same as --level but warnings instead of errors.\n"
|
|
|
|
" --high-tier : Used with --level. Use high tier bitrate limits\n"
|
|
|
|
" instead of the main tier limits during encoding.\n"
|
2016-10-26 23:33:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Compression tools:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --(no-)deblock <beta:tc> : Deblocking filter. [0:0]\n"
|
|
|
|
" - beta: Between -6 and 6\n"
|
|
|
|
" - tc: Between -6 and 6\n"
|
|
|
|
" --sao <string> : Sample Adaptive Offset [full]\n"
|
|
|
|
" - off: SAO disabled\n"
|
|
|
|
" - band: Band offset only\n"
|
|
|
|
" - edge: Edge offset only\n"
|
|
|
|
" - full: Full SAO\n"
|
|
|
|
" --(no-)rdoq : Rate-distortion optimized quantization [enabled]\n"
|
|
|
|
" --(no-)rdoq-skip : Skip RDOQ for 4x4 blocks. [enabled]\n"
|
|
|
|
" --(no-)signhide : Sign hiding [disabled]\n"
|
|
|
|
" --(no-)smp : Symmetric motion partition [disabled]\n"
|
|
|
|
" --(no-)amp : Asymmetric motion partition [disabled]\n"
|
|
|
|
" --rd <integer> : Intra mode search complexity [1]\n"
|
|
|
|
" - 0: Skip intra if inter is good enough.\n"
|
|
|
|
" - 1: Rough intra mode search with SATD.\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"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - hexbs: Hexagon Based Search\n"
|
|
|
|
" - tz: Test Zone Search\n"
|
|
|
|
" - full: Full Search\n"
|
|
|
|
" - full8, full16, full32, full64\n"
|
2017-12-12 12:45:01 +00:00
|
|
|
" - dia: Diamond Search\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --me-steps <integer> : Motion estimation search step limit. Only\n"
|
|
|
|
" affects 'hexbs' and 'dia'. [-1]\n"
|
|
|
|
" --subme <integer> : Fractional pixel motion estimation level [4]\n"
|
|
|
|
" - 0: Integer motion estimation only\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - 1: + 1/2-pixel horizontal and vertical\n"
|
|
|
|
" - 2: + 1/2-pixel diagonal\n"
|
|
|
|
" - 3: + 1/4-pixel horizontal and vertical\n"
|
|
|
|
" - 4: + 1/4-pixel diagonal\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --pu-depth-inter <int>-<int> : Inter prediction units sizes [1-3]\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - 0, 1, 2, 3: from 64x64 to 8x8\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --pu-depth-intra <int>-<int> : Intra prediction units sizes [1-3]\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" - 0, 1, 2, 3, 4: from 64x64 to 4x4\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --tr-depth-intra <int> : Transform split depth for intra blocks [0]\n"
|
|
|
|
" --(no-)bipred : Bi-prediction [disabled]\n"
|
|
|
|
" --cu-split-termination <string> : CU split search termination [zero]\n"
|
|
|
|
" - off: Don't terminate early.\n"
|
|
|
|
" - zero: Terminate when residual is zero.\n"
|
|
|
|
" --me-early-termination <string> : Motion estimation termination [on]\n"
|
|
|
|
" - off: Don't terminate early.\n"
|
|
|
|
" - on: Terminate early.\n"
|
|
|
|
" - sensitive: Terminate even earlier.\n"
|
|
|
|
" --(no-)implicit-rdpcm : Implicit residual DPCM. Currently only supported\n"
|
|
|
|
" with lossless coding. [disabled]\n"
|
|
|
|
" --(no-)tmvp : Temporal motion vector prediction [enabled]\n"
|
2015-05-13 09:45:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Parallel processing:\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --threads <integer> : Number of threads to use [auto]\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" - 0: Process everything with main thread.\n"
|
|
|
|
" - N: Use N threads for encoding.\n"
|
|
|
|
" - auto: Select automatically.\n"
|
|
|
|
" --owf <integer> : Frame-level parallelism [auto]\n"
|
|
|
|
" - N: Process N-1 frames at a time.\n"
|
|
|
|
" - auto: Select automatically.\n"
|
|
|
|
" --(no-)wpp : Wavefront parallel processing.\n"
|
|
|
|
" Enabling tiles automatically disables WPP. To\n"
|
|
|
|
" enable WPP with tiles, re-enable it after\n"
|
|
|
|
" enabling tiles. [enabled]\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --tiles <int>x<int> : Split picture into width x height uniform tiles.\n"
|
|
|
|
" --tiles-width-split <string>|u<int> :\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" - <string>: A comma-separated list of tile\n"
|
|
|
|
" column pixel coordinates.\n"
|
|
|
|
" - u<int>: Number of tile columns of uniform\n"
|
|
|
|
" width.\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --tiles-height-split <string>|u<int> :\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" - <string>: A comma-separated list of tile row\n"
|
|
|
|
" column pixel coordinates.\n"
|
|
|
|
" - u<int>: Number of tile rows of uniform\n"
|
|
|
|
" height.\n"
|
|
|
|
" --slices <string> : Control how slices are used.\n"
|
|
|
|
" - tiles: Put tiles in independent slices.\n"
|
|
|
|
" - wpp: Put rows in dependent slices.\n"
|
|
|
|
" - tiles+wpp: Do both.\n"
|
2016-10-26 23:33:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Video Usability Information:\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" --sar <width:height> : Specify sample aspect ratio\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --overscan <string> : Specify crop overscan setting [undef]\n"
|
|
|
|
" - undef, show, crop\n"
|
|
|
|
" --videoformat <string> : Specify video format [undef]\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
" - undef, component, pal, ntsc, secam, mac\n"
|
2016-11-04 13:30:58 +00:00
|
|
|
" --range <string> : Specify color range [tv]\n"
|
|
|
|
" - tv, pc\n"
|
|
|
|
" --colorprim <string> : Specify color primaries [undef]\n"
|
|
|
|
" - undef, bt709, bt470m, bt470bg,\n"
|
|
|
|
" smpte170m, smpte240m, film, bt2020\n"
|
|
|
|
" --transfer <string> : Specify transfer characteristics [undef]\n"
|
|
|
|
" - undef, bt709, bt470m, bt470bg,\n"
|
|
|
|
" smpte170m, smpte240m, linear, log100,\n"
|
|
|
|
" log316, iec61966-2-4, bt1361e,\n"
|
|
|
|
" iec61966-2-1, bt2020-10, bt2020-12\n"
|
|
|
|
" --colormatrix <string> : Specify color matrix setting [undef]\n"
|
|
|
|
" - undef, bt709, fcc, bt470bg, smpte170m,\n"
|
|
|
|
" smpte240m, GBR, YCgCo, bt2020nc, bt2020c\n"
|
|
|
|
" --chromaloc <integer> : Specify chroma sample location (0 to 5) [0]\n"
|
2015-05-13 09:45:11 +00:00
|
|
|
"\n"
|
2017-12-07 08:47:44 +00:00
|
|
|
/* Word wrap to this width to stay under 80 characters (including ") *************/
|
2016-10-26 23:33:11 +00:00
|
|
|
"Deprecated parameters: (might be removed at some point)\n"
|
2018-03-23 10:33:06 +00:00
|
|
|
" -w, --width <integer> : Use --input-res.\n"
|
|
|
|
" -h, --height <integer> : Use --input-res.\n");
|
2015-05-13 09:45:11 +00:00
|
|
|
}
|
2015-05-14 15:33:57 +00:00
|
|
|
|
|
|
|
|
2015-09-09 07:28:45 +00:00
|
|
|
void print_frame_info(const kvz_frame_info *const info,
|
|
|
|
const double frame_psnr[3],
|
2017-07-19 07:38:37 +00:00
|
|
|
const uint32_t bytes,
|
|
|
|
const bool print_psnr)
|
2015-05-14 15:33:57 +00:00
|
|
|
{
|
2017-07-19 07:38:37 +00:00
|
|
|
fprintf(stderr, "POC %4d QP %2d (%c-frame) %10d bits",
|
2015-09-09 07:28:45 +00:00
|
|
|
info->poc,
|
|
|
|
info->qp,
|
|
|
|
"BPI"[info->slice_type % 3],
|
2017-07-19 07:38:37 +00:00
|
|
|
bytes << 3);
|
|
|
|
if (print_psnr) {
|
|
|
|
fprintf(stderr, " PSNR Y %2.4f U %2.4f V %2.4f",
|
|
|
|
frame_psnr[0], frame_psnr[1], frame_psnr[2]);
|
|
|
|
}
|
2015-05-14 15:33:57 +00:00
|
|
|
|
2015-09-09 07:28:45 +00:00
|
|
|
if (info->slice_type != KVZ_SLICE_I) {
|
2015-09-09 07:01:02 +00:00
|
|
|
// Print reference picture lists
|
2015-05-14 15:33:57 +00:00
|
|
|
fprintf(stderr, " [L0 ");
|
2017-09-25 10:48:56 +00:00
|
|
|
for (int j = 0; j < info->ref_list_len[0]; j++) {
|
2015-09-09 07:28:45 +00:00
|
|
|
fprintf(stderr, "%d ", info->ref_list[0][j]);
|
2015-05-14 15:33:57 +00:00
|
|
|
}
|
|
|
|
fprintf(stderr, "] [L1 ");
|
2015-09-09 07:28:45 +00:00
|
|
|
for (int j = 0; j < info->ref_list_len[1]; j++) {
|
|
|
|
fprintf(stderr, "%d ", info->ref_list[1][j]);
|
2015-05-14 15:33:57 +00:00
|
|
|
}
|
|
|
|
fprintf(stderr, "]");
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(stderr, "\n");
|
|
|
|
}
|