2017-10-23

Описание конфигурационного файла Baka Encoder

Baka Encoder пытается загрузить свои настройки из XML файла кофигурации в следующем порядке:

  1. Из XML файла, указанного в аргументах командной строки. Для того чтобы указать Baka Encoder использовать настройки из определенного файла конфигурации его слудует запустить так:
    "C:\Program Files\Baka Encoder\Baka Encoder.exe" "C:\my presets.xml"

    или просто перетащить XML файл на иконку исполняемого файла Baka Encoder в Проводнике Windows.
  2. Из XML файла с именем
    "Baka Encoder.config.xml"
    , находящегося в той же папке, где и
    "Baka Encoder.exe"
    .
  3. Из встроенного ресурса с настройками по-умолчанию.

Заметки по процессу загрузки:

  • Файл конфигурации открывается в режиме чтения.
  • Если файл конфигурации не удалось загрузить, то будет выведено диагностическое сообщение.

Файл конфигурации должен быть корректным XML документом сохраненным в кодировке UTF-8. Далее дается полное описание содержимого файла конфигурации:

<baka_encoder>
количествоодин
описаниеКорневой элемент файла конфигурации.
"logging"
типбулевое
значения0, 1
описаниеКонтролирует, будет ли изначально включено ведение логов.
<presets>
количествоодин
описаниеСодержит список пресетов. Высота окна Baka Encoder будет автоматически подогнана так, чтобы все пресеты в нем поместились.
<preset>
количествоодин или несколько
описаниеОписывает отдельный пресет.
"name"
типстрока
значениянепустые строки
описаниеОтображаемое имя.
"suffix"
типстрока
значениянепустые строки без зарезервированных символов
< > : " / \ | ? *
описаниеСтрока, которая будет добавлена к имени исходного файла для формирования имени готового файла.
"on"
типбулевое
значения0, 1
описаниеКонтролирует, будет ли пресет изначально включен.
<hint>
количествоодин
описаниеПараметры всплывающей подсказки, которая отображается, когда пользователь задерживает курсор мыши над пресетом.
"quality"
типцелое число
значения0..16
описаниеВеличина, отображаемая на индикаторе качества в подсказке.
"compression"
типцелое число
значения0..16
описаниеВеличина, отображаемая на индикаторе степени сжатия в подсказке.
"speed"
типцелое число
значения0..16
описаниеВеличина, отображаемая на индикаторе скорости кодирования в подсказке.
"streaming"
типбулевое
значения0, 1
описаниеУстановите на 1, если закодированный файл будет подходить для просмотра онлайн.
<audio>
количествоодин
описаниеОписывает параметры кодирования Аудио.
"format"
типстрока
значенияnone, aac
описаниеЗадает аудио кодек. Установите "none" чтобы отключить кодирование аудио, в этом случае остальные аттрибуты ноды "audio" будут проигнорированы.
"cmd"
типстрока
значениялюбые
описаниеТут указываются аргументы командной строки для NeroAAC. Оставьте пустым, чтобы отключить кодирование звука.
<video>
количествоодин
описаниеПараметры кодирования видео
"format"
типстрока
значенияnone, avc, hevc
описаниеЗадает видео кодек. Установите "none" чтобы отключить кодирование видео, в этом случае остальные аттрибуты ноды "video" будут проигнорированы.
"bit_depth"
типцелое число
значения8, 10
описаниеГлубина цвета.
"passes_count"
типцелое число
значения1, 2, 3
описаниеКоличество проходов.
"base_bitrate"
типцелое число
значения0..2000000000
описаниеЦелевой битрейт для 640x480@24 видео. Реальный битрейт будет рассчитан путем изменения этой величины в зависимости от разрешения, частоты кадров, цветового пространства и глубины цвета видео. 0 - отключить автоматическое вычисление битрейта. Выставите значение на 0, если вы кодируете по CRF или указываете битрейт вручную среди аргументов командной строки.
"max_bitrate"
типцелое число
значения0..2000000000
описаниеНаибольшее разрешенное значение для автоматически рассчитанного битрейта. Используется только если
"base_bitrate"
не 0. 0 - без ограничения.
"max_width"
типцелое число
значения0..9000
описаниеНаибольшая разрешенная ширина видео в пикселях. Видео будет автоматически масштабироваться (с сохранением соотношения сторон) до этой ширины в случае, если его ширина превышает заданную. В зависимости от используемого цветового пространства, должна быть кратна 2 пикселям. 0 - ширина не ограничивается.
"max_height"
типцелое число
значения0..9000
описаниеНаибольшая разрешенная высота видео в пикселях. Видео будет автоматически масштабироваться (с сохранением соотношения сторон) до этой высоты в случае, если его высота превышает заданную. В зависимости от используемого цветового пространства, должна быть кратна 2 пикселям. 0 - высота не ограничивается.
"resizing_method"
типстрока
значенияpoint, linear, bicubic, gauss, sinc, lanczos, spline
описаниеМетод, который должен быть использован для масштабирования видео. Должен быть указан, если
"max_width"
или
"max_height"
не 0.
"cmd"
типстрока
значениялюбые
описаниеТут указываются аргументы командной строки для инструмента кодирования видео (x264 or x265). Аргумент
--bitrate
может быть указан только если автоматическое вычисление битрейта отключено. Если ведение лога отключено, то
--log-level
выставляется на
none
, а также задействуется
--quiet
(для x264), иначе
--log-level
выставляется на
debug
. Значение, указанное для
--output-csp
используется для определения требуемых параметров преобразования цветового пространства. Значение, указанное для
--input-range
или
--range
используются для определения требуемых параметров преобразования цветового пространства. Если
--input-range
не задан, то
TV
диапазон будет подразумеваться для видео на входе. Если
--range
отсутствует, то
TV
диапазон будет подразумеваться для видео на выходе. Если
--input-range
и
--range
(или подразумеваемые их значения) различаются, то будет произведено преобразование. Значения, указанные для
--colormatrix
или
--colorprim
используется для определения требуемых параметров преобразования цветового пространства. Следующие аргументы автоматически добавляются при необходимости и ДОЛЖНЫ НЕ присутствовать здесь:
--pass, --fps, --input-res, --input-depth, --input-csp, --stats, -o, -

Заметьте, что x264 and x265, используемые в Baka Encoder не содержат никаких дополнений, таких как swscale.
<muxing>
количествоодин
описаниеПараметры муксинга.
"format"
типstring
значенияnone, mp4
описаниеЗадает формат контейнера для муксинга. Установите "none" чтобы отключить муксинг, в этом случае остальные аттрибуты ноды "muxing" будут проигнорированы, и Baka Encoder создаст отдельные файлы для каждого закодированного потока.
"cmd"
типстрока
значениялюбые
описаниеТут указываются аргументы командной строки для l-smash.