pan attribute

The pan attribute determines the relative volume between the left and right output channels.

Member of

<sound>

Syntax

/ pan = integer

Parameters

integer

A positive integer specifying the number of lines.

Remarks

The pan value must fall with the range of -10,000 to 10,000 and is measured in hundredths of a decibel (dB). The neutral value is 0; it indicates that both channels are at full volume (attenuated by 0 decibels). At any other setting, one of the channels is at full volume and the other is attenuated. For example, a pan of -2173 means that the left channel is at full volume and the right channel is attenuated by 21.73 dB. Similarly, a pan of 870 means that the left channel is attenuated by 8.7 dB and the right channel is at full volume. A pan of -10,000 means that the right channel is silent and the sound is "all the way to the left," while a pan of 10,000 means that the left channel is silent and the sound is "all the way to the right." The pan control is cumulative with the volume control.

Examples

The following defines a set of sounds to be presented to the left speaker:

<sound rock>
/ items = ("beatles.wav", "stones.wav", "thewho.wav")
/ pan = -10,000
</sound>