pianobooster/src/Symbol.h

/*********************************************************************************/
/*!
@file           Symbol.h

@brief          A single musical symbols (eg note, rest, slur) that can appear on the page.

@author         L. J. Barman

    Copyright (c)   2008-2013, L. J. Barman, all rights reserved

    This file is part of the PianoBooster application

    PianoBooster is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    PianoBooster is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with PianoBooster.  If not, see <http://www.gnu.org/licenses/>.

*/
/*********************************************************************************/

#ifndef _SYMBOL_H_
#define _SYMBOL_H_

#include "Util.h"
#include "Cfg.h"
#include "StavePosition.h"

typedef enum
{
    PB_SYMBOL_none,
    PB_SYMBOL_drum,
    PB_SYMBOL_gClef, // The Treble Clef
    PB_SYMBOL_fClef, // The Base Clef
    PB_SYMBOL_sharp,
    PB_SYMBOL_flat,
    PB_SYMBOL_natural,
    PB_SYMBOL_barLine,
    PB_SYMBOL_barMarker,
    PB_SYMBOL_beatMarker,
    PB_SYMBOL_playingZone,
    PB_SYMBOL_theEndMarker,

    PB_SYMBOL_noteHead,             // ONLY ADD NOTES BELOW THIS MAKER
    PB_SYMBOL_demisemiquaver,       // Demisemiquaver / Thirty-second note
    PB_SYMBOL_threesixtyforth,      // Three-sixtyforth note (thirty-second note with dot)
    PB_SYMBOL_semiquaver,           // Semiquaver / Sixteenth note
    PB_SYMBOL_threethirtysecond,    // Three-thirty-second note (sixteenth note with dot)
    PB_SYMBOL_quaver,               // Quaver / Eighth note
    PB_SYMBOL_threesixteenth,       // Three-sixteenth note (eighth note with dot)
    PB_SYMBOL_crotchet,             // Crotchet / Quarter note
    PB_SYMBOL_threeeighth,          // Three-eighth note (quarter note with dot)
    PB_SYMBOL_minim,                // Minim / Half note
    PB_SYMBOL_threequater,          // Three-quater note (half note with dot)
    PB_SYMBOL_semibreve,            // Semibreve / Whole note
    PB_SYMBOL_breve,                // Breve / Double whole note

} musicalSymbol_t;

typedef enum {
    PB_ACCIDENTAL_MODIFER_noChange,
    PB_ACCIDENTAL_MODIFER_suppress,
    PB_ACCIDENTAL_MODIFER_force // force a natural/accidental to be played
} accidentalModifer_t;

#define BEAT_MARKER_OFFSET  20 // used to ensure that beat markers are drawn under the note by drawing them early

class CSymbol
{
public:

    ////////////////////////////////////////////////////////////////////////////////
    //@brief constructors
    CSymbol(musicalSymbol_t type, whichPart_t hand, int midiNote, int clef = -1)
    {
        init();
        m_symbolType = type;
        m_midiNote = midiNote;
        m_hand = hand;
        m_midiDuration = 0;
        m_stavePos.notePos(hand, midiNote, clef);
    }

    CSymbol()
    {
        init();
    }

    CSymbol(musicalSymbol_t type,  CStavePos stavePos, CColor color = Cfg::colorTheme().noteColor)
    {
        init();
        m_symbolType = type;
        m_stavePos = stavePos;
        m_color = color;
        m_hand = stavePos.getHand();
    }

    ////////////////////////////////////////////////////////////////////////////////
    //@brief Get the type of symbol
    musicalSymbol_t getType(){return m_symbolType;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief how long the midi note was played for
    int getMidiDuration(){return m_midiDuration;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief set the midi note duration
    void setMidiDuration(int midiDuration) {m_midiDuration = midiDuration;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief set the note score length
    //@param lengthModifer 0 for normal, 1 for doted rhythm etc
    void setNoteLength(musicalSymbol_t type) {m_symbolType = type;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief returns the midi note number
    int getNote(){return m_midiNote;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief returns the midi note number
    whichPart_t getHand(){return m_hand;}

    ////////////////////////////////////////////////////////////////////////////////
    //@brief get the Stave Position
    CStavePos getStavePos(){return m_stavePos;}

    void setColor(CColor color){ m_color = color;}
    CColor getColor(){return m_color;}
    void setPianistTiming(qint64 timing){ m_pianistTiming = timing;}
    qint64 getPianistTiming(){ return m_pianistTiming; }

    void transpose(int amount)
    {
        if (m_symbolType >= PB_SYMBOL_noteHead)
        {
            m_midiNote += amount;
            m_stavePos.notePos(m_hand, m_midiNote); // The save position has now moved
        }
    }

    void setIndex(int index, int total)
    {
        m_index = index;
        m_total = total;
    }

    int getNoteIndex() { return m_index; }
    int getNoteTotal() { return m_total; }
    ////////////////////////////////////////////////////////////////////////////////
    //! @brief          The accidental
    //! return          0 = none, 1=sharp, -1 =flat, 2=natural.
    int getAccidental() {
        return getStavePos().getAccidental();
    }

    void setAccidentalModifer(accidentalModifer_t value) {m_accidentalModifer = value;}
    accidentalModifer_t getAccidentalModifer() {return m_accidentalModifer;}

    void setClef(int clef = -1)
    {
    	m_stavePos.notePos(m_hand, m_midiNote, clef);
    }

private:
    void init()
    {
        m_symbolType = PB_SYMBOL_none;
        m_midiNote = 0;
        m_hand = PB_PART_none;
        m_midiDuration = 0;
        m_pianistTiming = NOT_USED;
        setIndex(0,0);
        m_accidentalModifer = PB_ACCIDENTAL_MODIFER_noChange;
    }

    CStavePos m_stavePos;
    musicalSymbol_t m_symbolType;
    int m_midiNote;
    accidentalModifer_t m_accidentalModifer; // Used to suppress the second sharp in the same bar
    int m_midiDuration;
    whichPart_t m_hand;

    CColor m_color;
    qint64 m_pianistTiming;
    int m_index;  // the number of the note per hand starting from the bottom.
    int m_total;  // the number of the notes per hand;
};

#endif // _SYMBOL_H_