3D SOUND 2.2

Category / Domain :
C3D3 Plugin
SCOL Voy@ger Compatibility : V 3.5 or above
Update : 2000/06

Function

This plugin allows to use 2D and 3D sounds buffers.
It is possible to adapt sounds to objects or to positions.
Objects or positions for which sounds may be attributed are defined in the anchor.

In practice, this plugin allows sound to follow the avatar : left or right side according to the avatar position, fade in or out following the distance...

Configuration


Figure 1 : 3DSound plugin interface

(1) wavFileName Name of the .wav file to play. The .wav file has to be saved in a sub-directory of the Scol partition.
(2) volume Volume of the buffer : the entered value must be included between 0 and -10000. 0 = maximum volume, -10000 = minimum volume
(3) pan Sound panning : value must be included between -10000 and 10000.
(4) frequency Allows to change the sound's frequency : value must be included beetween among 5000Hz and 100,000Hz
(5) minDistance Minimum distance after which sound is played at its maximum volume (1 unity = 1 cm)
(6) maxDistance Maximum distance after which sound is not longer played (1 unity = 1 cm)
(7) velocity Change of velocity (movment speed). A vector can be specified, 1 1 1 for example
(8) loop Tick if sound must be diffused in a loop
(9) autoStart Tick if sound has to start as soon as the plugin is initialized, otherwise it is necessary to use actions to start sound (cf below)
(10) streaming Tick if sound is to be directly streamed from the disk, don't tick if it is to be loaded in advance in memory before reading
(11) bufferType 2D or 3D

If no value is keyboarded, the plugin will work with the following default values :
MinDistance 1000
MaxDistance 10000
Loop 1 (marked)
AutoStart 1 (marked)
Streaming 0 (not marked)
BufferType 3D

Note :
If the sound file is too small, streaming will be automatically cancelled.
If sound file size is larger than 204,800 Kb, sound will not be downloaded to the client.

Implementation

If you use this plugin with a 3D object, attribute it a link.
Create an anchor containing one or several links of 3D objects and\or the positions which you have already defined.
Create the "3DSound (2.2)" instance by associating the anchor above with it.
Click the "Appliquer" button of the C3D3 and establish the SCS links which are necessary for you :

Action Function
module.event => C3D3.instance.start Begins to play sound
module.event => C3D3.instance.stop Stops playing sound
module.event => Enable3DSound Activates sound
module.event => Disable3DSound Deactivates sound
module.event => Pause3DSound Pauses the sound (use Enable3DSound action to start sound again)

Event Function

Zone Function Interface Assignment
None