# 6. Studio API Reference | Studio::EventDescription

The description for an FMOD Studio Event.

Event descriptions belong to banks and can be queried after the relevant bank has been loaded. Event descriptions may be retrieved via path or GUID lookup, or by enumerating all descriptions in a bank.

Instances:

- Studio::EventDescription::createInstance Creates a playable instance.
- Studio::EventDescription::getInstanceCount Retrieves the number of instances.
- Studio::EventDescription::getInstanceList Retrieves a list of the instances.
- Studio::EventDescription::releaseAllInstances Releases all instances.

Sample Data:

- Studio::EventDescription::loadSampleData Loads non-streaming sample data used by the event.
- Studio::EventDescription::unloadSampleData Unloads all non-streaming sample data.
- Studio::EventDescription::getSampleLoadingState Retrieves the sample data loading state.

Attributes:

- Studio::EventDescription::is3D Retrieves the event's 3D status.
- Studio::EventDescription::isDopplerEnabled Retrieves the event's doppler status.
- Studio::EventDescription::isOneshot Retrieves the event's oneshot status.
- Studio::EventDescription::isSnapshot Retrieves the event's snapshot status.
- Studio::EventDescription::isStream Retrieves the event's stream status.
- Studio::EventDescription::hasSustainPoint Retrieves whether the event has any sustain points.
- Studio::EventDescription::getMinMaxDistance Retrieves the minimum and maximum distances for 3D attenuation.
- Studio::EventDescription::getSoundSize Retrieves the sound size for 3D panning.

Parameters:

- Studio::EventDescription::getParameterDescriptionByName Retrieves an event parameter description by name.
- Studio::EventDescription::getParameterDescriptionByID Retrieves an event parameter description by id.
- Studio::EventDescription::getParameterDescriptionByIndex Retrieves an event parameter description by index.
- Studio::EventDescription::getParameterDescriptionCount Retrieves the number of parameters in the event.
- Studio::EventDescription::getParameterLabelByName Retrieves an event parameter label by name or path.
- Studio::EventDescription::getParameterLabelByID Retrieves an event parameter label by ID.
- Studio::EventDescription::getParameterLabelByIndex Retrieves an event parameter label by index.

User Properties:

- Studio::EventDescription::getUserProperty Retrieves a user property by name.
- Studio::EventDescription::getUserPropertyByIndex Retrieves a user property by index.
- Studio::EventDescription::getUserPropertyCount Retrieves the number of user properties attached to the event.

- FMOD_STUDIO_USER_PROPERTY Describes a user property.

- FMOD_STUDIO_USER_PROPERTY_TYPE User property types.

General:

- Studio::EventDescription::getID Retrieves the GUID.
- Studio::EventDescription::getLength Retrieves the length of the timeline.
- Studio::EventDescription::getPath Retrieves the path.
- Studio::EventDescription::getUserData Retrieves the event user data.
- Studio::EventDescription::setCallback Sets the user callback.
- Studio::EventDescription::setUserData Sets the event user data.
- Studio::EventDescription::isValid Checks that the EventDescription reference is valid.

See Also:

- Studio::System::getEvent Retrieves an EventDescription.
- Studio::System::getEventByID Retrieves an EventDescription.
- Studio::Bank::getEventList Retrieves a list of the event descriptions in the bank.

## Studio::EventDescription::createInstance

Creates a playable instance.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::createInstance(
      Studio::EventInstance **instance
    );

    FMOD_RESULT FMOD_Studio_EventDescription_CreateInstance(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_EVENTINSTANCE **instance
    );

    RESULT Studio.EventDescription.createInstance(
      out EventInstance instance
    );

    Studio.EventDescription.createInstance(
      instance
    );

instance Out
  EventInstance object. (Studio::EventInstance)

When an event instance is created, any required non-streaming sample data is loaded asynchronously.

Use Studio::EventDescription::getSampleLoadingState to check the loading status.

Sample data can be loaded ahead of time with Studio::EventDescription::loadSampleData or Studio::Bank::loadSampleData. See Sample Data Loading for more information.

See Also: Studio::EventInstance::release

## Studio::EventDescription::getID

Retrieves the GUID.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getID(
      FMOD_GUID *id
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetID(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_GUID *id
    );

    RESULT Studio.EventDescription.getID(
      out Guid id
    );

    Studio.EventDescription.getID(
      id
    );

id Out
  Event description GUID. (FMOD_GUID)

## Studio::EventDescription::getInstanceCount

Retrieves the number of instances.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getInstanceCount(
      int *count
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetInstanceCount(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int *count
    );

    RESULT Studio.EventDescription.getInstanceCount(
      out int count
    );

    Studio.EventDescription.getInstanceCount(
      count
    );

count Out
  Instance count.

May be used in conjunction with Studio::EventDescription::getInstanceList to enumerate the instances of this event.

## Studio::EventDescription::getInstanceList

Retrieves a list of the instances.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getInstanceList(
      Studio::EventInstance **array,
      int capacity,
      int *count
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetInstanceList(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_EVENTINSTANCE **array,
      int capacity,
      int *count
    );

    RESULT Studio.EventDescription.getInstanceList(
      out EventInstance[] array
    );

    Studio.EventDescription.getInstanceList(
      array,
      capacity,
      count
    );

array Out
  An array to receive the list. (Studio::EventInstance)
capacity
  Capacity of `array`.
count Out Opt
  Number of event instances written to `array`.

This function returns a maximum of `capacity` instances. If more than `capacity` instances have been created then additional instances will be silently ignored.

May be used in conjunction with Studio::EventDescription::getInstanceCount to enumerate the instances of this event.

## Studio::EventDescription::getLength

Retrieves the length of the timeline.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getLength(
      int *length
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetLength(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int *length
    );

    RESULT Studio.EventDescription.getLength(
      out int length
    );

    Studio.EventDescription.getLength(
      length
    );

length Out

  Timeline length.

  - Units: Milliseconds

A timeline's length is the largest of any logic markers, transition leadouts and the end of any trigger boxes on the timeline.

See Also: Studio::EventInstance::getTimelinePosition, Studio::EventInstance::setTimelinePosition

## Studio::EventDescription::getMinMaxDistance

Retrieves the minimum and maximum distances for 3D attenuation.

C
C++
C#
JS

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

    FMOD_RESULT FMOD_Studio_EventDescription_GetMinMaxDistance(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      float *min,
      float *max
    );

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

    Studio.EventDescription.getMinMaxDistance(
      min,
      max
    );

min Out Opt

  Minimum distance.

  - Units: Distance units
max Out Opt

  Maximum distance.

  - Units: Distance units

See Also: Studio::EventInstance::getMinMaxDistance

## Studio::EventDescription::getParameterDescriptionByID

Retrieves an event parameter description by id.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterDescriptionByID(
      FMOD_STUDIO_PARAMETER_ID id,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterDescriptionByID(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_PARAMETER_ID id,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    RESULT Studio.EventDescription.getParameterDescriptionByID(
      PARAMETER_ID id,
      out PARAMETER_DESCRIPTION parameter
    );

    Studio.EventDescription.getParameterDescriptionByID(
      id,
      parameter
    );

id
  Parameter id. (FMOD_STUDIO_PARAMETER_ID)
parameter Out
  Parameter description. (FMOD_STUDIO_PARAMETER_DESCRIPTION)

## Studio::EventDescription::getParameterDescriptionByIndex

Retrieves an event parameter description by index.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterDescriptionByIndex(
      int index,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterDescriptionByIndex(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int index,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    RESULT Studio.EventDescription.getParameterDescriptionByIndex(
      int index,
      out PARAMETER_DESCRIPTION parameter
    );

    Studio.EventDescription.getParameterDescriptionByIndex(
      index,
      parameter
    );

index
  Parameter index.
parameter Out
  Parameter description. (FMOD_STUDIO_PARAMETER_DESCRIPTION)

May be used in combination with Studio::EventDescription::getParameterDescriptionCount to enumerate event parameters.

The order of parameters is not necessarily the same as what is shown in the FMOD Studio event editor.

## Studio::EventDescription::getParameterDescriptionByName

Retrieves an event parameter description by name.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterDescriptionByName(
      const char *name,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterDescriptionByName(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      const char *name,
      FMOD_STUDIO_PARAMETER_DESCRIPTION *parameter
    );

    RESULT Studio.EventDescription.getParameterDescriptionByName(
      string name,
      out PARAMETER_DESCRIPTION parameter
    );

    Studio.EventDescription.getParameterDescriptionByName(
      name,
      parameter
    );

name
  Parameter name (case-insensitive). (UTF-8 string)
parameter Out
  Parameter description. (FMOD_STUDIO_PARAMETER_DESCRIPTION)

## Studio::EventDescription::getParameterDescriptionCount

Retrieves the number of parameters in the event.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterDescriptionCount(
      int *count
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterDescriptionCount(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int *count
    );

    RESULT Studio.EventDescription.getParameterDescriptionCount(
      out int count
    );

    Studio.EventDescription.getParameterDescriptionCount(
      count
    );

count Out
  Parameter count.

May be used in conjunction with Studio::EventDescription::getParameterDescriptionByIndex to enumerate event parameters.

## Studio::EventDescription::getParameterLabelByID

Retrieves an event parameter label by ID.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterLabelByID(
      FMOD_STUDIO_PARAMETER_ID id,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterLabelByID(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_PARAMETER_ID id,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    RESULT Studio.EventDescription.getParameterLabelByID(
      PARAMETER_ID id,
      int labelindex,
      out string label
    );

    Studio.EventDescription.getParameterLabelByID(
      id,
      labelindex,
      label,
      size,
      retrieved
    );

id
  Parameter ID. (FMOD_STUDIO_PARAMETER_ID)
labelindex

  Label index to retrieve.

  - Range: [0, FMOD_STUDIO_PARAMETER_DESCRIPTION::maximum].
label Out
  Buffer to receive the label. (UTF-8 string)
size
  Size of the label buffer in bytes. Must be 0 if `label` is null.
retrieved Out Opt
  Length of the label in bytes, including the terminating null character.

If the label is longer than `size` then it is truncated and this function returns FMOD_ERR_TRUNCATED.

The `retrieved` parameter can be used to get the buffer size required to hold the full label.

## Studio::EventDescription::getParameterLabelByIndex

Retrieves an event parameter label by index.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterLabelByIndex(
      int index,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterLabelByIndex(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int index,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    RESULT Studio.EventDescription.getParameterLabelByIndex(
      int index,
      int labelindex,
      out string label
    );

    Studio.EventDescription.getParameterLabelByIndex(
      index,
      labelindex,
      label,
      size,
      retrieved
    );

index
  Parameter index.
labelindex

  Label index to retrieve.

  - Range: [0, FMOD_STUDIO_PARAMETER_DESCRIPTION::maximum].
label Out
  Buffer to receive the label. (UTF-8 string)
size
  Size of the label buffer in bytes. Must be 0 if `label` is null.
retrieved Out Opt
  Length of the label in bytes, including the terminating null character.

If the label is longer than `size` then it is truncated and this function returns FMOD_ERR_TRUNCATED.

The `retrieved` parameter can be used to get the buffer size required to hold the full label.

May be used in combination with Studio::EventDescription::getParameterDescriptionCount to enumerate event parameters.

The order of parameters is not necessarily the same as what is shown in the FMOD Studio event editor.

## Studio::EventDescription::getParameterLabelByName

Retrieves an event parameter label by name or path.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getParameterLabelByName(
      const char *name,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetParameterLabelByName(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      const char *name,
      int labelindex,
      char *label,
      int size,
      int *retrieved
    );

    RESULT Studio.EventDescription.getParameterLabelByName(
      string name,
      int labelindex,
      out string label
    );

    Studio.EventDescription.getParameterLabelByName(
      name,
      labelindex,
      label,
      size,
      retrieved
    );

name
  Parameter name. (UTF-8 string)
labelindex

  Label index to retrieve.

  - Range: [0, FMOD_STUDIO_PARAMETER_DESCRIPTION::maximum].
label Out
  Buffer to receive the label. (UTF-8 string)
size
  Size of the label buffer in bytes. Must be 0 if `label` is null.
retrieved Out Opt
  Length of the label in bytes, including the terminating null character.

`name` can be the short name (such as 'Wind') or the full path (such as 'parameter:/Ambience/Wind'). Path lookups will only succeed if the strings bank has been loaded.

If the label is longer than `size` then it is truncated and this function returns FMOD_ERR_TRUNCATED.

The `retrieved` parameter can be used to get the buffer size required to hold the full label.

## Studio::EventDescription::getPath

Retrieves the path.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getPath(
      char *path,
      int size,
      int *retrieved
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetPath(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      char *path,
      int size,
      int *retrieved
    );

    RESULT Studio.EventDescription.getPath(
      out string path
    );

    Studio.EventDescription.getPath(
      path,
      size,
      retrieved
    );

path Out Opt
  Buffer to receive the path. (UTF-8 string)
size
  Size of the path buffer in bytes. Must be 0 if `path` is null.
retrieved Out Opt
  Length of the path in bytes, including the terminating null character.

The strings bank must be loaded prior to calling this function, otherwise FMOD_ERR_EVENT_NOTFOUND is returned.

If the path is longer than `size` then it is truncated and this function returns FMOD_ERR_TRUNCATED.

The `retrieved` parameter can be used to get the buffer size required to hold the full path.

## Studio::EventDescription::getSampleLoadingState

Retrieves the sample data loading state.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getSampleLoadingState(
      FMOD_STUDIO_LOADING_STATE *state
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetSampleLoadingState(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_LOADING_STATE *state
    );

    RESULT Studio.EventDescription.getSampleLoadingState(
      out LOADING_STATE state
    );

    Studio.EventDescription.getSampleLoadingState(
      state
    );

state Out
  Loading state. (FMOD_STUDIO_LOADING_STATE)

If the event is invalid, then the state is set to FMOD_STUDIO_LOADING_STATE_UNLOADED and this function returns FMOD_ERR_INVALID_HANDLE.

See Also: Studio::EventDescription::loadSampleData, Studio::Bank::loadSampleData, Studio::EventDescription::createInstance, Sample Data Loading

## Studio::EventDescription::getSoundSize

Retrieves the sound size for 3D panning.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getSoundSize(
      float *size
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetSoundSize(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      float *size
    );

    RESULT Studio.EventDescription.getSoundSize(
      out float size
    );

    Studio.EventDescription.getSoundSize(
      size
    );

size Out
  Sound size.

Retrieves the largest Sound Size value of all Spatializers and 3D Object Spatializers on the event's master track. Returns zero if there are no Spatializers or 3D Object Spatializers.

See Also: Studio::EventDescription::is3D

## Studio::EventDescription::getUserData

Retrieves the event user data.

C
C++
C#
JS

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

    FMOD_RESULT FMOD_Studio_EventDescription_GetUserData(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      void **userdata
    );

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

    Studio.EventDescription.getUserData(
      userdata
    );

userdata Out
  User data set by calling Studio::EventDescription::setUserData.

## Studio::EventDescription::getUserProperty

Retrieves a user property by name.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getUserProperty(
      const char *name,
      FMOD_STUDIO_USER_PROPERTY *property
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetUserProperty(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      const char *name,
      FMOD_STUDIO_USER_PROPERTY *property
    );

    RESULT Studio.EventDescription.getUserProperty(
      string name,
      out USER_PROPERTY property
    );

    Studio.EventDescription.getUserProperty(
      name,
      property
    );

name
  User property name. (UTF-8 string)
property Out
  User property. (FMOD_STUDIO_USER_PROPERTY)

See Also: Studio::EventDescription::getUserPropertyCount, Studio::EventDescription::getUserPropertyByIndex

## Studio::EventDescription::getUserPropertyByIndex

Retrieves a user property by index.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getUserPropertyByIndex(
      int index,
      FMOD_STUDIO_USER_PROPERTY *property
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetUserPropertyByIndex(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int index,
      FMOD_STUDIO_USER_PROPERTY *property
    );

    RESULT Studio.EventDescription.getUserPropertyByIndex(
      int index,
      out USER_PROPERTY property
    );

    Studio.EventDescription.getUserPropertyByIndex(
      index,
      property
    );

index
  User property index.
property Out
  User property. (FMOD_STUDIO_USER_PROPERTY)

May be used in combination with Studio::EventDescription::getUserPropertyCount to enumerate event user properties.

See Also: Studio::EventDescription::getUserProperty

## Studio::EventDescription::getUserPropertyCount

Retrieves the number of user properties attached to the event.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::getUserPropertyCount(
      int *count
    );

    FMOD_RESULT FMOD_Studio_EventDescription_GetUserPropertyCount(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      int *count
    );

    RESULT Studio.EventDescription.getUserPropertyCount(
      out int count
    );

    Studio.EventDescription.getUserPropertyCount(
      count
    );

count Out
  User property count.

May be used in combination with Studio::EventDescription::getUserPropertyByIndex to enumerate event user properties.

See Also: Studio::EventDescription::getUserProperty

## Studio::EventDescription::hasSustainPoint

Retrieves whether the event has any sustain points.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::hasSustainPoint(
      bool *sustainPoint
    );

    FMOD_RESULT FMOD_Studio_EventDescription_HasSustainPoint(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *sustainPoint
    );

    RESULT Studio.EventDescription.hasSustainPoint(
      out bool sustainPoint
    );

    Studio.EventDescription.hasSustainPoint(
      sustainPoint
    );

sustainPoint Out

  Sustain point status. True if the event has one or more sustain points.

  - Units: Boolean

## Studio::EventDescription::is3D

Retrieves the event's 3D status.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::is3D(
      bool *is3d
    );

    FMOD_RESULT FMOD_Studio_EventDescription_Is3D(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *is3d
    );

    RESULT Studio.EventDescription.is3D(
      out bool is3d
    );

    Studio.EventDescription.is3D(
      is3d
    );

is3d Out

  3D status. True if the event is 3D.

  - Units: Boolean

An event is considered 3D if any of these conditions are met:

- The event has a Spatializer, 3D Object Spatializer, or a 3rd party spatializer on its master track.
- The event contains an automatic parameter that depends on the event's 3D attributes:
  - Distance
  - Event Cone Angle
  - Event Orientation
  - Direction
  - Elevation
- The event contains any nested events which are 3D.

Note: If the event contains nested events built to separate banks using versions of FMOD Studio prior to 2.00.10 and those banks have not been loaded then this function may fail to correctly determine the event's 3D status.

## Studio::EventDescription::isDopplerEnabled

Retrieves the event's doppler status.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::isDopplerEnabled(
      bool *doppler
    );

    FMOD_RESULT FMOD_Studio_EventDescription_IsDopplerEnabled(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *doppler
    );

    RESULT Studio.EventDescription.isDopplerEnabled(
      out bool doppler
    );

    Studio.EventDescription.isDopplerEnabled(
      doppler
    );

doppler Out

  Doppler status. True if doppler is enabled for the event.

  - Units: Boolean

Note: If the event was built to a bank using versions of FMOD Studio prior to 2.01.09, then this function will return false regardless of the event's doppler state.

## Studio::EventDescription::isOneshot

Retrieves the event's oneshot status.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::isOneshot(
      bool *oneshot
    );

    FMOD_RESULT FMOD_Studio_EventDescription_IsOneshot(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *oneshot
    );

    RESULT Studio.EventDescription.isOneshot(
      out bool oneshot
    );

    Studio.EventDescription.isOneshot(
      oneshot
    );

oneshot Out

  oneshot status. True if the event is a oneshot event.

  - Units: Boolean

An event is considered oneshot if it is guaranteed to terminate without intervention in bounded time after being started. Instances of such events can be played in a fire-and-forget fashion by calling Studio::EventInstance::start immediately followed by Studio::EventInstance::release.

Note: If the event contains nested events built to separate banks and those banks have not been loaded then this function may fail to correctly determine the event's oneshot status.

## Studio::EventDescription::isSnapshot

Retrieves the event's snapshot status.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::isSnapshot(
      bool *snapshot
    );

    FMOD_RESULT FMOD_Studio_EventDescription_IsSnapshot(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *snapshot
    );

    RESULT Studio.EventDescription.isSnapshot(
      out bool snapshot
    );

    Studio.EventDescription.isSnapshot(
      snapshot
    );

snapshot Out

  Snapshot status. True if the event is a snapshot.

  - Units: Boolean

## Studio::EventDescription::isStream

Retrieves the event's stream status.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::isStream(
      bool *isStream
    );

    FMOD_RESULT FMOD_Studio_EventDescription_IsStream(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_BOOL *isStream
    );

    RESULT Studio.EventDescription.isStream(
      out bool isStream
    );

    Studio.EventDescription.isStream(
      isStream
    );

isStream Out

  Stream status. True if the event contains one or more streamed sounds.

  - Units: Boolean

Note: If the event contains nested events built to separate banks and those banks have not been loaded then this function may fail to correctly determine the event's stream status.

## Studio::EventDescription::isValid

Checks that the EventDescription reference is valid.

C
C++
C#
JS

    bool Studio::EventDescription::isValid()

    bool FMOD_Studio_EventDescription_IsValid(FMOD_STUDIO_EVENTDESCRIPTION *eventdescription)

    bool Studio.EventDescription.isValid()

    Studio.EventDescription.isValid()

## Studio::EventDescription::loadSampleData

Loads non-streaming sample data used by the event.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::loadSampleData();

    FMOD_RESULT FMOD_Studio_EventDescription_LoadSampleData(FMOD_STUDIO_EVENTDESCRIPTION *eventdescription);

    RESULT Studio.EventDescription.loadSampleData();

    Studio.EventDescription.loadSampleData();

This function will load all non-streaming sample data required by the event and any referenced events.

Sample data is loaded asynchronously, Studio::EventDescription::getSampleLoadingState may be used to poll the loading state.

See Also: Studio::EventDescription::unloadSampleData, Sample Data Loading

## Studio::EventDescription::releaseAllInstances

Releases all instances.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::releaseAllInstances();

    FMOD_RESULT FMOD_Studio_EventDescription_ReleaseAllInstances(FMOD_STUDIO_EVENTDESCRIPTION *eventdescription);

    RESULT Studio.EventDescription.releaseAllInstances();

    Studio.EventDescription.releaseAllInstances();

This function immediately stops and releases all instances of the event.

See Also: Studio::EventInstance::release

## Studio::EventDescription::setCallback

Sets the user callback.

C
C++
C#
JS

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

    FMOD_RESULT FMOD_Studio_EventDescription_SetCallback(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      FMOD_STUDIO_EVENT_CALLBACK callback,
      FMOD_STUDIO_EVENT_CALLBACK_TYPE callbackmask
    );

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

    Studio.EventDescription.setCallback(
      callback,
      callbackmask
    );

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

This function sets a user callback which will be assigned to all event instances subsequently created from the event. The callback for individual instances can be set with Studio::EventInstance::setCallback.

See Event Callbacks for more information about when callbacks occur.

See Also: Callback Behavior

## Studio::EventDescription::setUserData

Sets the event user data.

C
C++
C#
JS

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

    FMOD_RESULT FMOD_Studio_EventDescription_SetUserData(
      FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
      void *userdata
    );

    RESULT Studio.EventDescription.setUserData(
      IntPtr userdata
    );

    Studio.EventDescription.setUserData(
      userdata
    );

userdata
  User data.

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

## Studio::EventDescription::unloadSampleData

Unloads all non-streaming sample data.

C
C++
C#
JS

    FMOD_RESULT Studio::EventDescription::unloadSampleData();

    FMOD_RESULT FMOD_Studio_EventDescription_UnloadSampleData(FMOD_STUDIO_EVENTDESCRIPTION *eventdescription);

    RESULT Studio.EventDescription.unloadSampleData();

    Studio.EventDescription.unloadSampleData();

Sample data will not be unloaded until all instances of the event are released.

See Also: Studio::EventDescription::loadSampleData, Sample Data Loading

## FMOD_STUDIO_USER_PROPERTY

Describes a user property.

C
C++
C#
JS

    typedef struct FMOD_STUDIO_USER_PROPERTY {
      const char                      *name;
      FMOD_STUDIO_USER_PROPERTY_TYPE   type;
      union
      {
          int                              intvalue;
          FMOD_BOOL                        boolvalue;
          float                            floatvalue;
          const char                      *stringvalue;
      }
    } FMOD_STUDIO_USER_PROPERTY;

    struct USER_PROPERTY
    {
        StringWrapper name;
        USER_PROPERTY_TYPE type;
        int intvalue;
        bool boolvalue;
        float floatvalue;
        string stringvalue;
    }

    FMOD_STUDIO_USER_PROPERTY
    {
      name,
      type,
      intvalue,
      boolvalue,
      floatvalue,
      stringvalue,
    };

name
  Property name. (UTF-8 string)
type
  Property type. (FMOD_STUDIO_USER_PROPERTY_TYPE)
intvalue
  Integer value. Only valid when type is FMOD_STUDIO_USER_PROPERTY_TYPE_INTEGER.
boolvalue

  Boolean value. Only valid when type is FMOD_STUDIO_USER_PROPERTY_TYPE_BOOLEAN.

  - Units: Boolean
floatvalue
  Floating point value. Only valid when type is FMOD_STUDIO_USER_PROPERTY_TYPE_FLOAT.
stringvalue
  String value. Only valid when type is FMOD_STUDIO_USER_PROPERTY_TYPE_STRING.

See Also: Studio::EventDescription::getUserProperty

## FMOD_STUDIO_USER_PROPERTY_TYPE

User property types.

C
C++
C#
JS

    typedef enum FMOD_STUDIO_USER_PROPERTY_TYPE {
      FMOD_STUDIO_USER_PROPERTY_TYPE_INTEGER,
      FMOD_STUDIO_USER_PROPERTY_TYPE_BOOLEAN,
      FMOD_STUDIO_USER_PROPERTY_TYPE_FLOAT,
      FMOD_STUDIO_USER_PROPERTY_TYPE_STRING
    } FMOD_STUDIO_USER_PROPERTY_TYPE;

    enum USER_PROPERTY_TYPE
    {
        INTEGER,
        BOOLEAN,
        FLOAT,
        STRING,
    }

    STUDIO_USER_PROPERTY_TYPE_INTEGER
    STUDIO_USER_PROPERTY_TYPE_BOOLEAN
    STUDIO_USER_PROPERTY_TYPE_FLOAT
    STUDIO_USER_PROPERTY_TYPE_STRING

FMOD_STUDIO_USER_PROPERTY_TYPE_INTEGER
  Integer.
FMOD_STUDIO_USER_PROPERTY_TYPE_BOOLEAN
  Boolean.
FMOD_STUDIO_USER_PROPERTY_TYPE_FLOAT
  Floating point number.
FMOD_STUDIO_USER_PROPERTY_TYPE_STRING
  String.

See Also: FMOD_STUDIO_USER_PROPERTY