Logo Search packages:      
Sourcecode: rosegarden version File versions

NoteSymbols.h

#ifndef SYMBOLS_H_
#define SYMBOLS_H_

#include <qbrush.h>
#include <qpainter.h>

#include <iostream>

#include "GuitarNeck.h"
#include "Fingering.h"
#include "FingeringConstructor.h"

namespace Rosegarden
{

/**
 *----------------------------------------
 * Finding X position on fretboard pixmap
 *----------------------------------------
 *
 * Originally x = position * scale + FC::BORDER + FC::CIRCBORD + FC::FRETTEXT
 *
 * The last three can be condense into on term called XBorder
 *      XBorder = FC::BORDER + FC::CIRCBORD + FC::FRETTEXT
 *             = 5 + 2 + 10 (see fingers.h)
 *             = 17
 *
 * The drawable fretboard space on the x-axis:
 *      XFretboard = pixmap width - XBorder
 *                = width - 17
 *
 * The fretboard x-axis is broken up into colums which represent the drawable
 * space for a fretboard component (e.g. note, barre)
 *      Column Width = XFretboard / number of strings
 *
 * Therefore a new x can be calculated from the position and the column width
 *      x = (position * Column Width) + XBorder
 *
 *-------------------------------------------
 * Finding Y position on fretboard pixmap
 *-------------------------------------------
 *
 * Originally y = (FC::BORDER * scale) + (2 * FC::SPACER) + (fret * scale) + FC::CIRCBORD
 *
 * As with the x-axis the equation can be separated into the position plus the border. In
 * this case YBorder
 *      YBorder = (FC::BORDER*scale) + (2*FC::SPACER) + FC::CIRCBORD
 *              = 17 (If we want to use the same border as the x-axis)
 *
 * The drawable fretboard space on the y-axis:
 *      YFretboard = pixmap height - YBorder
 *
 * The fretboard y-axis is broken up into rows which represent the drawable
 * space for a fretboard component (e.g. note, barre)
 *      Row Height = YFretboard / number of frets
 *
 * Therefore a new y can be calculated from the fret position and the row height
 *      y = fret * Row Height
 **/

namespace Guitar
{

class NoteSymbols
{
private:
    typedef FingeringConstructor FC;
    typedef std::pair<unsigned int, unsigned int> posPair;

    static float const LEFT_BORDER_PERCENTAGE;
    static float const RIGHT_BORDER_PERCENTAGE;
    static float const FRETBOARD_WIDTH_PERCENTAGE;
    static float const TOP_BORDER_PERCENTAGE;
    static float const BOTTOM_BORDER_PERCENTAGE;
    static float const FRETBOARD_HEIGHT_PERCENTAGE;

public:

    //! Display a mute symbol in the QPainter object
    void
    drawMuteSymbol ( QPainter* p,
                     unsigned int position,
                     unsigned int fretDisplayed,
                     unsigned int string_num );

    /* This code borrowed from KGuitar 0.5 */
    //! Display a open symbol in the QPainter object (KGuitar)
    void drawOpenSymbol ( QPainter* p,
                          unsigned int position,
                          unsigned int fretDisplayed,
                          unsigned int string_num );

    /* This code borrowed from KGuitar 0.5 */
    //! Display a note symbol in the QPainter object (KGuitar)
    void drawNoteSymbol ( QPainter* p,
                          unsigned int position,
                          int fret,
                          unsigned int string_num,
                          unsigned int fretDisplayed );

    /* This code borrowed from KGuitar 0.5 */
    /**
     * Display a bar symbol in the QPainter object (KGuitar)
     * The code from the KGuitar project was modified to display a bar. This feature was not
     * available in that project
     */
    void drawBarreSymbol ( QPainter* p,
                           int fret,
                           unsigned int start,
                           unsigned int end,
                           unsigned int string_num,
                           unsigned int fretDisplayed );

    void drawFretNumber ( QPainter* p,
                          unsigned int fret_num,
                          unsigned int fretsDisplayed );

    void drawFretHorizontalLines ( QPainter* p,
                                   unsigned int fretsDisplayed,
                                   unsigned int maxStringNum );

    void drawFretVerticalLines ( QPainter* p,
                                 unsigned int maxFretsDisplayed,
                                 unsigned int string_num );

    unsigned int getTopBorder ( unsigned int imgHeight );

    unsigned int getBottomBorder ( unsigned int imgHeight );

    unsigned int getLeftBorder ( unsigned int imgWidth );

    unsigned int getRightBorder ( unsigned int imgWidth );

    unsigned int getFretboardWidth ( int imgWidth );

    unsigned int getFretboardHeight ( int imgHeight );

    std::pair<bool, unsigned int>
    getStringNumber ( int imgWidth,
                      unsigned int x_pos,
                      unsigned int string_num );

    std::pair<bool, unsigned int>
    getFretNumber ( int imgHeight,
                    unsigned int y_pos,
                    unsigned int maxFretNum );

private:

    posPair
    getX ( int imgWidth, unsigned int position, unsigned int string_num );

    posPair
    getY ( int imgHeight, unsigned int position, unsigned int fret_num );



};

} /* namespace Guitar */

}

#endif /* SYMBOLS_H_ */


Generated by  Doxygen 1.6.0   Back to index