Category / Domain : |
C3D3 Plugin |
SCOL Voy@ger Compatibility : | V 3.5 or above |
Update : | 2000/06 |
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...
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.
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 |