Previous

Up

Next

Creation of a H3d object from a sound source AsSnd in order to control the spatial positioning of the sound in a 3D scene.

H3d as3dSndCreate ( S3d _session_ AsSnd _sound_ I _flag_ )

_session_
	3D Session.
_sound_
	Sound object to be played with a 3D effect.
_flag_
	Creation flag. Value Meaning AS_SND_LINKED_TO_H3D The destruction of the H3d results in the destruction of the AsSnd

The AsSnd must have been created with the AS_SND_CTRL3D flag.

By default, the 3D sound calculation is active upon the creation of the H3d ( as3dSndEnable, as3dSndDisable)

Upon reading the AsSnd, the sound will be played in 3D, the position calculations being directly managed by the 3D engine.

The calculation of sound in 3D also requires the position of a listener in the scene which will act as the receiver, the H3d being the emitter.

From a AsSnd only a single H3d can be created. A second attempt returns the previously created H3d or rebuilds a new one if the first has been destroyed. To obtain several H3ds from the same sound data, begin by copying the AsSnd using the asSndCopy method and then create the H3d from the new AsSnd created.

Listener creation: as3dListenerCreate