/*===========================================================================*\ * * * OpenFlipper * * Copyright (c) 2001-2015, RWTH-Aachen University * * Department of Computer Graphics and Multimedia * * All rights reserved. * * www.openflipper.org * * * *---------------------------------------------------------------------------* * This file is part of OpenFlipper. * *---------------------------------------------------------------------------* * * * Redistribution and use in source and binary forms, with or without * * modification, are permitted provided that the following conditions * * are met: * * * * 1. Redistributions of source code must retain the above copyright notice, * * this list of conditions and the following disclaimer. * * * * 2. Redistributions in binary form must reproduce the above copyright * * notice, this list of conditions and the following disclaimer in the * * documentation and/or other materials provided with the distribution. * * * * 3. Neither the name of the copyright holder nor the names of its * * contributors may be used to endorse or promote products derived from * * this software without specific prior written permission. * * * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED * * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A * * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER * * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * * \*===========================================================================*/ //============================================================================= // // CLASS Core // //============================================================================= /** * \file Core.hh * This File contains the header of the frameworks system core */ #ifndef MVIEWWIDGET_HH #define MVIEWWIDGET_HH //== INCLUDES ================================================================= #include // QT INCLUDES #include #include #include #include #include #include #include #include #include #include #include "OpenFlipper/INIFile/INIFile.hh" #include "OpenFlipper/Logging/PluginLogging.hh" #include "OpenFlipper/Scripting/ScriptingWrapper.hh" // Prototypes for scripting #include "OpenFlipper/Scripting/scriptPrototypes/prototypeVec3d.hh" #include "OpenFlipper/Scripting/scriptPrototypes/prototypeVec4d.hh" #include "OpenFlipper/Scripting/scriptPrototypes/prototypeMatrix4x4.hh" #include "OpenFlipper/Scripting/scriptPrototypes/prototypeDataType.hh" #include #include #include #include // #include // Required Interface definition ( Some variables were defined there ) #include "OpenFlipper/BasePlugin/BaseInterface.hh" #include "OpenFlipper/BasePlugin/FileInterface.hh" #include "OpenFlipper/BasePlugin/TypeInterface.hh" #include "OpenFlipper/BasePlugin/MenuInterface.hh" #include "OpenFlipper/BasePlugin/InformationInterface.hh" #include "OpenFlipper/BasePlugin/SelectionInterface.hh" // -> for SelectionInterface::PrimitiveType #include "OpenFlipper/BasePlugin/ContextMenuInterface.hh" #include // Process manager widget #include #include #include #include #include #include #include "SpinBoxEventFilter.hh" //== CLASS DEFINITION ========================================================= struct dataTypes { QString name; DataType type; TypeInterface* plugin; }; /** Core Widget of the Application */ class Core : public QObject { Q_OBJECT public: /// constructor Core(); void init(); /// destructor ~Core(); /// Synchronise two viewers bool add_sync_host(const QString& _name); private slots: /// Handle Mouse events when in Identifier mode void slotMouseEventIdentify( QMouseEvent* _event ); /// Handle Mouse events when in Light mode void slotMouseEventLight( QMouseEvent* _event ); protected: //=========================================================================== /** @name Signals send to Plugins * @{ */ //=========================================================================== signals: /// Signal send to plugins when whole scene is cleared void allCleared(); /// When this Signal is emitted all Plugins are informed that the object list changed void signalObjectUpdated(int); /// When this Signal is emitted all Plugins are informed that some type of update was performed on an object void signalObjectUpdated(int, const UpdateType&); /// When this Signal is emitted when a Wheel Event occures void PluginWheelEvent(QWheelEvent * , const std::string & ); /// When this Signal is emitted when a Mouse Event occures void PluginMouseEvent(QMouseEvent* ); /// Emitted when an light event occurs void PluginMouseEventLight( QMouseEvent* ); /// This signal is emitted if the object has been changed (source/target) void objectSelectionChanged( int ); /// This signal is emitted if one of the viewers updated its view void pluginViewChanged(); /// This signal is emitted after the scene has been drawn void pluginSceneDrawn(); /// The texture with the given name and filename has been added void addTexture( QString, QString , uint, int ); /// The texture with the given name and image has been added void addTexture( QString, QImage , uint, int ); /// The texture with the given name and filename has been added void addTexture( QString, QString , uint ); /// The texture with the given name and image has been added void addTexture( QString, QImage , uint ); /// The texture with the given name and filename has been added void addMultiTexture( QString _textureGroup , QString _name , QString _filename , int _id , int& _textureId ); /// The texture with the given name and image has been added void addMultiTexture( QString _textureGroup , QString _name , QImage _image , int _id , int& _textureId ); /// Tell the plugins to update the given texture void updateTexture( QString , int ); /// Update all textures in the plugins void updateAllTextures( ); /// This Signal is send to the plugins if a texture has been updated void updatedTextures( QString , int ); /// A texture mode should be changed void setTextureMode(QString _textureName ,QString _mode, int _id); /// A texture mode should be changed void setTextureMode(QString _textureName ,QString _mode); /// Switch Texture Plugins to a given Mode void switchTexture( QString, int ); /// Switch Texture Plugins to a given Mode void switchTexture( QString ); /// Change the image for a given texture void textureChangeImage( QString _textureName , QImage& _image ); /// Change the image for a given texture void textureChangeImage( QString _textureName , QImage& _image , int _id ); ///fetch texture image void textureGetImage( QString _textureName , QImage& _image ); ///fetch texture image void textureGetImage( QString _textureName , QImage& _image , int _id ); /// get the texture index void textureIndex( QString _textureName, int _id, int& _index); /// get the texture index property name void textureIndexPropertyName( int _id, QString& _propertyName); /// get the texture name void textureName( int _id, int _textureIndex, QString& _textureName); /// get the texture's filename void textureFilename( int _id, QString _textureName, QString& _textureFilename); ///get current texture void getCurrentTexture( int _id, QString& _textureName ); /// get a multi-texture's sub textures void getSubTextures( int _id, QString _multiTextureName, QStringList& _subTextures ); /// SelectionInterface: This signal is emitted when a new toolbutton should be added void addSelectionEnvironment(QString _modeName, QString _description, QString _icon, QString& _handleName); /// SelectionInterface: This signal is emitted when a data type should be registered for a selection mode void registerType(QString _handleName, DataType _type); /// SelectionInterface: This signal is emitted when a selection plugin should handle a new primitive type void addPrimitiveType(QString _handleName, QString _name, QString _icon, SelectionInterface::PrimitiveType& _typeHandle); /// SelectionInterface: This signal is emitted when a custom selection mode is added void addCustomSelectionMode(QString _handleName, QString _modeName, QString _description, QString _icon, SelectionInterface::PrimitiveType _associatedTypes, QString& _customIdentifier); void addCustomSelectionMode(QString _handleName, QString _modeName, QString _description, QString _icon, SelectionInterface::PrimitiveType _associatedTypes, QString& _customIdentifier, DataType _objectTypeRestriction); /// SelectionInterface: This signal is used to add non-interactive operations for a specific primitive type void addSelectionOperations(QString _handleName, QStringList _operationsList, QString _category, SelectionInterface::PrimitiveType _type); /// SelectionInterface: This signal is used to add interactive selection parameters for a specific primitive type void addSelectionParameters(QString _handleName, QWidget* _widget, QString _category, SelectionInterface::PrimitiveType _type); /// SelectionInterface: This signal is emitted when a non-interactive operation has been performed void selectionOperation(QString _operation); /// SelectionInterface: This signal is emitted when standard toggle selection is required void showToggleSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard lasso selection is required void showLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard volume lasso selection is required void showVolumeLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard surface lasso selection is required void showSurfaceLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard sphere selection is required void showSphereSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard closest boundary selection is required void showClosestBoundarySelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard flood fill selection is required void showFloodFillSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard connected components selection is required void showComponentsSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: This signal is emitted when standard toggle selection has been performed void toggleSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard lasso selection has been performed void lassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard volume lasso selection has been performed void volumeLassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard surface lasso selection has been performed void surfaceLassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard sphere selection has been performed void sphereSelection(QMouseEvent* _event, double _radius, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard closest boundary selection has been performed void closestBoundarySelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard flood fill selection has been performed void floodFillSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when standard connected components selection has been performed void componentsSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: This signal is emitted when a custom selection operation has been performed void customSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, QString _customIdentifier, bool _deselect); /// SelectionInterface: This signal is emitted when the active (selected) data types should be fetched void getActiveDataTypes(SelectionInterface::TypeList& _types); /// SelectionInterface: This signal is emitted when the active (selected) primitive type should be fetched void getActivePrimitiveType(SelectionInterface::PrimitiveType& _type); /// SelectionInterface: This signal is emitted if the current target restriction state is requested void targetObjectsOnly(bool& _targetsOnly); /// SelectionInterface: This signal is emitted when a selection should be loaded from a file void loadSelection(const INIFile& _file); /// SelectionInterface: This signal is emitted when a selection should be written into a file void saveSelection(INIFile& _file); /// SelectionInterface: This signal is emitted when a type selection plugin wants to listen to a key event void registerKeyShortcut(int _key, Qt::KeyboardModifiers _modifiers); /// SelectionInterface: This signal is emitted when a key shortcut has been pressed void keyShortcutEvent(int _key, Qt::KeyboardModifiers _modifiers = Qt::NoModifier); /// If an ini File is opened, this signal is send to Plugins capable of handling ini files void iniLoad( INIFile&, int ); /// This signal is used to tell the plugins to save the data of _id to the given file void iniSave( INIFile& _ini ,int _id ); /// This signal is used to tell the plugins to save their current status void iniSaveOptions( INIFile& _ini ); /// This signal is used to tell the plugins to load their new status void iniLoadOptions( INIFile& _ini ); /// This signal is used to tell the plugins to load their new status after objects are loaded void iniLoadOptionsLast( INIFile& _ini ); /// This signal is emitted before the core deletes its data and exits void saveOnExit( INIFile& _ini ); /// Tell backup-plugin to create a backup void createBackup( int _objectid, QString _name, UpdateType _type = UPDATE_ALL); void createBackup( IdList _objectids, QString _name, std::vector _types); /// Tell backup-plugin to undo/redo void undo(int _objectid); void redo(int _objectid); void undo(); void redo(); /// Backup Plugin tells other Plugins that a restore will happen void aboutToRestore(int _objectId); /// Backup Plugin tells other Plugins that a restore has happened void restored( int _objectId); /// Tell the plugins that a file has been opened ( -> Database) void openedFile( int _id ); /// Tell the plugins that an empty object has been added void emptyObjectAdded( int _id); /// Called after all plugins are loaded void pluginsInitialized(); /// Called after all plugins are loaded and additionally passes command line plugin options void pluginsInitialized(QVector> const&); /// Tell plugins that the visibility of an object has changed void visibilityChanged(int _id); /// Tell plugins that object properties such as object names have been changed void objectPropertiesChanged( int _id ); /// Called after an object has been deleted void objectDeleted( int ); /** @} */ //=========================================================================== /** @name Slots called by the plugins * @{ */ //=========================================================================== private slots : /// Called by the plugins if they changed something in the object list (deleted, added, or other property changes) void slotObjectUpdated(int _identifier, const UpdateType& _type = UPDATE_ALL); /// Called when a plugin changes the visibility of an object void slotVisibilityChanged(int _id); /// Called by plugins if object properties like names have changed void slotObjectPropertiesChanged( int _id ); /// Called by Plugins if they changed the active object void slotObjectSelectionChanged( int _id); /// Add a new picking mode to the examiner_widget_ void slotAddPickMode( const std::string& _mode ); /// Add a new and invisible picking mode to the examiner_widget_ void slotAddHiddenPickMode( const std::string& _mode ); /// Called by a plugin if it creates a texture void slotAddTexture( QString _textureName , QString _filename , uint _dimension , int _id ); /// Called by a plugin if it creates a texture void slotAddTexture( QString _textureName , QImage _image , uint _dimension , int _id ); /// Called by a plugin if it creates a texture void slotAddTexture( QString _textureName , QString _filename , uint _dimension ); /// Called by a plugin if it creates a texture void slotAddTexture( QString _textureName , QImage _image , uint _dimension ); /// Called by a plugin if it creates a multitexture void slotMultiTextureAdded( QString _textureGroup , QString _name , QString _filename , int _id , int& _textureId ); void slotMultiTextureAdded( QString _textureGroup , QString _name , QString _filename , int _id , int* _textureId ); /// Called by a plugin if it creates a multitexture void slotMultiTextureAdded( QString _textureGroup , QString _name , QImage _image , int _id , int& _textureId ); /// Tell the plugins to update the given texture void slotUpdateTexture( QString _name , int _identifier); /// Update all textures in the plugins void slotUpdateAllTextures( ); /// A Texture has been updated void slotTextureUpdated( QString _textureName , int _identifier ); /// A texture mode should be changed void slotSetTextureMode(QString _textureName ,QString _mode, int _id); /// A texture mode should be changed void slotSetTextureMode(QString _textureName ,QString _mode); /// Tells Plugins to switch to the given Texture void slotSwitchTexture( QString _textureName, int _id ); /// Tells Plugins to switch to the given Texture void slotSwitchTexture( QString _textureName ); ///Called by plugins if texture image should be changed void slotTextureChangeImage( QString _textureName , QImage& _image ); ///Called by plugins if texture image should be changed void slotTextureChangeImage( QString _textureName , QImage& _image , int _id ); ///Called by plugins if texture image should be fetched void slotTextureGetImage( QString _textureName , QImage& _image ); ///Called by plugins if texture image should be fetched void slotTextureGetImage( QString _textureName , QImage& _image , int _id ); ///Called by plugins if texture index should be fetched void slotTextureIndex( QString _textureName, int _id, int& _index); ///Called by plugins if texture index property name should be fetched void slotTextureIndexPropertyName( int _id, QString& _propertyName); ///Called by plugins if texture name should be fetched void slotTextureName( int _id, int _textureIndex, QString& _textureName); ///Called by plugins if texture name should be fetched void slotTextureFilename( int _id, QString _textureName, QString& _textureFilename); ///Called by plugins if current texture should be retrieved void slotGetCurrentTexture( int _id, QString& _textureName ); ///Called by plugins if a multi-texture's sub textures should be fetched void slotGetSubTextures( int _id, QString _multiTextureName, QStringList& _subTextures ); /// A plugin wants to load a given file void slotLoad(QString _filename, DataType _type, int& _id); /// the load widget wants to load a given file void slotLoad(QStringList _filenames, IdList _pluginIDs); /// Called when a file has been opened void slotFileOpened ( int _id ); /// Called when an empty object has been Added void slotEmptyObjectAdded ( int _id ); /// SelectionInterface: Called when a new selection type button should be added to the toolbar void slotAddSelectionEnvironment(QString _modeName, QString _description, QString _icon, QString& _handleName); /// SelectionInterface: Called when a data type is added for a specific selection type void slotRegisterType(QString _handleName, DataType _type); /// SelectionInterface: Called when a new, non-standard primitive type should be handled void slotAddPrimitiveType(QString _handleName, QString _name, QString _icon, SelectionInterface::PrimitiveType& _typeHandle); /** \brief SelectionInterface: Add new selection mode for specified type * * @param _handleName Handle of the selection mode * @param _modeName User visible name of the selection mode * @param _description Description of the mode * @param _icon Icon displayed in the selection toolbar * @param _associatedTypes primitive types supported by this mode * @param _customIdentifier Identifier of this mode */ void slotAddCustomSelectionMode(QString _handleName, QString _modeName, QString _description, QString _icon, SelectionInterface::PrimitiveType _associatedTypes, QString& _customIdentifier); /** \brief SelectionInterface: Add new selection mode for specified type * * @param _handleName Handle of the selection mode * @param _modeName User visible name of the selection mode * @param _description Description of the mode * @param _icon Icon displayed in the selection toolbar * @param _associatedTypes primitive types supported by this mode * @param _customIdentifier Identifier of this mode * @param _objectTypeRestriction Object types supported by this mode */ void slotAddCustomSelectionMode(QString _handleName, QString _modeName, QString _description, QString _icon, SelectionInterface::PrimitiveType _associatedTypes, QString& _customIdentifier, DataType _objectTypeRestriction); /// SelectionInterface: Called in order to add non-interactive operations for a specific primitive type void slotAddSelectionOperations(QString _handleName, QStringList _operationsList, QString _category, SelectionInterface::PrimitiveType _type); /// SelectionInterface: Called in order to add interactive parameters for a specific primitive type void slotAddSelectionParameters(QString _handleName, QWidget* _widget, QString _category, SelectionInterface::PrimitiveType _type); /// SelectionInterface: Called when a non-interactive operation has been performed void slotSelectionOperation(QString _operation); /// SelectionInterface: Provide toggle selection operation for specific selection mode void slotShowToggleSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide lasso selection operation for specific selection mode void slotShowLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide volume lasso selection operation for specific selection mode void slotShowVolumeLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide surface lasso selection operation for specific selection mode void slotShowSurfaceLassoSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide sphere selection operation for specific selection mode void slotShowSphereSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide closest boundary selection operation for specific selection mode void slotShowClosestBoundarySelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide flood fill selection operation for specific selection mode void slotShowFloodFillSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Provide connected components selection operation for specific selection mode void slotShowComponentsSelectionMode(QString _handleName, bool _show, SelectionInterface::PrimitiveType _associatedTypes); /// SelectionInterface: Called when toggle selection operation has been performed void slotToggleSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when lasso selection operation has been performed void slotLassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when volume lasso selection operation has been performed void slotVolumeLassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when surface lasso selection operation has been performed void slotSurfaceLassoSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when sphere selection operation has been performed void slotSphereSelection(QMouseEvent* _event, double _radius, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when closest boundary selection operation has been performed void slotClosestBoundarySelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when flood fill selection operation has been performed void slotFloodFillSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when connected components selection operation has been performed void slotComponentsSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, bool _deselect); /// SelectionInterface: Called when custom selection operation has been performed void slotCustomSelection(QMouseEvent* _event, SelectionInterface::PrimitiveType _currentType, QString _customIdentifier, bool _deselect); /// SelectionInterface: Called when active (selected) data types should be fetched void slotGetActiveDataTypes(SelectionInterface::TypeList& _types); /// SelectionInterface: Called when active primitive type should be fetched void slotGetActivePrimitiveType(SelectionInterface::PrimitiveType& _type); /// SelectionInterface: Called when target restriction state should be fetched void slotTargetObjectsOnly(bool& _targetsOnly); /// SelectionInterface: Called when a selection should be loaded from a file void slotLoadSelection(const INIFile& _file); /// SelectionInterface: Called when a selection should be stored into a file void slotSaveSelection(INIFile& _file); /// SelectionInterface: Called when a key shortcut is to be registered void slotRegisterKeyShortcut(int _key, Qt::KeyboardModifiers _modifiers); /// SelectionInterface: Called when a key event occurred void slotKeyShortcutEvent(int _key, Qt::KeyboardModifiers _modifiers); /** \brief Called when a plugin requests a list of file-filters * * This function collects all available load filters from the file Plugins. * It is normally called via the Load/Save interface ( LoadSaveInterface ). * * @param _list Returns a list of all available file load filters */ void slotGetAllFilters ( QStringList& _list); /// Called when a plugin wants to delete all objects void slotDeleteAllObjects( ); /// Called to create inter plugin connections void slotCrossPluginConnect( QString _pluginName1, const char* _signal, QString _pluginName2, const char* _slot); /// Called to create inter plugin connections void slotCrossPluginConnectQueued( QString _pluginName1, const char* _signal, QString _pluginName2, const char* _slot); /// called to switch the renderer for a specific viewer void slotSetRenderer(unsigned int _viewer, QString _rendererName); /// called to get the currently active renderer renderer for a specific viewer void slotGetCurrentRenderer(unsigned int _viewer, QString& _rendererName); /// Get a Pointer to the Plugin with given _name (if it is loaded) // void slotGetPlugin(QString _name, QObject* & _plugin ); /** @} */ //=========================================================================== /** @name scriptable slots * @{ */ //=========================================================================== public slots: /// Called when a plugin requests an update in the viewer void updateView(); /// Called when a plugin wants to lock or unlock scenegraph updates void blockScenegraphUpdates(bool _block); /// process events during script execution to keep the ui alive void updateUI(); /// Clear all data objects void clearAll(); /// Called to delete an object void deleteObject( int _id ); void setObjectComment(int objId, QString key, QString comment); void clearObjectComment(int objId, QString key); void clearAllComments(int objId); /// set fullscreen mode void fullscreen( bool _state ); /// Show or Hide the viewmode control widget. void showViewModeControls( bool _show ); /// Change the logging window state void loggerState(int _state); /// Enable or disable OpenMesh error logging void enableOpenMeshErrorLog(bool _state); /// Show or hide toolbox void showToolbox( bool _state ); /// Show or hide Status Bar void showStatusBar( bool _state ); /// Switch the multiView Mode void multiViewMode( int _mode ); /// Enable or disable framerate restriction void restrictFrameRate( bool _enable ); /// set the maximal framerate ( automatically enables framerate restriction ) void setMaxFrameRate( int _rate ); /// set the baseFilename for snapshots (a counter is automatically increased when /// snapshot() is called) void snapshotBaseFileName(QString _fname, unsigned int _viewerId = 0); /// Set the file type for snapshots. void snapshotFileType(QString _type, unsigned int _viewerId = 0); /// Set the start index for the snapshot counter void snapshotCounterStart(const int _counter, unsigned int _viewerId = 0); /** Trigger a snapshot and increase the snapshot counter. Save snapshot to file determined by snapshotBaseFileName() and the current snapshot counter. The \a back buffer will be saved. The id of the current viewer is 0 (default). */ void snapshot(unsigned int _viewerId = 0, int _width = 0, int _height = 0, bool _alpha = false, bool _hideCoordsys = false, int _numSamples = 1); /// Take a snapshot from the whole app void applicationSnapshot(); /// Set the baseName for the application snapshot void applicationSnapshotName(QString _name); /// Take a snapshot from all viewers void viewerSnapshot(); /// Scriptable snapshot method offering full control void viewerSnapshot(QString file_name, bool store_comments, bool comments_visible_only, bool comments_targeted_only, bool store_material_info, int snapshot_width, int snapshot_height, bool snapshot_transparent, bool hide_coord_sys, int snapshot_multisampling, bool store_view); /// resize the examinerViewer void resizeViewers(int _width, int _height ); /// resize the whole Application void resizeApplication(int _width, int _height ); /// write the current versions of all plugins to ini file void writeVersionNumbers(QString _filename); /// return the list of available object that has the given selection and type QList objectList (QString _selection, QStringList _types); /// Block the scenegraph updates void blockSceneGraphUpdates(); /// Unblock the scenegraph updates void unblockSceneGraphUpdates(); void setView(QString view); void setViewAndWindowGeometry(QString view); /** @} */ //=========================================================================== /** @name Scripting functions for controlling view modes * @{ */ //=========================================================================== public slots: /** \brief Scripting function to set toolboxes in a view mode * * @param _modeName Name of the View Mode * @param _toolboxList ; separated list of toolboxes in the view mode */ void addViewModeToolboxes(QString _modeName, QString _toolboxList); /** \brief Scripting function to set toolbars in a view mode * * @param _modeName Name of the View Mode * @param _toolbarList ; separated list of toolbars in the view mode * */ void addViewModeToolbars(QString _modeName, QString _toolbarList); /** \brief Scripting function to set context menus in a view mode * * @param _modeName Name of the View Mode * @param _contextMenuList ; separated list of context menus in the view mode */ void addViewModeContextMenus(QString _modeName, QString _contextMenuList); /** \brief Scripting function to set an icon for a view mode * @param _modeName Name of the View Mode * @param _iconName Name of the Icon File. Will be taken from OpenFlippers Icon directory */ void addViewModeIcon(QString _modeName, QString _iconName); /** \brief Scripting function to set the side of the main window on which the toolbox should be displayed * * @param _side The desired side (either "left" or "right") */ void setToolBoxSide(QString _side); /** \brief Scripting function to activate or deactivate a toolbox * * @param _toolBoxName Name of the toolbox to manipulate * @param _active Activate or deactivate */ void setToolBoxActive(QString _toolBoxName, bool _active); /** @} */ //=========================================================================== /** @name Basic functions * @{ */ //=========================================================================== public slots: /** \brief Load a new Object ( this may also be an ini or ofs file ) * * This function tries to get the type of data to be loaded from the filename * and then load the file. * * @param _filename Filename of the data * @return id of object otherwise -1 */ int loadObject ( QString _filename ); private slots: void loadObjectFinished(QString _filename); /** Do a reset of the scenegraph (bounding box update,...) * * @param _resetTrackBall Should the rotation center of the trackball be reset to the scene center? */ void resetScenegraph( bool _resetTrackBall ); public : /** \brief Load an object from the commandline on application start * * This function is called before the event queue is executed. The filename and parameters * are stored. After the event queue is started, all files in this list will be opened. * This is necessary as the event queue has to run to schedule the events emitted * during open operations. * * @param _filename filename of the file to be opened. If it does not contain a full path, * the current path will be prepended. * @param _asPolyMesh Load as a polymesh ( yes/no) */ void commandLineOpen(const QString& _filename, bool _asPolyMesh ); /** \brief Load a script from the commandline on application start * * This function is called before the event queue is executed. The filename * is stored. After the event queue is started, all files in this list will be opened. * This is necessary as the event queue has to run to schedule the events emitted * during open operations. * * @param _filename filename of the script to be opened. If it does not contain a full path, * the current path will be prepended. */ void commandLineScript(const QString& _filename ); private slots: /** \brief Executed after loading core completly to load files from commandline * * This slot is automatically called after application startup. All files from the commandline * will be loaded by this slot. This is required as the core and the event queue need to be running * to emit the required signals to the plugins. */ void slotExecuteAfterStartup(); private: /// Vector storing filenames from commandline to be opened after application startup (objects) std::vector< std::pair < QString , bool > > commandLineFileNames_; /// Vector storing filenames from commandline to be opened after application startup (script files) std::vector< QString > commandLineScriptNames_; public: /** Add an empty Object of the given Type * @return id of the new object or -1 if unsupported */ int addEmptyObject( DataType _type ); /** \brief Load object of the given Type with given filename * * This function should not be used anymore. \n * The extension is now used to check for the plugin handling the given types. * * @return id of the new object or -1 if unsupported */ int loadObject( DataType _type, QString _filename); /** @} */ //=========================================================================== /** @name Video Stream creation * @{ */ //=========================================================================== private slots: /// Slot called everytime the view is updated void viewUpdated(); /// Function called for every frame when capturing video void captureVideo(); public slots: /// Start video capturing void startVideoCapture(QString _baseName, int _fps, bool _captureViewers); /// Stop video capturing void stopVideoCapture(); private: QTimer videoTimer_; QTime lastVideoTime_; int captureType_; bool capture_; int lastWidth_; int lastHeight_; /** @} */ //=========================================================================== /** @name Load / Save slots * @{ */ //=========================================================================== public slots: /** Save object with given id * @param _id id of the object */ bool saveObject( int _id, QString _filename ); void saveObject( int _id, QString _filename, int _pluginID ); void saveObjects( IdList _ids, QString _filename, int _pluginID ); /** Show dialog for saving an object to a new location * @param _id id of the object * @param _filename current filename of the object */ bool saveObjectTo( int _id, QString _filename ); bool saveObjectsTo( IdList _ids, QString _filename ); /// Slot for saving objects from Menu void saveAllObjects(); /// Slot for saving objects to a new location void saveAllObjectsTo(); /// Save current status to a settings file. Solicit file name through dialog. void saveSettings(); /// Save current status to a the provided settings file void saveSettings(QString filePath, bool is_saveObjectInfo, bool is_targetOnly, bool is_saveAll, bool is_askOverwrite, bool is_saveProgramSettings, bool is_savePluginSettings); /// Open Load Widget void loadObject(); /// Load status from file void loadSettings(); /// Load status from file void loadSettings(QString _filename); /// Get object id from filename int getObjectId(QString _filename); /** \brief Serialize material properties * * @param _objId Id of the object where the material should be deserialized into * @param _props A QString containing the serialized material */ void deserializeMaterialProperties(int _objId, QString _props); /** \brief Serialize material properties * * @param _objId Id of the object where the material should be serialized * @return A Qstring containing the serialized material */ QString serializeMaterialProperties(int _objId); /** @} */ //=========================================================================== /** @name Basic slots * @{ */ //=========================================================================== private slots : /// Gets called by examiner widget when mouse is moved in picking mode void slotMouseEvent( QMouseEvent* _event ); /// Gets called by examiner widget when Wheel is moved in picking mode void slotWheelEvent( QWheelEvent * _event, const std::string & _mode); /** \brief Open the add Empty dialog * * This slot shows the addEmpty dialog which is used to add empty objects of supported dataTypes */ void slotAddEmptyObjectMenu(); /// Slot adding empty object of a given type void slotAddEmptyObject( DataType _type , int& _id ); void slotAddEmptyObject( DataType _type, int* _id); /// Slot copying an object void slotCopyObject( int _oldId , int& _newId ); /// Exit Application void slotExit(); /// Open Recent file void slotRecentOpen(QAction* _action); /// Slot for generating type specific backups void slotGenerateBackup( int _id, QString _name, UpdateType _type ); public slots: /// Add a Toolbox from a plugin or from scripting void addToolbox(QString _name ,QWidget* _widget); /// Add a Toolbox from a plugin or from scripting (with icon) void addToolbox(QString _name ,QWidget* _widget, QIcon* _icon); /// Add a Toolbox from a plugin or from scripting (with icon) void addToolbox(QString _name ,QWidget* _widget, QIcon* _icon, QWidget* _headerAreaWidget); /** * Get a toolbox. * * @param _pluginName The plugin which the requested toolbox belongs to. * @param _toolboxName The name of the requested toolbox. * @return A pointer to the requested toolbox widget if it was found, nullptr, otherwise. */ QWidget *getToolbox(QString _pluginName, QString _toolboxName); /** \brief expand or collapse a toolbox * * @param _pluginName To which plugin does the toolbox belong * @param _toolboxName Name of the toolbox * @param activate Expand or collapse? */ void activateToolbox(QString _pluginName, QString _toolboxName, bool activate); private : //=========================================================================== /** @name Scenegraph * @{ */ //=========================================================================== private: /// Scenegraphs root node SeparatorNode* root_node_scenegraph_; /// Seperator node for global nodes SeparatorNode* root_node_scenegraph_global_; /// Separator Node holding all core scenegraph nodes SeparatorNode* core_nodes_; ///Toplevel Nodes for data objects SeparatorNode* dataSeparatorNode_; /// Root Node for data objects SeparatorNode* dataRootNode_; /// Node for coordsys Material ACG::SceneGraph::MaterialNode* coordsysMaterialNode_; /// Node for the coordinate system ACG::SceneGraph::CoordsysNode* coordsysNode_; /** @} */ //=========================================================================== /** @name IniFile and Options Handling * @{ */ //=========================================================================== /// Get all ini files and set basic paths and options void setupOptions(); /// Read Options that needs the GUI to be set up completely void readGUIOptions(INIFile& _ini); /// Get and set Application options from ini file void readApplicationOptions(INIFile& _ini); /// Write Application options to ini file void writeApplicationOptions(INIFile& _ini); /// Restore key assignments from configs files void restoreKeyBindings(); public slots: /// Save the current options to the standard ini file void saveOptions(); /// after ini-files have been loaded and core is up or if options have been changed -> apply Options void applyOptions(); /** \brief Load information from an ini file * * This function will open an ini file and load the information in it. * * @param _filename Name of the ini file * @param _coreSettings Load core settings from the file * @param _perPluginSettings Load per plugin settings from the file * @param _loadObjects Load objects defined in the ini file * */ void openIniFile( QString _filename, bool _coreSettings , bool _perPluginSettings, bool _loadObjects ); private: /** \brief Write current status to ini file (Application and File Options) * * Writes the complete status to an ini file ( All open objects and their Information ) * * @param _filename Filename of the ini file to write with full path * @param _relativePaths This defines if the paths to the objects should be made relative * @param _targetOnly Select if we want all open objects or only the ones which are selected as target. * @param _saveSystemSettings Choose if you also want to save system settings into the ini file. * @param _savePluginSettings Choose if you want to save per Plugin global settings into the ini file. * @param _saveObjectInfo If you want to store information about all open objects this has to be true * @param _fileMapping If multiple files have the same name, all duplicates get renamed. Mapping: Id -> new file name. */ void writeIniFile( QString _filename, bool _relativePaths, bool _targetOnly, bool _saveSystemSettings, bool _savePluginSettings , bool _saveObjectInfo, std::map& _fileMapping); /** \brief Write current status to obj file (Application and File Options) * * Writes the complete status to an obj file ( All open objects and their Information ) */ void writeObjFile(QString _filename, bool _relativePaths, bool _targetOnly, std::map& _fileMapping); /// Called if app is closed and writes all information to ini file void writeOnExit(); /** @} */ //=========================================================================== /** @name Logging * @{ */ //=========================================================================== signals: /// Logg with OUT,WARN or ERR as type void log(Logtype _type , QString _message ); /// Default logging as OUT void log(QString _message ); /// Logging signal for ScriptEngine void scriptLog(QString _message); /// This signal is emitted to send log data to a plugin void externalLog(Logtype _type , QString _message); private slots: /// Console logger void slotLog(Logtype _type, QString _message); /// log to file void slotLogToFile(Logtype _type, QString _message); private: ///stream for logging to file QTextStream* logStream_; ///logfile QFile* logFile_; public : void scriptLogFunction( QString _output); /** @} */ //=========================================================================== /** @name Signal and Slot processing for Plugins * @{ */ //=========================================================================== private : /// Check if a plugin has a slot bool checkSlot(QObject* _plugin , const char* _slotSignature); /// Check if a plugin has a signal bool checkSignal(QObject* _plugin , const char* _signalSignature); /** @} */ //=========================================================================== /** @name Plugin Management * @{ */ //=========================================================================== public : std::vector& plugins(); private: /// Index of Plugins toolbox widget int toolboxindex_; /// Load all plugins from default plugin directory and from INI-File void loadPlugins(); /// Print all info collected about plugin during loading void printPluginLoadLog(const QString& errors,const QString& warnings); private slots: /// Show Plugins Dialog void slotShowPlugins(); /// Function for loading Plugins void loadPlugin(const QString& _filename,const bool _silent, QString& _licenseErrors , QObject* _plugin = 0 ); /// Load Plugins from menu void slotLoadPlugin(); /// Function for Blocking Plugins. Blocked plugins will unloaded and not loaded wthin the next starts void slotBlockPlugin(const QString &_rpcName); /// Function for UnBlocking Plugins. Plugins will not loaded automatically void slotUnBlockPlugin(const QString &_rpcName); /** @} */ //=========================================================================== /** @name Metadata support * @{ */ //=========================================================================== signals: void genericMetadataDeserialized(QString key, QString value); void objectMetadataDeserialized(QString object_name, QString value); void objectMetadataDeserializedJson( QString object_name, QJsonDocument value); private slots: void slotMetadataDeserialized( const QVector > &data); /** @} */ //=========================================================================== /** @name Scripting support * @{ */ //=========================================================================== signals: void scriptInfo( QString _pluginName , QString _functionName ); void executeScript( QString _script ); void executeFileScript( QString _filename ); void setSlotDescription(QString _slotName, QString _slotDescription, QStringList _parameters, QStringList _descriptions); public slots: /** \brief Create an script object from a ui file * * This function will load an ui file, set up a qwidget from that and makes it available * under _objectName for scripting. * @param _objectName The name in scripting environment used for the new object * @param _uiFilename ui file to load */ void createWidget(QString _objectName, QString _uiFilename, bool _show = true); /// Set the active ViewMode void setViewMode(QString _viewMode); /// Get current view mode QString getCurrentViewMode(); /// Set the icon of a viewMode void setViewModeIcon(QString _mode, QString _iconName); /// Move selected toolbox to top of side area void moveToolBoxToTop(QString _name); /// Move selected toolbox to bottom of side area void moveToolBoxToBottom(QString _name); void showReducedMenuBar(bool reduced); /** \brief Open the given file and execute its contents as a python script * * @param _filename Name of the python script */ void executePythonScriptFile(QString _filename); /** \brief execute the given string as a python script * * @param _script Python script */ void executePythonScript(QString _script); private : /// Core scripting engine QScriptEngine scriptEngine_; /// Wrappers for plugin scripting std::vector scriptingWrappers_; /// List of all registered scripting functions QStringList scriptingFunctions_; /// Prototype for the Vector type prototypeVec3d vec3dPrototype_; /// Prototype for the Vector type prototypeVec4d vec4dPrototype_; /// Prototype for the DataType prototypeDataType DataTypePrototype_; /// Prototype for the Matrix type prototypeMatrix4x4 matrix4x4Prototype_; private slots: void slotScriptInfo( QString _pluginName , QString _functionName ); /** Core slot, executes the given script text via scripting plugin * * @param _script Script as QString */ void slotExecuteScript( QString _script ); /** Core slot, executes the given file as a script via scripting plugin * * @param _filename Filename of the script */ void slotExecuteFileScript( QString _filename ); void slotGetScriptingEngine( QScriptEngine*& _engine ); void slotGetAllAvailableFunctions( QStringList& _functions ); /// set a description for one of the plugin's public slots void slotSetSlotDescription(QString _slotName, QString _slotDescription, QStringList _parameters, QStringList _descriptions); /// set a description for a global scripting function void slotSetSlotDescriptionGlobalFunction(QString _functionName, QString _slotDescription, QStringList _parameters, QStringList _descriptions); void slotScriptError(const QScriptValue &error); public slots: /// get available descriptions for a given public slot void slotGetDescription(QString _function, QString& _fnDescription, QStringList& _parameters, QStringList& _descriptions ); private: QList< SlotInfo > coreSlots_; QList< SlotInfo > globalFunctions_; void setDescriptions(); /** @} */ //=========================================================================== /** @name RPC ( Remote procedure Call) support * @{ */ //=========================================================================== private slots: /** \brief Check if a plugin exists * * @param _pluginName Name of the plugin to check * @param _exists Returns if the function was found in the plugin */ void slotPluginExists( QString _pluginName , bool& _exists ); /** \brief Check if a function exists * * @param _pluginName Name of the plugin to check * @param _functionName Name of the function inside the plugin * @param _exists Returns if the function was found in the plugin */ void slotFunctionExists( QString _pluginName , QString _functionName , bool& _exists ); /** This slot executes a function of a plugin. * If it does not exist, _success will be false * @param _pluginName Plugin where the function is implemented * @param _functionName name of the function ( Standard name, no parameters allowed!) * @param _success successfull execution? */ void slotCall( QString _pluginName , QString _functionName , bool& _success ); /** This slot executes the given expression. * No checks are performed if the remote function is available. * @param _expression command to execute * @param _success successfull execution? */ void slotCall( QString _expression , bool& _success ); /** This slot executes the given expression and returns the result * No checks are performed if the remote function is available. * if an error occurs the result contains an invalid QVariant * * ex. getValue("databaseplugin.tableExists(\"meshes\")", result) ) * result.toBool() == true * * @param _expression command to execute * @param _result The return value of the command */ void slotGetValue(QString _expression, QVariant& _result ); /** @} */ //=========================================================================== /** @name Scenegraph redraw handling * @{ */ //=========================================================================== private slots: /// Called to check if the scenegraph needs to be redrawn void checkScenegraphDirty(); private: /// Timer that starts scenegraph check QTimer *scenegraphCheckTimer_; /// Holds the time since last redraw QTime *redrawTime_; /** @} */ //=========================================================================== /** @name Process Interface and Controls * @{ */ //=========================================================================== private: QList< JobInfo > currentJobs; ProcessManagerWidget* processManager_; /// Find a job in the jobslist bool getJob(QString _jobId, int& _index); private slots: /// A job has been started by a plugin void slotStartJob( QString _jobId, QString _description , int _min , int _max,bool _blocking ); /// A job state has been updated by a plugin void slotSetJobState(QString _jobId, int _value ); /// A job's widget caption has been updated by a plugin void slotSetJobName(QString _jobId, QString _name ); /// A job's widget's status text has been updated by a plugin void slotSetJobDescription(QString _jobId, QString _text ); /// A job state has been canceled by a plugin void slotCancelJob(QString _jobId ); /// A job state has been finished by a plugin void slotFinishJob(QString _jobId ); /// Called by dialogs if cancel button is pressed void slotJobCancelRequested(QString _jobId); signals: void jobCanceled( QString _jobId ); /** @} */ //=========================================================================== /** @name Object Manager * @{ */ //=========================================================================== private slots: /// This slot is called by the object manager when a new object is created void newObject(int _objectId); /// This slot is called by the object manager when an object is deleted void deletedObject(int _objectId); /** @} */ //=========================================================================== /** @name Exit functions * @{ */ //=========================================================================== public slots: /// exit the current application void exitApplication(); /** \brief Aborts the application with an error code * * Use this function in unit tests, if you detected a failure. Therefore the * test functions will recognize that something went wrong. */ void exitFailure(); void finishSplash(); /** @} */ private: /** \brief OpenGL capability check * * Checks if the OpenGL Capabilities of the graphics card are sufficient and * prints an error message if not. */ bool checkOpenGLCapabilities(); /** \brief Checks for library inconsistencies * * Checks if the used libraries are consistent */ bool checkLibraryVersions(); void hookUpEventFilter(QWidget *widget); private : /// Id for the next backup int nextBackupId_; /// Id for the next backup group int nextBackupGroupId_; /// Logger interfaces between plugins and core logger std::vector loggers_; /// Type-Plugins std::vector supportedDataTypes_; private : ///Pointer to the data rootNode; BaseObject* objectRoot_; /// The main applications widget ( only created in gui mode ) CoreWidget* coreWidget_; /// SplashScreen, only used in gui mode QSplashScreen* splash_; /// Last Splash message; QString splashMessage_; /// List of available draw modes QVector viewModes_; /// If enabled, this timer will block screen refresh if done more then 30 times per second. QTimer* redrawTimer_; SpinBoxEventFilter spinBoxEventFilter_; }; /// Special print function for core logger QScriptValue myPrintFunction(QScriptContext *context, QScriptEngine *engine); /// Special print function for sending output to a file QScriptValue printToFileFunction(QScriptContext *context, QScriptEngine *engine); /// Function to print help about scripting functions QScriptValue helpFunction(QScriptContext *context, QScriptEngine *engine); //============================================================================= #endif // MVIEWWIDGET_HH defined //=============================================================================