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::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::hasCue Retrieves whether the event has any sustain points.
• Studio::EventDescription::getMaximumDistance Retrieves the maximum distance for 3D attenuation.
• Studio::EventDescription::getMinimumDistance Retrieves the minimum distance 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.

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.

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.

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.

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.

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 OutOpt

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.

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::getMaximumDistance

Retrieves the maximum distance for 3D attenuation.

FMOD_RESULT Studio::EventDescription::getMaximumDistance(
  float *distance
);

FMOD_RESULT FMOD_Studio_EventDescription_GetMaximumDistance(
  FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
  float *distance
);

RESULT Studio.EventDescription.getMaximumDistance(
  out float distance
);

Studio.EventDescription.getMaximumDistance(
  distance
);

distance Out

Maximum distance.

• Units: Distance units

Retrieves the largest maximum distance value of all FMOD Spatializers FMOD_DSP_TYPE_PAN and FMOD Object Spatializers FMOD_DSP_TYPE_OBJECTPAN on the event's master track. Returns zero if none are found. This function is not compatible with third party spatializers.

See Also: Studio::EventDescription::getMinimumDistance

Studio::EventDescription::getMinimumDistance

Retrieves the minimum distance for 3D attenuation.

FMOD_RESULT Studio::EventDescription::getMinimumDistance(
  float *distance
);

FMOD_RESULT FMOD_Studio_EventDescription_GetMinimumDistance(
  FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
  float *distance
);

RESULT Studio.EventDescription.getMinimumDistance(
  out float distance
);

Studio.EventDescription.getMinimumDistance(
  distance
);

distance Out

Minimum distance.

• Units: Distance units

Retrieves the smallest minimum distance value of all FMOD Spatializers FMOD_DSP_TYPE_PAN and FMOD Object Spatializers FMOD_DSP_TYPE_OBJECTPAN on the event's master track. Returns zero if none are found. This function is not compatible with third party spatializers.

See Also: Studio::EventDescription::getMaximumDistance

Studio::EventDescription::getParameterDescriptionByID

Retrieves an event parameter description by id.

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.

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.

Studio::EventDescription::getParameterDescriptionByName

Retrieves an event parameter description by name.

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.

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::getPath

Retrieves the path.

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 OutOpt

Buffer to receive the path. (UTF-8 string)

size

Size of the path buffer in bytes. Must be 0 if path is null.

retrieved OutOpt

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.

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.

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.

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.

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.

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.

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::hasCue

Retrieves whether the event has any sustain points.

FMOD_RESULT Studio::EventDescription::hasCue(
  bool *cue
);

FMOD_RESULT FMOD_Studio_EventDescription_HasCue(
  FMOD_STUDIO_EVENTDESCRIPTION *eventdescription,
  FMOD_BOOL *cue
);

RESULT Studio.EventDescription.hasCue(
  out bool cue
);

Studio.EventDescription.hasCue(
  cue
);

cue Out

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

• Units: Boolean

Studio::EventDescription::is3D

Retrieves the event's 3D status.

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::isOneshot

Retrieves the event's oneshot status.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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