Sound functions

From HEWIKI
Jump to: navigation, search

Contents

These are External functions which control the playing of sounds.

Note: HeroEngine comes with some Class methods which already make use of the below functions. For information on these, see HeroEngine Audio System.

Sound functions

Play a sound

PlaySound(fileName as String, volume as Float, fadeInLength as Float) as NodeRef

Plays the specified sound at the specified volume. The filename must be a valid FQN (full path and filename). Volume is a float from 1.0 (full volume) to 0.0 (inaudible). FadeInLength is the time in seconds that the sound should fade in from inaudible to the specified volume.

Sounds played with PlaySound are played on a stereo channel. Thus stereo wavs will be properly channeled to left and right speakers. Mono wavs are played equally on both left and right channels.

Example

var mySound = PlaySound("world/livecontent/audio/boom.wav", 1.0, 0.0)

Play a 3D sound space

Play3DSound(fileName as String, volume as Float, fadeInLength as Float, whereAt as Vector3) as NodeRef

Plays the specified sound at the specified volume and positioned at the specified vector in 3d space. A fadeInLength (in seconds) may be specified to have the sound fade in from inaudible to the specified volume.

Example

var location = "(1.5, 0.0, 0.5)"
var my3DSound = Play3DSound("world/livecontent/audio/boom.wav", 1.0, 0.0, location)


Looping Sounds

Stopping a looping sound

StopSound(handle as NodeRef)

The StopSound command can be used to stop any sound that is playing. You must pass in the noderef of the playing sound, which is given to you by the PlaySound or Play3DSound function.

Example

function PlayRainSound() as noderef
  // play the sound
  var myRainSound = PlaySound("world/livecontent/audio/rain.sgt", 1.0, 0,0)
  // return the sound noderef so we know what sound to stop later
  return myRainSound
.
function StopRainSound(myRainSound as noderef)
  // stop the sound
  StopSound(myRainSound)
.

Manipulating Sound Volumes

Occasionally, you may need to change the volume of a sound. The following functions support this.

GetSoundVolume(sound as NodeRef) as Float

GetSoundVolume returns the current volume of the specified sound node.

SetSoundVolume(sound as NodeRef, volume as Float, fadeLength as Float) as Boolean

SetSoundVolume changes the volume of the current sound. With this, you can have existing sounds fade out smoothly.

Example

function FadeOutSound(theSound as noderef)
  // fade sound to inaudible over 3 seconds
  SetSoundVolume(theSound, 0.0, 3.0)
.

See also

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox