AbstractFigure.h

/* ********************************************************************
    itom software
    URL: http://www.uni-stuttgart.de/ito
    Copyright (C) 2020, Institut für Technische Optik (ITO),
    Universität Stuttgart, Germany
 
    This file is part of itom and its software development toolkit (SDK).
 
    itom is free software; you can redistribute it and/or modify it
    under the terms of the GNU Library General Public Licence as published by
    the Free Software Foundation; either version 2 of the Licence, or (at
    your option) any later version.
 
    In addition, as a special exception, the Institut für Technische
    Optik (ITO) gives you certain additional rights.
    These rights are described in the ITO LGPL Exception version 1.0,
    which can be found in the file LGPL_EXCEPTION.txt in this package.
 
    itom 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 Library
    General Public Licence for more details.
 
    You should have received a copy of the GNU Library General Public License
    along with itom. If not, see <http://www.gnu.org/licenses/>.
*********************************************************************** */
 
#ifndef ABSTRACTFIGURE_H
#define ABSTRACTFIGURE_H
 
#include "plotCommon.h"
#include "AbstractNode.h"
 
#include "../common/apiFunctionsGraphInc.h"
#include "../common/apiFunctionsInc.h"
 
#include <qmainwindow.h>
#include <qlabel.h>
#include <qtoolbar.h>
#include <qevent.h>
#include <qdockwidget.h>
#include <qscopedpointer.h>
 
class QPropertyEditorWidget; //forward declaration
 
#if !defined(Q_MOC_RUN) || defined(ITOMCOMMONPLOT_MOC) //only moc this file in itomCommonQtLib but not in other libraries or executables linking against this itomCommonQtLib
 
//place this macro in the header file of the designer plugin widget class right before the first section (e.g. public:)
#define DESIGNER_PLUGIN_ITOM_API \
            protected: \
                void importItomApi(void** apiPtr) \
                {ito::ITOM_API_FUNCS = apiPtr;} \
                void importItomApiGraph(void** apiPtr) \
                { ito::ITOM_API_FUNCS_GRAPH = apiPtr;} \
            public: \
                //.
 
namespace ito {
 
class AbstractFigure; //forward declaration
class AbstractFigurePrivate; //forward declaration
 
class ITOMCOMMONPLOT_EXPORT AbstractFigure : public QMainWindow, public AbstractNode
{
    Q_OBJECT
 
    Q_PROPERTY(bool toolbarVisible READ getToolbarVisible WRITE setToolbarVisible DESIGNABLE true USER true)
    Q_PROPERTY(bool contextMenuEnabled READ getContextMenuEnabled WRITE setContextMenuEnabled DESIGNABLE true)
    Q_PROPERTY(bool renderLegend READ getLegendRender WRITE setLegendRender DESIGNABLE true)
 
    Q_CLASSINFO("prop://toolbarVisible", "Toggles the visibility of the toolbar of the plot.")
    Q_CLASSINFO("prop://contextMenuEnabled", "Defines whether the context menu of the plot should be enabled or not.")
    Q_CLASSINFO("prop://renderLegend", "If this property is true, the legend are included in pixelmaps renderings.")
 
    Q_CLASSINFO("slot://getPlotID", "Return window ID of this plot {int}.")
    Q_CLASSINFO("slot://refreshPlot", "Triggers an update of the current plot window.")
 
    public:
        enum WindowMode
        {
            ModeInItomFigure,
            ModeStandaloneInUi,
            ModeStandaloneWindow
        };
 
        enum UnitLabelStyle
        {
            UnitLabelSlash,              // x-axis / m  -> corresponds to DIN461
            UnitLabelKeywordIn,          // x-axis in m -> corresponds to DIN461
            UnitLabelSquareBrackets      // x-axis [m]  -> does not correspond to DIN461
        };
 
        //Q_ENUM exposes a meta object to the enumeration types, such that the key names for the enumeration
        //values are always accessible.
        Q_ENUM(WindowMode)
        Q_ENUM(UnitLabelStyle)
 
        struct ToolBarItem {
            ToolBarItem() : toolbar(NULL), visible(1), section(0), key("") {}
            QToolBar *toolbar;
            bool visible;
            int section;
            Qt::ToolBarArea area;
            QString key;
        };
 
        struct ToolboxItem {
            ToolboxItem() : toolbox(NULL), key("") {}
            QDockWidget *toolbox;
            Qt::DockWidgetArea area;
            QString key;
        };
 
        AbstractFigure(const QString &itomSettingsFile, WindowMode windowMode = ModeStandaloneInUi, QWidget *parent = 0);
        virtual ~AbstractFigure();
 
        virtual bool event(QEvent *e);
        void setApiFunctionGraphBasePtr(void **apiFunctionGraphBasePtr);
        void setApiFunctionBasePtr(void **apiFunctionBasePtr);
        void ** getApiFunctionGraphBasePtr(void) { return m_apiFunctionsGraphBasePtr; }
        void ** getApiFunctionBasePtr(void) { return m_apiFunctionsBasePtr; }
 
        virtual RetVal update(void) = 0; 
        //properties
        virtual void setToolbarVisible(bool visible);
        virtual bool getToolbarVisible() const;
        virtual void setContextMenuEnabled(bool show) = 0;
        virtual bool getContextMenuEnabled() const = 0;
 
        QDockWidget *getPropertyDockWidget() const;
 
        virtual bool getLegendRender() const { return false;}
        virtual void setLegendRender(const bool val) { return;}
 
        QList<QMenu*> getMenus() const;
        QList<AbstractFigure::ToolBarItem> getToolbars() const;
        QList<AbstractFigure::ToolboxItem> getToolboxes() const; //the first toolbox is always the property dock widget
        void setWindowTitleExtension(const QString& title); /*< call this method if the window title should be changed. This emits the signal windowTitleChanged which is connected to the plot window.*/
 
    protected:
 
        virtual RetVal init() { return retOk; } //this method is called from after construction and after that the api pointers have been transmitted
 
        virtual void importItomApi(void** apiPtr) = 0;      
        virtual void importItomApiGraph(void** apiPtr) = 0; 
        void addToolBar(QToolBar *toolbar, const QString &key, Qt::ToolBarArea area = Qt::TopToolBarArea, int section = 1); 
        void addToolBarBreak(const QString &key, Qt::ToolBarArea area = Qt::TopToolBarArea); 
        void addToolbox(QDockWidget *toolbox, const QString &key, Qt::DockWidgetArea area = Qt::RightDockWidgetArea); 
                bool removeToolbox(const QString &key); 
                void showToolBar(const QString &key); 
        void hideToolBar(const QString &key); 
        void addMenu(QMenu *menu); 
        void updatePropertyDock(); 
        void setPropertyObservedObject(QObject* obj); 
        RetVal initialize();
 
        RetVal registerShortcutActions(); 
        WindowMode getWindowMode() const;
 
        QString getItomSettingsFile() const;
 
        void **m_apiFunctionsGraphBasePtr;
        void **m_apiFunctionsBasePtr;
 
    private:
        QScopedPointer<AbstractFigurePrivate> d_ptr; 
        Q_DECLARE_PRIVATE(AbstractFigure);
 
    private slots:
        inline void mnuShowToolbar(bool /*checked*/) { setToolbarVisible(true); } 
        void mnuShowProperties(bool checked); 
                void toolBoxDestroyed(QObject *object);
                void toolBarDestroyed(QObject *object);
 
        void actionChanged();
 
    public slots:
        int getPlotID();
        void refreshPlot() { update(); }
 
    signals:
       void windowTitleModified(QString windowTitleSuffix); 
};
 
} // namespace ito
 
#endif //#if !defined(Q_MOC_RUN) || defined(ITOMCOMMONQT_MOC)
 
#endif // ABSTRACTFIGURE_H