Inheritance diagram for ScaleObject:

[legend]

Collaboration diagram for ScaleObject:

[legend]

Public Types
using	MusicalScale = dsp::MusicalScale

Public Types inherited from ArrangerObject
enum class	ResizeType { Normal , Loop , Fade , Stretch , StretchTempoChange }
	Flag used in some functions. More...

enum class	Type { MidiRegion , AudioRegion , ChordRegion , AutomationRegion , MidiNote , ChordObject , ScaleObject , Marker , AutomationPoint }
	The type of the object. More...

enum class	Flags { NonProject = 1 << 0 }
	Flags. More...

enum class	PositionType { Start , End , ClipStart , LoopStart , LoopEnd , FadeIn , FadeOut }

using	SelectionStatusGetter = std::function<bool (const Uuid &)>

using	Position = zrythm::dsp::Position

using	ArrangerObjectPtr = ArrangerObject *

Public Member Functions
QString	getName () const

Q_SIGNAL void	nameChanged (const QString &name)

void	init_after_cloning (const ScaleObject &other, ObjectCloneType clone_type) override
	Initializes the cloned object.

void	set_scale (const MusicalScale &scale)

utils::Utf8String	gen_human_friendly_name () const override
	Generates a human readable name for the object.

ArrangerObjectPtrVariant	add_clone_to_project (bool fire_events) const override
	Appends the ArrangerObject to where it belongs in the project (eg, a Track), without taking into account its previous index (eg, before deletion if undoing).

ArrangerObjectPtrVariant	insert_clone_to_project () const override
	Inserts the object where it belongs in the project (eg, a Track).

bool	validate (bool is_project, dsp::FramesPerTick frames_per_tick) const override
	Validates the arranger object.

Public Member Functions inherited from ArrangerObject
auto	get_type () const

bool	is_start_hit_by_range (const dsp::Position &start, const dsp::Position &end, bool range_start_inclusive=true, bool range_end_inclusive=false) const
	Returns whether the given object is hit by the given range.

bool	is_start_hit_by_range (const signed_frame_t global_frames_start, const signed_frame_t global_frames_end, bool range_start_inclusive=true, bool range_end_inclusive=false) const

void	set_parent_on_base_qproperties (QObject &derived)
	Set the parent on QObject's that are children of this class.

auto	get_position () const
	Getter.

void	position_setter_validated (const dsp::Position &pos, dsp::TicksPerFrame ticks_per_frame)
	The setter is for use in e.g.

void	set_position_unvalidated (const dsp::Position &pos)

bool	is_position_valid (const dsp::Position &pos, PositionType pos_type, dsp::TicksPerFrame ticks_per_frame) const
	Returns if the given Position is valid.

bool	set_position (const dsp::Position &pos, PositionType pos_type, bool validate, dsp::TicksPerFrame ticks_per_frame)
	Sets the given position on the object, optionally attempting to validate before.

void	move (double ticks, dsp::FramesPerTick frames_per_tick)
	Moves the object by the given amount of ticks.

void	set_track_id (const TrackUuid &track_id)

void	set_track_id (std::optional< TrackUuid > track_id)

void	unset_track_id ()

void	update_positions (bool from_ticks, bool bpm_change, dsp::FramesPerTick frames_per_tick)
	Updates the positions in each child recursively.

auto	get_track () const
	Returns the Track this ArrangerObject is in.

std::optional< TrackUuid >	get_track_id () const

std::optional< ArrangerObjectPtrVariant >	remove_from_project (bool free_obj, bool fire_events=false)
	Removes the object (which can be obtained from find_in_project()) from its parent in the project.

void	set_selection_status_getter (SelectionStatusGetter getter)

void	unset_selection_status_getter ()

virtual bool	is_deletable () const
	Returns whether the given object is deletable or not (eg, start marker).

Public Member Functions inherited from zrythm::utils::UuidIdentifiableObject< ArrangerObject >
	UuidIdentifiableObject (const Uuid &id)

	UuidIdentifiableObject (const UuidIdentifiableObject &other)=default

	UuidIdentifiableObject (UuidIdentifiableObject &&other)=default

UuidIdentifiableObject &	operator= (const UuidIdentifiableObject &other)=default

UuidIdentifiableObject &	operator= (UuidIdentifiableObject &&other)=default

auto	get_uuid () const

void	copy_members_from (const UuidIdentifiableObject &other)

Public Member Functions inherited from MuteableObject
virtual bool	get_muted (bool check_parent) const
	Gets the mute status of the object.

void	set_muted (bool muted, bool fire_events)
	Sets the mute status of the object.

Public Member Functions inherited from ICloneable< ScaleObject >
std::unique_ptr< ScaleObject >	clone_unique (ObjectCloneType clone_type=ObjectCloneType::Snapshot, Args &&... args) const

std::shared_ptr< ScaleObject >	clone_shared (ObjectCloneType clone_type=ObjectCloneType::Snapshot, Args &&... args) const

ScaleObject *	clone_raw_ptr (ObjectCloneType clone_type=ObjectCloneType::Snapshot, Args &&... args) const

ScaleObject *	clone_qobject (QObject *parent, ObjectCloneType clone_type=ObjectCloneType::Snapshot, Args &&... args) const

QScopedPointer< ScaleObject >	clone_unique_qobject (QObject *parent, ObjectCloneType clone_type=ObjectCloneType::Snapshot, Args &&... args) const

Data Fields
MusicalScale	scale_
	The scale descriptor.

Data Fields inherited from ArrangerObject
Flags	flags_ {}
	Track this object belongs to (cache to be set during graph calculation).

Data Fields inherited from MuteableObject
bool	muted_ = false
	Whether muted or not.

Data Fields inherited from ICloneable< ScaleObject >
friend	Derived

Properties
QML_ELEMENT QString	name

Friends
void	to_json (nlohmann::json &j, const ScaleObject &so)

void	from_json (const nlohmann::json &j, ScaleObject &so)

Additional Inherited Members
Static Public Attributes inherited from ArrangerObject
static constexpr double	DEFAULT_NUDGE_TICKS = 0.1

Protected Member Functions inherited from TimelineObject
void	copy_members_from (const TimelineObject &other, ObjectCloneType clone_type)

Protected Member Functions inherited from ArrangerObject
	ArrangerObject (Type type, TrackResolver track_resolver) noexcept

void	copy_members_from (const ArrangerObject &other, ObjectCloneType clone_type)

bool	are_members_valid (bool is_project, dsp::FramesPerTick frames_per_tick) const
	To be called by validate() implementations.

Protected Member Functions inherited from MuteableObject
void	copy_members_from (const MuteableObject &other, ObjectCloneType clone_type)

Protected Attributes inherited from ArrangerObject
TrackResolver	track_resolver_

PositionProxy *	pos_ = nullptr
	Position (or start Position if the object has length).

std::optional< TrackUuid >	track_id_
	ID of the track this object belongs to.

std::optional< SelectionStatusGetter >	selection_status_getter_
	Whether part of an auditioner track.

Detailed Description

Definition at line 22 of file scale_object.h.

Member Typedef Documentation

◆ MusicalScale

using ScaleObject::MusicalScale = dsp::MusicalScale

Definition at line 34 of file scale_object.h.

Member Function Documentation

◆ add_clone_to_project()

ArrangerObjectPtrVariant ScaleObject::add_clone_to_project ( bool fire_events ) const

overridevirtual

Appends the ArrangerObject to where it belongs in the project (eg, a Track), without taking into account its previous index (eg, before deletion if undoing).

Exceptions

ZrythmError on failure.

Returns: A reference to the newly added clone.

Implements ArrangerObject.

◆ gen_human_friendly_name()

utils::Utf8String ScaleObject::gen_human_friendly_name ( ) const

overridevirtual

Generates a human readable name for the object.

If the object has a name, this returns a copy of the name, otherwise generates something appropriate.

Reimplemented from ArrangerObject.

◆ getName()

QString ScaleObject::getName ( ) const

inline

Definition at line 43 of file scale_object.h.

◆ init_after_cloning()

void ScaleObject::init_after_cloning	(	const ScaleObject &	other,
		ObjectCloneType	clone_type )

overridevirtual

Initializes the cloned object.

Note: Only final classes should implement this.

Exceptions

ZrythmException If the object could not be cloned.

Implements ICloneable< ScaleObject >.

◆ insert_clone_to_project()

ArrangerObjectPtrVariant ScaleObject::insert_clone_to_project ( ) const

overridevirtual

Inserts the object where it belongs in the project (eg, a Track).

This function assumes that the object already knows the index where it should be inserted in its parent.

This is mostly used when undoing.

Exceptions

ZrythmException on failure.

Returns: A reference to the newly inserted clone.

Implements ArrangerObject.

◆ set_scale()

void ScaleObject::set_scale ( const MusicalScale & scale )

inline

Definition at line 51 of file scale_object.h.

◆ validate()

bool ScaleObject::validate	(	bool	is_project,
		dsp::FramesPerTick	frames_per_tick ) const

overridevirtual

Validates the arranger object.

Parameters

frames_per_tick Frames per tick used when validating audio regions. Passing 0 will use the value from the current engine.

Returns: Whether valid.

Must only be implemented by final objects.

Implements ArrangerObject.

Friends And Related Symbol Documentation

◆ from_json

void from_json	(	const nlohmann::json &	j,
		ScaleObject &	so )

friend

Definition at line 71 of file scale_object.h.

◆ to_json

void to_json	(	nlohmann::json &	j,
		const ScaleObject &	so )

friend

Definition at line 65 of file scale_object.h.

Field Documentation

◆ scale_

MusicalScale ScaleObject::scale_

The scale descriptor.

Definition at line 80 of file scale_object.h.

Property Documentation

◆ name

QML_ELEMENT QString ScaleObject::name

read

Definition at line 31 of file scale_object.h.

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

src/gui/dsp/scale_object.h

Public Types

Public Member Functions

Data Fields

Properties

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ MusicalScale

Member Function Documentation

◆ add_clone_to_project()

◆ gen_human_friendly_name()

◆ getName()

◆ init_after_cloning()

◆ insert_clone_to_project()

◆ set_scale()

◆ validate()

Friends And Related Symbol Documentation

◆ from_json

◆ to_json

Field Documentation

◆ scale_

Property Documentation

◆ name