about summary refs log tree commit homepage
path: root/Documentation/dtas-player_effects.pod
blob: c0861f53803efc274cae4385327a3cbdbe54d51f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
% dtas-player_effects(7) dtas user manual

=head1 NAME

L<dtas-player(1)> effects overview

=head1 DESCRIPTION

Effects in dtas-player may be applied either at the source or the sink.
They are applied in the order described.

=over

=item 1. source effects

Source effects are effects which should be applied per-source and do not
rely on inter-track information.

Examples include:

=over

=item ReplayGain (simple gain changes)

=item anything which does not change the length of the audio:

gain, stereo, highpass, lowpass, loudness, bass, treble, equalizer, ...

=back

Modifying source effects should introduce no extra gaps in playback.
Effects which modify the length of the audio is not recommended here,
as seek functionality will be impaired.

=item 2. sink effects

Sink effects are any effects which:

=over

=item 1) should only be applied to a specific sink

=item 2) effects which require inter-track information

(multiband delays/compressors/expanders)

=item 3) alter the length of the audio

=back

In a multi-zone audio system (where each zone has its own sink), sink
effects may also customize the sound of a certain zone while not
affecting others.

Examples include:

=over

=item equalizer effects (highpass/bass/treble/equalizer)

=item loudness

=item delaying a certain channel or frequency range for time-alignment

=item compressors/limiters

=item reverb

=item gain

=item remix (for stereo image adjustments)

=back

Additionally, effects which are necessary due to the limitation of the
playback hardware are applied at the sink:

=over

=item rate

=item dither

=item remix (static channel mappings)

=back

=back

=head1 CONTACT

All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>

Mailing list archives available at L<https://80x24.org/dtas-all/>
and L<ftp://lists.gnu.org/dtas-all/>

No subscription is necessary to post to the mailing list.

=head1 COPYRIGHT

Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>

License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>