---
layout: default
title: Stereo Panner
---                        

<h2>Stereo Panner</h2>

<p>
The stereo panner distributes 2 inputs to 2 outputs. Its behaviour is
controlled by two parameters, <code>width</code>
and <code>position</code> (the latter could also be referred to as
"direction", or "azimuth" without loss of accuracy).
</p>

<p>
The default settings for the stereo panner
are <code>width=100%</code>, <code>position=center</code>. With these
values it is not possible to alter the position, since the width is
already spread entirely across both outputs. To alter the position,
you must first reduce the width.
</p>

<h4>Using the mouse</h4>

<p>Mouse operations in the upper half of the panner adjust the position
  parameter, constrained by the current width setting. 
</p>

<p>Mouse operations in the lower half of the panner adjust the width
  parameter, constrained by the current position setting. 
</p>


<p>To change the position smoothly, press the right button and drag
  within the top half of the panner, then release. The position will
  be limited by the current width setting.
</p>

<p>To change the width smoothly, press the right button and drag
  within the lower half of the panner, then release. The width will be
  limited by the current position setting.
</p>

<dl class="faq">

<dt>Reset to defaults</dt>
<dd>Click <key class="mod3">button 1</key></dd>

<dt>Change to a "hard left"</dt>
<dd>Double click <key class="mod1">button 1</key> in the upper left half
  of the panner</dd>

<dt>Change to a "hard right"</dt>
<dd>Double click <key class="mod1">button 1</key> in the upper right half
  of the panner</dd>

<dt>Move position as far left as possible, given width</dt>
<dd>Double click <key>button 1</key> in the upper left half of the
  panner</dd>

<dt>Move position as far right as possible, given width</dt>
<dd>Double click <key>button 1</key> in the upper right half of the
  panner</dd>

<dt>Set the position to center</dt>
<dd>Click <key>button 1</key> in the upper middle of the panner</dd>

<dt>Reset width to 180&deg; (100%)</dt>
<dd>Double click <key>button 1</key> on the lower left side</dd>

<dt>Reset width to -180&deg; (inverted 100%)</dt>
<dd>Double click <key>button 1</key> on the lower right side</dd>

<dt>Set width to 0&deg;</dt>
<dd>Double click <key>button 1</key> in the lower middle</dd>
</dl>

<h4>Keyboard bindings</h4>

When the pointer is within a stereo panner user interface, the following
keybindings are available to operate on that panner:

<dl>
<dt><key>&uarr;</key></dt>
<dd>increase width by 1&deg;</dd>
<dt><key class="mod1">&uarr;</key></dt>
<dd>increase width by 5&deg</dd>
<dt><key>&darr;</key></dt>
<dd>decrease width by 1&deg;</dd>
<dt><key class="mod1">&darr;</key></dt>
<dd>decrease width by 5&deg;</dd>
<dt><key class="mod2">&uarr;</key></dt>
<dd>reset width to 180&deg; (100%)</dd>
<dt><key>&larr;</key></dt>
<dd>move position 1&deg; to the left</dd>
<dt><key>&rarr;</key></dt>
<dd>move position 1&deg to the right</dd>
<dt><key>0</key></dt>
<dd>reset position to center</dd>
</dl>

<h4>Using the scroll wheel</h4>

When the pointer is within a stereo panner user interface, the scroll
wheel may be used as follows:

<dl>
<dt>scroll left</dt>
<dd>increase width by 1&deg;</dd>

<dt><key class="mod1">scroll left</key></dt>
<dd>increase width by 5&deg;</dd>

<dt>scroll left</dt>
<dd>decrease width by 1&deg;</dd>

<dt><key class="mod1">scroll left<key></dt>
<dd>decrease width by 5&deg;</dd>

<dt>scroll up</dt>
<dd>move position 1&deg; to the right</dd>

<dt>scroll down</dt>
<dd>move position 1&deg; to the right</dd>
</dl>