Unigine::Plugins::FMOD::FMODCore Class

Header:

#include <plugins/UnigineFMOD.h>

Notice

This set of functions is available when the FMOD plugin is loaded.

This class is intended to cover the basics / primitives of sound.

Methods:

Name	Description View: Sort by:
close	Closes the connection to the output and returns to an uninitialized state without releasing the object.
release	Closes and frees this object and its resources.
update	Updates the FMOD system.
initCore	Initializes the system object and prepares FMOD for playback.
createSound	Loads a sound into memory, opens it for streaming or sets it up for callback based sounds.
createStream	Creates a stream, for example, an internet stream to be used as a radio.
playSound	Plays a sound on a channel.
setListener3DAttributes	Sets the 3D attributes of the listener.
getListener3DAttributes	Returns the 3D attributes of the listener.
getChannel	Returns the channel object at the specified index.

FMODCore Class

Members

void close ( ) #

Closes the connection to the output and returns to an uninitialized state without releasing the object.

void release ( ) #

Closes and frees this object and its resources.

void update ( ) #

Updates the FMOD system.

void initCore ( int max_channels, FMODEnums::INIT_FLAGS flags ) #

Initializes the system object and prepares FMOD for playback.

Arguments

int max_channels - Maximum number of Channel objects available for playback, also known as virtual channels. Virtual channels will play with minimal overhead, with a subset of 'real' voices that are mixed, and selected based on priority and audibility. Range: [0; 4095]
FMODEnums::INIT_FLAGS flags - Initialization flags. More than one mode can be set at once by combining them with the OR operator.

Sound * createSound ( const char * name_of_data, FMODEnums::FMOD_MODE mode ) #

Loads a sound into memory, opens it for streaming or sets it up for callback based sounds.

Arguments

const char * name_of_data - Name of the file or URL to open (UTF-8 string) or a pointer to a preloaded sound memory block.
FMODEnums::FMOD_MODE mode - Behavior modifier for opening the sound.

Return value

Newly created Sound object.

Sound * createStream ( const char * url ) #

Creates a stream, for example, an internet stream to be used as a radio.

Arguments

const char * url - URL of the resource.

Return value

Newly created Sound object.

Channel * playSound ( Sound * sound, ChannelGroup * channel_group, bool paused ) #

Plays a sound on a channel.

Arguments

Sound * sound - Sound to play.
ChannelGroup * channel_group - Group to output to instead of the master.
bool paused - Determines whether to start in the paused state. Start a Channel paused to allow altering attributes without it being audible, then follow it up with a call to ChannelControl::setPaused with paused = False.

Return value

Newly playing channel.

void setListener3DAttributes ( int listener, const Math::Vec3 & position, const Math::Vec3 & up, const Math::Vec3 & forward, const Math::Vec3 & velocity ) #

Sets the 3D attributes of the listener. Vectors must be provided in the correct handedness.

Arguments

int listener - Listener index.
const Math::Vec3 & position - Position in world space used for panning and attenuation.
const Math::Vec3 & up - Upwards orientation, must be of unit length (1.0) and perpendicular to forward.
const Math::Vec3 & forward - Forwards orientation, must be of unit length (1.0) and perpendicular to up.
const Math::Vec3 & velocity - Velocity in world space used for doppler.

void getListener3DAttributes ( int listener, Math::Vec3 & position, Math::Vec3 & up, Math::Vec3 & forward, Math::Vec3 & velocity ) #

Returns the 3D attributes of the listener.

Arguments

int listener - Listener index.
Math::Vec3 & position - Position in world space.
Math::Vec3 & up - Upwards orientation.
Math::Vec3 & forward - Forwards orientation.
Math::Vec3 & velocity - Velocity in world space.

Channel * getChannel ( int index ) #

Returns the channel object at the specified index.

Arguments

int index - Channel index.

Return value

Channel object.

Last update: 2022-10-10

Help improve this article

Was this article helpful?

Report a problem related to this article

(or select a word/phrase and press Ctrl+Enter)