The Alternative Csound Reference Manual
Previous |  | Next

# vbap8

vbap8 -- Distributes an audio signal among 8 channels.

## Description

Distributes an audio signal among 8 channels.

## Syntax

ar1, ..., ar8 vbap8 asig, iazim [, ielev] [, ispread]

## Initialization

iazim -- azimuth angle of the virtual source

ielev (optional) -- elevation angle of the virtual source

ispread (optional) -- spreading of the virtual source (range 0 - 100). If value is zero, conventional amplitude panning is used. When ispread is increased, the number of loudspeakers used in panning increases. If value is 100, the sound is applied to all loudspeakers.

## Performance

asig -- audio signal to be panned

vbap8 takes an input signal, asig, and distributes it among 8 outputs, according to the controls iazim and ielev, and the configured loudspeaker placement. If idim = 2, ielev is set to zero. The distribution is performed using Vector Base Amplitude Panning (VBAP - See reference). VBAP distributes the signal using loudspeaker data configured with vbaplsinit. The signal is applied to, at most, two loudspeakers in 2-D loudspeaker configurations, and three loudspeakers in 3-D loudspeaker configurations. If the virtual source is panned outside the region spanned by loudspeakers, the nearest loudspeakers are used in panning.

## Examples

Example 1. 2-D panning example with stationary virtual sources

      sr      =          4100
      kr      =           441
      ksmps   =           100
      nchnls  =             4
      vbaplsinit         2, 6,  0, 45, 90, 135, 200, 245, 290, 315

              instr 1
      asig    oscil      20000, 440, 1
      a1,a2,a3,a4,a5,a6,a7,a8   vbap8  asig, p4, 0, 20 ;p4 = azimuth

      ;render twice with alternate outq statements
      ;  to obtain two 4 channel .wav files:

              outq       a1,a2,a3,a4
      ;       outq       a5,a6,a7,a8
              endin

## Reference

Ville Pulkki: "Virtual Sound Source Positioning Using Vector Base Amplitude Panning" Journal of the Audio Engineering Society, 1997 June, Vol. 45/6, p. 456.

## See Also

vbap16, vbap16move, vbap4, vbap4move, vbap8move, vbaplsinit, vbapz, vbapzmove

## Credits

Author: Ville Pulkki
Sibelius Academy Computer Music Studio
Laboratory of Acoustics and Audio Signal Processing
Helsinki University of Technology
Helsinki, Finland
May 2000

New in Csound Version 4.07

Previous | Home | Next
vbap4move | Up | vbap8move