Processor parameter that accepts automation and modulation sources and integrates with QML and the DSP graph. More...

#include <src/dsp/parameter.h>

Inheritance diagram for zrythm::dsp::ProcessorParameter:

[legend]

Collaboration diagram for zrythm::dsp::ProcessorParameter:

[legend]

Data Structures
struct	UniqueId

Public Types
using	Resolver
using	AutomationValueProvider
	Provides the automation value for a given sample position.

Public Member Functions
	ProcessorParameter (PortRegistry &port_registry, UniqueId unique_id, ParameterRange range, utils::Utf8String label, QObject *parent=nullptr)
QString	label () const
QString	description () const
bool	automatable () const
ParameterRange	range () const
float	baseValue () const
void	setBaseValue (float newValue)
Q_INVOKABLE void	resetBaseValueToDefault ()
Q_SIGNAL void	baseValueChanged (float value)
Q_INVOKABLE float	currentValue () const
	Returns the current (normalized) value after any automation and modulation has been applied.
Q_INVOKABLE float	valueAfterAutomationApplied () const
	Returns the value after automation, but before modulation has been applied.
Q_INVOKABLE void	beginUserGesture ()
Q_INVOKABLE void	endUserGesture ()
Q_SIGNAL void	userGestureStarted ()
Q_SIGNAL void	userGestureFinished ()
utils::Utf8String	get_node_name () const override
	Returns a human friendly name of the node.
void	process_block (EngineProcessTimeInfo time_nfo, const dsp::ITransport &transport, const dsp::TempoMap &tempo_map) noexcept override
	Processes automation and modulation.
void	prepare_for_processing (const graph::GraphNode *node, units::sample_rate_t sample_rate, nframes_t max_block_length) override
	Called to allocate resources required for processing.
void	release_resources () override
	Called to release resources allocated by prepare_for_processing().
void	set_automation_provider (AutomationValueProvider provider)
void	unset_automation_provider ()
PortUuidReference	get_modulation_input_port_ref () const
void	set_description (utils::Utf8String descr)
void	set_automatable (bool automatable)
const auto &	get_unique_id () const
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.
Public Member Functions inherited from zrythm::utils::UuidIdentifiableObject< ProcessorParameter >
UuidIdentifiableObject &	operator= (const UuidIdentifiableObject &other)=default
auto	get_uuid () const

Properties
float	baseValue
QString	label
QString	description
ParameterRange	range
bool	automatable

Friends
void	to_json (nlohmann::json &j, const ProcessorParameter &p)
void	from_json (const nlohmann::json &j, ProcessorParameter &p)

Detailed Description

Processor parameter that accepts automation and modulation sources and integrates with QML and the DSP graph.

While ProcessorParameter inherits from IProcessable, it is not part of the DSP graph and is expected to be processed manually by its processor.

Definition at line 216 of file parameter.h.

Member Typedef Documentation

◆ AutomationValueProvider

using zrythm::dsp::ProcessorParameter::AutomationValueProvider

Initial value:

std::function<std::optional<float> (units::sample_t sample_position)>

Provides the automation value for a given sample position.

Parameters

sample_position The sample position in the timeline to get the automation value for.

This allows for flexibility in how automation is obtained (e.g. call once to get the automation value for the entire cycle for efficiency, or call for each sample position for sample-accurate automation), or every few samples.

Returns: The normalized automation value (0.0-1.0) at the given sample position, or std::nullopt if no automation is available.

Definition at line 269 of file parameter.h.

◆ Resolver

using zrythm::dsp::ProcessorParameter::Resolver

Initial value:

std::function<QPointer<ProcessorParameter> (const UniqueId &unique_id)>

zrythm::dsp::ProcessorParameter::UniqueId

Definition parameter.h:235

Definition at line 246 of file parameter.h.

Member Function Documentation

◆ automatable()

bool zrythm::dsp::ProcessorParameter::automatable ( ) const

inline

Definition at line 278 of file parameter.h.

◆ baseValue()

float zrythm::dsp::ProcessorParameter::baseValue ( ) const

inline

Definition at line 282 of file parameter.h.

◆ beginUserGesture()

Q_INVOKABLE void zrythm::dsp::ProcessorParameter::beginUserGesture ( )

inline

Definition at line 314 of file parameter.h.

◆ currentValue()

Q_INVOKABLE float zrythm::dsp::ProcessorParameter::currentValue ( ) const

inline

Returns the current (normalized) value after any automation and modulation has been applied.

Definition at line 301 of file parameter.h.

◆ description()

QString zrythm::dsp::ProcessorParameter::description ( ) const

inline

Definition at line 277 of file parameter.h.

◆ endUserGesture()

Q_INVOKABLE void zrythm::dsp::ProcessorParameter::endUserGesture ( )

inline

Definition at line 319 of file parameter.h.

◆ get_modulation_input_port_ref()

PortUuidReference zrythm::dsp::ProcessorParameter::get_modulation_input_port_ref ( ) const

inline

Definition at line 360 of file parameter.h.

◆ get_node_name()

utils::Utf8String zrythm::dsp::ProcessorParameter::get_node_name ( ) const

overridevirtual

Returns a human friendly name of the node.

Implements zrythm::dsp::graph::IProcessable.

◆ get_unique_id()

const auto & zrythm::dsp::ProcessorParameter::get_unique_id ( ) const

inline

Definition at line 372 of file parameter.h.

◆ label()

QString zrythm::dsp::ProcessorParameter::label ( ) const

inline

Definition at line 276 of file parameter.h.

◆ prepare_for_processing()

void zrythm::dsp::ProcessorParameter::prepare_for_processing	(	const graph::GraphNode *	node,
		units::sample_rate_t	sample_rate,
		nframes_t	max_block_length )

overridevirtual

Called to allocate resources required for processing.

Parameters

node	The node in the processing graph. Null means we are processing outside of a graph context and must be handled gracefully.
sample_rate
max_block_length

Reimplemented from zrythm::dsp::graph::IProcessable.

◆ process_block()

void zrythm::dsp::ProcessorParameter::process_block	(	EngineProcessTimeInfo	time_nfo,
		const dsp::ITransport &	transport,
		const dsp::TempoMap &	tempo_map )

overridevirtualnoexcept

Processes automation and modulation.

Since parameters are not part of the graph, this should be spinned manually by the owning processor.

Reimplemented from zrythm::dsp::graph::IProcessable.

◆ range()

ParameterRange zrythm::dsp::ProcessorParameter::range ( ) const

inline

Definition at line 280 of file parameter.h.

◆ release_resources()

void zrythm::dsp::ProcessorParameter::release_resources ( )

overridevirtual

Called to release resources allocated by prepare_for_processing().

This may be called multiple times.

Reimplemented from zrythm::dsp::graph::IProcessable.

◆ resetBaseValueToDefault()

Q_INVOKABLE void zrythm::dsp::ProcessorParameter::resetBaseValueToDefault ( )

inline

Definition at line 291 of file parameter.h.

◆ set_automatable()

void zrythm::dsp::ProcessorParameter::set_automatable ( bool automatable )

inline

Definition at line 370 of file parameter.h.

◆ set_automation_provider()

void zrythm::dsp::ProcessorParameter::set_automation_provider ( AutomationValueProvider provider )

inline

Definition at line 354 of file parameter.h.

◆ set_description()

void zrythm::dsp::ProcessorParameter::set_description ( utils::Utf8String descr )

inline

Definition at line 365 of file parameter.h.

◆ setBaseValue()

void zrythm::dsp::ProcessorParameter::setBaseValue ( float newValue )

inline

Definition at line 283 of file parameter.h.

◆ unset_automation_provider()

void zrythm::dsp::ProcessorParameter::unset_automation_provider ( )

inline

Definition at line 358 of file parameter.h.

◆ valueAfterAutomationApplied()

Q_INVOKABLE float zrythm::dsp::ProcessorParameter::valueAfterAutomationApplied ( ) const

inline

Returns the value after automation, but before modulation has been applied.

Intended to be used in the UI.

Definition at line 309 of file parameter.h.

Property Documentation

◆ automatable

bool zrythm::dsp::ProcessorParameter::automatable

read

Definition at line 226 of file parameter.h.

◆ baseValue

float zrythm::dsp::ProcessorParameter::baseValue

readwrite

Definition at line 222 of file parameter.h.

◆ description

QString zrythm::dsp::ProcessorParameter::description

read

Definition at line 224 of file parameter.h.

◆ label

QString zrythm::dsp::ProcessorParameter::label

read

Definition at line 223 of file parameter.h.

◆ range

ParameterRange zrythm::dsp::ProcessorParameter::range

read

Definition at line 225 of file parameter.h.

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

src/dsp/parameter.h

Data Structures

Public Types

Public Member Functions

Properties

Friends

Detailed Description

Member Typedef Documentation

◆ AutomationValueProvider

◆ Resolver

Member Function Documentation

◆ automatable()

◆ baseValue()

◆ beginUserGesture()

◆ currentValue()

◆ description()

◆ endUserGesture()

◆ get_modulation_input_port_ref()

◆ get_node_name()

◆ get_unique_id()

◆ label()

◆ prepare_for_processing()

◆ process_block()

◆ range()

◆ release_resources()

◆ resetBaseValueToDefault()

◆ set_automatable()

◆ set_automation_provider()

◆ set_description()

◆ setBaseValue()

◆ unset_automation_provider()

◆ valueAfterAutomationApplied()

Property Documentation

◆ automatable

◆ baseValue

◆ description

◆ label

◆ range