Salome HOME
refs #426: grammatic error
[modules/hydro.git] / src / HYDROGUI / HYDROGUI_Tool.h
index e67274fc5dc09200352e7b807aeef3160590381f..e1565e72f930c724ba82f3510da735d026e23120 100644 (file)
@@ -23,7 +23,7 @@
 #ifndef HYDROGUI_TOOL_H
 #define HYDROGUI_TOOL_H
 
-#include <HYDROData_Object.h>
+#include <HYDROData_Image.h>
 
 #include <GraphicsView_Defs.h>
 #include <GraphicsView_ViewPort.h>
 #include <TCollection_HAsciiString.hxx>
 #include <TCollection_HExtendedString.hxx>
 
+// IDL includes
+#include <SALOMEconfig.h>
+#include CORBA_SERVER_HEADER(GEOM_Gen)
+
 class SUIT_ViewManager;
+class OCCViewer_ViewFrame;
 
 class HYDROGUI_DataModel;
 class HYDROGUI_Module;
 class HYDROGUI_Prs;
 
+class QDockWidget;
+class Handle(HYDROData_Document);
+
 /**
  * \class HYDROGUI_Tool
  * \brief This class contains several useful methods.
@@ -87,20 +95,17 @@ public:
   static Handle(TCollection_HExtendedString)      ToHExtString( const QString& );
 
   /**
-   * \brief Encode the Lambert93 coordinates to the absolute double value
+   * \brief Get the active study id.
+   * \return active study id
    */
-  static void                     LambertToDouble( const int theDegrees,
-                                                   const int theMinutes,
-                                                   const double theSeconds,
-                                                   double& theCoord );
+  static int                      GetActiveStudyId();
 
   /**
-   * \brief Decode the Lambert93 coordinates from the absolute double value
+   * \brief Get path to the temporary directory.
+   * \param theToCreate flag used to create a directory if it doesn't exist
+   * \return path
    */
-  static void                     DoubleToLambert( const double theCoord,
-                                                   int& theDegrees,
-                                                   int& theMinutes,
-                                                   double& theSeconds );
+  static QString                  GetTempDir( const bool theToCreate );
 
   /**
    * \brief Set the specified view manager to be active on the desktop.
@@ -111,6 +116,14 @@ public:
                                                         SUIT_ViewManager* theViewManager );
 
   /**
+   * \brief Returns TRUE if object can be shown on the viewer.
+   * \param theObject data model object to check
+   * \param theViewerType viewer type
+   */
+  static bool                     IsObjectHasPresentation( const Handle(HYDROData_Entity)& theObject,
+                                                           const QString&                  theViewerType = "" );
+
+/**
    * \brief Get sub-objects to build presentations.
    * \param theModule module
    * \param theSeq sequence of sub-objects
@@ -124,7 +137,7 @@ public:
    * \param theObjects list of existing presentations
    * \return presentation
    */
-  static HYDROGUI_Prs*            GetPresentation( const Handle(HYDROData_Object)& theObj,
+  static HYDROGUI_Prs*            GetPresentation( const Handle(HYDROData_Entity)& theObj,
                                                    const GraphicsView_ObjectList& theObjects );
 
   /**
@@ -146,7 +159,30 @@ public:
    * \param theModule module
    * \return selected data object
    */
-  static Handle(HYDROData_Object) GetSelectedObject( HYDROGUI_Module* theModule );
+  static Handle(HYDROData_Entity) GetSelectedObject( HYDROGUI_Module* theModule );
+
+  /**
+   * \brief Get the geometry data objects from document.
+   * \param theModule module
+   * \return sequence of data objects
+   */
+  static HYDROData_SequenceOfObjects GetGeometryObjects( HYDROGUI_Module* theModule );
+
+  /**
+   * \brief Get kind of objects the selected partition contains.
+   * \param theModule module
+   * \return object kind
+   */
+  static ObjectKind GetSelectedPartition( HYDROGUI_Module* theModule );
+
+  /**
+   * \brief Get the selected GEOM objects.
+   * \param theModule module
+   * \param theTypes the acceptable GEOM object types
+   * \return list of GEOM objects entries
+   */
+  static QStringList GetSelectedGeomObjects( HYDROGUI_Module* theModule,
+                                             QList<GEOM::shape_type> theTypes );
 
   /**
    * \brief Find the data object with the specified name.
@@ -155,32 +191,158 @@ public:
    * \param theObjectKind kind of object
    * \return data object
    */
-  static Handle(HYDROData_Object) FindObjectByName( HYDROGUI_Module* theModule,
+  static Handle(HYDROData_Entity) FindObjectByName( HYDROGUI_Module* theModule,
                                                     const QString& theName,
                                                     const ObjectKind theObjectKind = KIND_UNKNOWN );
 
+  /**
+   * \brief Find the data objects with the specified names.
+   * \param theModule module
+   * \param theNames list of names
+   * \param theObjectKind kind of object
+   * \return list of data objects
+   */
+  static HYDROData_SequenceOfObjects FindObjectsByNames( HYDROGUI_Module*   theModule,
+                                                         const QStringList& theNames,
+                                                         const ObjectKind   theObjectKind = KIND_UNKNOWN );
+
   /**
    * \brief Generate name for new object.
    * \param theModule module
    * \param thePrefix name prefix
+   * \param theUsedNames list of already used names
+   * \param theIsTryToUsePurePrefix if true - the prefix will be returned if the name equal to the prefix is not busy
    * \return generated name
    */
-  static QString                  GenerateObjectName( HYDROGUI_Module* theModule,
-                                                      const QString& thePrefix );
+  static QString                  GenerateObjectName( HYDROGUI_Module*   theModule,
+                                                      const QString&     thePrefix,
+                                                      const QStringList& theUsedNames = QStringList(),
+                                                      const bool         theIsTryToUsePurePrefix = false );
+
+  /**
+   * \brief Get id of the active view.
+   * \param theModule module
+   * \return view id
+   */
+  static size_t                   GetActiveViewId( HYDROGUI_Module* theModule,
+                                                   const QString&   theViewId = QString() );
 
   /**
    * \brief Get id of the active GraphicsView view.
    * \param theModule module
    * \return view id
    */
-  static int                      GetActiveGraphicsViewId( HYDROGUI_Module* theModule );
+  static size_t                   GetActiveGraphicsViewId( HYDROGUI_Module* theModule );
+
+  /**
+   * \brief Get id of the active OCC view.
+   * \param theModule module
+   * \return view id
+   */
+  static size_t                   GetActiveOCCViewId( HYDROGUI_Module* theModule );
 
   /**
    * \brief Get list of ids of existing GraphicsView views.
    * \param theModule module
    * \return list of view ids
    */
-  static QList<int>               GetGraphicsViewIdList( HYDROGUI_Module* theModule );
+  static QList<size_t>            GetGraphicsViewIdList( HYDROGUI_Module* theModule );
+
+  /**
+   * \brief Get list of ids of existing OCC views.
+   * \param theModule module
+   * \return list of view ids
+   */
+  static QList<size_t>            GetOCCViewIdList( HYDROGUI_Module* theModule );
+
+
+  /**
+   * \brief Change OCC viewer action visibility.
+   * \param theViewFrame OCC viewer frame
+   * \param theActionId an action index, which state should be changed
+   * \param isShown the action visibility state
+   */
+  static void                     setOCCActionShown( OCCViewer_ViewFrame* theViewFrame,
+                                                     const int theActionId,
+                                                     const bool isShown );
+
+  /**
+   * \brief Change OCC viewer action visibility for all opened views.
+   * \param theActionId an action index, which state should be changed
+   * \param isShown the action visibility state
+   */
+  static void                     setOCCActionShown( HYDROGUI_Module* theModule,
+                                                     const int theActionId,
+                                                     const bool isShown );
+
+  /**
+   * \brief Get the list of references (recursively) for the specified data object
+   * \param theObj data object
+   * \param theRefObjects list of reference objects
+   * \param theRefNames list of reference object names
+   */
+  static void                     GetObjectReferences( const Handle(HYDROData_Entity)& theObj,
+                                                       HYDROData_SequenceOfObjects& theRefObjects,
+                                                       QStringList& theRefNames );
+
+  /**
+   * \brief Get the list of back-references for the specified object
+   * \param theModule module
+   * \param theObj data object
+   * \return list of back-reference objects
+   */
+  static HYDROData_SequenceOfObjects GetObjectBackReferences( HYDROGUI_Module*                theModule,
+                                                              const Handle(HYDROData_Entity)& theObj );
+
+  /**
+   * \brief Get the map of back-references for the specified list of objects
+   * \param theModule module
+   * \param theObjectNames names of objects
+   * \return map of back-reference objects
+   */
+  static QMap<QString,HYDROData_SequenceOfObjects> GetObjectsBackReferences( HYDROGUI_Module*   theModule,
+                                                                             const QStringList& theObjectNames );
+
+  /**
+   * \brief Get father dock window for widget 
+   * \param wid widget
+   * \return dock window
+   */
+  static QDockWidget*             WindowDock( QWidget* wid );
+
+  /**
+   * \brief Generates the filling color for intersected zone
+   * \param theModule module
+   * \param theZoneNames list of intersected zones
+   * \return result color
+   */
+  static QColor                   GenerateFillingColor( HYDROGUI_Module*   theModule,
+                                                        const QStringList& theZoneNames );
+
+  /**
+   * \brief Generates the filling color for intersected zone
+   * \param theDoc model document
+   * \param theZoneNames list of intersected zones
+   * \return result color
+   */
+  static QColor                   GenerateFillingColor( const Handle(HYDROData_Document)& theDoc,
+                                                        const QStringList&                theZoneNames );
+
+  /**
+   * \brief Find names of existing objects of the given kind.
+   * \param theDoc model document
+   * \param theObjectKind kind of object
+   * \return list of names
+   */
+  static QStringList              FindExistingObjectsNames( const Handle(HYDROData_Document)& theDoc, 
+                                                            const ObjectKind theObjectKind );
+
+  /**
+   * \brief Converts coordinate value to string.
+   * \param theNumber coordinate as a number
+   * \return coordinate as a string
+   */
+  static QString                  GetCoordinateString( const double theNumber, bool isInLocale );
 };
 
 #endif