Unigine.Plugins.FMOD.Channel Class
Notice
This set of functions is available when the FMOD plugin is loaded.
A source of audio signal that connects to the ChannelGroup mixing hierarchy.
Channel Class
Properties
float Pitch#
The Pitch value: 0.5f represents half pitch (one octave down), 1.0f represents unmodified pitch and 2.0f represents double pitch (one octave up).
float Frequency#
The Playback frequency.
bool Paused#
The true if the channel is paused; otherwise, false.
int Priority#
The Priority: 0 means the most important, 256 means the least important.
bool Mute#
The Mute state. true for silent, false for audible.
int LoopCount#
The Times to loop before stopping : 0 means oneshot, 1 means loop once then stop and -1 represents loop forever.
float Volume#
The volume level.
bool VolumeRamp#
The true if volume change is ramped; false if volume change is instantaeous.
bool IsPlaying#
The current playing state.
float Audibility#
The estimation of the output volume. The estimated volume is calculated based on 3D spatialization, occlusion, API volume levels and DSPs used. This value is used to determine which Channels should be audible and which Channels should be virtualized when resources are limited.
bool IsVirtual#
The Virtual state. true means silent / emulated, false means audible / real.
Members
void Stop ( ) #
Stops the Channel (or all Channels in nested ChannelGroups) from playing.void SetMinMaxDistance ( float min, float max ) #
Sets the minimum and maximum distances used to calculate the 3D rolloff attenuation.Arguments
- float min - Distance from the source where attenuation begins. Range: [0; max]. Default: 1
- float max - Distance from the source where attenuation ends. Range: [min; inf]. Default: 10000.
void SetPosition ( vec3 position ) #
Sets the 3D position used to apply panning and attenuation.Arguments
- vec3 position - Position in 3D space used for panning and attenuation.
void SetPositionTimeLine ( uint position, FMODEnums.TIME_UNIT time_unit ) #
Sets the current playback position.Arguments
- uint position - Playback position.
- FMODEnums.TIME_UNIT time_unit - Time units for position.
void GetPositionTimeLine ( out uint position, FMODEnums.TIME_UNIT time_unit ) #
Returns the current playback position.Arguments
- out uint position - Playback position.
- FMODEnums.TIME_UNIT time_unit - Time units for position.
void Release ( ) #
Releases the channel object.void SetVelocity ( vec3 velocity ) #
Sets the velocity used to apply doppler.Arguments
- vec3 velocity - Velocity in 3D space used for doppler.
DSP AddDSP ( int index, DSPType.TYPE dsp_type ) #
Adds a DSP unit to the specified index in the DSP chain.Arguments
- int index - Offset into the DSP chain.
- DSPType.TYPE dsp_type - Type of the DSP.
Return value
Added DSP.void RemoveDSP ( int index ) #
Removes the specified DSP unit from the DSP chain.Arguments
- int index - Index of the DSP unit.
DSP GetDSP ( int index ) #
Returns the DSP unit at the specified index in the DSP chain.Arguments
- int index - Index of the DSP unit.
Return value
DSP unit at the specified index.void SetPan ( float pan ) #
Sets the left/right pan level.Arguments
- float pan - Pan level: -1 represents the full left, 0 represents the center, 1 represents the full right.
Last update:
2022-12-14
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)