about summary refs log tree commit homepage
path: root/Documentation/dtas-xdelay.txt
blob: 255dcdead1c237a015bd8127088bf0b7734a3255 (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
% dtas-xdelay(1) dtas user manual
%

# NAME

dtas-xdelay - play audio with a crossover delay

# SYNOPSYS

dtas-xdelay [OPTIONS] INPUT1 INPUT2 DELAY

# DESCRIPTION

dtas-xdelay will delay an audio band by a given delay (in seconds or
fractions thereof).  This can be useful for tuning a sub/sat speaker
system.  It is intended for use a dtas-player sink command as displayed
in the synopsis.

The INPUT arguments (/dev/fd/lo and /dev/fd/hi) are automatically
changed by dtas-player to match the given file descriptors of the pipes.

Both descriptors receive the same audio data, but will be split using a
Linkwitz-Riley crossover.  The high-band (second argument) will be
delayed by default.

# EXAMPLE

To set this via dtas-player to delay the high frequencies by 20ms.

	dtas-ctl sink ed SINKNAME \
	   command='dtas-xdelay /dev/fd/lo /dev/fd/hi 0.020'

# OPTIONS

-x, \--crossover-frequency FREQUENCY
:   Frequency at which to set the crossover.  This defaults to 80 (Hz).

-l, \--lowpass-delay
:   Delay the lowpass frequency instead of the highpass one.

# ENVIRONMENT

SOXFMT - this environment is automatically set if used as a dtas-player
sink

DTAS_PLAYER_SOCK - the path to the dtas-player control socket.
This defaults to ~/.dtas/player.sock

# NOTES

The author of this knows little about signal processing and is just
parroting things he's learned on the sox documentation and mailing list.
Corrections greatly appreciated (email Eric Wong e@80x24.org)

# CONTACT

All feedback welcome via plain-text mail to <dtas-all@nongnu.org>\
Mailing list archives available at <ftp://lists.gnu.org/dtas-all/>\
No subscription is necessary to post to the mailing list.

# COPYRIGHT

Copyright 2013, Eric Wong <normalperson@yhbt.net> and all contributors.\
License: GPLv3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>

# SEE ALSO

dtas-player(1), dtas-player_protocol(7), dtas-ctl(1), sox(1)