The ChordTrack class is responsible for managing the chord and scale information in the project. More...

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

Inheritance diagram for zrythm::structure::tracks::ChordTrack:

[legend]

Collaboration diagram for zrythm::structure::tracks::ChordTrack:

[legend]

Public Types
using	ScaleObject = arrangement::ScaleObject
using	ChordRegion = arrangement::ChordRegion
using	ChordObject = arrangement::ChordObject
using	ScaleObjectPtr = ScaleObject *
using	NotePitchToChordDescriptorFunc
Public Types inherited from zrythm::structure::tracks::Track
enum class	Type : basic_enum_base_type_t { Instrument , Audio , Master , Chord , Marker , Modulator , AudioBus , AudioGroup , Midi , MidiBus , MidiGroup , Folder }
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	Color = utils::Color
Public Types inherited from zrythm::structure::arrangement::ArrangerObjectOwner< arrangement::ChordRegion >
using	ArrangerObjectChildType
using	ArrangerObjectListModel
Public Types inherited from zrythm::structure::arrangement::ArrangerObjectOwner< arrangement::ScaleObject >
using	ArrangerObjectChildType
using	ArrangerObjectListModel

Public Member Functions
	ChordTrack (FinalTrackDependencies dependencies)
const dsp::ChordDescriptor *	note_pitch_to_chord_descriptor (midi_byte_t note_pitch) const
void	set_note_pitch_to_descriptor_func (NotePitchToChordDescriptorFunc func)
ScaleObject *	get_scale_at (size_t index) const
ChordObject *	get_chord_at_ticks (units::precise_tick_t timeline_ticks) const
	Returns the ChordObject at the given Position in the TimelineArranger.
ScaleObject *	get_scale_at_ticks (units::precise_tick_t timeline_ticks) const
	Returns the ScaleObject at the given Position in the TimelineArranger.
std::string	get_field_name_for_serialization (const ChordRegion *) const override
std::string	get_field_name_for_serialization (const ScaleObject *) const override
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
Type	type () const
AutomationTracklist *	automationTracklist () const
QString	name () const
void	setName (const QString &name)
Q_SIGNAL void	nameChanged (const QString &name)
QColor	color () const
void	setColor (const QColor &color)
Q_SIGNAL void	colorChanged (const QColor &color)
QString	comment () const
void	setComment (const QString &comment)
Q_SIGNAL void	commentChanged (const QString &comment)
bool	visible () const
void	setVisible (bool visible)
Q_SIGNAL void	visibleChanged (bool visible)
bool	enabled () const
void	setEnabled (bool enabled)
Q_SIGNAL void	enabledChanged (bool enabled)
double	height () const
void	setHeight (double height)
Q_SIGNAL void	heightChanged (double height)
double	fullVisibleHeight () const
Q_SIGNAL void	fullVisibleHeightChanged ()
QString	icon () const
void	setIcon (const QString &icon)
Q_SIGNAL void	iconChanged (const QString &icon)
Channel *	channel () const
plugins::PluginGroup *	modulators () const
TrackLaneList *	lanes () const
RecordableTrackMixin *	recordableTrackMixin () const
PianoRollTrackMixin *	pianoRollTrackMixin () const
bool	clipLauncherMode () const
void	setClipLauncherMode (bool mode)
Q_SIGNAL void	clipLauncherModeChanged (bool mode)
Q_INVOKABLE void	regeneratePlaybackCaches (utils::ExpandableTickRange affectedRange)
	To be connected to to notify of any changes to the playable content, like MIDI or audio events.
bool	is_deletable () const
bool	is_copyable () const
bool	has_automation () const
double	get_full_visible_height () const
	Returns the full visible height (main height + height of all visible automation tracks + height of all visible lanes).
bool	multiply_heights (double multiplier, bool visible_only, bool check_only)
bool	can_be_group_target () const
template<arrangement::RegionObject RegionT>
auto	generate_name_for_region (const RegionT &region, AutomationTrack *automation_track=nullptr)
void	collect_timeline_objects (std::vector< ArrangerObjectPtrVariant > &objects) const
	Appends all the timeine objects in the track to `objects`.
bool	contains_uninstantiated_plugin () const
utils::Utf8String	get_name () const
	Getter for the track name.
auto	get_input_signal_type () const
auto	get_output_signal_type () const
uint8_t	get_midi_ch (const arrangement::MidiRegion &midi_region) const
	Returns the MIDI channel that this region should be played on, starting from 1.
void	collect_plugins (std::vector< plugins::PluginPtrVariant > &plugins) const
	Fills in the given array with all plugins in the track.
void	set_caches (CacheType types)
	Set various caches (snapshots, track name hash, plugin input/output ports, etc).
utils::Utf8String	get_full_designation_for_port (const dsp::Port &port) const
void	generate_basic_automation_tracks ()
	Adds basic automation tracks.
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 ()
TrackProcessor *	get_track_processor () 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
Public Member Functions inherited from zrythm::structure::arrangement::ArrangerObjectOwner< arrangement::ChordRegion >
	ArrangerObjectOwner (ArrangerObjectRegistry &registry, dsp::FileAudioSourceRegistry &file_audio_source_registry, T &derived)
auto &	get_children_vector () const
auto	get_children_view () const
auto	get_sorted_children_view () const
void	add_ticks_to_children (double ticks)
bool	contains_object (const ArrangerObject::Uuid &id) const
	O(1) lookup if an object with the given ID exists.
ArrangerObjectListModel *	get_model () const
ArrangerObjectUuidReference	remove_object (this SelfT &self, const ArrangerObject::Uuid &id)
void	insert_object (this SelfT &self, const ArrangerObjectUuidReference &obj_ref, int idx)
void	add_object (this SelfT &self, const ArrangerObjectUuidReference &obj_ref)
void	clear_objects ()
virtual std::string	get_field_name_for_serialization (const ChildT *) const=0
	Get the children field name to be used during serialization/deserialization.
Public Member Functions inherited from zrythm::structure::arrangement::ArrangerObjectOwner< arrangement::ScaleObject >
	ArrangerObjectOwner (ArrangerObjectRegistry &registry, dsp::FileAudioSourceRegistry &file_audio_source_registry, T &derived)
auto &	get_children_vector () const
auto	get_children_view () const
auto	get_sorted_children_view () const
void	add_ticks_to_children (double ticks)
bool	contains_object (const ArrangerObject::Uuid &id) const
	O(1) lookup if an object with the given ID exists.
ArrangerObjectListModel *	get_model () const
ArrangerObjectUuidReference	remove_object (this SelfT &self, const ArrangerObject::Uuid &id)
void	insert_object (this SelfT &self, const ArrangerObjectUuidReference &obj_ref, int idx)
void	add_object (this SelfT &self, const ArrangerObjectUuidReference &obj_ref)
void	clear_objects ()
virtual std::string	get_field_name_for_serialization (const ChildT *) const=0
	Get the children field name to be used during serialization/deserialization.

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

Additional Inherited Members
Static Public Member Functions inherited from zrythm::structure::tracks::Track
static bool	type_can_have_region_type (Type type, ArrangerObject::Type region_type)
static constexpr bool	type_is_foldable (Type 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 constexpr bool	type_can_be_group_target (const Type type)
	Returns if the Track can be a direct route target.
static constexpr bool	type_can_have_automation (const Type type)
static constexpr bool	type_can_have_lanes (const Type type)
template<typename T>
static consteval Type	get_type_for_class ()
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`.
Static Public Attributes inherited from zrythm::structure::tracks::Track
static constexpr int	MIN_HEIGHT = 26
static constexpr int	DEF_HEIGHT = 52
Protected Types inherited from zrythm::structure::tracks::Track
enum class	TrackFeatures : std::uint8_t { Modulators = 1 << 0 , Automation = 1 << 1 , Lanes = 1 << 2 , Recording = 1 << 3 , PianoRoll = 1 << 4 }
Protected Member Functions inherited from zrythm::structure::tracks::Track
	Track (Type type, PortType in_signal_type, PortType out_signal_type, TrackFeatures enabled_features, BaseTrackDependencies dependencies)
	Constructor to be used by subclasses.
void	generate_automation_tracks_for_processor (std::vector< utils::QObjectUniquePtr< AutomationTrack > > &ats, const dsp::ProcessorBase &processor)
utils::QObjectUniquePtr< TrackProcessor >	make_track_processor (std::optional< TrackProcessor::FillEventsCallback > fill_events_cb=std::nullopt, std::optional< TrackProcessor::TransformMidiInputsFunc > transform_midi_inputs_func=std::nullopt, std::optional< TrackProcessor::AppendMidiInputsToOutputsFunc > append_midi_inputs_to_outputs_func=std::nullopt)
	Implementations with a processor must call this in their constructor.
virtual void	collect_additional_timeline_objects (std::vector< ArrangerObjectPtrVariant > &objects) const
	Called by collect_timeline_objects to collect any additional objects not handled by this class (such as markers and scales).
Protected Attributes inherited from zrythm::structure::tracks::Track
BaseTrackDependencies	base_dependencies_
Type	type_ {}
	The type of track this is.
TrackFeatures	features_ {}
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.
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).
utils::QObjectUniquePtr< AutomationTracklist >	automation_tracklist_
	Automation tracks, if track is automatable.
utils::QObjectUniquePtr< TrackProcessor >	processor_
	The TrackProcessor, used for processing.
utils::QObjectUniquePtr< Channel >	channel_
	Channel for this track, if any.
utils::QObjectUniquePtr< plugins::PluginGroup >	modulators_
	Modulators.
std::vector< utils::QObjectUniquePtr< dsp::ModulatorMacroProcessor > >	modulator_macro_processors_
	Modulator macros.
utils::QObjectUniquePtr< TrackLaneList >	lanes_
utils::QObjectUniquePtr< RecordableTrackMixin >	recordable_track_mixin_
utils::QObjectUniquePtr< PianoRollTrackMixin >	piano_roll_track_mixin_
utils::QObjectUniquePtr< utils::PlaybackCacheScheduler >	playable_content_cache_request_debouncer_
	Debouncer/scheduler of audio/MIDI cache requests.
bool	clip_launcher_mode_ {}
Properties inherited from zrythm::structure::tracks::Track
Type	type
zrythm::structure::tracks::AutomationTracklist *	automationTracklist
QString	name
QColor	color
QString	comment
QString	icon
bool	visible
bool	enabled
double	height
double	fullVisibleHeight
zrythm::structure::tracks::Channel *	channel
zrythm::plugins::PluginGroup *	modulators
zrythm::structure::tracks::TrackLaneList *	lanes
zrythm::structure::tracks::RecordableTrackMixin *	recordableTrackMixin
zrythm::structure::tracks::PianoRollTrackMixin *	pianoRollTrackMixin
bool	clipLauncherMode

Detailed Description

The ChordTrack class is responsible for managing the chord and scale information in the project.

Definition at line 17 of file chord_track.h.

Member Typedef Documentation

◆ ChordObject

using zrythm::structure::tracks::ChordTrack::ChordObject = arrangement::ChordObject

Definition at line 37 of file chord_track.h.

◆ ChordRegion

using zrythm::structure::tracks::ChordTrack::ChordRegion = arrangement::ChordRegion

Definition at line 36 of file chord_track.h.

◆ NotePitchToChordDescriptorFunc

using zrythm::structure::tracks::ChordTrack::NotePitchToChordDescriptorFunc

Initial value:

dsp::MidiEventVector::NotePitchToChordDescriptorFunc

Definition at line 39 of file chord_track.h.

◆ ScaleObject

using zrythm::structure::tracks::ChordTrack::ScaleObject = arrangement::ScaleObject

Definition at line 35 of file chord_track.h.

◆ ScaleObjectPtr

using zrythm::structure::tracks::ChordTrack::ScaleObjectPtr = ScaleObject *

Definition at line 38 of file chord_track.h.

Member Function Documentation

◆ get_field_name_for_serialization() [1/2]

std::string zrythm::structure::tracks::ChordTrack::get_field_name_for_serialization ( const ChordRegion * ) const

inlineoverride

Definition at line 84 of file chord_track.h.

◆ get_field_name_for_serialization() [2/2]

std::string zrythm::structure::tracks::ChordTrack::get_field_name_for_serialization ( const ScaleObject * ) const

inlineoverride

Definition at line 89 of file chord_track.h.

◆ note_pitch_to_chord_descriptor()

const dsp::ChordDescriptor * zrythm::structure::tracks::ChordTrack::note_pitch_to_chord_descriptor ( midi_byte_t note_pitch ) const

inline

Definition at line 51 of file chord_track.h.

◆ set_note_pitch_to_descriptor_func()

void zrythm::structure::tracks::ChordTrack::set_note_pitch_to_descriptor_func ( NotePitchToChordDescriptorFunc func )

inline

Definition at line 59 of file chord_track.h.

◆ from_json

void from_json	(	const nlohmann::json &	j,
		ChordTrack &	track )

friend

Definition at line 101 of file chord_track.h.

◆ to_json

void to_json	(	nlohmann::json &	j,
		const ChordTrack &	track )

friend

Definition at line 95 of file chord_track.h.

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

src/structure/tracks/chord_track.h

Public Types

Public Member Functions

Friends

Additional Inherited Members