Abstract class for a track that has a channel in the mixer. More...

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

Inheritance diagram for zrythm::structure::tracks::ChannelTrack:

[legend]

Collaboration diagram for zrythm::structure::tracks::ChannelTrack:

[legend]

Public Member Functions
Channel *	channel () const
bool	currently_muted () const override
	Returns if the track is muted.
bool	currently_listened () const override
	Returns if the track is listened.
bool	get_implied_soloed () const override
	Returns whether the fader is not soloed on its own but its direct out (or its direct out's direct out, etc.) or its child (or its children's child, etc.) is soloed.
bool	currently_soloed () const override
void	set_listened (bool listen, bool trigger_undo, bool auto_select, bool fire_events)
	Generates a menu to be used for channel-related items, eg, fader buttons, direct out, etc.
void	set_soloed (bool solo, bool trigger_undo, bool auto_select, bool fire_events)
	Sets track soloed, updates UI and optionally adds the action to the undo stack.
void	set_muted (bool mute, bool trigger_undo, bool auto_select, bool fire_events)
	Sets track muted and optionally adds the action to the undo stack.
void	set_output (std::optional< Track::Uuid > id)
bool	has_output () const
auto	output_track () const
GroupTargetTrack &	output_track_as_group_target () const
Public Member Functions inherited from zrythm::structure::tracks::ProcessableTrack
	ProcessableTrack (const dsp::ITransport &transport, PortType signal_type, Dependencies dependencies)
AutomationTracklist *	automationTracklist () const
Public Member Functions inherited from zrythm::structure::tracks::Track
bool	has_piano_roll () const
bool	is_folder () const
bool	is_audio_group () const
bool	is_midi_group () const
bool	is_audio_bus () const
bool	is_midi_bus () const
bool	is_modulator () const
bool	is_chord () const
bool	is_marker () const
bool	is_audio () const
bool	is_instrument () const
bool	is_midi () const
bool	is_master () const
bool	is_deletable () const
bool	is_copyable () const
template<typename DerivedT> requires std::derived_from<base_type<DerivedT>, Track> && FinalClass<base_type<DerivedT>>
double	get_full_visible_height (this DerivedT &&self)
	Returns the full visible height (main height + height of all visible automation tracks + height of all visible lanes).
template<typename DerivedT> requires std::derived_from<base_type<DerivedT>, Track> && FinalClass<base_type<DerivedT>>
bool	multiply_heights (this DerivedT &&self, double multiplier, bool visible_only, bool check_only)
bool	can_be_group_target () const
bool	is_frozen () const
template<arrangement::RegionObject RegionT, FinalClass SelfT>
void	insert_region (this SelfT &self, arrangement::ArrangerObjectUuidReference region_ref, AutomationTrack *at, std::optional< int > lane_pos, std::optional< int > idx, bool gen_name)
	Inserts a Region to the given lane or AutomationTrack of the track, at the given index.
template<arrangement::RegionObject RegionT>
void	add_region (this auto &self, auto region_ref, AutomationTrack *at, std::optional< int > lane_pos, bool gen_name)
	Appends a Region to the given lane or AutomationTrack of the track.
void	append_objects (std::vector< ArrangerObjectPtrVariant > &objects) const
	Appends all the objects in the track to `objects`.
void	unselect_all ()
	Unselects all arranger objects in the track.
template<typename DerivedT> requires std::derived_from<base_type<DerivedT>, Track> && FinalClass<base_type<DerivedT>>
bool	contains_uninstantiated_plugin (this DerivedT &&self)
virtual void	clear_objects ()
	Removes all objects recursively from the track.
virtual void	temporary_virtual_method_hack () const =0
utils::Utf8String	get_name () const
	Getter for the track name.
bool	set_name_with_action_full (const utils::Utf8String &name)
	Internally called by set_name_with_action().
void	set_name_with_action (const utils::Utf8String &name)
	Setter to be used by the UI to create an undoable action.
void	set_name (const Tracklist &tracklist, const utils::Utf8String &name, bool pub_events)
	Setter for the track name.
utils::Utf8String	get_unique_name (const Tracklist &tracklist, const utils::Utf8String &name)
	Returns a unique name for a new track based on the given name.
virtual void	get_regions_in_range (std::vector< arrangement::ArrangerObjectUuidReference > &regions, std::optional< signed_frame_t > p1, std::optional< signed_frame_t > p2)
	Returns all the regions inside the given range, or all the regions if both p1 and p2 are NULL.
auto	get_input_signal_type () const
auto	get_output_signal_type () const
template<typename DerivedT> requires std::derived_from<base_type<DerivedT>, Track> && FinalClass<base_type<DerivedT>>
void	get_plugins (this DerivedT &&self, std::vector< zrythm::plugins::Plugin * > &arr)
	Fills in the given array with all plugins in the track.
void	track_freeze (bool freeze)
	Freezes or unfreezes the track.
bool	is_enabled () const
bool	enabled () const
bool	disabled () const
int	get_total_bars (const engine::session::Transport &transport, int total_bars) const
void	set_caches (CacheType types)
	Set various caches (snapshots, track name hash, plugin input/output ports, etc).
utils::Utf8String	generate_window_name_for_plugin (const plugins::Plugin &plugin) const
utils::Utf8String	get_full_designation_for_port (const dsp::Port &port) const
void	set_selection_status_getter (TrackSelectionStatusGetter getter)
void	unset_selection_status_getter ()
auto &	get_plugin_registry () const
auto &	get_plugin_registry ()
auto &	get_port_registry () const
auto &	get_port_registry ()
auto &	get_param_registry () const
auto &	get_param_registry ()
auto &	get_object_registry () const
auto &	get_object_registry ()
auto	get_type () const
auto	get_icon_name () const
Public Member Functions inherited from zrythm::utils::UuidIdentifiableObject< Track >
UuidIdentifiableObject &	operator= (const UuidIdentifiableObject &other)=default
auto	get_uuid () const

Protected Member Functions
	ChannelTrack (FinalTrackDependencies dependencies)
void	init_channel ()
	Initializes the channel.
Protected Member Functions inherited from zrythm::structure::tracks::Track
	Track (Type type, PortType in_signal_type, PortType out_signal_type, BaseTrackDependencies dependencies)
	Constructor to be used by subclasses.
virtual void	set_playback_caches ()
	Set the playback caches for a track.
void	add_region_if_in_range (std::optional< signed_frame_t > p1, std::optional< signed_frame_t > p2, std::vector< arrangement::ArrangerObjectUuidReference > &regions, arrangement::ArrangerObjectUuidReference region)

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

Additional Inherited Members
Public Types inherited from zrythm::structure::tracks::ProcessableTrack
using	Dependencies = AutomationTrackHolder::Dependencies
Public Types inherited from zrythm::structure::tracks::Track
using	Plugin = plugins::Plugin
using	PluginUuid = Plugin::Uuid
using	PortType = dsp::PortType
using	PluginRegistry = plugins::PluginRegistry
using	PluginPtrVariant = PluginRegistry::VariantType
using	PluginSlot = plugins::PluginSlot
using	ArrangerObject = structure::arrangement::ArrangerObject
using	ArrangerObjectPtrVariant
using	ArrangerObjectRegistry = structure::arrangement::ArrangerObjectRegistry
using	Type = ::TrackTypeWrapper::TrackType
using	TrackSelectionStatusGetter = std::function<bool (const Track::Uuid &)>
using	Color = utils::Color
Static Public Member Functions inherited from zrythm::structure::tracks::Track
static constexpr bool	type_can_have_direct_out (Type type)
static bool	type_can_have_region_type (Type type, ArrangerObject::Type region_type)
static constexpr bool	type_is_copyable (Type type)
static constexpr bool	type_is_deletable (Type type)
	Returns whether a track of the given type should be deletable by the user.
static Type	type_get_from_plugin_descriptor (const zrythm::plugins::PluginDescriptor &descr)
static consteval bool	type_has_mono_compat_switch (const Type tt)
static constexpr bool	type_is_compatible_for_moving (const Type type1, const Type type2)
	Returns if regions in tracks from `type1` can be moved to `type2`.
static constexpr bool	type_has_piano_roll (const Type type)
	Returns if the Track should have a piano roll.
static constexpr bool	type_has_inputs (const Type type)
	Returns if the Track should have an inputs selector.
static bool	type_can_be_group_target (const Type type)
	Returns if the Track can be a direct route target.
template<typename T>
static consteval Type	get_type_for_class ()
static Track *	from_variant (const TrackPtrVariant &variant)
static bool	is_plugin_descriptor_valid_for_slot_type (const plugins::PluginDescriptor &descr, zrythm::plugins::PluginSlotType slot_type, Track::Type track_type)
	Returns if `descr` can be dropped at `slot_type` in a track of type `track_type`.
Data Fields inherited from zrythm::structure::tracks::ProcessableTrack
utils::QObjectUniquePtr< TrackProcessor >	processor_
	The TrackProcessor, used for processing.
Static Public Attributes inherited from zrythm::structure::tracks::Track
static constexpr int	MIN_HEIGHT = 26
static constexpr int	DEF_HEIGHT = 52
Protected Attributes inherited from zrythm::structure::tracks::Track
BaseTrackDependencies	base_dependencies_
Type	type_ {}
	The type of track this is.
utils::Utf8String	name_
	Track name, used in channel too.
utils::Utf8String	icon_name_
	Icon name of the track.
bool	visible_ = true
	Whole Track is visible or not.
bool	filtered_ = false
	Track will be hidden if true (temporary and not serializable).
double	main_height_ { DEF_HEIGHT }
	Height of the main part (without lanes).
bool	enabled_ = true
	Active (enabled) or not.
Color	color_
	Track color.
PortType	in_signal_type_ = {}
	The input signal type (eg audio bus tracks have audio input signals).
PortType	out_signal_type_ = {}
	The output signal type (eg midi tracks have MIDI output signals).
utils::Utf8String	comment_
	User comments.
std::optional< dsp::FileAudioSourceUuidReference >	frozen_clip_id_
	Pool ID of the clip if track is frozen (unset if not frozen).
std::optional< TrackSelectionStatusGetter >	track_selection_status_getter_
	Track selection status getter.

Detailed Description

Abstract class for a track that has a channel in the mixer.

Definition at line 18 of file channel_track.h.

Member Function Documentation

◆ channel()

Channel * zrythm::structure::tracks::ChannelTrack::channel ( ) const

inline

Definition at line 26 of file channel_track.h.

◆ currently_listened()

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

inlineoverridevirtual

Returns if the track is listened.

Reimplemented from zrythm::structure::tracks::Track.

Definition at line 39 of file channel_track.h.

◆ currently_muted()

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

inlineoverridevirtual

Returns if the track is muted.

Reimplemented from zrythm::structure::tracks::Track.

Definition at line 31 of file channel_track.h.

◆ currently_soloed()

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

inlineoverridevirtual

Reimplemented from zrythm::structure::tracks::Track.

Definition at line 51 of file channel_track.h.

◆ get_implied_soloed()

bool zrythm::structure::tracks::ChannelTrack::get_implied_soloed ( ) const

overridevirtual

Returns whether the fader is not soloed on its own but its direct out (or its direct out's direct out, etc.) or its child (or its children's child, etc.) is soloed.

Reimplemented from zrythm::structure::tracks::Track.

◆ has_output()

bool zrythm::structure::tracks::ChannelTrack::has_output ( ) const

inline

Definition at line 97 of file channel_track.h.

◆ init_channel()

void zrythm::structure::tracks::ChannelTrack::init_channel ( )

protected

Initializes the channel.

This is mainly used to set the parent on the channel.

◆ output_track()

auto zrythm::structure::tracks::ChannelTrack::output_track ( ) const

inline

Definition at line 99 of file channel_track.h.

◆ set_listened()

void zrythm::structure::tracks::ChannelTrack::set_listened	(	bool	listen,
		bool	trigger_undo,
		bool	auto_select,
		bool	fire_events )

Generates a menu to be used for channel-related items, eg, fader buttons, direct out, etc.

Sets track soloed, updates UI and optionally adds the action to the undo stack.

Parameters

auto_select	Makes this track the only selection in the tracklist. Useful when listening to a single track.
trigger_undo	Create and perform an undoable action.
fire_events	Fire UI events.

◆ set_output()

void zrythm::structure::tracks::ChannelTrack::set_output ( std::optional< Track::Uuid > id )

inline

Definition at line 95 of file channel_track.h.

◆ set_soloed()

void zrythm::structure::tracks::ChannelTrack::set_soloed	(	bool	solo,
		bool	trigger_undo,
		bool	auto_select,
		bool	fire_events )

Sets track soloed, updates UI and optionally adds the action to the undo stack.

Parameters

auto_select	Makes this track the only selection in the tracklist. Useful when soloing a single track.
trigger_undo	Create and perform an undoable action.
fire_events	Fire UI events.

◆ from_json

void from_json	(	const nlohmann::json &	j,
		ChannelTrack &	c )

friend

Definition at line 127 of file channel_track.h.

◆ to_json

void to_json	(	nlohmann::json &	j,
		const ChannelTrack &	c )

friend

Definition at line 122 of file channel_track.h.

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

src/structure/tracks/channel_track.h

Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ channel()

◆ currently_listened()

◆ currently_muted()

◆ currently_soloed()

◆ get_implied_soloed()

◆ has_output()

◆ init_channel()

◆ output_track()

◆ set_listened()

◆ set_output()

◆ set_soloed()

Friends And Related Symbol Documentation

◆ from_json

◆ to_json