qmlpluginapi.h

//=============================================================================
//  MuseScore
//  Music Composition & Notation
//
//  Copyright (C) 2012 Werner Schweer
//
//  This program is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License version 2
//  as published by the Free Software Foundation and appearing in
//  the file LICENCE.GPL
//=============================================================================

#ifndef __QMLPLUGINAPI_H__
#define __QMLPLUGINAPI_H__

#include "config.h"
#include "../qmlplugin.h"
#include "enums.h"
#include "libmscore/harmony.h"
#include "libmscore/lyrics.h"
#include "libmscore/mscore.h"
#include "libmscore/utils.h"
#include "libmscore/score.h"
#include "libmscore/spanner.h"

namespace Ms {

class Element;
class MScore;

namespace PluginAPI {

class Element;
class FractionWrapper;
class MsProcess;
class Score;

#define DECLARE_API_ENUM(qmlName, cppName, enumName) \
      Q_PROPERTY(Ms::PluginAPI::Enum* qmlName READ get_##cppName CONSTANT) \
      static Enum* cppName; \
      static Enum* get_##cppName() { \
            if (!cppName) \
                  cppName = wrapEnum<enumName>(); \
            return cppName; \
      }

//---------------------------------------------------------
//   @P scores               array[Ms::Score]  all currently open scores (read only)
//---------------------------------------------------------

class PluginAPI : public Ms::QmlPlugin {
      Q_OBJECT
      Q_PROPERTY(QString menuPath        READ menuPath WRITE setMenuPath)
      Q_PROPERTY(QString filePath        READ filePath)
      Q_PROPERTY(QString version         READ version WRITE setVersion)
      Q_PROPERTY(QString description     READ description WRITE setDescription)
      Q_PROPERTY(QString pluginType      READ pluginType WRITE setPluginType)
      Q_PROPERTY(QString dockArea        READ dockArea WRITE setDockArea)
      Q_PROPERTY(bool requiresScore      READ requiresScore WRITE setRequiresScore)
      Q_PROPERTY(int division            READ division)
      Q_PROPERTY(int mscoreVersion       READ mscoreVersion       CONSTANT)
      Q_PROPERTY(int mscoreMajorVersion  READ mscoreMajorVersion  CONSTANT)
      Q_PROPERTY(int mscoreMinorVersion  READ mscoreMinorVersion  CONSTANT)
      Q_PROPERTY(int mscoreUpdateVersion READ mscoreUpdateVersion CONSTANT)
      Q_PROPERTY(qreal mscoreDPI         READ mscoreDPI)
      Q_PROPERTY(Ms::PluginAPI::Score* curScore     READ curScore)
      Q_PROPERTY(QQmlListProperty<Ms::PluginAPI::Score> scores READ scores)

      // Should be initialized in qmlpluginapi.cpp
      DECLARE_API_ENUM( Element,          elementTypeEnum,        Ms::ElementType           )
      DECLARE_API_ENUM( Accidental,       accidentalTypeEnum,     Ms::AccidentalType        )
      DECLARE_API_ENUM( Beam,             beamModeEnum,           Ms::Beam::Mode            )
      DECLARE_API_ENUM( Placement,        placementEnum,          Ms::Placement             )
      DECLARE_API_ENUM( Glissando,        glissandoTypeEnum,      Ms::GlissandoType         ) // was probably absent in 2.X
      DECLARE_API_ENUM( LayoutBreak,      layoutBreakTypeEnum,    Ms::LayoutBreak::Type     )
      DECLARE_API_ENUM( Lyrics,           lyricsSyllabicEnum,     Ms::Lyrics::Syllabic      )
      DECLARE_API_ENUM( Direction,        directionEnum,          Ms::Direction             )
      DECLARE_API_ENUM( DirectionH,       directionHEnum,         Ms::MScore::DirectionH    )
      DECLARE_API_ENUM( OrnamentStyle,    ornamentStyleEnum,      Ms::MScore::OrnamentStyle )
      DECLARE_API_ENUM( GlissandoStyle,   glissandoStyleEnum,     Ms::GlissandoStyle        )
      DECLARE_API_ENUM( Tid,              tidEnum,                Ms::Tid                   )
      DECLARE_API_ENUM( Align,            alignEnum,              Ms::Align                 )
      DECLARE_API_ENUM( NoteType,         noteTypeEnum,           Ms::NoteType              )
      DECLARE_API_ENUM( PlayEventType,    playEventTypeEnum,      Ms::PlayEventType         )
      DECLARE_API_ENUM( NoteHeadType,     noteHeadTypeEnum,       Ms::NoteHead::Type        )
      DECLARE_API_ENUM( NoteHeadScheme,   noteHeadSchemeEnum,     Ms::NoteHead::Scheme      )
      DECLARE_API_ENUM( NoteHeadGroup,    noteHeadGroupEnum,      Ms::NoteHead::Group       )
      DECLARE_API_ENUM( NoteValueType,    noteValueTypeEnum,      Ms::Note::ValueType       )
      DECLARE_API_ENUM( Segment,          segmentTypeEnum,        Ms::SegmentType           )
      DECLARE_API_ENUM( Spanner,          spannerAnchorEnum,      Ms::Spanner::Anchor       ) // probably unavailable in 2.X
      DECLARE_API_ENUM( SymId,            symIdEnum,              Ms::SymId                 )
      DECLARE_API_ENUM( HarmonyType,      harmonyTypeEnum,        Ms::HarmonyType           )

      QFile logFile;

   signals:
      void run();

      void scoreStateChanged(const QMap<QString, QVariant>& state);

   public:
      PluginAPI(QQuickItem* parent = 0);

      static void registerQmlTypes();

      void runPlugin() override            { emit run();       }
      void endCmd(const QMap<QString, QVariant>& stateInfo) override { emit scoreStateChanged(stateInfo); }

      Score* curScore() const;
      QQmlListProperty<Score> scores();

      Q_INVOKABLE Ms::PluginAPI::Score* newScore(const QString& name, const QString& part, int measures);
      Q_INVOKABLE Ms::PluginAPI::Element* newElement(int);
      Q_INVOKABLE void removeElement(Ms::PluginAPI::Element* wrapped);
      Q_INVOKABLE void cmd(const QString&);
      Q_INVOKABLE Ms::PluginAPI::MsProcess* newQProcess();
      Q_INVOKABLE bool writeScore(Ms::PluginAPI::Score*, const QString& name, const QString& ext);
      Q_INVOKABLE Ms::PluginAPI::Score* readScore(const QString& name, bool noninteractive = false);
      Q_INVOKABLE void closeScore(Ms::PluginAPI::Score*);

      Q_INVOKABLE void log(const QString&);
      Q_INVOKABLE void logn(const QString&);
      Q_INVOKABLE void log2(const QString&, const QString&);
      Q_INVOKABLE void openLog(const QString&);
      Q_INVOKABLE void closeLog();

      Q_INVOKABLE Ms::PluginAPI::FractionWrapper* fraction(int numerator, int denominator) const;
      };

#undef DECLARE_API_ENUM
} // namespace PluginAPI
} // namespace Ms
#endif