A measure containing measure elements. More...

#include <pawssheetline.h>

Classes
class	MeasureAttributes
	Keep general attributes that can change from a measure to another like key signature, beats and tempo. More...

Public Member Functions
void	AppendMeasure (Measure *measure)
	Append the given measure after this one. More...

void	AttachMeasure (Measure *measure)
	Insert the given measure after this one and update the chord list. More...

bool	Cut (uint divisions)
	Cut the last chords of the measures that exceeds the given number of durations. More...

void	DeleteAllElements ()
	Delete all elements from the measure. More...

void	DeleteChord (Chord *chord)
	Deletes the chord if it belong to this measure. More...

void	DeleteElement (size_t n)
	Delete the element in position n. More...

void	Draw (pawsSheetLine pawsLine, Chord selectedChord, int startPosition)
	Draws this measure. More...

void	Empty ()
	Deletes all the chords in this line and keeps only an empty chord. More...

void	Fill (uint divisions)
	Fills the measure with rests if it is incomplete. More...

void	Fit (const MeasureAttributes *const attributes)
	Remove the elements at the end of the measures that exceeds the total duration or push a rest if there are not enough elements. More...

MeasureAttributes	GetAttributes () const
	Get a copy of the attributes of this measure. More...

MeasureElementType &	GetElement (size_t n)
	Get the element at position n. More...

const MeasureElementType &	GetElement (size_t n) const
	Get the element at position n. More...

uint	GetEnding ()
	Gets the number of this ending. More...

uint	GetEndRepeat ()
	Gets the number of times this part must be repeat. More...

Chord *	GetFirstChord ()
	Returns the first chord of this measure. More...

Chord *	GetLastChord ()
	Returns the last chord of this measure. More...

uint	GetMimimumSize (uint noteLength)
	Gets the mimimum size of this measure. More...

uint	GetNChords ()
	Returns the number of chords in this measure. More...

size_t	GetNElements () const
	Get the number of elements in this measure. More...

int	GetNEndRepeat () const
	Get the number of time the repeat at the end of this measure must be performed. More...

uint	GetSize (uint noteLength)
	Returns the measure's size. More...

bool	GetStartRepeat ()
	Gets the start repeat state. More...

bool	Hit (int x, Chord *&chord, bool &before)
	Check if a chord in this measure is hit. More...

Chord *	InsertChord (Chord *nearChord, bool before)
	Inserts a new empty chord before or after the given one. More...

void	InsertElement (size_t n, const MeasureElementType &element)
	Insert a copy of the given element after element n. More...

bool	IsEmpty () const
	Check if the measure has at least one element. More...

bool	IsEnding () const
	Return true if this is an ending measure. More...

bool	IsEndRepeat () const
	Return true if this measure ends a repeat section. More...

bool	IsStartRepeat () const
	Return true if this measure starts a repeat section. More...

	Measure (Chord *firstChord)
	Constructor. More...

	Measure (csRef< iDocumentNode > measure, int quarterDivisions)
	Constructor. More...

	Measure ()
	Constructor. More...

Measure *	Next ()
	Returns the next Measure. More...

Measure *	Prev ()
	Returns the previous Measure. More...

void	PushChord (Chord *chord)
	Pushes a chord at the end of the measure. More...

size_t	PushElement (const MeasureElementType &element)
	Push a copy of the given element after all the elements currently in the measure. More...

void	SetBeat (int beats, int beatType)
	Set the beat information. More...

void	SetEnding (bool isEnding)
	Sets this measure as an ending and updates all the following endings. More...

void	SetEnding (bool isEnding)
	Set this measure as an ending. More...

void	SetEndRepeat (uint repeat)
	Sets the number of times this part must be repeat. More...

void	SetFifths (int fifths)
	Set the key signature as the number of accidentals. More...

void	SetNEndRepeat (int nEndRepeat)
	Set the number of time the repeat at the end of this measure must be performed. More...

bool	SetSize (uint size, uint noteLength)
	Sets the measure's size. More...

void	SetStartRepeat (bool repeat)
	Sets the start repeat of this measure. More...

void	SetStartRepeat (bool isStartRepeat)
	Set this measure to start a repeat section. More...

void	SetTempo (int tempo)
	Set the tempo. More...

csString	ToXML (uint number, csString attributes="")
	Writes this measure as a <measure> XML node. More...

	~Measure ()
	Destructor. More...

	~Measure ()
	Destructor. More...

Detailed Description

template<typename MeasureElementType>
class Measure< MeasureElementType >

A measure containing measure elements.

Definition at line 229 of file pawssheetline.h.

Constructor & Destructor Documentation

template<typename MeasureElementType>

Measure< MeasureElementType >::Measure ( Chord * firstChord )

Constructor.

Creates a non empty measure.

Parameters

firstChord the first chord of the measure.

template<typename MeasureElementType>

Measure< MeasureElementType >::Measure	(	csRef< iDocumentNode >	measure,
		int	quarterDivisions
	)

Constructor.

Creates a measure from a <measure> XML node.

Parameters

measure	the <measure> XML node.
quarterDivisions	the number of divisions in a quarter.

template<typename MeasureElementType>

Measure< MeasureElementType >::~Measure ( )

Destructor.

template<typename MeasureElementType>

Measure< MeasureElementType >::Measure ( )

Constructor.

template<typename MeasureElementType>

Measure< MeasureElementType >::~Measure ( )

Destructor.

Member Function Documentation

template<typename MeasureElementType>

void Measure< MeasureElementType >::AppendMeasure ( Measure< MeasureElementType > * measure )

Append the given measure after this one.

This is not an insertion and the next measure is lost.

Parameters

measure the measure to insert.

template<typename MeasureElementType>

void Measure< MeasureElementType >::AttachMeasure ( Measure< MeasureElementType > * measure )

Insert the given measure after this one and update the chord list.

If the given measure is already the next one it does nothing.

Parameters

measure the measure to insert.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::Cut ( uint divisions )

Cut the last chords of the measures that exceeds the given number of durations.

Parameters

divisions the number of divisions that this measure must have.

Returns: true if this measure is completed, false otherwise.

template<typename MeasureElementType>

void Measure< MeasureElementType >::DeleteAllElements ( )

inline

Delete all elements from the measure.

Definition at line 422 of file scoreelements.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::DeleteChord ( Chord * chord )

Deletes the chord if it belong to this measure.

Parameters

chord the chord to delete.

template<typename MeasureElementType>

void Measure< MeasureElementType >::DeleteElement ( size_t n )

inline

Delete the element in position n.

If n is not a valid index it does nothing.

Parameters

n	The index of the measure element.

Definition at line 417 of file scoreelements.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::Draw	(	pawsSheetLine *	pawsLine,
		Chord *	selectedChord,
		int	startPosition
	)

Draws this measure.

Parameters

pawsLine	the pawsSheetLine that store the font-dependent parameters.
selectedChord	the current selected chord.
startPosition	the horizontal position where the first chord must be drawn.

template<typename MeasureElementType>

void Measure< MeasureElementType >::Empty ( )

Deletes all the chords in this line and keeps only an empty chord.

template<typename MeasureElementType>

void Measure< MeasureElementType >::Fill ( uint divisions )

Fills the measure with rests if it is incomplete.

Converts all the empty chords into rests of the same duration.

Parameters

divisions the number of divisions that this measure must have.

template<typename MeasureElementType>

void Measure< MeasureElementType >::Fit ( const MeasureAttributes *const attributes )

Remove the elements at the end of the measures that exceeds the total duration or push a rest if there are not enough elements.

The total duration is determined from the beat and beat type contained in the attributes. Attributes specified in this measure have priority. If they are undefined, the given attributes are used instead.

Parameters

attributes Attributes of previous measures. This can be a null pointer if this measure specifies both beat and beat type. If this is not the case however, the parameter must specify at least information about beat and beat type.

template<typename MeasureElementType>

MeasureAttributes Measure< MeasureElementType >::GetAttributes ( ) const

Get a copy of the attributes of this measure.

Returns: The attributes of this measure.

template<typename MeasureElementType>

MeasureElementType& Measure< MeasureElementType >::GetElement ( size_t n )

inline

Get the element at position n.

Parameters

n	The index of the element.

Returns: The element.

Definition at line 450 of file scoreelements.h.

template<typename MeasureElementType>

const MeasureElementType& Measure< MeasureElementType >::GetElement ( size_t n ) const

inline

Get the element at position n.

Parameters

n	The index of the element.

Returns: The element.

Definition at line 455 of file scoreelements.h.

template<typename MeasureElementType>

uint Measure< MeasureElementType >::GetEnding ( )

inline

Gets the number of this ending.

Returns: the number of the ending, 0 if this is not an ending.

Definition at line 319 of file pawssheetline.h.

template<typename MeasureElementType>

uint Measure< MeasureElementType >::GetEndRepeat ( )

inline

Gets the number of times this part must be repeat.

Returns: the number of times this part must be repeat.

Definition at line 307 of file pawssheetline.h.

template<typename MeasureElementType>

Chord* Measure< MeasureElementType >::GetFirstChord ( )

inline

Returns the first chord of this measure.

Returns: the first chord of this measure.

Definition at line 345 of file pawssheetline.h.

template<typename MeasureElementType>

Chord* Measure< MeasureElementType >::GetLastChord ( )

inline

Returns the last chord of this measure.

Returns: the last chord of this measure.

Definition at line 351 of file pawssheetline.h.

template<typename MeasureElementType>

uint Measure< MeasureElementType >::GetMimimumSize ( uint noteLength )

Gets the mimimum size of this measure.

Parameters

noteLength the length of a note.

Returns: the mimimum size of this measure.

template<typename MeasureElementType>

uint Measure< MeasureElementType >::GetNChords ( )

inline

Returns the number of chords in this measure.

Returns: the number of chords in this measure.

Definition at line 266 of file pawssheetline.h.

template<typename MeasureElementType>

size_t Measure< MeasureElementType >::GetNElements ( ) const

inline

Get the number of elements in this measure.

Returns: The number of elements in this measure.

Definition at line 462 of file scoreelements.h.

template<typename MeasureElementType>

int Measure< MeasureElementType >::GetNEndRepeat ( ) const

inline

Get the number of time the repeat at the end of this measure must be performed.

Returns: The number of time the repeat must be performed or 0 if there is not a repeat at the end of the measure.

Definition at line 470 of file scoreelements.h.

template<typename MeasureElementType>

uint Measure< MeasureElementType >::GetSize ( uint noteLength )

Returns the measure's size.

Parameters

noteLength the length of a note.

Returns: the measure's size.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::GetStartRepeat ( )

inline

Gets the start repeat state.

Returns: the start repeat state.

Definition at line 295 of file pawssheetline.h.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::Hit	(	int	x,
		Chord *&	chord,
		bool &	before
	)

Check if a chord in this measure is hit.

Parameters

x	the horizontal position of the input from the beginning of the measure.
chord	at the end this pointer will contains the hit chord or null if any chord has been hit.
before	at the end this boolean will be true if the click has happened before the selected chord, false if after.

Returns: true if a note has been hit, false otherwise.

template<typename MeasureElementType>

Chord* Measure< MeasureElementType >::InsertChord	(	Chord *	nearChord,
		bool	before
	)

Inserts a new empty chord before or after the given one.

Parameters

nearChord	the chord near the new one.
before	true to insert before the given chord, false to insert it after.

Returns: the new Chord.

template<typename MeasureElementType>

void Measure< MeasureElementType >::InsertElement	(	size_t	n,
		const MeasureElementType &	element
	)

Insert a copy of the given element after element n.

If n is greater than the number of elements in this measure, the element is pushed at the end.

Parameters

n	The number of the element after which the given element must be inserted.
element	The element to insert in the measure.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::IsEmpty ( ) const

inline

Check if the measure has at least one element.

Returns: True if this measure does not contain elements, false otherwise.

Definition at line 486 of file scoreelements.h.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::IsEnding ( ) const

inline

Return true if this is an ending measure.

Returns: True if this is an ending measure, false otherwise.

Definition at line 493 of file scoreelements.h.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::IsEndRepeat ( ) const

inline

Return true if this measure ends a repeat section.

Returns: True if this is the end of a repeat section, false otherwise.

Definition at line 500 of file scoreelements.h.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::IsStartRepeat ( ) const

inline

Return true if this measure starts a repeat section.

Returns: True if this is the start of a repeat section, false otherwise.

Definition at line 507 of file scoreelements.h.

template<typename MeasureElementType>

Measure* Measure< MeasureElementType >::Next ( )

inline

Returns the next Measure.

Returns: the next Measure.

Definition at line 254 of file pawssheetline.h.

template<typename MeasureElementType>

Measure* Measure< MeasureElementType >::Prev ( )

inline

Returns the previous Measure.

Returns: the previous Measure.

Definition at line 260 of file pawssheetline.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::PushChord ( Chord * chord )

Pushes a chord at the end of the measure.

Parameters

chord the new chord.

template<typename MeasureElementType>

size_t Measure< MeasureElementType >::PushElement ( const MeasureElementType & element )

inline

Push a copy of the given element after all the elements currently in the measure.

Parameters

element The element to push in the measure.

Returns: The index of the pushed element.

Definition at line 515 of file scoreelements.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetBeat	(	int	beats,
		int	beatType
	)

Set the beat information.

Both beats and beatType must be defined. If only one of them is undefined, both of them will be saved as undefined.

Parameters

beats	The numerator of the time signature.
beatType	The denominator of the time signature.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetEnding ( bool isEnding )

Sets this measure as an ending and updates all the following endings.

Parameters

isEnding true if this is an ending.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetEnding ( bool isEnding )

Set this measure as an ending.

Parameters

isEnding True if this is an ending, false otherwise.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetEndRepeat ( uint repeat )

inline

Sets the number of times this part must be repeat.

Parameters

repeat 0 to not repeat.

Definition at line 313 of file pawssheetline.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetFifths ( int fifths )

Set the key signature as the number of accidentals.

Parameters

fifths The number of accidentals in the key signature. Positive for sharps, negative for flats.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetNEndRepeat ( int nEndRepeat )

Set the number of time the repeat at the end of this measure must be performed.

Parameters

nEndRepeat The number of time the repeat must be performed or 0 if this measure does not end a repeat.

template<typename MeasureElementType>

bool Measure< MeasureElementType >::SetSize	(	uint	size,
		uint	noteLength
	)

Sets the measure's size.

Parameters

size	the new size of the measure.
noteLength	the length of the note with the current font.

Returns: true if the given space is greater than the minimum space allowed.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetStartRepeat ( bool repeat )

inline

Sets the start repeat of this measure.

Parameters

repeat true to start a repeat, false otherwise.

Definition at line 301 of file pawssheetline.h.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetStartRepeat ( bool isStartRepeat )

Set this measure to start a repeat section.

Parameters

isEnding True if this is the start of a repeat section, false otherwise.

template<typename MeasureElementType>

void Measure< MeasureElementType >::SetTempo ( int tempo )

Set the tempo.

Parameters

tempo The new tempo.

template<typename MeasureElementType>

csString Measure< MeasureElementType >::ToXML	(	uint	number,
		csString	attributes = `""`
	)

Writes this measure as a <measure> XML node.

Parameters

number	the number of this measure.
attributes	the attributes and direction nodes.

Returns: the <measure> XML node.

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

client/gui/pawssheetline.h
common/music/scoreelements.h

Classes

Public Member Functions

Detailed Description

template<typename MeasureElementType> class Measure< MeasureElementType >

Constructor & Destructor Documentation

Member Function Documentation

template<typename MeasureElementType>
class Measure< MeasureElementType >