Class used for tuplets (triplets, duols etc.) More...

#include <tuplet.h>

Inheritance diagram for CATuplet:

Public Member Functions
	CATuplet (int number, int actualNumber, QList< CAPlayable * > noteList)
	CATuplet (int number, int actualNumber)
virtual	~CATuplet ()
CATuplet *	clone (CAContext *context=0)
CATuplet *	clone (QList< CAPlayable * > newList)
int	compare (CAMusElement *)
int	number ()
void	setNumber (int n)
int	actualNumber ()
void	setActualNumber (int n)
QList< CAPlayable * > &	noteList ()
void	addNote (CAPlayable *p)
void	addNotes (QList< CAPlayable * > l)
void	removeNote (CAPlayable *p)
CAPlayable *	firstNote ()
CAPlayable *	lastNote ()
bool	containsNote (CAPlayable *p)
CAPlayable *	nextTimed (CAPlayable *p)
int	timeLength ()
int	timeStart ()
void	assignTimes ()
Private Member Functions
void	resetTimes ()
Private Attributes
int	_number
int	_actualNumber
QList< CAPlayable * >	_noteList

Detailed Description

Class used for tuplets (triplets, duols etc.)

Licensed under the GNU GENERAL PUBLIC LICENSE. See LICENSE.GPL for details.

    Tuplets are a rhythmic specialty. They are used to shorten the set of
    notes for a specified multiplier.

    Most used tuplets are triplets (multiplier 2/3) and duols (multiplier 3/4).

Constructor & Destructor Documentation

CATuplet::CATuplet	(	int	number,
		int	actualNumber,
		QList< CAPlayable * >	noteList
	)

Constructs a tuplet.

number is the existing number of notes and actualNumber is the desired length of the notes expressed in number of them. These parameters are used to calculate the multiplier of the notes. eg. number=3, actualNumber=2 multiplies all notes by a factor of 2/3.

noteList is a sorted list of rests and notes under the tuplet. Elements should already be part of the voice.

References assignTimes(), CAMusElement::setMusElementType(), and CAMusElement::Tuplet.

Referenced by clone().

Here is the call graph for this function:

Here is the caller graph for this function:

CATuplet::CATuplet	(	int	number,
		int	actualNumber
	)

Constructs an empty tuplet.

Add notes and rests under it manually by calling addNote(). Call assignTimes() to apply the actual times then.

References CAMusElement::setMusElementType(), and CAMusElement::Tuplet.

Here is the call graph for this function:

CATuplet::~CATuplet ( ) [virtual]

References resetTimes().

Here is the call graph for this function:

Member Function Documentation

int CATuplet::actualNumber ( ) [inline]

References _actualNumber.

Referenced by assignTimes(), clone(), CAStaff::clone(), compare(), CALilyPondExport::exportPlayable(), CACanorusMLExport::exportVoiceImpl(), and CAMainWin::insertMusElementAt().

Here is the caller graph for this function:

void CATuplet::addNote ( CAPlayable * p )

Adds a note to the tuplet.

References CAMusElement::Note, noteList(), and CAMusElement::timeStart().

Referenced by CAMainWin::deleteSelection(), CAVoice::insertInTupletAndVoiceAt(), and CACanorusMLImport::startElement().

Here is the call graph for this function:

Here is the caller graph for this function:

void CATuplet::addNotes ( QList< CAPlayable * > l ) [inline]

References noteList().

Here is the call graph for this function:

void CATuplet::assignTimes ( )

Transforms note times to tuplet-affected times.

The use case should be somewhat this: 1) Place ordinary notes and rests. 2) Create a tuplet containing them. This calls assignTimes() automatically to transform music elements times.

This function requires elements to be part of the voice.

See also:: resetTimes()

References actualNumber(), CAMusElement::context(), firstNote(), CAVoice::insert(), CAMusElement::musElementType(), CAVoice::next(), CAMusElement::Note, noteList(), number(), CAPlayableLength::playableLengthToTimeLength(), CAVoice::remove(), resetTimes(), CAMusElement::setContext(), CAMusElement::setTimeLength(), CAMusElement::timeEnd(), and timeStart().

Referenced by CATuplet(), CAMainWin::deleteSelection(), CACanorusMLImport::endElement(), and CAVoice::insertInTupletAndVoiceAt().

Here is the call graph for this function:

Here is the caller graph for this function:

CATuplet * CATuplet::clone ( CAContext * context = 0 ) [virtual]

Clones a music element with exact properties including the context.

Implements CAMusElement.

References actualNumber(), CATuplet(), noteList(), and number().

Referenced by CAMainWin::copySelection(), and CAMainWin::pasteAt().

Here is the call graph for this function:

Here is the caller graph for this function:

CATuplet * CATuplet::clone ( QList< CAPlayable * > newList )

References actualNumber(), CATuplet(), and number().

Here is the call graph for this function:

int CATuplet::compare ( CAMusElement * elt ) [virtual]

Compares the music element with the given elt and returns number of differences in their properties. Returns 0, if the music elements are exact; -1 if the music element type differs; otherwise number greater than 0.

This method is usually used when opening a score document where music elements are written in various voices (eg. barlines), but are eventually merged and written only once per staff.

Implements CAMusElement.

References actualNumber(), CAMusElement::musElementType(), number(), and CAMusElement::Tuplet.

Here is the call graph for this function: