.TH GAVF-ENCODE 1 "2024-02-09" Gmerlin "User Manuals"
.SH NAME
gavf-encode \- Gavf stream encoder
.SH SYNOPSIS
.B gavf-encode 
.I [options]
.SH DESCRIPTION
gavf encoder

.SH OPTIONS

.B \-i
.I <input_file>

.RS 2
Input file or location
.RE

.B \-iopt
.I param1=val1[&param2=val2...]

.RS 2

.RE
.RS 2
.BR dh "=[1|0] (default: 0)"
.P
Dump gavf headers
.P
Use this for debugging

.P
.BR dp "=[1|0] (default: 0)"
.P
Dump gavf packets
.P
Use this for debugging

.P
.BR dm "=[1|0] (default: 0)"
.P
Dump inline metadata
.P
Use this for debugging

.P
.BR to "=<number> (500..100000, default: 5000)"
.P
Timeout (milliseconds)
.P
.BR nomsg "=[1|0] (default: 0)"
.P
No messages
.P
Don't attempt to make a back-channel for messages. Forward messages might
still be sent.

.P
.RE

.B \-as
.I <stream_selector>

.RS 2
Comma separated list of characters 'd' (decode), 'm' (mute) or 'c' (read
compressed)
.RE

.B \-vs
.I <stream_selector>

.RS 2
Comma separated list of characters 'd' (decode), 'm' (mute) or 'c' (read
compressed)
.RE

.B \-ts
.I <stream_selector>

.RS 2
Comma separated list of characters 'm' (mute) or 'c' (read)
.RE

.B \-os
.I <stream_selector>

.RS 2
Comma separated list of characters 'd' (decode), 'm' (mute) or 'c' (read
compressed)
.RE

.B \-enc
.I param1=val1[&param2=val2...]

.RS 2
Encoding options
.RE
.RS 2
.BR ae "=option[{suboptions}]"
.P
Supported options: $to_video
.P
Default: (null)
.P
Audio
.P
.BR te "=option[{suboptions}]"
.P
Supported options: $to_video
.P
Default: (null)
.P
Text subtitles
.P
.BR oe "=option[{suboptions}]"
.P
Supported options: $to_video e_ovl2text
.P
Default: e_ovl2text
.P
Overlay subtitles
.P
.B Suboptions for oe=e_ovl2text

.P
.RS 2
.BR background_color "=<r>,<g>,<b> (default: 0.000,0.000,0.000)"
.P
<r>, <g> and <b> are in the range 0.0..1.0
.P
Background color
.P
Background color to use, when converting formats with transparency to
grayscale

.P
.BR tmpdir "=<string> (Default: /tmp)"
.P
Temporary directory
.P
Temporary directory for image files

.P
.BR plugin "=option[{suboptions}]"
.P
Supported options: 
.P
Default: (null)
.P
Plugin
.P
Plugin for writing the text subtitles

.P
.RE
.BR ve "=option[{suboptions}]"
.P
Supported options: 
.P
Default: (null)
.P
Video
.P
.RE

.B \-ac
.I <options>

.RS 2
Audio compression options
.RE

.B \-vc
.I <options>

.RS 2
Video compression options
.RE

.B \-tc
.I <options>

.RS 2
Text  compression options
.RE

.B \-oc
.I <options>

.RS 2
Overlay compression options
.RE

.B \-o
.I <output>

.RS 2
Output file (without extension) or location 
.RE

.SH GENERIC OPTIONS
The following generic options are available for all gmerlin applications

.B \-help

.RS 2
Print this help message and exit
.RE

.B \-help\-man

.RS 2
Print this help message as a manual page and exit
.RE

.B \-help\-texi

.RS 2
Print this help message in texinfo format and exit
.RE

.B \-version

.RS 2
Print version info and exit
.RE

.B \-v
.I level

.RS 2
Set verbosity level (0..4)
.RE

.B \-syslog
.I name

.RS 2
Log to syslog the specified name
.RE

.B \-stderr

.RS 2
Always log to stderr
.RE

.SH FILES
.B ~/.gmerlin/plugins.xml

.RS 2
Cache of the plugin registry (shared by all applications)
.RE

.P
.B ~/.gmerlin/generic/cfg.xml

.RS 2
Default plugin parameters are read from there. Use gmerlin_plugincfg to change
them.
.RE

.P