Struct Dsp 

pub struct Dsp { /* private fields */ }

A digital signal processor is one node within a graph that transforms input audio signals into an output stream.

Create with System::create_dsp, System::create_dsp_by_type or System::create_dsp_by_plugin.

Implementations

impl Dsp

pub fn set_callback<C: DspCallback>(&self) -> Result<()>

Sets the callback for DSP notifications.

impl Dsp

pub fn set_channel_format( &self, channel_mask: ChannelMask, channel_count: c_int, source_speaker_mode: SpeakerMode, ) -> Result<()>

Sets the PCM input format this Dsp will receive when processing.

Setting the number of channels on a unit will force either a down or up mix to that channel count before processing the Dsp read/process callback.

pub fn get_channel_format(&self) -> Result<(ChannelMask, c_int, SpeakerMode)>

Retrieves the PCM input format this Dsp will receive when processing.

pub fn get_output_channel_format( &self, in_mask: ChannelMask, in_channels: c_int, in_speaker_mode: SpeakerMode, ) -> Result<(ChannelMask, c_int, SpeakerMode)>

Retrieves the output format this Dsp will produce when processing based on the input specified.

impl Dsp

pub fn add_input( &self, input: Dsp, kind: DspConnectionType, ) -> Result<DspConnection>

Adds a Dsp unit as an input to this object.

When a Dsp has multiple inputs the signals are automatically mixed together, sent to the unit’s output(s).

The returned DspConnection will remain valid until the units are disconnected.

pub fn get_input(&self, index: c_int) -> Result<(Dsp, DspConnection)>

Retrieves the Dsp unit at the specified index in the input list.

This will flush the Dsp queue (which blocks against the mixer) to ensure the input list is correct, avoid this during time sensitive operations.

The returned DspConnection will remain valid until the units are disconnected.

pub fn get_output(&self, index: c_int) -> Result<(Dsp, DspConnection)>

Retrieves the Dsp unit at the specified index in the output list.

This will flush the Dsp queue (which blocks against the mixer) to ensure the output list is correct, avoid this during time sensitive operations.

The returned DspConnection will remain valid until the units are disconnected.

pub fn get_input_count(&self) -> Result<c_int>

Retrieves the number of Dsp units in the input list.

This will flush the Dsp queue (which blocks against the mixer) to ensure the input list is correct, avoid this during time sensitive operations.

pub fn get_output_count(&self) -> Result<c_int>

Retrieves the number of Dsp units in the output list.

This will flush the Dsp queue (which blocks against the mixer) to ensure the output list is correct, avoid this during time sensitive operations.

pub fn disconnect_all(&self, inputs: bool, outputs: bool) -> Result<()>

Disconnects all inputs and/or outputs.

This is a convenience function that is faster than disconnecting all inputs and outputs individually.

pub fn disconnect_from( &self, target: Option<Dsp>, connection: Option<DspConnection>, ) -> Result<()>

Disconnect the specified input Dsp.

If target had only one output, after this operation that entire sub graph will no longer be connected to the Dsp network.

After this operation connection is no longer valid.

impl Dsp

pub unsafe fn show_config_dialogue( &self, hwnd: *mut c_void, show: bool, ) -> Result<()>

Display or hide a DSP unit configuration dialog box inside the target window.

Some DSP plug-ins (especially VST plug-ins) use dialog boxes to display graphical user interfaces for modifying their parameters, rather than using the other method of enumerating their parameters and setting them with Dsp::set_parameter.

To find out what size window to create to store the configuration screen, use Dsp::get_info where you can get the width and height.

Safety

hwnd must be a valid window pointer. On Windows, this would be a HWND, on X11 a window id, etc.

pub fn reset(&self) -> Result<()>

Reset a DSPs internal state ready for new input signal.

This will clear all internal state derived from input signal while retaining any set parameter values. The intended use of the function is to avoid audible artifacts if moving the Dsp from one part of the Dsp network to another.

pub fn release(&self) -> Result<()>

Frees a Dsp object.

If Dsp is not removed from the network with ChannelControl::removeDSP after being added with ChannelControl::addDSP, it will not release and will instead return FMOD_RESULT::FMOD_ERR_DSP_INUSE.

pub fn get_type(&self) -> Result<DspType>

Retrieves the pre-defined type of a FMOD registered Dsp unit.

pub fn get_info(&self) -> Result<DspInfo>

Retrieves information about this DSP unit.

pub fn get_cpu_usage(&self) -> Result<(c_uint, c_uint)>

Retrieves statistics on the mixer thread CPU usage for this unit.

crate::InitFlags::PROFILE_ENABLE with crate::SystemBuilder::new is required to call this function.

pub fn set_userdata(&self, userdata: *mut c_void) -> Result<()>

Sets the user data.

pub fn get_userdata(&self) -> Result<*mut c_void>

Retrieves user data.

pub fn get_system(&self) -> Result<System>

Retrieves the parent System object.

impl Dsp

pub fn get_metering_info(&self) -> Result<(DspMeteringInfo, DspMeteringInfo)>

Retrieve the signal metering information.

Requesting metering information when it hasn’t been enabled will result in FMOD_RESULT::FMOD_ERR_BADCOMMAND.

FMOD_INIT_PROFILE_METER_ALL with SystemBuilder::build will automatically enable metering for all Dsp units.

pub fn set_metering_enabled( &self, input_enabled: bool, output_enabled: bool, ) -> Result<()>

Sets the input and output signal metering enabled states.

Input metering is pre processing, while output metering is post processing.

Enabled metering allows Dsp::get_metering_info to return metering information and allows FMOD profiling tools to visualize the levels.

FMOD_INIT_PROFILE_METER_ALL with SystemBuilder::build will automatically turn on metering for all Dsp units inside the mixer graph.

This function must have inputEnabled and outputEnabled set to true if being used by the FMOD Studio API, such as in the Unity or Unreal Engine integrations, in order to avoid conflict with FMOD Studio’s live update feature.

pub fn get_metering_enabled(&self) -> Result<(bool, bool)>

Retrieves the input and output signal metering enabled states.

Input metering is pre processing, while output metering is post processing.

Enabled metering allows Dsp::get_metering_info to return metering information and allows FMOD profiling tools to visualize the levels.

FMOD_INIT_PROFILE_METER_ALL with SystemBuilder::build will automatically turn on metering for all Dsp units inside the mixer graph.

impl Dsp

pub fn get_data_parameter_index( &self, data_type: DspParameterDataType, ) -> Result<c_int>

Retrieve the index of the first data parameter of a particular data type.

This function returns Ok if a parmeter of matching type is found and FMOD_RESULT::FMOD_ERR_INVALID_PARAM if no matches were found.

The return code can be used to check whether the Dsp supports specific functionality through data parameters of certain types without the need to provide index.

pub fn get_parameter_count(&self) -> Result<c_int>

Retrieves the number of parameters exposed by this unit.

Use this to enumerate all parameters of a Dsp unit with Dsp::get_parameter_info.

pub fn get_parameter_info( &self, index: c_int, ) -> Result<DspParameterDescription>

Retrieve information about a specified parameter.

pub fn get_raw_parameter_info( &self, index: c_int, ) -> Result<FMOD_DSP_PARAMETER_DESC>

Retrieve information about a specified parameter.

Returns the raw struct, useful if you don’t want to pay for the expensive pointer copies that converting a FMOD_DSP_PARAMETER_DESC to a DspParameterDescription would entail.

pub fn set_parameter<I, P>(&self, index: I, parameter: P) -> Result<()>

where I: WritableParameterIndex<P>, P: WritableParameter,

Sets a parameter by index.

The parameter must be writable and index must be a type that impls WritableParameterIndex<P>. Notably, c_int impls WritableParameterIndex<T> for any T.

pub fn get_parameter<I, P>(&self, index: I) -> Result<P>

where I: ReadableParameterIndex<P>, P: ReadableParameter,

Gets a parameter by index.

The parameter must be readable and index must be a type that impls ReadableParameterIndex<P>. Notably, c_int impls ReadableParameterIndex<T> for any T.

pub fn get_parameter_string<P, I>(&self, index: I) -> Result<Utf8CString>

where I: ReadableParameterIndex<P>, P: ReadableParameter,

Gets a parameter by index.

The parameter must be readable and index must be a type that impls ReadableParameterIndex<P>. Notably, c_int impls ReadableParameterIndex<T> for any T.

impl Dsp

pub fn set_active(&self, active: bool) -> Result<()>

Sets the processing active state.

If active is false, processing of this unit and its inputs are stopped.

When created a Dsp is inactive. If ChannelControl::addDSP is used it will automatically be activated, otherwise it must be set to active manually.

pub fn get_active(&self) -> Result<bool>

Retrieves the processing active state.

If active is False, processing of this unit and its inputs are stopped.

When created a Dsp is inactive. If ChannelControl::addDSP is used it will automatically be activated, otherwise it must be set to active manually.

pub fn set_bypass(&self, bypass: bool) -> Result<()>

Sets the processing bypass state.

If bypass is true, processing of this unit is skipped but it continues to process its inputs.

pub fn get_bypass(&self) -> Result<bool>

Retrieves the processing bypass state.

If bypass is true, processing of this unit is skipped but it continues to process its inputs.

pub fn set_wet_dry_mix( &self, pre_wet: c_float, post_wet: c_float, dry: c_float, ) -> Result<()>

Sets the scale of the wet and dry signal components.

The dry signal path is silent by default, because dsp effects transform the input and pass the newly processed result to the output.

pub fn get_wet_dry_mix(&self) -> Result<(c_float, c_float, c_float)>

Retrieves the scale of the wet and dry signal components.

pub fn get_idle(&self) -> Result<bool>

Retrieves the idle state.

A Dsp is considered idle when it stops receiving input signal and all internal processing of stored input has been exhausted.

Each Dsp type has the potential to have differing idle behaviour based on the type of effect. A reverb or echo may take a longer time to go idle after it stops receiving a valid signal, compared to an effect with a shorter tail length like an EQ filter.

impl Dsp

pub unsafe fn from_ffi(value: *mut FMOD_DSP) -> Self

Safety

value must be a valid pointer either aquired from Self::as_ptr or FMOD.

Panics

Panics if value is null.

pub fn as_ptr(self) -> *mut FMOD_DSP

Converts self into its raw representation.

Trait Implementations

impl Clone for Dsp

fn clone(&self) -> Dsp

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Dsp

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Dsp> for *mut FMOD_DSP

fn from(value: Dsp) -> Self

Converts to this type from the input type.

impl Hash for Dsp

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Dsp

fn eq(&self, other: &Dsp) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Dsp

impl Eq for Dsp

impl Send for Dsp

Available on non-crate feature thread-unsafe only.

impl StructuralPartialEq for Dsp

impl Sync for Dsp

Available on non-crate feature thread-unsafe only.