xch_device

Since there are potentially multiple sound devices on client machines, the XCH_DEVICE attribute may be used to specify the behavior of individual devices. The following values may be used with this attribute:

midi This specifies the MIDI (synthesizer) device.

wave This specifies the WAVE (waveform audio) device.

voice This specifies the voice output device. Note that this is normally the same device as the ‘wave’ device. Also note that the voice device is only supported on specially-enabled versions of Pueblo.

Normally you would not specify the XCH_DEVICE attribute for an XCH_SOUND=play or XCH_SOUND=loop command. The file will be played on the appropriate device. For XCH_SOUND=stop, this attribute tells which device should be stopped.

If the XCH_DEVICE attribute is not specified, it is taken to mean either 'all devices' or ‘the appropriate device’ depending on context.

Examples

The following statement will set the volume for the wave device to 30:

<img xch_volume=30 xch_device=wave>

The following statement will stop any playing music on the midi device:

<img xch_sound=stop xch_device=midi>

Also see

xch_sound

xch_volume