.TH GAVF-FILTER 1 "2024-04-12" Gmerlin "User Manuals"
.SH NAME
gavf-filter \- Gavf A/V filter
.SH SYNOPSIS
.B gavf-filter 
.I [options]
.SH DESCRIPTION
gavf filter

.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 \-aq
.I param1=val1[&param2=val2...]

.RS 2
Audio conversion options
.RE
.RS 2
.BR q "=<number> (1..5, default: 2)"
.P
Conversion Quality
.P
Set the conversion quality for format conversions. Lower quality means more
speed. Values above 3 enable slow high quality calculations.

.P
.BR sm "=<string>"
.P
Supported strings: auto zoh linear sinc_fast sinc_medium sinc_best
.P
Default: auto
.P
Resample mode
.P
Resample mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.P
.BR dm "=<string>"
.P
Supported strings: auto none rect tri shaped
.P
Default: auto
.P
Dither mode
.P
Dither mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.P
.RE

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

.RS 2
Video conversion options
.RE
.RS 2
.BR q "=<number> (1..5, default: 2)"
.P
Conversion Quality
.P
Set the conversion quality for format conversions. Lower quality means more
speed. Values above 3 enable slow high quality calculations.

.P
.BR sm "=<string>"
.P
Supported strings: auto zoh linear sinc_fast sinc_medium sinc_best
.P
Default: auto
.P
Resample mode
.P
Resample mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.P
.BR dm "=<string>"
.P
Supported strings: auto none rect tri shaped
.P
Default: auto
.P
Dither mode
.P
Dither mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.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 \-af
.I param1=val1[&param2=val2...]

.RS 2
Audio compression options
.RE
.RS 2
.BR f "={option[{suboptions}][:option[{suboptions}]...]}"
.P
Supported options: 

Audio Filters
.P
.RE

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

.RS 2
Video compression options
.RE
.RS 2
.BR f "={option[{suboptions}][:option[{suboptions}]...]}"
.P
Supported options: 

Video Filters
.P
.RE

.B \-o
.I <output>

.RS 2
Output file or location
.RE

.B \-m
.I name=value

.RS 2
Set global metadata of the output (can be used multiple times). Use "name=" to
clear a field
.RE

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

.RS 2
options
.RE
.RS 2
.BR shm "=<number> (default: 1024)"
.P
SHM threshold
.P
Select the minimum packet size for using shared memory for a stream.
Non-positive values disable shared memory completely

.P
.BR to "=<number> (500..100000, default: 5000)"
.P
Timeout (milliseconds)
.P
.BR dp "=[1|0] (default: 0)"
.P
Dump gavf packets
.P
Use this for debugging

.P
.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