Audio playback of the score. This class creates playback events (usually MIDI events) for the music elements and sends these events to one of the playback devices (usually CAMidiDevice). More...

#include <playback.h>

Inheritance diagram for CAPlayback:

[legend]

List of all members.

Public Slots
void	stopNow ()
Signals
void	playbackFinished ()
Public Member Functions
	CAPlayback (CASheet , CAMidiDevice )
	CAPlayback (CAMidiDevice *, int port)
	~CAPlayback ()
void	run ()
void	stop ()
void	playImmediately (QList< CAMusElement * > elts, int port)
const int	getInitTimeStart ()
void	setInitTimeStart (int t)
CAMidiDevice *	midiDevice ()
CASheet *	sheet ()
void	setSheet (CASheet *s)
QList< CAPlayable * > &	curPlaying ()
Private Member Functions
void	initStreams (CASheet *sheet)
void	loopUntilPlayable (int i, bool ignoreRepeats=false)
void	playSelectionImpl ()
QList< CAMusElement * >	streamAt (int idx)
int	streamCount ()
int &	streamIdx (int i)
int &	curTime (int i)
int &	lastRepeatOpenIdx (int i)
bool &	repeating (int i)
bool	stopLock ()
void	setStopLock (bool lock)
void	setMidiDevice (CAMidiDevice *d)
void	setStop (bool stop)
Private Attributes
CASheet *	_sheet
CAMidiDevice *	_midiDevice
bool	_stop
bool	_stopLock
bool	_playSelectionOnly
QList< CAMusElement * >	_selection
int	_initTimeStart
QList< QList< CAMusElement * > >	_stream
QList< CAPlayable * >	_curPlaying
int *	_streamIdx
bool *	_repeating
int *	_lastRepeatOpenIdx
int *	_curTime

Detailed Description

Audio playback of the score. This class creates playback events (usually MIDI events) for the music elements and sends these events to one of the playback devices (usually CAMidiDevice).

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

    To use the playback capabilities:
    1) Create one of the CAMidiDevices (eg. CARtMidiDevice) and configure it (open output/input port).
    2) Create CAPlayback object passing it the current score viewport (played notes will be painted red) or only
       the sheet (usually used in scripting environment) and the midi device.
    3) Optionally configure playback (setInitTimeStart() to start playback from the specific time. Default 0).
    4) Call myPlaybackObject->run(). This will start playing in a new thread.
    5) Call myPlaybackObject->stop() to stop the playback. Playback also stops automatically when finished.

    The playbackFinished() signal is emitted once playback has finished or stopped.

    If you want to immediately play only given elements (eg. when inserting notes), call playImmediately().

Constructor & Destructor Documentation

CAPlayback::CAPlayback	(	CASheet *	s,
		CAMidiDevice *	m
	)

References _curTime, _lastRepeatOpenIdx, _playSelectionOnly, _repeating, _stop, _streamIdx, setInitTimeStart(), setMidiDevice(), setSheet(), setStopLock(), and stopNow().

Here is the call graph for this function:

CAPlayback::CAPlayback	(	CAMidiDevice *	m,
		int	port
	)

Plays the list of music elements simultaniously. It only takes notes into account.

References _curTime, _lastRepeatOpenIdx, _playSelectionOnly, _repeating, _stop, _streamIdx, setMidiDevice(), setStopLock(), and stopNow().

Here is the call graph for this function:

CAPlayback::~CAPlayback ( )

Destructor deletes the created arrays.

References _curTime, _lastRepeatOpenIdx, _repeating, and _streamIdx.

Member Function Documentation

QList<CAPlayable*>& CAPlayback::curPlaying ( ) [inline]

References _curPlaying.

Referenced by CAMainWin::deleteSelection(), and CAMainWin::onRepaintTimerTimeout().

Here is the caller graph for this function:

int& CAPlayback::curTime ( int i ) [inline, private]

References _curTime.

Referenced by initStreams(), loopUntilPlayable(), playSelectionImpl(), and run().

Here is the caller graph for this function:

const int CAPlayback::getInitTimeStart ( ) [inline]

References _initTimeStart.

Referenced by initStreams().

Here is the caller graph for this function:

void CAPlayback::initStreams ( CASheet * sheet ) [private]

Generates streams (elements lists) of playable elements (notes, rests) from the given sheet.

References _curTime, _lastRepeatOpenIdx, _repeating, _stream, _streamIdx, CASheet::contextAt(), CASheet::contextCount(), CAContext::contextType(), curTime(), getInitTimeStart(), lastRepeatOpenIdx(), loopUntilPlayable(), CAVoice::midiChannel(), midiDevice(), CAVoice::midiProgram(), CAVoice::musElementList(), repeating(), CAMidiDevice::send(), CAContext::Staff, streamCount(), streamIdx(), CAStaff::voiceAt(), and CAStaff::voiceCount().

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

int& CAPlayback::lastRepeatOpenIdx ( int i ) [inline, private]

References _lastRepeatOpenIdx.

Referenced by initStreams(), and loopUntilPlayable().

Here is the caller graph for this function:

void CAPlayback::loopUntilPlayable	(	int	i,
		bool	ignoreRepeats = `false`
	)		`[private]`

Loops from the stream with the given index i until the last element with smaller or equal start time of the current time. This function also remembers any special signs like open repeat barlines.

References CAMusElement::Barline, curTime(), lastRepeatOpenIdx(), CAMusElement::Note, CABarline::RepeatClose, repeating(), CABarline::RepeatOpen, streamAt(), and streamIdx().

Referenced by initStreams(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

CAMidiDevice* CAPlayback::midiDevice ( ) [inline]

References _midiDevice.

Referenced by initStreams(), playImmediately(), playSelectionImpl(), and run().

Here is the caller graph for this function:

void CAPlayback::playbackFinished ( ) [signal]

Referenced by stopNow().

Here is the caller graph for this function:

void CAPlayback::playImmediately	(	QList< CAMusElement * >	elts,
		int	port
	)

Immediately plays the given elts.

References _selection, midiDevice(), and CAMidiDevice::openOutputPort().

Referenced by CAMainWin::playImmediately().

Here is the call graph for this function:

Here is the caller graph for this function:

void CAPlayback::playSelectionImpl ( ) [private]

Private function for immediately playing the music elements in _selection. This function ends when all the notes in _selection queue are played. _selection queue might be refilled during the playback by calling playImmediately().

This function is usually called when inserting new notes. If the first note is still playing, the second note is played simultaniously - thus having two notes in _selection for eg.

References _curPlaying, _selection, _stop, curTime(), CANote::diatonicPitch(), CAMidiDevice::diatonicPitchToMidiPitch(), CAVoice::midiChannel(), midiDevice(), CAVoice::midiProgram(), CAMusElement::Note, CAMidiDevice::send(), stop(), CAMusElement::timeLength(), and CAPlayable::voice().