# 6. Studio API Reference | Studio::EventInstance

An instance of an FMOD Studio Event.

Playback Control:

- Studio::EventInstance::start Starts playback.
- Studio::EventInstance::stop Stops playback.
- Studio::EventInstance::getPlaybackState Retrieves the playback state.
- Studio::EventInstance::setPaused Sets the pause state.
- Studio::EventInstance::getPaused Retrieves the pause state.
- Studio::EventInstance::keyOff Allow an event to continue past a sustain point.

- FMOD_STUDIO_STOP_MODE Stop modes.

Playback Properties:

- Studio::EventInstance::setPitch Sets the pitch multiplier.
- Studio::EventInstance::getPitch Retrieves the pitch multiplier.
- Studio::EventInstance::setProperty Sets the value of a built-in property.
- Studio::EventInstance::getProperty Retrieves the value of a built-in property.
- Studio::EventInstance::setTimelinePosition Sets the timeline cursor position.
- Studio::EventInstance::getTimelinePosition Retrieves the timeline cursor position.
- Studio::EventInstance::setVolume Sets the volume level.
- Studio::EventInstance::getVolume Retrieves the volume level.
- Studio::EventInstance::isVirtual Retrieves the virtualization state.

- FMOD_STUDIO_EVENT_PROPERTY These definitions describe built-in event properties.

3D Attributes:

- Studio::EventInstance::set3DAttributes Sets the 3D attributes.
- Studio::EventInstance::get3DAttributes Retrieves the 3D attributes.
- Studio::EventInstance::setListenerMask Sets the listener mask.
- Studio::EventInstance::getListenerMask Retrieves the listener mask.
- Studio::EventInstance::getMinMaxDistance Retrieves the minimum and maximum distances for 3D attenuation.

Parameters:

- Studio::EventInstance::setParameterByName Sets a parameter value by name.
- Studio::EventInstance::setParameterByNameWithLabel Sets a parameter value by name, looking up the value label.
- Studio::EventInstance::getParameterByName Retrieves a parameter value by name.
- Studio::EventInstance::setParameterByID Sets a parameter value by unique identifier.
- Studio::EventInstance::setParameterByIDWithLabel Sets a parameter value by unique identifier, looking up the value label.
- Studio::EventInstance::getParameterByID Retrieves a parameter value by unique identifier.
- Studio::EventInstance::setParametersByIDs Sets multiple parameter values by unique identifier.

Core:

- Studio::EventInstance::getChannelGroup Retrieves the core channel group.
- Studio::EventInstance::setReverbLevel Sets the core reverb send level.
- Studio::EventInstance::getReverbLevel Retrieves the core reverb send level.

Profiling:

- Studio::EventInstance::getCPUUsage Retrieves the event CPU usage data.
- Studio::EventInstance::getMemoryUsage Retrieves memory usage statistics.

Callbacks:

- Studio::EventInstance::setCallback Sets the user callback.
- Studio::EventInstance::setUserData Sets the event instance user data.
- Studio::EventInstance::getUserData Retrieves the event instance user data.

- FMOD_STUDIO_EVENT_CALLBACK Callback that is fired when a Studio::EventInstance changes state.
- FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES Describes a DSP plugin instance.
- FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES Describes a programmer sound.
- FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES Describes a marker on the timeline.
- FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES Describes a beat on the timeline.
- FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES Describes a beat on the timeline from a nested event.

- FMOD_STUDIO_EVENT_CALLBACK_TYPE Studio event callback types.

General:

- Studio::EventInstance::getDescription Retrieves the event description.
- Studio::EventInstance::release Marks the event instance for release.
- Studio::EventInstance::isValid Checks that the EventInstance reference is valid.

## Studio::EventInstance::get3DAttributes

Retrieves the 3D attributes.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::get3DAttributes(
      FMOD_3D_ATTRIBUTES *attributes
    );

    FMOD_RESULT FMOD_Studio_EventInstance_Get3DAttributes(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_3D_ATTRIBUTES *attributes
    );

    RESULT Studio.EventInstance.get3DAttributes(
      out _3D_ATTRIBUTES attributes
    );

    Studio.EventInstance.get3DAttributes(
      attributes
    );

attributes Out
  3D attributes. (FMOD_3D_ATTRIBUTES)

See Also: Studio::EventInstance::set3DAttributes

## Studio::EventInstance::getChannelGroup

Retrieves the core channel group.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getChannelGroup(
      ChannelGroup **group
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetChannelGroup(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_CHANNELGROUP **group
    );

    RESULT Studio.EventInstance.getChannelGroup(
      out FMOD.ChannelGroup group
    );

    Studio.EventInstance.getChannelGroup(
      group
    );

group Out
  Core channel group corresponding to the master track. (ChannelGroup)

Until the event instance has been fully created this function will return FMOD_ERR_STUDIO_NOT_LOADED.

## Studio::EventInstance::getCPUUsage

Retrieves the event CPU usage data.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getCPUUsage(
      unsigned int *exclusive,
      unsigned int *inclusive
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetCPUUsage(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      unsigned int *exclusive,
      unsigned int *inclusive
    );

    RESULT Studio.EventInstance.getCPUUsage(
      out uint exclusive,
      out uint inclusive
    );

    Studio.EventInstance.getCPUUsage(
      exclusive,
      inclusive
    );

exclusive Out Opt

  CPU time spent processing just this unit during the last update.

  - Units: Microseconds
inclusive Out Opt

  CPU time spent processing this unit and all of its input during the last update.

  - Units: Microseconds

FMOD_INIT_PROFILE_ENABLE with System::init is required to call this function.

## Studio::EventInstance::getDescription

Retrieves the event description.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getDescription(
      Studio::EventDescription **description
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetDescription(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_EVENTDESCRIPTION **description
    );

    RESULT Studio.EventInstance.getDescription(
      out EventDescription description
    );

    Studio.EventInstance.getDescription(
      description
    );

description Out
  Event description. (Studio::EventDescription)

## Studio::EventInstance::getListenerMask

Retrieves the listener mask.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getListenerMask(
      unsigned int *mask
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetListenerMask(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      unsigned int *mask
    );

    RESULT Studio.EventInstance.getListenerMask(
      out uint mask
    );

    Studio.EventInstance.getListenerMask(
      mask
    );

mask Out
  Listener mask.

See Also: Studio::EventInstance::setListenerMask

## Studio::EventInstance::getMemoryUsage

Retrieves memory usage statistics.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getMemoryUsage(
      FMOD_STUDIO_MEMORY_USAGE *memoryusage
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetMemoryUsage(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_MEMORY_USAGE *memoryusage
    );

    RESULT Studio.EventInstance.getMemoryUsage(
      out MEMORY_USAGE memoryusage
    );

Not supported for JavaScript.

memoryusage Out
  Memory usage. (FMOD_STUDIO_MEMORY_USAGE)

Memory usage statistics are only available in logging builds, in release builds `memoryusage` will contain zero for all values this function.

## Studio::EventInstance::getMinMaxDistance

Retrieves the minimum and maximum distances for 3D attenuation.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getMinMaxDistance(
      float *min,
      float *max
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetMinMaxDistance(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      float *min,
      float *max
    );

    RESULT Studio.EventInstance.getMinMaxDistance(
      out float min,
      out float max
    );

    Studio.EventInstance.getMinMaxDistance(
      min,
      max
    );

min Out Opt

  Minimum distance.

  - Units: Distance units
max Out Opt

  Maximum distance.

  - Units: Distance units

See Also: Studio::EventDescription::getMinMaxDistance

## Studio::EventInstance::getParameterByID

Retrieves a parameter value by unique identifier.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getParameterByID(
      FMOD_STUDIO_PARAMETER_ID id,
      float *value,
      float *finalvalue = nullptr
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetParameterByID(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_PARAMETER_ID id,
      float *value,
      float *finalvalue
    );

    RESULT Studio.EventInstance.getParameterByID(
      PARAMETER_ID id,
      out float value
    );
    RESULT Studio.EventInstance.getParameterByID(
      PARAMETER_ID id,
      out float value,
      out float finalvalue
    );

    Studio.EventInstance.getParameterByID(
      id,
      value,
      finalvalue
    );

id
  Parameter identifier. (FMOD_STUDIO_PARAMETER_ID)
value Out Opt
  Parameter value as set from the public API.
finalvalue Out Opt
  Final combined parameter value.

Automatic parameters always return `value` as 0 since they can never have their value set from the public API.

`finalvalue` is the final value of the parameter after applying adjustments due to automation, modulation, seek speed, and parameter velocity to `value`. This is calculated asynchronously when the Studio system updates.

See Also: Studio::EventInstance::setParameterByID

## Studio::EventInstance::getParameterByName

Retrieves a parameter value by name.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getParameterByName(
      const char *name,
      float *value,
      float *finalvalue = nullptr
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetParameterByName(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      const char *name,
      float *value,
      float *finalvalue
    );

    RESULT Studio.EventInstance.getParameterByName(
      string name,
      out float value
    );
    RESULT Studio.EventInstance.getParameterByName(
      string name,
      out float value,
      out float finalvalue
    );

    Studio.EventInstance.getParameterByName(
      name,
      value,
      finalvalue
    );

name
  Parameter name (case-insensitive). (UTF-8 string)
value Out Opt
  Parameter value as set from the public API.
finalvalue Out Opt
  Final combined parameter value.

Automatic parameters always return `value` as 0 since they can never have their value set from the public API.

`finalvalue` is the final value of the parameter after applying adjustments due to automation, modulation, seek speed, and parameter velocity to `value`. This is calculated asynchronously when the Studio system updates.

See Also: Studio::EventInstance::setParameterByName

## Studio::EventInstance::getPaused

Retrieves the pause state.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getPaused(
      bool *paused
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetPaused(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_BOOL *paused
    );

    RESULT Studio.EventInstance.getPaused(
      out bool paused
    );

    Studio.EventInstance.getPaused(
      paused
    );

paused Out

  Pause state. True if the event instance is paused.

  - Units: Boolean

See Also: Studio::EventInstance::setPaused

## Studio::EventInstance::getPitch

Retrieves the pitch multiplier.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getPitch(
      float *pitch,
      float *finalpitch = nullptr
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetPitch(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      float *pitch,
      float *finalpitch
    );

    RESULT Studio.EventInstance.getPitch(
      out float pitch
    );
    RESULT Studio.EventInstance.getPitch(
      out float pitch,
      out float finalpitch
    );

    Studio.EventInstance.getPitch(
      pitch,
      finalpitch
    );

pitch Out Opt
  Pitch multiplier as set from the public API.
finalpitch Out Opt
  Final combined pitch.

The final combined value returned in `finalpitch` combines the pitch set using Studio::EventInstance::setPitch with the result of any automation or modulation. The final combined pitch is calculated asynchronously when the Studio system updates.

## Studio::EventInstance::getPlaybackState

Retrieves the playback state.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getPlaybackState(
      FMOD_STUDIO_PLAYBACK_STATE *state
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetPlaybackState(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_PLAYBACK_STATE *state
    );

    RESULT Studio.EventInstance.getPlaybackState(
      out PLAYBACK_STATE state
    );

    Studio.EventInstance.getPlaybackState(
      state
    );

state Out
  Playback state. (FMOD_STUDIO_PLAYBACK_STATE)

You can poll this function to track the playback state of an event instance.

If the instance is invalid, then the state will be set to FMOD_STUDIO_PLAYBACK_STOPPED.

See Also: Studio::EventInstance::start, Studio::EventInstance::stop, FMOD_STUDIO_EVENT_CALLBACK_TYPE

## Studio::EventInstance::getProperty

Retrieves the value of a built-in property.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getProperty(
      FMOD_STUDIO_EVENT_PROPERTY index,
      float *value
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetProperty(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_EVENT_PROPERTY index,
      float *value
    );

    RESULT Studio.EventInstance.getProperty(
      EVENT_PROPERTY index,
      out float value
    );

    Studio.EventInstance.getProperty(
      index,
      value
    );

index
  Property index. (FMOD_STUDIO_EVENT_PROPERTY)
value Out
  Property value set via Studio::EventInstance::setProperty.

A default FMOD_STUDIO_EVENT_PROPERTY value means that the Instance is using the value set in Studio and it has not been overridden using Studio::EventInstance::setProperty. Access the default property values through the Studio::EventDescription.

## Studio::EventInstance::getReverbLevel

Retrieves the core reverb send level.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getReverbLevel(
      int index,
      float *level
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetReverbLevel(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      int index,
      float *level
    );

    RESULT Studio.EventInstance.getReverbLevel(
      int index,
      out float level
    );

    Studio.EventInstance.getReverbLevel(
      index,
      level
    );

index

  Core reverb instance index.

  - Range: [0, 3]
level Out
  Reverb send level.

See Also: Studio::EventInstance::setReverbLevel

## Studio::EventInstance::getTimelinePosition

Retrieves the timeline cursor position.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getTimelinePosition(
      int *position
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetTimelinePosition(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      int *position
    );

    RESULT Studio.EventInstance.getTimelinePosition(
      out int position
    );

    Studio.EventInstance.getTimelinePosition(
      position
    );

position Out
  Timeline position.

See Also: Studio::EventInstance::setTimelinePosition

## Studio::EventInstance::getUserData

Retrieves the event instance user data.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getUserData(
      void **userdata
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetUserData(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      void **userdata
    );

    RESULT Studio.EventInstance.getUserData(
      out IntPtr userdata
    );

    Studio.EventInstance.getUserData(
      userdata
    );

userdata Out
  User data.

See Also: Studio::EventInstance::setUserData

## Studio::EventInstance::getVolume

Retrieves the volume level.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::getVolume(
      float *volume,
      float *finalvolume = nullptr
    );

    FMOD_RESULT FMOD_Studio_EventInstance_GetVolume(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      float *volume,
      float *finalvolume
    );

    RESULT Studio.EventInstance.getVolume(
      out float volume
    );
    RESULT Studio.EventInstance.getVolume(
      out float volume,
      out float finalvolume
    );

    Studio.EventInstance.getVolume(
      volume,
      finalvolume
    );

volume Out Opt
  Volume as set from the public API.
finalvolume Out Opt
  Final combined volume.

The final combined value returned in `finalvolume` combines the volume set using the public API with the result of any automation or modulation. The final combined volume is calculated asynchronously when the Studio system updates.

See Also: Studio::EventInstance::setVolume

## Studio::EventInstance::isValid

Checks that the EventInstance reference is valid.

C
C++
C#
JS

    bool Studio::EventInstance::isValid()

    bool FMOD_Studio_EventInstance_IsValid(FMOD_STUDIO_EVENTINSTANCE *eventinstance)

    bool Studio.EventInstance.isValid()

    Studio.EventInstance.isValid()

## Studio::EventInstance::isVirtual

Retrieves the virtualization state.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::isVirtual(
      bool *virtualstate
    );

    FMOD_RESULT FMOD_Studio_EventInstance_IsVirtual(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_BOOL *virtualstate
    );

    RESULT Studio.EventInstance.isVirtual(
      out bool virtualstate
    );

    Studio.EventInstance.isVirtual(
      virtualstate
    );

virtualstate Out

  Virtualization state. True if the event instance has been virtualized.

  - Units: Boolean

This function checks whether an event instance has been virtualized due to the polyphony limit being exceeded.

## Studio::EventInstance::keyOff

Allow an event to continue past a sustain point.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::keyOff();

    FMOD_RESULT FMOD_Studio_EventInstance_KeyOff(FMOD_STUDIO_EVENTINSTANCE *eventinstance);

    RESULT Studio.EventInstance.keyOff();

    Studio.EventInstance.keyOff();

Multiple sustain points may be bypassed ahead of time and the key off count will be decremented each time the timeline cursor passes a sustain point.

This function returns FMOD_ERR_EVENT_NOTFOUND if the event has no sustain points.

See Also: Studio::EventDescription::hasSustainPoint

## Studio::EventInstance::release

Marks the event instance for release.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::release();

    FMOD_RESULT FMOD_Studio_EventInstance_Release(FMOD_STUDIO_EVENTINSTANCE *eventinstance);

    RESULT Studio.EventInstance.release();

    Studio.EventInstance.release();

This function marks the event instance to be released. Event instances marked for release are destroyed by the asynchronous update when they are in the stopped state (FMOD_STUDIO_PLAYBACK_STOPPED).

See Also: Studio::EventInstance::stop, Studio::EventInstance::getPlaybackState

## Studio::EventInstance::set3DAttributes

Sets the 3D attributes.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::set3DAttributes(
      const FMOD_3D_ATTRIBUTES *attributes
    );

    FMOD_RESULT FMOD_Studio_EventInstance_Set3DAttributes(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_3D_ATTRIBUTES *attributes
    );

    RESULT Studio.EventInstance.set3DAttributes(
      _3D_ATTRIBUTES attributes
    );

    Studio.EventInstance.set3DAttributes(
      attributes
    );

attributes
  3D attributes. (FMOD_3D_ATTRIBUTES)

An event's 3D attributes specify its position, velocity and orientation. The 3D attributes are used to calculate 3D panning, doppler and the values of automatic distance and angle parameters.

See Also: Studio::EventInstance::get3DAttributes

## Studio::EventInstance::setCallback

Sets the user callback.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setCallback(
      FMOD_STUDIO_EVENT_CALLBACK callback,
      FMOD_STUDIO_EVENT_CALLBACK_TYPE callbackmask = FMOD_STUDIO_EVENT_CALLBACK_ALL
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetCallback(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_EVENT_CALLBACK callback,
      FMOD_STUDIO_EVENT_CALLBACK_TYPE callbackmask
    );

    RESULT Studio.EventInstance.setCallback(
      EVENT_CALLBACK callback,
      EVENT_CALLBACK_TYPE callbackmask = EVENT_CALLBACK_TYPE.ALL
    );

    Studio.EventInstance.setCallback(
      callback,
      callbackmask
    );

callback
  User callback. (FMOD_STUDIO_EVENT_CALLBACK)
callbackmask
  Bitfield specifying which callback types are required. (FMOD_STUDIO_EVENT_CALLBACK_TYPE)

See Event Callbacks for more information about when callbacks occur.

See Also: Callback Behavior, Studio::EventDescription::setCallback

## Studio::EventInstance::setListenerMask

Sets the listener mask.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setListenerMask(
      unsigned int mask
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetListenerMask(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      unsigned int mask
    );

    RESULT Studio.EventInstance.setListenerMask(
      uint mask
    );

    Studio.EventInstance.setListenerMask(
      mask
    );

mask

  Listener mask.

  - Default: 0xFFFFFFFF

The listener mask controls which listeners are considered when calculating 3D panning and the values of listener relative automatic parameters.

To create the mask you must perform bitwise OR and shift operations, the basic form is `1 << listener_index` ORd together with other required listener indices.
For example to create a mask for listener index 0 and 2 the calculation would be `mask = (1 << 0) | (1 << 2)`, to include all listeners use the default mask of `0xFFFFFFFF`.

See Also: Studio::EventInstance::getListenerMask

## Studio::EventInstance::setParameterByID

Sets a parameter value by unique identifier.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setParameterByID(
      FMOD_STUDIO_PARAMETER_ID id,
      float value,
      bool ignoreseekspeed = false
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetParameterByID(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_PARAMETER_ID id,
      float value,
      FMOD_BOOL ignoreseekspeed
    );

    RESULT Studio.EventInstance.setParameterByID(
      PARAMETER_ID id,
      float value,
      bool ignoreseekspeed = false
    );

    Studio.EventInstance.setParameterByID(
      id,
      value,
      ignoreseekspeed
    );

id
  Parameter identifier. (FMOD_STUDIO_PARAMETER_ID)
value
  Value for given identifier.
ignoreseekspeed

  Specifies whether to ignore the parameter's seek speed and set the value immediately.

  - Units: Boolean

The `value` will be set instantly regardless of `ignoreseekspeed` when the Event playback state is FMOD_STUDIO_PLAYBACK_STOPPED.

If the specified parameter is read only, is an automatic parameter or is not of type FMOD_STUDIO_PARAMETER_GAME_CONTROLLED then FMOD_ERR_INVALID_PARAM is returned.

See Also: Studio::EventInstance::setParameterByName, Studio::EventInstance::setParametersByIDs, Studio::EventInstance::getParameterByName, Studio::EventInstance::getParameterByID

## Studio::EventInstance::setParameterByIDWithLabel

Sets a parameter value by unique identifier, looking up the value label.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setParameterByIDWithLabel(
      FMOD_STUDIO_PARAMETER_ID id,
      const char *label,
      bool ignoreseekspeed = false
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetParameterByIDWithLabel(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_PARAMETER_ID id,
      const char *label,
      FMOD_BOOL ignoreseekspeed
    );

    RESULT Studio.EventInstance.setParameterByIDWithLabel(
      PARAMETER_ID id,
      string label,
      bool ignoreseekspeed = false
    );

    Studio.EventInstance.setParameterByIDWithLabel(
      id,
      label,
      ignoreseekspeed
    );

id
  Parameter identifier. (FMOD_STUDIO_PARAMETER_ID)
label
  Labeled value for given name.
ignoreseekspeed
  Specifies whether to ignore the parameter's seek speed and set the value immediately.

The `label` will be set instantly regardless of `ignoreseekspeed` when the Event playback state is FMOD_STUDIO_PLAYBACK_STOPPED.

If the specified parameter is read only, is an automatic parameter or is not of type FMOD_STUDIO_PARAMETER_GAME_CONTROLLED then FMOD_ERR_INVALID_PARAM is returned.

If the specified label is not found, FMOD_ERR_EVENT_NOTFOUND is returned. This lookup is case sensitive.

See Also: Studio::EventInstance::setParameterByName, Studio::EventInstance::setParametersByIDs, Studio::EventInstance::getParameterByName, Studio::EventInstance::getParameterByID

## Studio::EventInstance::setParameterByName

Sets a parameter value by name.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setParameterByName(
      const char *name,
      float value,
      bool ignoreseekspeed = false
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetParameterByName(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      const char *name,
      float value,
      FMOD_BOOL ignoreseekspeed
    );

    RESULT Studio.EventInstance.setParameterByName(
      string name,
      float value,
      bool ignoreseekspeed = false
    );

    Studio.EventInstance.setParameterByName(
      name,
      value,
      ignoreseekspeed
    );

name
  Parameter name (case-insensitive). (UTF-8 string)
value
  Value for given name.
ignoreseekspeed

  Specifies whether to ignore the parameter's seek speed and set the value immediately.

  - Units: Boolean

The `value` will be set instantly regardless of `ignoreseekspeed` when the Event playback state is FMOD_STUDIO_PLAYBACK_STOPPED.

If the specified parameter is read only, is an automatic parameter or is not of type FMOD_STUDIO_PARAMETER_GAME_CONTROLLED then FMOD_ERR_INVALID_PARAM is returned.

If the event has no parameter matching `name` then FMOD_ERR_EVENT_NOTFOUND is returned.

See Also: Studio::EventInstance::setParameterByID, Studio::EventInstance::setParametersByIDs, Studio::EventInstance::getParameterByName, Studio::EventInstance::getParameterByID

## Studio::EventInstance::setParameterByNameWithLabel

Sets a parameter value by name, looking up the value label.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setParameterByNameWithLabel(
      const char *name,
      const char *label,
      bool ignoreseekspeed = false
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetParameterByNameWithLabel(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      const char *name,
      const char *label,
      FMOD_BOOL ignoreseekspeed
    );

    RESULT Studio.EventInstance.setParameterByNameWithLabel(
      string name,
      string label,
      bool ignoreseekspeed = false
    );

    Studio.EventInstance.setParameterByNameWithLabel(
      name,
      label,
      ignoreseekspeed
    );

name
  Parameter name (case-insensitive). (UTF-8 string)
label
  Labeled value for given name.
ignoreseekspeed
  Specifies whether to ignore the parameter's seek speed and set the value immediately.

The `label` will be set instantly regardless of `ignoreseekspeed` when the Event playback state is FMOD_STUDIO_PLAYBACK_STOPPED.

If the specified parameter is read only, is an automatic parameter or is not of type FMOD_STUDIO_PARAMETER_GAME_CONTROLLED then FMOD_ERR_INVALID_PARAM is returned.

If the event has no parameter matching `name` then FMOD_ERR_EVENT_NOTFOUND is returned.

If the specified label is not found, FMOD_ERR_EVENT_NOTFOUND is returned. This lookup is case sensitive.

See Also: Studio::EventInstance::setParameterByID, Studio::EventInstance::setParametersByIDs, Studio::EventInstance::getParameterByName, Studio::EventInstance::getParameterByID

## Studio::EventInstance::setParametersByIDs

Sets multiple parameter values by unique identifier.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setParametersByIDs(
      const FMOD_STUDIO_PARAMETER_ID *ids,
      float *values,
      int count,
      bool ignoreseekspeed = false
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetParametersByIDs(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      const FMOD_STUDIO_PARAMETER_ID *ids,
      float *values,
      int count,
      FMOD_BOOL ignoreseekspeed
    );

    RESULT Studio.EventInstance.setParametersByIDs(
      PARAMETER_ID[] ids,
      float[] values,
      int count,
      bool ignoreseekspeed = false
    );

    Studio.EventInstance.setParametersByIDs(
      ids,
      values,
      count,
      ignoreseekspeed
    );

ids
  Array of parameter identifiers. (FMOD_STUDIO_PARAMETER_ID)
values
  Array of values for each given identifier.
count

  Number of items in the given arrays.

  - Range: [1, 32]
ignoreseekspeed

  Specifies whether to ignore the parameter's seek speed and set the value immediately.

  - Units: Boolean

All `values` will be set instantly regardless of `ignoreseekspeed` when the Event playback state is FMOD_STUDIO_PLAYBACK_STOPPED.

If any ID is set to all zeroes then the corresponding value will be ignored.

See Also: Studio::EventInstance::setParameterByName, Studio::EventInstance::setParameterByID, Studio::EventInstance::getParameterByName, Studio::EventInstance::getParameterByID

## Studio::EventInstance::setPaused

Sets the pause state.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setPaused(
      bool paused
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetPaused(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_BOOL paused
    );

    RESULT Studio.EventInstance.setPaused(
      bool paused
    );

    Studio.EventInstance.setPaused(
      paused
    );

paused

  The desired pause state. True = paused, False = unpaused.

  - Units: Boolean

This function allows pausing/unpausing of an event instance.

See Also: Studio::EventInstance::getPaused

## Studio::EventInstance::setPitch

Sets the pitch multiplier.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setPitch(
      float pitch
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetPitch(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      float pitch
    );

    RESULT Studio.EventInstance.setPitch(
      float pitch
    );

    Studio.EventInstance.setPitch(
      pitch
    );

pitch

  Pitch multiplier.

  - Units: Linear
  - Range: [0, inf)
  - Default: 1

The pitch multiplier is used to modulate the event instance's pitch. 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.

See Also: Studio::EventInstance::getPitch

## Studio::EventInstance::setProperty

Sets the value of a built-in property.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setProperty(
      FMOD_STUDIO_EVENT_PROPERTY index,
      float value
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetProperty(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_EVENT_PROPERTY index,
      float value
    );

    RESULT Studio.EventInstance.setProperty(
      EVENT_PROPERTY index,
      float value
    );

    Studio.EventInstance.setProperty(
      index,
      value
    );

index
  Property index. (FMOD_STUDIO_EVENT_PROPERTY)
value
  Property value.

This will override the value set in Studio. Using the default FMOD_STUDIO_EVENT_PROPERTY value will revert back to the default values set in Studio.

An FMOD spatializer or object spatializer may override the values set for FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE and FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE.

See Also: Studio::EventInstance::getProperty

## Studio::EventInstance::setReverbLevel

Sets the core reverb send level.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setReverbLevel(
      int index,
      float level
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetReverbLevel(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      int index,
      float level
    );

    RESULT Studio.EventInstance.setReverbLevel(
      int index,
      float level
    );

    Studio.EventInstance.setReverbLevel(
      index,
      level
    );

index

  Core reverb instance index.

  - Range: [0, 3]
level

  Reverb send level.

  - Units: Linear
  - Range: [0, 1]
  - Default: 0

This function controls the send level for the signal from the event instance to a core reverb instance.

See Also: Studio::EventInstance::getReverbLevel, Working with Reverb

## Studio::EventInstance::setTimelinePosition

Sets the timeline cursor position.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setTimelinePosition(
      int position
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetTimelinePosition(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      int position
    );

    RESULT Studio.EventInstance.setTimelinePosition(
      int position
    );

    Studio.EventInstance.setTimelinePosition(
      position
    );

position

  Timeline position.

  - Units: Milliseconds
  - Range: [0, inf)

See Also: Studio::EventInstance::getTimelinePosition

## Studio::EventInstance::setUserData

Sets the event instance user data.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setUserData(
      void *userdata
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetUserData(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      void *userdata
    );

    RESULT Studio.EventInstance.setUserData(
      IntPtr userdata
    );

    Studio.EventInstance.setUserData(
      userdata
    );

userdata
  User data.

This function allows arbitrary user data to be attached to an event instance. The user data can be retrieved by calling Studio::EventInstance::getUserData.

## Studio::EventInstance::setVolume

Sets the volume level.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::setVolume(
      float volume
    );

    FMOD_RESULT FMOD_Studio_EventInstance_SetVolume(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      float volume
    );

    RESULT Studio.EventInstance.setVolume(
      float volume
    );

    Studio.EventInstance.setVolume(
      volume
    );

volume

  Volume.

  - Units: Linear
  - Range: [0, inf)
  - Default: 1

This volume is applied as a scaling factor for the event volume. It does not override the volume level set in FMOD Studio, nor any internal volume automation or modulation.

See Also: Studio::EventInstance::getVolume

## Studio::EventInstance::start

Starts playback.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::start();

    FMOD_RESULT FMOD_Studio_EventInstance_Start(FMOD_STUDIO_EVENTINSTANCE *eventinstance);

    RESULT Studio.EventInstance.start();

    Studio.EventInstance.start();

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

See Also: Studio::EventInstance::stop, Sample Data Loading

## Studio::EventInstance::stop

Stops playback.

C
C++
C#
JS

    FMOD_RESULT Studio::EventInstance::stop(
      FMOD_STUDIO_STOP_MODE mode
    );

    FMOD_RESULT FMOD_Studio_EventInstance_Stop(
      FMOD_STUDIO_EVENTINSTANCE *eventinstance,
      FMOD_STUDIO_STOP_MODE mode
    );

    RESULT Studio.EventInstance.stop(
      STOP_MODE mode
    );

    Studio.EventInstance.stop(
      mode
    );

mode
  Stop mode. (FMOD_STUDIO_STOP_MODE)

See Also: Studio::EventInstance::start

## FMOD_STUDIO_EVENT_CALLBACK

Callback that is fired when a Studio::EventInstance changes state.

C
C++
C#
JS

    FMOD_RESULT F_CALLBACK FMOD_STUDIO_EVENT_CALLBACK(
      FMOD_STUDIO_EVENT_CALLBACK_TYPE type,
      FMOD_STUDIO_EVENTINSTANCE *event,
      void *parameters
    );

    delegate RESULT Studio.EVENT_CALLBACK(
      EVENT_CALLBACK_TYPE type,
      IntPtr event,
      IntPtr parameters
    );

    function FMOD_STUDIO_EVENT_CALLBACK(
      type,
      event,
      parameters
    )

type
  The type of event that has occurred. (FMOD_STUDIO_EVENT_CALLBACK_TYPE)
event
  The event instance that has changed state. (Studio::EventInstance)
parameters
  The callback parameters. The data passed varies based on the callback type.

The data passed to the callback function in the `parameters` argument varies based on the callback type. See FMOD_STUDIO_EVENT_CALLBACK_TYPE for more information.

The 'event' argument Can be cast to `Studio::EventInstance *`.

The 'event' argument can be used via `EventInstance` by using `FMOD.Studio.EventInstance instance = new FMOD.Studio.EventInstance(event);`

See Also: Callback Behavior, Studio::EventInstance::setCallback, Studio::EventDescription::setCallback, Studio::System::getSoundInfo, FMOD_STUDIO_EVENT_CALLBACK_TYPE, FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES

## FMOD_STUDIO_EVENT_CALLBACK_TYPE

Studio event callback types.

C
C++
C#
JS

    #define FMOD_STUDIO_EVENT_CALLBACK_CREATED                  0x00000001
    #define FMOD_STUDIO_EVENT_CALLBACK_DESTROYED                0x00000002
    #define FMOD_STUDIO_EVENT_CALLBACK_STARTING                 0x00000004
    #define FMOD_STUDIO_EVENT_CALLBACK_STARTED                  0x00000008
    #define FMOD_STUDIO_EVENT_CALLBACK_RESTARTED                0x00000010
    #define FMOD_STUDIO_EVENT_CALLBACK_STOPPED                  0x00000020
    #define FMOD_STUDIO_EVENT_CALLBACK_START_FAILED             0x00000040
    #define FMOD_STUDIO_EVENT_CALLBACK_CREATE_PROGRAMMER_SOUND  0x00000080
    #define FMOD_STUDIO_EVENT_CALLBACK_DESTROY_PROGRAMMER_SOUND 0x00000100
    #define FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_CREATED           0x00000200
    #define FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED         0x00000400
    #define FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER          0x00000800
    #define FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT            0x00001000
    #define FMOD_STUDIO_EVENT_CALLBACK_SOUND_PLAYED             0x00002000
    #define FMOD_STUDIO_EVENT_CALLBACK_SOUND_STOPPED            0x00004000
    #define FMOD_STUDIO_EVENT_CALLBACK_REAL_TO_VIRTUAL          0x00008000
    #define FMOD_STUDIO_EVENT_CALLBACK_VIRTUAL_TO_REAL          0x00010000
    #define FMOD_STUDIO_EVENT_CALLBACK_START_EVENT_COMMAND      0x00020000
    #define FMOD_STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT     0x00040000
    #define FMOD_STUDIO_EVENT_CALLBACK_ALL                      0xFFFFFFFF

    enum Studio.EVENT_CALLBACK_TYPE : uint
    {
      CREATED                  = 0x00000001,
      DESTROYED                = 0x00000002,
      STARTING                 = 0x00000004,
      STARTED                  = 0x00000008,
      RESTARTED                = 0x00000010,
      STOPPED                  = 0x00000020,
      START_FAILED             = 0x00000040,
      CREATE_PROGRAMMER_SOUND  = 0x00000080,
      DESTROY_PROGRAMMER_SOUND = 0x00000100,
      PLUGIN_CREATED           = 0x00000200,
      PLUGIN_DESTROYED         = 0x00000400,
      TIMELINE_MARKER          = 0x00000800,
      TIMELINE_BEAT            = 0x00001000,
      SOUND_PLAYED             = 0x00002000,
      SOUND_STOPPED            = 0x00004000,
      REAL_TO_VIRTUAL          = 0x00008000,
      VIRTUAL_TO_REAL          = 0x00010000,
      START_EVENT_COMMAND      = 0x00020000,
      NESTED_TIMELINE_BEAT     = 0x00040000,
      ALL                      = 0xFFFFFFFF,
    }

    STUDIO_EVENT_CALLBACK_CREATED                  0x00000001
    STUDIO_EVENT_CALLBACK_DESTROYED                0x00000002
    STUDIO_EVENT_CALLBACK_STARTING                 0x00000004
    STUDIO_EVENT_CALLBACK_STARTED                  0x00000008
    STUDIO_EVENT_CALLBACK_RESTARTED                0x00000010
    STUDIO_EVENT_CALLBACK_STOPPED                  0x00000020
    STUDIO_EVENT_CALLBACK_START_FAILED             0x00000040
    STUDIO_EVENT_CALLBACK_CREATE_PROGRAMMER_SOUND  0x00000080
    STUDIO_EVENT_CALLBACK_DESTROY_PROGRAMMER_SOUND 0x00000100
    STUDIO_EVENT_CALLBACK_PLUGIN_CREATED           0x00000200
    STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED         0x00000400
    STUDIO_EVENT_CALLBACK_TIMELINE_MARKER          0x00000800
    STUDIO_EVENT_CALLBACK_TIMELINE_BEAT            0x00001000
    STUDIO_EVENT_CALLBACK_SOUND_PLAYED             0x00002000
    STUDIO_EVENT_CALLBACK_SOUND_STOPPED            0x00004000
    STUDIO_EVENT_CALLBACK_REAL_TO_VIRTUAL          0x00008000
    STUDIO_EVENT_CALLBACK_VIRTUAL_TO_REAL          0x00010000
    STUDIO_EVENT_CALLBACK_START_EVENT_COMMAND      0x00020000
    STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT     0x00040000
    STUDIO_EVENT_CALLBACK_ALL                      0xFFFFFFFF

FMOD_STUDIO_EVENT_CALLBACK_CREATED
  Called when an instance is fully created. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_DESTROYED
  Called when an instance is just about to be destroyed. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_STARTING
  Studio::EventInstance::start has been called on an event which was not already playing. The event will remain in this state until its sample data has been loaded. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_STARTED
  The event has commenced playing. Normally this callback will be issued immediately after FMOD_STUDIO_EVENT_CALLBACK_STARTING, but may be delayed until sample data has loaded. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_RESTARTED
  Studio::EventInstance::start has been called on an event which was already playing. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_STOPPED
  The event has stopped. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_START_FAILED
  Studio::EventInstance::start has been called but the polyphony settings did not allow the event to start. In this case none of FMOD_STUDIO_EVENT_CALLBACK_STARTING, FMOD_STUDIO_EVENT_CALLBACK_STARTED and FMOD_STUDIO_EVENT_CALLBACK_STOPPED will be called. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_CREATE_PROGRAMMER_SOUND
  A programmer sound is about to play. FMOD expects the callback to provide an FMOD::Sound object for it to use. Parameters = FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_DESTROY_PROGRAMMER_SOUND
  A programmer sound has stopped playing. At this point it is safe to release the FMOD::Sound object that was used. Parameters = FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_CREATED
  Called when a DSP plugin instance has just been created. Parameters = FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED
  Called when a DSP plugin instance is about to be destroyed. Parameters = FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER
  Called when the timeline passes a named marker. Parameters = FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT
  Called when the timeline hits a beat in a tempo section. Parameters = FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_SOUND_PLAYED
  Called when the event plays a sound. Parameters = Sound.
FMOD_STUDIO_EVENT_CALLBACK_SOUND_STOPPED
  Called when the event finishes playing a sound. Parameters = Sound.
FMOD_STUDIO_EVENT_CALLBACK_REAL_TO_VIRTUAL
  Called when the event becomes virtual. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_VIRTUAL_TO_REAL
  Called when the event becomes real. Parameters = unused.
FMOD_STUDIO_EVENT_CALLBACK_START_EVENT_COMMAND
  Called when a new event is started by a start event command. Parameters = Studio::EventInstance.
FMOD_STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT
  Called when the timeline hits a beat in a tempo section of a nested event. Parameters = FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES.
FMOD_STUDIO_EVENT_CALLBACK_ALL
  Pass this mask to Studio::EventDescription::setCallback or Studio::EventInstance::setCallback to receive all callback types.

Callbacks are called from the Studio Update Thread in default / async mode and the main (calling) thread in synchronous mode.
If using FMOD_STUDIO_INIT_DEFERRED_CALLBACKS, FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER and FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT are instead called from the main thread.

See Also: Callback Behavior, Studio::EventDescription::setCallback, Studio::EventInstance::setCallback, FMOD_STUDIO_EVENT_CALLBACK

## FMOD_STUDIO_EVENT_PROPERTY

These definitions describe built-in event properties.

C
C++
C#
JS

    typedef enum FMOD_STUDIO_EVENT_PROPERTY {
      FMOD_STUDIO_EVENT_PROPERTY_CHANNELPRIORITY,
      FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_DELAY,
      FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_LOOKAHEAD,
      FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE,
      FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE,
      FMOD_STUDIO_EVENT_PROPERTY_COOLDOWN,
      FMOD_STUDIO_EVENT_PROPERTY_MAX
    } FMOD_STUDIO_EVENT_PROPERTY;

    enum Studio.EVENT_PROPERTY
    {
        CHANNELPRIORITY,
        SCHEDULE_DELAY,
        SCHEDULE_LOOKAHEAD,
        MINIMUM_DISTANCE,
        MAXIMUM_DISTANCE,
        COOLDOWN,
        MAX
    };

    STUDIO_EVENT_PROPERTY_CHANNELPRIORITY
    STUDIO_EVENT_PROPERTY_SCHEDULE_DELAY
    STUDIO_EVENT_PROPERTY_SCHEDULE_LOOKAHEAD
    STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE
    STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE
    STUDIO_EVENT_PROPERTY_COOLDOWN
    STUDIO_EVENT_PROPERTY_MAX

FMOD_STUDIO_EVENT_PROPERTY_CHANNELPRIORITY

  Priority to set on Core channels created by this event instance, or -1 for default.

  - Range: [-1, 256]
  - Default: -1
FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_DELAY

  Schedule delay in DSP clocks, or -1 for default.

  - Range: -1, [0, inf)
  - Default: -1
FMOD_STUDIO_EVENT_PROPERTY_SCHEDULE_LOOKAHEAD

  Schedule look-ahead on the timeline in DSP clocks, or -1 for default.

  - Range: -1, [0, inf)
  - Default: -1
FMOD_STUDIO_EVENT_PROPERTY_MINIMUM_DISTANCE

  Override the event's 3D minimum distance, or -1 for default.

  - Range: -1, [0, inf)
  - Default: -1
  - Units: Distance units
FMOD_STUDIO_EVENT_PROPERTY_MAXIMUM_DISTANCE

  Override the event's 3D maximum distance, or -1 for default.

  - Range: -1, [0, inf)
  - Default: -1
  - Units: Distance units
FMOD_STUDIO_EVENT_PROPERTY_COOLDOWN

  Override the event's cooldown, or -1 for default.

  - Range: -1, [0, inf)
  - Default: -1
FMOD_STUDIO_EVENT_PROPERTY_MAX
  Maximum number of event property types.

A property that returns a value of -1 from Studio::EventInstance::getProperty means it will use the values set in Studio, use Studio::EventInstance::setProperty to override these values. You can revert the properties value to default by setting it to -1.

## FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES

Describes a DSP plugin instance.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES {
      const char   *name;
      FMOD_DSP    *dsp;
    } FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES;

    struct Studio.PLUGIN_INSTANCE_PROPERTIES
    {
        IntPtr name;
        IntPtr dsp;
    }

    FMOD_STUDIO_PLUGIN_INSTANCE_PROPERTIES
    {
      name,
    };

name
  Name of the plugin effect or sound (set in FMOD Studio).
dsp
  DSP plugin instance. (DSP)

This data is passed to the event callback function when type is FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_CREATED or FMOD_STUDIO_EVENT_CALLBACK_PLUGIN_DESTROYED.

The `dsp` argument can be cast to `FMOD::DSP *`.

The 'name' argument can be used via `StringWrapper` by using `FMOD.StringWrapper dspName = new FMOD.StringWrapper(name);`

The 'dsp' argument can be used via `DSP` by using `FMOD.DSP dspInstance = new FMOD.DSP(dsp);`

See Also: FMOD_STUDIO_EVENT_CALLBACK

## FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES

Describes a programmer sound.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES {
      const char   *name;
      FMOD_SOUND   *sound;
      int          subsoundIndex;
    } FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES;

    struct Studio.PROGRAMMER_SOUND_PROPERTIES
    {
        StringWrapper name;
        IntPtr sound;
        int subsoundIndex;
    }

    FMOD_STUDIO_PROGRAMMER_SOUND_PROPERTIES
    {
      name,
      sound,
      subsoundIndex,
    };

name
  Name of the programmer instrument (set in FMOD Studio). (UTF-8 string)
sound
  Programmer-created sound. (Sound)
subsoundIndex
  Subsound index.

This data is passed to the event callback function when type is FMOD_STUDIO_EVENT_CALLBACK_CREATE_PROGRAMMER_SOUND or FMOD_STUDIO_EVENT_CALLBACK_DESTROY_PROGRAMMER_SOUND.

When the callback type is FMOD_STUDIO_EVENT_CALLBACK_CREATE_PROGRAMMER_SOUND the callback should fill in the `sound` and `subsoundIndex` fields. The provided sound should be created with the FMOD_LOOP_NORMAL mode bit set. FMOD will set this bit internally if it is not set, possibly incurring a performance penalty. The subsound index should be set to the subsound to play, or -1 if the provided sound should be used directly.

When the callback type is FMOD_STUDIO_EVENT_CALLBACK_DESTROY_PROGRAMMER_SOUND the sound in `sound` should be cleaned up.

`sound` can be cast to/from `FMOD::Sound *`.

See Also: FMOD_STUDIO_EVENT_CALLBACK

## FMOD_STUDIO_STOP_MODE

Stop modes.

C
C++
C#
JS

    typedef enum FMOD_STUDIO_STOP_MODE {
      FMOD_STUDIO_STOP_ALLOWFADEOUT,
      FMOD_STUDIO_STOP_IMMEDIATE
    } FMOD_STUDIO_STOP_MODE;

    enum Studio.STOP_MODE
    {
        ALLOWFADEOUT,
        IMMEDIATE,
    }

    STUDIO_STOP_ALLOWFADEOUT
    STUDIO_STOP_IMMEDIATE

FMOD_STUDIO_STOP_ALLOWFADEOUT
  Allows AHDSR modulators to complete their release, and DSP effect tails to play out.
FMOD_STUDIO_STOP_IMMEDIATE
  Stops the event instance immediately.

See Also: Studio::EventInstance::stop, Studio::Bus::stopAllEvents

## FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES

Describes a beat on the timeline.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES {
      int     bar;
      int     beat;
      int     position;
      float   tempo;
      int     timesignatureupper;
      int     timesignaturelower;
    } FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES;

    struct Studio.TIMELINE_BEAT_PROPERTIES
    {
      int bar;
      int beat;
      int position;
      float tempo;
      int timesignatureupper;
      int timesignaturelower;
    }

    FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES
    {
      bar,
      beat,
      position,
      tempo,
      timesignatureupper,
      timesignaturelower,
    };

bar
  Bar number (starting from 1).
beat
  Beat number within bar (starting from 1).
position
  Position of the beat on the timeline in milliseconds.
tempo
  Current tempo in beats per minute.
timesignatureupper
  Current time signature upper number (beats per bar).
timesignaturelower
  Current time signature lower number (beat unit).

This data is passed to the event callback function when type is FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT.

Nested events do not trigger this callback. Instead, see FMOD_STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT.

See Also: FMOD_STUDIO_EVENT_CALLBACK

## FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES

Describes a marker on the timeline.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES {
      const char   *name;
      int          position;
    } FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES;

    struct Studio.TIMELINE_MARKER_PROPERTIES
    {
      IntPtr name;
      int position;
    }

    FMOD_STUDIO_TIMELINE_MARKER_PROPERTIES
    {
      name,
      position,
    };

name
  Marker name.
position
  Position of the marker on the timeline in milliseconds.

This data is passed to the event callback function when type is FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_MARKER.

See Also: Studio::EventDescription::setCallback, Studio::EventInstance::setCallback

## FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES

Describes a beat on the timeline from a nested event.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES {
      FMOD_GUID                             eventid;
      FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES  properties;
    } FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES;

    struct Studio.TIMELINE_NESTED_BEAT_PROPERTIES
    {
      Guid                      eventid;
      TIMELINE_BEAT_PROPERTIES  properties;
    }

    FMOD_STUDIO_TIMELINE_NESTED_BEAT_PROPERTIES
    {
      eventid,
      properties,
    };

eventid
  Event description GUID. (FMOD_GUID)
properties
  Beat properties. (FMOD_STUDIO_TIMELINE_BEAT_PROPERTIES)

This data is passed to the event callback function when type is FMOD_STUDIO_EVENT_CALLBACK_NESTED_TIMELINE_BEAT.

See Also: FMOD_STUDIO_EVENT_CALLBACK, FMOD_STUDIO_EVENT_CALLBACK_TIMELINE_BEAT