#include <clef.h>

Inheritance diagram for CAClef:

Public Types
enum	CAPredefinedClefType { Undefined = -1, Treble, Bass, French, Soprano, Mezzosoprano, Alto, Tenor, Baritone, Varbaritone, Subbass, Percussion, Tablature }
enum	CAClefType { F, G, C, PercussionHigh, PercussionLow, Tab }
Public Member Functions
	CAClef (CAPredefinedClefType type, CAStaff *staff, int time, int offsetInterval=0)
	CAClef (CAClefType type, int c1, CAStaff *staff, int time, int offset=0)
CAClef *	clone (CAContext *context=0)
CAStaff *	staff ()
void	setPredefinedType (CAPredefinedClefType type)
CAClefType	clefType ()
const int	c1 ()
const int	centerPitch ()
int	compare (CAMusElement *elt)
void	setClefType (CAClefType type)
void	setOffset (int offset)
int	offset ()
Static Public Member Functions
static const QString	clefTypeToString (CAClefType)
static CAClefType	clefTypeFromString (const QString)
static const int	offsetFromReadable (const int offsetInterval)
static const int	offsetToReadable (const int offset)
Private Attributes
CAClefType	_clefType
int	_c1
int	_centerPitch
int	_offset

Detailed Description

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

    Represents a clef in the score

    This class represents every clef in the score. It directly inherits the base class
    CAMusElement. Element is not playable (_timeLength=0).

Member Enumeration Documentation

enum CAClef::CAClefType

Enumerator:

F
G
C
PercussionHigh
PercussionLow
Tab

enum CAClef::CAPredefinedClefType

Enumerator:

Undefined
Treble
Bass
French
Soprano
Mezzosoprano
Alto
Tenor
Baritone
Varbaritone
Subbass
Percussion
Tablature

Constructor & Destructor Documentation

CAClef::CAClef	(	CAPredefinedClefType	type,
		CAStaff *	staff,
		int	time,
		int	offsetInterval = `0`
	)

Creates a new predefined clef with type type, parent staff and start time time. _timeLength is set to 0. offsetInterval can be custom -1,0,1 no offset, +8 or -8 etc. mean the 8 written above or below the clef which raises or lowers the clef for one octave or whichever interval. Offset is the musical interval, not the internal offset.

See also:: CAPredefinedClefType, CAMusElement

References CAMusElement::_musElementType, _offset, CAMusElement::Clef, offsetFromReadable(), and setPredefinedType().

Referenced by clone().

Here is the call graph for this function:

Here is the caller graph for this function:

CAClef::CAClef	(	CAClefType	type,
		int	c1,
		CAStaff *	staff,
		int	time,
		int	offset = `0`
	)

Creates a new clef with type type, location of middle C c1, time start time and parent staff. offset is the internal clef offset 0, +7, -7 etc. It does not affect c1.

See also:: CAPredefinedClefType, CAMusElement

References _c1, CAMusElement::_musElementType, _offset, c1(), CAMusElement::Clef, offset(), and setClefType().

Here is the call graph for this function:

Member Function Documentation

const int CAClef::c1 ( ) [inline]

References _c1.

Referenced by CAClef(), CADrawableKeySignature::CADrawableKeySignature(), CADrawableStaff::calculateCenterYCoord(), CADrawableStaff::calculatePitch(), CACanorusMLExport::exportVoiceImpl(), CALilyPondExport::exportVoiceImpl(), and CANote::notePosition().

Here is the caller graph for this function:

const int CAClef::centerPitch ( ) [inline]

References _centerPitch.

CAClefType CAClef::clefType ( ) [inline]

References _clefType.

Referenced by CACanorusMLExport::exportVoiceImpl(), and CALilyPondExport::exportVoiceImpl().

Here is the caller graph for this function:

CAClef::CAClefType CAClef::clefTypeFromString ( const QString type ) [static]

Converts QString type to clef type.

See also:: CAClefType, clefTypeToString()

References C, F, G, PercussionHigh, PercussionLow, and Tab.

Referenced by CACanorusMLImport::startElement().

Here is the caller graph for this function:

const QString CAClef::clefTypeToString ( CAClefType type ) [static]

Converts clef type to QString.

See also:: CAClefType, clefTypeFromString()

References C, F, G, PercussionHigh, PercussionLow, and Tab.

Referenced by CACanorusMLExport::exportVoiceImpl().

Here is the caller graph for this function:

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

Clones a music element with exact properties including the context.

Implements CAMusElement.

References _c1, _clefType, _offset, CAMusElement::_timeStart, CAMusElement::addMark(), CAClef(), and CAMusElement::markList().

Here is the call graph for this function:

int CAClef::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 _c1, _clefType, _offset, CAMusElement::Clef, and CAMusElement::musElementType().

Here is the call graph for this function:

int CAClef::offset ( ) [inline]

References _offset.

Referenced by CAClef(), CACanorusMLExport::exportVoiceImpl(), CALilyPondExport::exportVoiceImpl(), setClefType(), setOffset(), setPredefinedType(), and CAMainWin::updateClefToolBar().

Here is the caller graph for this function:

const int CAClef::offsetFromReadable ( const int offset ) [static]

Converts the musical interval offset to Canorus internal offset. This method is usually called where user inputs the offset interval and it needs to be stored.

See also:: offsetToReadable()

Referenced by CAClef(), and CAMainWin::on_uiClefOffset_valueChanged().

Here is the caller graph for this function:

const int CAClef::offsetToReadable ( const int offsetInterval ) [static]

Converts the internal clef offset to the musical interval. eg. offset +1 means +2 (supper second), +7 means +8 (supper octave), -7 means -8 (sub octave), 0 is an exception and stays 0 (instead of prime)

This method is usually called when displaying the offset of the key (eg. when rendering it).