X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FXGUI%2FXGUI_Displayer.h;h=9b606dab3b55c0877694e1fe5033e150b8df9d77;hb=4c763543675ec80cad142d3a2f8b4766ca64ac0f;hp=9e853afb0eaefbc54464c9c7136441c5b361ee0b;hpb=8873182f935a9f77cdb25a770d4c8780b7669773;p=modules%2Fshaper.git diff --git a/src/XGUI/XGUI_Displayer.h b/src/XGUI/XGUI_Displayer.h index 9e853afb0..9b606dab3 100644 --- a/src/XGUI/XGUI_Displayer.h +++ b/src/XGUI/XGUI_Displayer.h @@ -1,8 +1,22 @@ -// Copyright (C) 2014-20xx CEA/DEN, EDF R&D --> - -// File: XGUI_Displayer.h -// Created: 20 Apr 2014 -// Author: Natalia ERMOLAEVA +// Copyright (C) 2014-2017 CEA/DEN, EDF R&D +// +// This library is free software; you can redistribute it and/or +// modify it under the terms of the GNU Lesser General Public +// License as published by the Free Software Foundation; either +// version 2.1 of the License, or (at your option) any later version. +// +// This library 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 +// Lesser General Public License for more details. +// +// You should have received a copy of the GNU Lesser General Public +// License along with this library; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +// +// See http://www.salome-platform.org/ or +// email : webmaster.salome@opencascade.com +// #ifndef XGUI_Displayer_H #define XGUI_Displayer_H @@ -13,12 +27,12 @@ #include #include #include -#include +#include +#include #include #include -#include #include @@ -29,9 +43,14 @@ #include #include +class ModuleBase_ViewerPrs; class ModelAPI_Feature; class XGUI_Workshop; +#ifdef TINSPECTOR +class VInspectorAPI_CallBack; +#endif + /**\class XGUI_Displayer * \ingroup GUI * \brief Displayer. Provides mechanizm of display/erase of objects in the viewer @@ -41,13 +60,13 @@ class XGUI_EXPORT XGUI_Displayer: public QObject Q_OBJECT public: /// \enum DisplayMode display mode - enum DisplayMode { + enum DisplayMode { /// Mode is not defined - NoMode = -1, + NoMode = -1, /// Wireframe display mode - Wireframe, + Wireframe, /// Shading display mode - Shading + Shading }; /// Constructor @@ -67,16 +86,18 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// \return true if the object visibility state is changed bool display(ObjectPtr theObject, bool theUpdateViewer = true); - /// Display the given AIS object. This object is not added to the displayer internal map of objects - /// So, it can not be obtained from displayer. This is just a wrap method of OCC display in order - /// to perform the display with correct flags. + /// Display the given AIS object. + /// This object is not added to the displayer internal map of objects + /// So, it can not be obtained from displayer. This is just a wrap method of OCC display in + /// order to perform the display with correct flags. /// \param theAIS AIOS object to display /// \param toActivateInSelectionModes boolean value whether the presentation should be /// activated in the current selection modes + /// \param theDisplayMode mode how the presentation should be displayed /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly /// \return true if the object visibility state is changed bool displayAIS(AISObjectPtr theAIS, const bool toActivateInSelectionModes, - bool theUpdateViewer = true); + const Standard_Integer theDisplayMode = 0, bool theUpdateViewer = true); /// Redisplay the shape if it was displayed /// \param theObject an object instance @@ -92,10 +113,13 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// empty, select it, otherwise select the result. /// \param theValues a list of presentation to be selected /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void setSelected(const QList& theValues, bool theUpdateViewer = true); + void setSelected(const QList>& theValues, + bool theUpdateViewer = true); /// Unselect all objects - void clearSelected(); + /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly + /// \param theUpdateViewer the parameter to update viewer + void clearSelected(const bool theUpdateViewer = true); /// Erase the feature and a shape. /// \param theObject an object instance @@ -116,9 +140,9 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// Deactivates selection of sub-shapes /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void closeLocalContexts(const bool theUpdateViewer = true); + //void closeLocalContexts(const bool theUpdateViewer = true); - // Remove default selection filters of the module from the current viewer + /// Remove default selection filters of the module from the current viewer void deactivateSelectionFilters(); /// \brief Add selection filter @@ -136,21 +160,31 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// Remove all selection filters void removeFilters(); - /// Sets a flag to the displayer whether the internal viewer can be updated by - /// the updateViewer method call. If it is not enabled, this method do nothing + /// Sets a flag to the displayer whether the internal viewer can be updated by + /// the updateViewer method call. If it is not enabled, this method do nothing. + /// This state maintain recurse, if the update is blocked twice or three times, the + /// viewer will not be updated until it is unblocked necessary times + /// (twice or three in the example). /// \param isEnabled a boolean value bool enableUpdateViewer(const bool isEnabled); + /// Returns true if the viewer update is not blocked + bool isUpdateEnabled() const; + /// Updates the viewer void updateViewer() const; /// Activate interactive context - /// \param theIO - /// \param theMode + /// \param theIO an interactive object + /// \param theMode activation mode + /// \param theUpdateViewer update viewer flag void activateAIS(const Handle(AIS_InteractiveObject)& theIO, const int theMode, const bool theUpdateViewer) const; - /// Activate interactive context. It is necessary to call ClearOutdatedSelection after deactivation + /// Activate interactive context. It is necessary to call ClearOutdatedSelection + /// after deactivation + /// \param theIO an interactive object + /// \param theMode a mode to deactivate. When theMode=-1 then all modes will be deactivated void deactivateAIS(const Handle(AIS_InteractiveObject)& theIO, const int theMode = -1) const; /// Searches the interactive object by feature @@ -186,6 +220,7 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// Activates in local context displayed outside of the context. /// \param theModes - modes on which it has to be activated (can be empty) /// \param theObjList - list of objects which has to be activated. + /// \param theUpdateViewer an update viewer flag void activateObjects(const QIntList& theModes, const QObjectPtrList& theObjList, const bool theUpdateViewer = true); @@ -215,12 +250,45 @@ class XGUI_EXPORT XGUI_Displayer: public QObject bool canBeShaded(ObjectPtr theObject) const; /// Set color on presentation of an object if it is displayed - /// \param theObject an object + /// \param theObject an object /// \param theColor a color which has to be set /// \param theUpdateViewer update viewer flag /// \return previously defined color on the object QColor setObjectColor(ObjectPtr theObject, const QColor& theColor, bool theUpdateViewer = true); + /// Returns Trihedron object if it is displayed + Handle(AIS_InteractiveObject) getTrihedron() const; + + /// Set trihedron active (used in selection) or non active + void activateTrihedron(bool theIsActive); + + /// Displays/erases thrihedron in current modes. It will be activated or deactivated + /// depending on the trihedron visible state and displayer active trihedron state + void displayTrihedron(bool theToDisplay) const; + + /// Returns true if the trihedron should be activated in current selection modes + bool isTrihedronActive() const { return myIsTrihedronActive; } + + /// Returns list of currently active selection modes + /// Selection modes will be returned according to TopAbs_ShapeEnum + QIntList activeSelectionModes() const; + +#ifdef TINSPECTOR + void setCallBack(const Handle(VInspectorAPI_CallBack)& theCallBack) + { myVCallBack = theCallBack; } + Handle(VInspectorAPI_CallBack) getCallBack() const { return myVCallBack; } +#endif + /// Converts shape type (TopAbs_ShapeEnum) to selection mode + /// \param theShapeType a shape type from TopAbs_ShapeEnum + static int getSelectionMode(int theShapeType); + + /// Return true if the object is visible. If the object is feature, it returns true + /// if all results of the feature are shown + /// \param theDisplayer a displayer + /// \param theObject an object + /// \return a boolean value + static bool isVisible(XGUI_Displayer* theDisplayer, const ObjectPtr& theObject); + signals: /// Signal on object display /// \param theObject a data object @@ -253,7 +321,8 @@ private: /// Activates the interactive object in the local context. /// \param theIO an interactive object /// \param theModes - modes on which it has to be activated (can be empty) - void activate(const Handle(AIS_InteractiveObject)& theIO, const QIntList& theModes, + /// \return a flag is object activated or not + bool activate(const Handle(AIS_InteractiveObject)& theIO, const QIntList& theModes, const bool theUpdateViewer) const; /// Deactivates the given object (not allow selection) @@ -261,10 +330,8 @@ private: void deactivate(ObjectPtr theObject, const bool theUpdateViewer); /// Find a trihedron in a list of displayed presentations and deactivate it. - void deactivateTrihedron() const; - - /// Opens local context. Does nothing if it is already opened. - void openLocalContext(); + /// \param theUpdateViewer an update viewer flag + void deactivateTrihedron(const bool theUpdateViewer) const; /// Update the object presentable properties such as color, lines width and other /// If the object is result with the color attribute value set, it is used, @@ -278,18 +345,41 @@ private: /// \param theAIS AIOS object to display void appendResultObject(ObjectPtr theObject, AISObjectPtr theAIS); +#ifdef _DEBUG /// Returns an information about alredy displayed objects /// \return a string representation std::string getResult2AISObjectMapInfo() const; +#endif + + /// Returns container of visible presentations for the object. For a feature object, + /// the feature results are processed also. The presentations map is not cleared inside. + /// \param theObject a feature or result + /// \param thePresentations result map of presentations + void getPresentations(const ObjectPtr& theObject, + NCollection_Map& thePresentations); + + /// Sets the shapes selected in the context. It contains logic of the similar method + /// in OCCT but improved for performance. The modification is to iterates by a list + /// of owners in the context only once. + /// \param theContext a viewer context. It has opened local context + /// \param theShapesToBeSelected a map of shapes. Owner's shape is searched in the map and the + /// owner is selected if it is found there. + /// Only first owner is processed(according to OCCT logic) + static void AddOrRemoveSelectedShapes(Handle(AIS_InteractiveContext) theContext, + const NCollection_DataMap>& theShapesToBeSelected); protected: /// Reference to workshop XGUI_Workshop* myWorkshop; - +#ifdef TINSPECTOR + Handle(VInspectorAPI_CallBack) myVCallBack; +#endif /// A container for selection filters Handle(SelectMgr_AndFilter) myAndFilter; - /// A default custom presentation, which is used if the displayed feature is not a custom presentation + /// A default custom presentation, which is used if the displayed feature is not + /// a custom presentation GeomCustomPrsPtr myCustomPrs; /// Definition of a type of map which defines correspondance between objects and presentations @@ -301,8 +391,17 @@ private: /// Selection modes installed for external objects in local context QIntList myActiveSelectionModes; - /// the enable update viewer flag - bool myEnableUpdateViewer; + /// Number of blocking of the viewer update. The viewer is updated only if it equals zero + int myViewerBlockedRecursiveCount; + + /// Flag: first asking of AIS context: trihedron activation + bool myIsFirstAISContextUse; + + /// Flag: use trihedgon for selection or not + bool myIsTrihedronActive; + + /// A flag that update was requested but not done + mutable bool myNeedUpdate; }; #endif