X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FXGUI%2FXGUI_Displayer.h;h=3739668835a4591ee383e78cc81243bf8ded5d46;hb=ca05954b3f9fe2c1a21333df5d454eeccbd42224;hp=dfaffc9bb1162d26e2cdec91e915abdb558993e6;hpb=8648407e479eeffbfbb0a952db8c47ddc8d058aa;p=modules%2Fshaper.git diff --git a/src/XGUI/XGUI_Displayer.h b/src/XGUI/XGUI_Displayer.h index dfaffc9bb..373966883 100644 --- a/src/XGUI/XGUI_Displayer.h +++ b/src/XGUI/XGUI_Displayer.h @@ -64,8 +64,8 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// Display the feature. Obtain the visualized object from the feature. /// \param theObject an object to display /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - /// Returns true if the Feature succesfully displayed - void display(ObjectPtr theObject, bool theUpdateViewer = true); + /// \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 @@ -74,52 +74,51 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// \param toActivateInSelectionModes boolean value whether the presentation should be /// activated in the current selection modes /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void displayAIS(AISObjectPtr theAIS, const bool toActivateInSelectionModes, + /// \return true if the object visibility state is changed + bool displayAIS(AISObjectPtr theAIS, const bool toActivateInSelectionModes, bool theUpdateViewer = true); - /** Redisplay the shape if it was displayed - * \param theObject an object instance - * \param theUpdateViewer the parameter whether the viewer should be update immediatelly - */ - void redisplay(ObjectPtr theObject, bool theUpdateViewer = true); + /// Redisplay the shape if it was displayed + /// \param theObject an object instance + /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly + /// \return true if the object visibility state is changed + bool redisplay(ObjectPtr theObject, bool theUpdateViewer = true); - /** - * Sends and flushes a signal to redisplay all visualized objects. - */ + /// Sends and flushes a signal to redisplay all visualized objects. void redisplayObjects(); - /** - * Add presentations to current selection. It unhighlight and deselect the current selection. - * The shape and result components are processed in the values. If the presentation shape is not - * 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 - */ + /// Add presentations to current selection. It unhighlight and deselect the current selection. + /// The shape and result components are processed in the values. If the presentation shape is not + /// 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); - /// Unselect all objects void clearSelected(); /// Erase the feature and a shape. /// \param theObject an object instance /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void erase(ObjectPtr theObject, const bool theUpdateViewer = true); + /// \return true if the object visibility state is changed + bool erase(ObjectPtr theObject, const bool theUpdateViewer = true); /// Erase the given AIS object displayed by corresponded display method /// \param theAIS instance of AIS object /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void eraseAIS(AISObjectPtr theAIS, const bool theUpdateViewer = true); + /// \return true if the object visibility state is changed + bool eraseAIS(AISObjectPtr theAIS, const bool theUpdateViewer = true); /// Erase all presentations /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - void eraseAll(const bool theUpdateViewer = true); + /// \return true if the object visibility state is changed + bool eraseAll(const bool theUpdateViewer = true); /// Deactivates selection of sub-shapes /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly 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 @@ -137,23 +136,27 @@ 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 - * \param isEnabled a boolean value - */ + /// 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 + /// \param isEnabled a boolean value bool enableUpdateViewer(const bool isEnabled); + /// Returns myEnableUpdateViewer flag + bool isUpdateEnabled() const { return myEnableUpdateViewer; } + /// 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 + /// \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 @@ -177,20 +180,11 @@ class XGUI_EXPORT XGUI_Displayer: public QObject void deactivateObjects(const QObjectPtrList& theObjList, const bool theUpdateViewer = true); - /// Activates the given object (it can be selected) - /// \param theObject object to activate - /// \param theModes - modes on which it has to be activated (can be empty) - //void activate(ObjectPtr theObject, const QIntList& theModes); - /// Returns the modes of activation /// \param theObject the feature or NULL if it not visualized /// \param theModes - modes on which it is activated (can be empty) void getModesOfActivation(ObjectPtr theObject, QIntList& theModes); - /// Activates the given object with default modes - /// \param theObject object to activate - //void activate(ObjectPtr theObject); - /// Returns true if the given object can be selected /// \param theObject object to check bool isActive(ObjectPtr theObject) const; @@ -198,6 +192,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); @@ -233,6 +228,13 @@ class XGUI_EXPORT XGUI_Displayer: public QObject /// \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; + + /// Converts shape type (TopAbs_ShapeEnum) to selection mode + /// \param theShapeType a shape type from TopAbs_ShapeEnum + static int getSelectionMode(int theShapeType); + signals: /// Signal on object display /// \param theObject a data object @@ -257,15 +259,16 @@ signals: /// \param theAIS AIS presentation /// \param isShading flag to show in shading mode /// \param theUpdateViewer the parameter whether the viewer should be update immediatelly - /// \return true if the object is succesfully displayed - void display(ObjectPtr theObject, AISObjectPtr theAIS, bool isShading, + /// \return true if the object visibility state is changed + bool display(ObjectPtr theObject, AISObjectPtr theAIS, bool isShading, bool theUpdateViewer = true); 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) @@ -278,12 +281,11 @@ private: /// Opens local context. Does nothing if it is already opened. void openLocalContext(); - /** 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, - * otherwise the customize is applyed to the object's feature if it is a custom prs - * \param theObject an object instance - * \return the true state if there is changes and the presentation is customized - */ + /// 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, + /// otherwise the customize is applyed to the object's feature if it is a custom prs + /// \param theObject an object instance + /// \return the true state if there is changes and the presentation is customized bool customizeObject(ObjectPtr theObject); /// Append the objects in the internal map. Checks whether the map already contains the object @@ -315,7 +317,10 @@ private: QIntList myActiveSelectionModes; /// the enable update viewer flag - bool myEnableUpdateViewer; + bool myEnableUpdateViewer; + + /// A flag that update was requested but not done + mutable bool myNeedUpdate; }; #endif