This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Basics
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Unigine::Plugins::FMOD::EventInstance Class

Header: #include <plugins/Unigine/FMOD/UnigineFMOD.h>
Notice
This set of functions is available when the FMOD plugin is loaded.

An instance of an FMOD Studio Event.

EventInstance Class

Members


void setPaused ( bool paused ) #

Sets the pause state.

Arguments

  • bool paused - true to pause the event instance, false to unpause it.

bool isPaused ( ) const#

Returns the pause state.

Return value

true if the event instance is paused, otherwise, false.

void setPitch ( float pitch ) #

Sets the pitch multiplier.

Arguments

  • float pitch - Pitch multiplier. Range: [0; inf]. Default: 1. The pitch multiplier can be set to any value greater than or equal to zero but the final combined pitch is clamped to the range [0; 100] before being applied.

float getPitch ( ) const#

Returns the current pitch multiplier.

Return value

Pitch multiplier.

void setGain ( float gain ) #

Sets the gain value.

Arguments

  • float gain - Gain value to be set.

float getGain ( ) const#

Returns the current gain value.

Return value

Gain value.

void setMaxDistance ( float distance ) #

Sets the maximum distance for 3D attenuation.

Arguments

  • float distance - Maximum distance, in distance units.

float getMaxDistance ( ) const#

Returns the current maximum distance for 3D attenuation.

Return value

Maximum distance, in distance units.

void setMinDistance ( float distance ) #

Sets the minimum distance for 3D attenuation.

Arguments

  • float distance - Minimum distance, in distance units.

float getMinDistance ( ) const#

Returns the current minimum distance for 3D attenuation.

Return value

Minimum distance, in distance units.

void setTimeLinePosition ( int position ) #

Sets the timeline cursor position.

Arguments

  • int position - Timeline position, in milliseconds. Range: [0; inf].

int getTimeLinePosition ( ) const#

Returns the current timeline cursor position.

Return value

Timeline position, in milliseconds.

void set3DAttributes ( const Math::Vec3 & position, const Math::Vec3 & up, const Math::Vec3 & forward, const Math::Vec3 & velocity ) #

Sets event's position, velocity and orientation used to calculate 3D panning, doppler and the values of automatic distance and angle parameters.

Arguments

  • 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, in distance units per second.

void get3DAttributes ( Math::Vec3 & position, Math::Vec3 & up, Math::Vec3 & forward, Math::Vec3 & velocity ) #

Returns event's position, velocity and orientation.

Arguments

  • Math::Vec3 & position - Position in world space.
  • Math::Vec3 & up - Upwards orientation.
  • Math::Vec3 & forward - Forwards orientation.
  • Math::Vec3 & velocity - Velocity in world space.

void setVelocity ( const Math::Vec3 & velocity ) #

Sets event's velocity.

Arguments

  • const Math::Vec3 & velocity - Velocity in world space, in distance units per second.

bool isVirtual ( ) const#

Returns a value indicating whether an event instance has been virtualized due to the polyphony limit being exceeded.

Return value

true if the event instance has been virtualized, otherwise, false.

bool isStarting ( ) const#

Returns a value indicating whether an event instance is preparing to start.

Return value

true if the event instance is preparing to start, otherwise, false.

bool isStopping ( ) const#

Returns a value indicating whether an event instance is preparing to stop.

Return value

true if the event instance is preparing to stop, otherwise, false.

bool isStopped ( ) const#

Returns a value indicating whether an event instance is stopped.

Return value

true if the event instance is stopped, otherwise, false.

bool isSustaining ( ) const#

Returns a value indicating whether the timeline cursor is paused on a sustain point.

Return value

true if the timeline cursor is paused on a sustain point, otherwise, false.

bool isPlaying ( ) const#

Returns a value indicating whether an event instance is playing.

Return value

true if the event instance is playing, otherwise, false.

void play ( ) #

Starts playback. If the instance was already playing then calling this function will restart the event.

void stop ( ) #

Stops playback.

void stopWithFadeout ( ) #

Stops playback with the fadeout effect.

void release ( ) #

Marks the event instance for release. Event instances marked for release are destroyed by the asynchronous update when they are in the stopped state.

void update ( ) #

Updates the position of the event instance in world space.

void setParameter ( const char * name, float value ) #

Sets a parameter value by name.

Arguments

  • const char * name - Parameter name (case-insensitive) of an FMOD Studio event. (UTF-8 string)
  • float value - Value for a given name.

float getParameter ( const char * name ) #

Returns a parameter value by name.

Arguments

  • const char * name - Parameter name (case-insensitive). (UTF-8 string)

Return value

Value for a given name.

void setTransform ( const Math::Mat4 & transform ) #

Sets the transformation matrix for the node in world coordinates.

Arguments

  • const Math::Mat4 & transform - New transformation matrix to be set for the node (world coordinates).

void setParent ( const Ptr<Node> & parent ) #

Sets a new parent for the node. Transformations of the current node will be done in the coordinates of the parent.

Arguments

  • const Ptr<Node> & parent - New parent node.

void releaseFromDefinition ( ) #

Auxiliary function, not to be used.

void setPriority ( float priority ) #

Sets the priority in range [-1;256] on the Channels created by the current EventInstance.

Arguments

  • float priority - The priority in range [-1;256]: 0 means the most important, 256 means the least important. The default is -1.

float getPriority ( ) const#

Returns the priority of the Channels created by the current EventInstance.

Return value

The priority in range [-1;256]: 0 means the most important, 256 means the least important. The default is -1.

bool isValid ( ) const#

Checks if the EventInstance reference is valid or not.

Return value

true if the reference is valid; otherwise, false.

String getDescriptionPath ( ) const#

Returns the path for the EventDescription of the current EventInstance.

Return value

EventDescription path.
Last update: 2024-04-19
Build: ()