A Fader is a processor that is used for volume controls and pan. More...

#include <src/structure/tracks/fader.h>

Inheritance diagram for zrythm::structure::tracks::Fader:

[legend]

Collaboration diagram for zrythm::structure::tracks::Fader:

[legend]

Public Types
enum class	MidiFaderMode : basic_enum_base_type_t { MIDI_FADER_MODE_VEL_MULTIPLIER , MIDI_FADER_MODE_CC_VOLUME }
using	ShouldBeMutedCallback = std::function<bool (bool fader_solo_status)>
	A callback to check if the fader should be muted based on various external factors (such as solo status of other tracks).
using	MuteGainCallback = std::function<float ()>
	Callback to get the gain that should be used if the fader is effectively muted.
using	PreProcessAudioCallback
	Callback to pre-process the incoming audio before applying gain, pan, etc.

Public Member Functions
	Fader (dsp::ProcessorBase::ProcessorBaseDependencies dependencies, dsp::PortType signal_type, bool hard_limit_output, bool make_params_automatable, std::optional< std::function< utils::Utf8String()> > owner_name_provider, ShouldBeMutedCallback should_be_muted_cb, QObject *parent=nullptr)
	Creates a new fader.
MidiFaderMode	midiMode () const
void	setMidiMode (MidiFaderMode mode)
Q_SIGNAL void	midiModeChanged (MidiFaderMode mode)
zrythm::dsp::ProcessorParameter *	gain () const
zrythm::dsp::ProcessorParameter *	balance () const
zrythm::dsp::ProcessorParameter *	mute () const
zrythm::dsp::ProcessorParameter *	solo () const
zrythm::dsp::ProcessorParameter *	listen () const
zrythm::dsp::ProcessorParameter *	monoToggle () const
zrythm::dsp::ProcessorParameter *	swapPhaseToggle () const
bool	currently_muted () const
	Returns if the fader is muted.
bool	currently_soloed () const
	Returns if the track is soloed.
bool	currently_listened () const
	Returns whether the fader is listened.
float	get_current_amp () const
	Gets the fader amplitude (not db)
std::string	db_string_getter () const
void	set_mute_gain_callback (MuteGainCallback cb)
void	set_preprocess_audio_callback (PreProcessAudioCallback cb)
void	custom_prepare_for_processing (sample_rate_t sample_rate, nframes_t max_block_length) override
void	custom_release_resources () override
void	custom_process_block (EngineProcessTimeInfo time_nfo) noexcept override
	Custom processor logic after processing all owned parameters.
bool	is_audio () const
bool	is_midi () const
bool	hard_limiting_enabled () const
dsp::ProcessorParameter &	get_amp_param () const
dsp::ProcessorParameter &	get_balance_param () const
dsp::ProcessorParameter &	get_mute_param () const
dsp::ProcessorParameter &	get_solo_param () const
dsp::ProcessorParameter &	get_listen_param () const
dsp::ProcessorParameter &	get_mono_compat_enabled_param () const
dsp::ProcessorParameter &	get_swap_phase_param () const
dsp::AudioPort &	get_stereo_in_port () const
dsp::AudioPort &	get_stereo_out_port () const
dsp::MidiPort &	get_midi_in_port () const
dsp::MidiPort &	get_midi_out_port () const
Public Member Functions inherited from zrythm::dsp::ProcessorBase
	ProcessorBase (ProcessorBaseDependencies dependencies, utils::Utf8String name={ u8"ProcessorBase" })
void	set_name (const utils::Utf8String &name)
	Set a custom name to be used in the DSP graph.
void	add_input_port (const dsp::PortUuidReference &uuid)
void	add_output_port (const dsp::PortUuidReference &uuid)
void	add_parameter (const dsp::ProcessorParameterUuidReference &uuid)
auto &	get_input_ports () const
auto &	get_output_ports () const
auto &	get_parameters () const
utils::Utf8String	get_node_name () const final
	Returns a human friendly name of the node.
void	process_block (EngineProcessTimeInfo time_nfo) noexcept final
	Calls custom_process_block() internally after processing all the parameters.
void	prepare_for_processing (sample_rate_t sample_rate, nframes_t max_block_length) final
	Called to allocate resources required for processing.
void	release_resources () final
	Called to release resources allocated by prepare_for_processing().
Public Member Functions inherited from zrythm::dsp::graph::IProcessable
virtual nframes_t	get_single_playback_latency () const
	Returns the latency of only the given processable, without adding the previous/next latencies.

Properties
MidiFaderMode	midiMode
zrythm::dsp::ProcessorParameter *	gain
zrythm::dsp::ProcessorParameter *	balance
zrythm::dsp::ProcessorParameter *	mute
zrythm::dsp::ProcessorParameter *	solo
zrythm::dsp::ProcessorParameter *	listen
zrythm::dsp::ProcessorParameter *	monoToggle
zrythm::dsp::ProcessorParameter *	swapPhaseToggle

Friends
void	init_from (Fader &obj, const Fader &other, utils::ObjectCloneType clone_type)
void	to_json (nlohmann::json &j, const Fader &fader)
void	from_json (const nlohmann::json &j, Fader &fader)

Additional Inherited Members
Protected Member Functions inherited from zrythm::dsp::ProcessorBase
auto	dependencies () const

Detailed Description

A Fader is a processor that is used for volume controls and pan.

Definition at line 20 of file fader.h.

Member Typedef Documentation

◆ MuteGainCallback

using zrythm::structure::tracks::Fader::MuteGainCallback = std::function<float ()>

Callback to get the gain that should be used if the fader is effectively muted.

Definition at line 80 of file fader.h.

◆ PreProcessAudioCallback

using zrythm::structure::tracks::Fader::PreProcessAudioCallback

Initial value:

 std::function<void (
    std::pair<std::span<float>, std::span<float>> stereo_bufs,
    const EngineProcessTimeInfo                  &time_nfo)>

Callback to pre-process the incoming audio before applying gain, pan, etc.

Mainly for use by the monitor fader.

Definition at line 88 of file fader.h.

◆ ShouldBeMutedCallback

using zrythm::structure::tracks::Fader::ShouldBeMutedCallback = std::function<bool (bool fader_solo_status)>

A callback to check if the fader should be muted based on various external factors (such as solo status of other tracks).

Note: If the fader itself is muted this will not be called - fader is assumed to be muted.

Parameters

current_solo_status The fader's own solo status.

Definition at line 74 of file fader.h.

Member Enumeration Documentation

◆ MidiFaderMode

enum class zrythm::structure::tracks::Fader::MidiFaderMode : basic_enum_base_type_t

strong

Enumerator
MIDI_FADER_MODE_VEL_MULTIPLIER	Multiply velocity of all MIDI note ons.
MIDI_FADER_MODE_CC_VOLUME	Send CC volume event on change TODO.

Definition at line 54 of file fader.h.

Constructor & Destructor Documentation

◆ Fader()

zrythm::structure::tracks::Fader::Fader	(	dsp::ProcessorBase::ProcessorBaseDependencies	dependencies,
		dsp::PortType	signal_type,
		bool	hard_limit_output,
		bool	make_params_automatable,
		std::optional< std::function< utils::Utf8String()> >	owner_name_provider,
		ShouldBeMutedCallback	should_be_muted_cb,
		QObject *	parent = nullptr )

Creates a new fader.

Parameters

hard_limit_output	Whether the output should be hard-limited (only applies to audio faders). This should be true for the master track fader, the monitor fader and the sample processor (deprecated?) fader.
make_params_automatable	Whether to make (a subset of) the parameters automatable. If false, no parameter will be automatable.

Member Function Documentation

◆ balance()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::balance ( ) const

inline

Definition at line 133 of file fader.h.

◆ currently_listened()

bool zrythm::structure::tracks::Fader::currently_listened ( ) const

inline

Returns whether the fader is listened.

Definition at line 205 of file fader.h.

◆ currently_muted()

bool zrythm::structure::tracks::Fader::currently_muted ( ) const

inline

Returns if the fader is muted.

Definition at line 187 of file fader.h.

◆ currently_soloed()

bool zrythm::structure::tracks::Fader::currently_soloed ( ) const

inline

Returns if the track is soloed.

Definition at line 196 of file fader.h.

◆ custom_prepare_for_processing()

void zrythm::structure::tracks::Fader::custom_prepare_for_processing	(	sample_rate_t	sample_rate,
		nframes_t	max_block_length )

overridevirtual

Reimplemented from zrythm::dsp::ProcessorBase.

◆ custom_process_block()

void zrythm::structure::tracks::Fader::custom_process_block ( EngineProcessTimeInfo time_nfo )

overridevirtualnoexcept

Custom processor logic after processing all owned parameters.

By default, this does passthrough to same-type ports.

Reimplemented from zrythm::dsp::ProcessorBase.

◆ custom_release_resources()

void zrythm::structure::tracks::Fader::custom_release_resources ( )

overridevirtual

Reimplemented from zrythm::dsp::ProcessorBase.

◆ gain()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::gain ( ) const

inline

Definition at line 125 of file fader.h.

◆ get_amp_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_amp_param ( ) const

inline

Definition at line 255 of file fader.h.

◆ get_balance_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_balance_param ( ) const

inline

Definition at line 260 of file fader.h.

◆ get_current_amp()

float zrythm::structure::tracks::Fader::get_current_amp ( ) const

inline

Gets the fader amplitude (not db)

Definition at line 214 of file fader.h.

◆ get_listen_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_listen_param ( ) const

inline

Definition at line 275 of file fader.h.

◆ get_midi_in_port()

dsp::MidiPort & zrythm::structure::tracks::Fader::get_midi_in_port ( ) const

inline

Definition at line 307 of file fader.h.

◆ get_midi_out_port()

dsp::MidiPort & zrythm::structure::tracks::Fader::get_midi_out_port ( ) const

inline

Definition at line 311 of file fader.h.

◆ get_mono_compat_enabled_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_mono_compat_enabled_param ( ) const

inline

Definition at line 280 of file fader.h.

◆ get_mute_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_mute_param ( ) const

inline

Definition at line 265 of file fader.h.

◆ get_solo_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_solo_param ( ) const

inline

Definition at line 270 of file fader.h.

◆ get_stereo_in_port()

dsp::AudioPort & zrythm::structure::tracks::Fader::get_stereo_in_port ( ) const

inline

Definition at line 291 of file fader.h.

◆ get_stereo_out_port()

dsp::AudioPort & zrythm::structure::tracks::Fader::get_stereo_out_port ( ) const

inline

Definition at line 299 of file fader.h.

◆ get_swap_phase_param()

dsp::ProcessorParameter & zrythm::structure::tracks::Fader::get_swap_phase_param ( ) const

inline

Definition at line 286 of file fader.h.

◆ hard_limiting_enabled()

bool zrythm::structure::tracks::Fader::hard_limiting_enabled ( ) const

inline

Definition at line 250 of file fader.h.

◆ is_audio()

bool zrythm::structure::tracks::Fader::is_audio ( ) const

inline

Definition at line 247 of file fader.h.

◆ is_midi()

bool zrythm::structure::tracks::Fader::is_midi ( ) const

inline

Definition at line 248 of file fader.h.

◆ listen()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::listen ( ) const

inline

Definition at line 157 of file fader.h.

◆ midiMode()

MidiFaderMode zrythm::structure::tracks::Fader::midiMode ( ) const

inline

Definition at line 114 of file fader.h.

◆ monoToggle()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::monoToggle ( ) const

inline

Definition at line 165 of file fader.h.

◆ mute()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::mute ( ) const

inline

Definition at line 141 of file fader.h.

◆ set_mute_gain_callback()

void zrythm::structure::tracks::Fader::set_mute_gain_callback ( MuteGainCallback cb )

inline

Definition at line 222 of file fader.h.

◆ set_preprocess_audio_callback()

void zrythm::structure::tracks::Fader::set_preprocess_audio_callback ( PreProcessAudioCallback cb )

inline

Definition at line 227 of file fader.h.

◆ setMidiMode()

void zrythm::structure::tracks::Fader::setMidiMode ( MidiFaderMode mode )

inline

Definition at line 115 of file fader.h.

◆ solo()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::solo ( ) const

inline

Definition at line 149 of file fader.h.

◆ swapPhaseToggle()

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::swapPhaseToggle ( ) const

inline

Definition at line 173 of file fader.h.

◆ to_json

void to_json	(	nlohmann::json &	j,
		const Fader &	fader )

friend

Definition at line 318 of file fader.h.

Property Documentation

◆ balance

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::balance

read

Definition at line 26 of file fader.h.

◆ gain

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::gain

read

Definition at line 25 of file fader.h.

◆ listen

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::listen

read

Definition at line 29 of file fader.h.

◆ midiMode

MidiFaderMode zrythm::structure::tracks::Fader::midiMode

readwrite

Definition at line 23 of file fader.h.

◆ monoToggle

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::monoToggle

read

Definition at line 30 of file fader.h.

◆ mute

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::mute

read

Definition at line 27 of file fader.h.

◆ solo

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::solo

read

Definition at line 28 of file fader.h.

◆ swapPhaseToggle

zrythm::dsp::ProcessorParameter * zrythm::structure::tracks::Fader::swapPhaseToggle

read

Definition at line 32 of file fader.h.

The documentation for this class was generated from the following file:

src/structure/tracks/fader.h

Public Types

Public Member Functions

Properties

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ MuteGainCallback

◆ PreProcessAudioCallback

◆ ShouldBeMutedCallback

Member Enumeration Documentation

◆ MidiFaderMode

Constructor & Destructor Documentation

◆ Fader()

Member Function Documentation

◆ balance()

◆ currently_listened()

◆ currently_muted()

◆ currently_soloed()

◆ custom_prepare_for_processing()

◆ custom_process_block()

◆ custom_release_resources()

◆ gain()

◆ get_amp_param()

◆ get_balance_param()

◆ get_current_amp()

◆ get_listen_param()

◆ get_midi_in_port()

◆ get_midi_out_port()

◆ get_mono_compat_enabled_param()

◆ get_mute_param()

◆ get_solo_param()

◆ get_stereo_in_port()

◆ get_stereo_out_port()

◆ get_swap_phase_param()

◆ hard_limiting_enabled()

◆ is_audio()

◆ is_midi()

◆ listen()

◆ midiMode()

◆ monoToggle()

◆ mute()

◆ set_mute_gain_callback()

◆ set_preprocess_audio_callback()

◆ setMidiMode()

◆ solo()

◆ swapPhaseToggle()

Friends And Related Symbol Documentation

◆ to_json

Property Documentation

◆ balance

◆ gain

◆ listen

◆ midiMode

◆ monoToggle

◆ mute

◆ solo

◆ swapPhaseToggle