9 The stereo panner distributes 2 inputs to 2 outputs. Its behaviour is
10 controlled by two parameters, <code>width</code>
11 and <code>position</code> (the latter could also be referred to as
12 "direction", or "azimuth" without loss of accuracy).
16 The default settings for the stereo panner
17 are <code>width=100%</code>, <code>position=center</code>. With these
18 values it is not possible to alter the position, since the width is
19 already spread entirely across both outputs. To alter the position,
20 you must first reduce the width.
23 <h4>Using the mouse</h4>
25 <p>Mouse operations in the upper half of the panner adjust the position
26 parameter, constrained by the current width setting.
29 <p>Mouse operations in the lower half of the panner adjust the width
30 parameter, constrained by the current position setting.
34 <p>To change the position smoothly, press the right button and drag
35 within the top half of the panner, then release. The position will
36 be limited by the current width setting.
39 <p>To change the width smoothly, press the right button and drag
40 within the lower half of the panner, then release. The width will be
41 limited by the current position setting.
46 <dt>Reset to defaults</dt>
47 <dd>Click <key class="mod3">button 1</key></dd>
49 <dt>Change to a "hard left"</dt>
50 <dd>Double click <key class="mod1">button 1</key> in the upper left half
53 <dt>Change to a "hard right"</dt>
54 <dd>Double click <key class="mod1">button 1</key> in the upper right half
57 <dt>Move position as far left as possible, given width</dt>
58 <dd>Double click <key>button 1</key> in the upper left half of the
61 <dt>Move position as far right as possible, given width</dt>
62 <dd>Double click <key>button 1</key> in the upper right half of the
65 <dt>Set the position to center</dt>
66 <dd>Click <key>button 1</key> in the upper middle of the panner</dd>
68 <dt>Reset width to 180° (100%)</dt>
69 <dd>Double click <key>button 1</key> on the lower left side</dd>
71 <dt>Reset width to -180° (inverted 100%)</dt>
72 <dd>Double click <key>button 1</key> on the lower right side</dd>
74 <dt>Set width to 0°</dt>
75 <dd>Double click <key>button 1</key> in the lower middle</dd>
78 <h4>Keyboard bindings</h4>
80 When the pointer is within a stereo panner user interface, the following
81 keybindings are available to operate on that panner:
84 <dt><key>↑</key></dt>
85 <dd>increase width by 1°</dd>
86 <dt><key class="mod1">↑</key></dt>
87 <dd>increase width by 5°</dd>
88 <dt><key>↓</key></dt>
89 <dd>decrease width by 1°</dd>
90 <dt><key class="mod1">↓</key></dt>
91 <dd>decrease width by 5°</dd>
92 <dt><key class="mod2">↑</key></dt>
93 <dd>reset width to 180° (100%)</dd>
94 <dt><key>←</key></dt>
95 <dd>move position 1° to the left</dd>
96 <dt><key>→</key></dt>
97 <dd>move position 1° to the right</dd>
99 <dd>reset position to center</dd>
102 <h4>Using the scroll wheel</h4>
104 When the pointer is within a stereo panner user interface, the scroll
105 wheel may be used as follows:
109 <dd>increase width by 1°</dd>
111 <dt><key class="mod1">scroll left</key></dt>
112 <dd>increase width by 5°</dd>
115 <dd>decrease width by 1°</dd>
117 <dt><key class="mod1">scroll left<key></dt>
118 <dd>decrease width by 5°</dd>
121 <dd>move position 1° to the right</dd>
124 <dd>move position 1° to the right</dd>