Salome HOME
#24666 [CEA][Windows] BLSURPLUGIN compilation issue
[modules/smesh.git] / idl / SMESH_Group.idl
index 9842df2f6f682ebace0a6870c513cfb17b73232e..8730c1a78be8b040c24a904e678b0000f3af0221 100644 (file)
@@ -1,41 +1,48 @@
-//  Copyright (C) 2004  CEA 
-// 
-//  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. 
-// 
-//  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.org 
+// Copyright (C) 2007-2021  CEA/DEN, EDF R&D, OPEN CASCADE
 //
+// Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
+// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
 //
+// 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
+//
+
 //  File   : SMESH_Group.idl
 //  Author : Sergey ANIKIN, OCC
 //  $Header$
-
+//
 #ifndef _SMESH_GROUP_IDL_
 #define _SMESH_GROUP_IDL_
 
 #include "SALOME_Exception.idl"
 #include "SALOME_GenericObj.idl"
+#include "SALOMEDS_Attributes.idl"
 
 #include "SMESH_Mesh.idl"
+#include "SMESH_smIdType.idl"
 
 module SMESH
 {
+  interface Predicate;
+  interface Filter;
+
   /*!
-   * SMESH_Group: interface of group object
+   * SMESH_Group: base interface of group object
    */
-  interface SMESH_Group : SALOME::GenericObj
+  interface SMESH_GroupBase : SMESH_IDSource
   {
     /*!
      * Sets group name
@@ -55,7 +62,7 @@ module SMESH
     /*!
      * Returns the number of elements in the group
      */
-    long Size();
+    smIdType Size();
 
     /*!
      * Returns true if the group does not contain any elements
@@ -63,40 +70,120 @@ module SMESH
     boolean IsEmpty();
 
     /*!
-     * Clears the group's contents
+     * returns true if the group contains an element with ID == <elem_id> 
      */
-    void Clear();
+    boolean Contains( in smIdType elem_id );
 
     /*!
-     * returns true if the group contains an element with ID == <elem_id> 
+     * Returns ID of an element at position <elem_index> counted from 1
      */
-    boolean Contains( in long elem_id );
+    smIdType GetID( in smIdType elem_index );
 
     /*!
-     * Adds elements to the group
+     * Returns a sequence of all element IDs in the group
      */
-    long Add( in long_array elem_ids );
+    smIdType_array GetListOfID();
 
     /*!
-     * Returns ID of an element at position <elem_index>
+     * Get the number of nodes of cells included to the group
+     * For a nodal group returns the same value as Size() function
      */
-    long GetID( in long elem_index );
+    smIdType GetNumberOfNodes();
 
     /*!
-     * Returns a sequence of all element IDs in the group
+     * Get IDs of nodes of cells included to the group
+     * For a nodal group returns result of GetListOfID() function
+     */
+    smIdType_array GetNodeIDs();
+
+    /*!
+     * Return true if GetNumberOfNodes() won't take a long time for computation
+     */
+    boolean IsNodeInfoAvailable();
+
+    /*!
+     * Sets group color
+     */
+    void SetColor(in SALOMEDS::Color theColor);
+
+    /*!
+     * Returns group color
+     */
+    SALOMEDS::Color GetColor();
+
+    /*!
+     * Sets group color number
+     * (corresponds to the "hue" parameter of the color - must be in range [0, 360])
+     */
+    void SetColorNumber( in long color );
+
+    /*!
+     * Returns group color number (obsolete - use GetColor instead)
+     * (corresponds to the "hue" parameter of the color - must be in range [0, 360])
      */
-    long_array GetListOfID();
+    long GetColorNumber();
 
     /*!
-     * Removes elements from the group
+     * Returns \c true if \c this group depends on the \a other via
+     * FT_BelongToMeshGroup predicate or vice versa
      */
-    long Remove( in long_array elem_ids );
+    boolean IsInDependency( in SMESH_GroupBase other );
+  };
 
+  /*!
+   * SMESH_Group: interface of a standalone group object
+   */
+  interface SMESH_Group : SMESH_GroupBase
+  {
+    /*!
+     * Clears the group's contents
+     */
+    void Clear();
+
+    /*!
+     * Adds elements or nodes with specified identifiers to the group
+     */
+    smIdType Add( in smIdType_array elem_ids );
+    /*!
+     * Adds elements or nodes that match specified predicate to the group
+     */
+    smIdType AddByPredicate( in Predicate thePredicate );
+    /*!
+     * Add all elements or nodes from the specified source to the group
+     */
+    smIdType AddFrom( in SMESH_IDSource theSource );
+
+    /*!
+     * Removes elements or nodes with specified identifiers from the group
+     */
+    smIdType Remove( in smIdType_array elem_ids );
     /*!
-     * Returns the mesh object this group belongs to
+     * Removes elements or nodes that match specified predicate from the group
      */
-    SMESH_Mesh GetMesh();
-  }; 
+    smIdType RemoveByPredicate( in Predicate thePredicate );
+
+  };
+
+  /*!
+   * SMESH_GroupOnGeom: interface of a group object linked to geometry
+   */
+  interface SMESH_GroupOnGeom : SMESH_GroupBase
+  {
+    GEOM::GEOM_Object GetShape();
+  };
+
+  /*!
+   * SMESH_GroupOnFilter: interface of a group object defined by filter
+   */
+  interface SMESH_GroupOnFilter : SMESH_GroupBase
+  {
+    void   SetFilter( in Filter theFilter) raises (SALOME::SALOME_Exception); 
+    Filter GetFilter();
+
+    //! @return True if group contents is computed
+    boolean IsUpToDate();
+  };
+
 };