The pan attribute determines the relative volume between the left and right output channels.
<sound>
Name | Type | Description |
---|---|---|
integer | value | An expression resolving to an integer ranging from -10000 to 10000. |
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.
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>