Scaleform Studio Lua API Reference: scaleform.Sound object reference

scaleform.Sound object reference

Description

A Sound object for playing audio through Wwise Wwise is only available if Scaleform Studio is compiled with it enabled (by default it is enabled).

Functions

Parameters

target :

scaleform.Actor

The actor to link the sound.

Returns

scaleform.Sound

The newly created Sound object.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

bank_name :

string

The sound bank name.

Returns

boolean

Returns true if the sound bank is loaded and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

play_id :

integer

The event playing ID.

Returns

boolean

Returns true if success and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

play_id :

integer

The event playing ID.

Returns

boolean

Returns true if success and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

lang :

string

The language.

Returns

boolean

Returns true if the language set successfully and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

param_name :

string

Parameter name.

param_value :

number

Parameter value.

global :

boolean?

Specifies if parameter is global.

The ? notation indicates that this type is optional: there may be zero or one instances of it.
Returns

boolean

Returns true if success and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

play_id :

integer

The event playing ID.

Returns

boolean

Returns true if success and false otherwise.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object currently considered.

Returns

scaleform.Actor

The actor linked with this Sound object.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

event_name :

string

The event name.

Returns

integer

Returns playing event ID.

Used with Wwise implementation.

Parameters

self :

scaleform.Sound

The sound object.

bank_name :

string

The sound bank name.

Returns

boolean

Returns true if the sound bank is unloaded successfully and false otherwise.

Used with Wwise implementation.

 scaleform.EventDispatcher
The base object for managing event listeners and dispatching events to the listeners.
 scaleform.Sound.create (target) : scaleform.Sound
Creates a Sound object.
 scaleform.FMODSound.load (self, file_name) : boolean
Pre-loads sound file.
 scaleform.FMODSound.play (self, file_name, start_time, loops)
Plays the specified sound file.
 scaleform.FMODSound.stop (self) : boolean
Stops playback of all sound channels of this object.
 scaleform.FMODSound.target (self) : scaleform.Actor
Returns the actor this sound object is linked to.
 target : scaleform.Actor
The actor to link the sound.
 scaleform.Sound
The newly created Sound object.
 scaleform.Actor
Generic objects located in a scene.
 scaleform.Sound
A Sound object for playing audio through Wwise Wwise is only available if Scaleform Studio is compiled with it enabled (by default it is enabled).
 scaleform.Sound.load_bank (self, bank_name) : boolean
Loads the sound bank.
 self : scaleform.Sound
The sound object.
 bank_name : string
The sound bank name.
 booleanA string of characters.true or false.  scaleform.Sound.pause_event (self, play_id) : boolean
Pauses playback of an active event.
 self : scaleform.Sound
The sound object.
 play_id : integer
The event playing ID.
 booleanA strictly integral numeric value, with no decimal component.  scaleform.Sound.resume_event (self, play_id) : boolean
Resumes playback of an active event.
 self : scaleform.Sound
The sound object.
 play_id : integer
The event playing ID.
 boolean  scaleform.Sound.set_language (self, lang) : boolean
Sets the current language.
 self : scaleform.Sound
The sound object.
 lang : string
The language.
 boolean  scaleform.Sound.set_parameter (self, param_name, param_value, global) : boolean
Sets the value of a real-time parameter control.
 self : scaleform.Sound
The sound object.
 param_name : string
Parameter name.
 param_value : number
Parameter value.
 global : boolean?
Specifies if parameter is global.
The ? notation indicates that this type is optional: there may be zero or one instances of it.
 booleanA numeric value.  scaleform.Sound.stop_event (self, play_id) : boolean
Stops playback of an active event.
 self : scaleform.Sound
The sound object.
 play_id : integer
The event playing ID.
 boolean  scaleform.Sound.target (self) : scaleform.Actor
Returns the actor this sound object is linked to.
 self : scaleform.Sound
The sound object currently considered.
 scaleform.Actor
The actor linked with this Sound object.
 scaleform.Sound.trigger_event (self, event_name) : integer
Asynchronously trigger an event in the sound engine.
 self : scaleform.Sound
The sound object.
 event_name : string
The event name.
 integer  scaleform.Sound.unload_bank (self, bank_name) : boolean
Unloads the sound bank.
 self : scaleform.Sound
The sound object.
 bank_name : string
The sound bank name.
 boolean  self : scaleform.Sound
The sound object.
 file_name : string
The sound file to play.
 boolean  self : scaleform.Sound
The sound object.
 file_name : string
The sound file to play.
 start_time : integer
The start time of the file.
 loops : integer
The number of loops.
 self : scaleform.Sound
The sound object.
 boolean  self : scaleform.Sound
The sound object currently considered.
 scaleform.Actor
The actor linked with this Sound object.
Indicates a table.
This documentation uses the term table to mean an anonymous, temporary Lua table that contains named data values. You typically use these tables to pass data or settings to a function, or to hold data returned by a function.
Indicates an object.
This documentation uses the term object to mean a named Lua table or userdata value that maintains a state. Some object types may have multiple instances existing at the same time, each with its own state; these objects typically have creation functions or accessors that you must call in order to get an instance. Some object types have only one instance, which you always access through the object's name.
Indicates a named variable within a namespace, object or table; or an element within an enumeration.Indicates a code sample.Indicates an enumeration.
This documentation uses the term enumeration to mean a named Lua table that contains only a set of constant values. These values typically identify a predefined set of options for some setting or behavior. You might pass an enumeration value to a function, or test the value returned by a function against the items in the enumeration to see which option is currently set.
Indicates a named variable within a namespace or object that has a pre-set constant value.Indicates a category: a semantic grouping of related API elements.Indicates a namespace.
This documentation uses the term namespace to mean a named Lua table that exists in only one single instance, intended as a container for an interface of related objects, functions and data variables.
Indicates an output value returned by a function.Indicates a named function within a namespace or object.Indicates an input parameter for a function.