EIC code displayed by LXR master/​include/​opencascade/​TNaming_Tool.hxx	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2026-09-18 09:22:12

 // Created on: 1996-12-24
 // Created by: Yves FRICAUD
 // Copyright (c) 1996-1999 Matra Datavision
 // Copyright (c) 1999-2014 OPEN CASCADE SAS
 //
 // This file is part of Open CASCADE Technology software library.
 //
 // This library is free software; you can redistribute it and/or modify it under
 // the terms of the GNU Lesser General Public License version 2.1 as published
 // by the Free Software Foundation, with special exception defined in the file
 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
 // distribution for complete text of the license and disclaimer of any warranty.
 //
 // Alternatively, this file may be used under the terms of Open CASCADE
 // commercial license or contractual agreement.
 
 #ifndef _TNaming_Tool_HeaderFile
 #define _TNaming_Tool_HeaderFile
 
 #include <Standard.hxx>
 #include <Standard_DefineAlloc.hxx>
 #include <Standard_Handle.hxx>
 
 #include <TDF_Label.hxx>
 #include <NCollection_Map.hxx>
 #include <TNaming_NamedShape.hxx>
 #include <Standard_Integer.hxx>
 #include <NCollection_List.hxx>
 #include <TopTools_ShapeMapHasher.hxx>
 #include <NCollection_IndexedMap.hxx>
 class TNaming_NamedShape;
 class TNaming_OldShapeIterator;
 class TopoDS_Shape;
 class TDF_Label;
 class TNaming_UsedShapes;
 
 //! A tool to get information on the topology of a
 //! named shape attribute.
 //! This information is typically a TopoDS_Shape object.
 //! Using this tool, relations between named shapes
 //! are also accessible.
 class TNaming_Tool
 {
 public:
   DEFINE_STANDARD_ALLOC
 
   //! Returns the last Modification of <NS>.
   //! Returns the shape CurrentShape contained in
   //! the named shape attribute NS.
   //! CurrentShape is the current state of the entities
   //! if they have been modified in other attributes of the same data structure.
   //! Each call to this function creates a new compound.
   Standard_EXPORT static TopoDS_Shape CurrentShape(const occ::handle<TNaming_NamedShape>& NS);
 
   //! Returns the shape CurrentShape contained in
   //! the named shape attribute NS, and present in
   //! the updated attribute map Updated.
   //! CurrentShape is the current state of the entities
   //! if they have been modified in other attributes of the same data structure.
   //! Each call to this function creates a new compound.
   //! Warning
   //! Only the contents of Updated are searched.R
   Standard_EXPORT static TopoDS_Shape CurrentShape(const occ::handle<TNaming_NamedShape>& NS,
                                                    const NCollection_Map<TDF_Label>&      Updated);
 
   //! Returns the NamedShape of the last Modification of <NS>.
   //! This shape is identified by a label.
   Standard_EXPORT static occ::handle<TNaming_NamedShape> CurrentNamedShape(
     const occ::handle<TNaming_NamedShape>& NS,
     const NCollection_Map<TDF_Label>&      Updated);
 
   //! Returns NamedShape the last Modification of <NS>.
   Standard_EXPORT static occ::handle<TNaming_NamedShape> CurrentNamedShape(
     const occ::handle<TNaming_NamedShape>& NS);
 
   //! Returns the named shape attribute defined by
   //! the shape aShape and the label anAccess.
   //! This attribute is returned as a new shape.
   //! You call this function, if you need to create a
   //! topological attribute for existing data.
   //! Example
   //! class MyPkg_MyClass
   //! {
   //! public: bool
   //! SameEdge(const
   //! occ::handle<OCafTest_Line>& , const
   //! occ::handle<CafTest_Line>& );
   //! };
   //!
   //! bool
   //! MyPkg_MyClass::SameEdge
   //! (const occ::handle<OCafTest_Line>& L1
   //! const occ::handle<OCafTest_Line>& L2)
   //! { occ::handle<TNaming_NamedShape>
   //! NS1 = L1->NamedShape();
   //! occ::handle<TNaming_NamedShape>
   //! NS2 = L2->NamedShape();
   //!
   //! return
   //! BRepTools::Compare(NS1->Get(),NS2->Get());
   //! }
   //! In the example above, the function SameEdge is
   //! created to compare the edges having two lines
   //! for geometric supports. If these edges are found
   //! by BRepTools::Compare to be within the same
   //! tolerance, they are considered to be the same.
   //! Warning
   //! To avoid sharing of names, a SELECTED
   //! attribute will not be returned. Sharing of names
   //! makes it harder to manage the data structure.
   //! When the user of the name is removed, for
   //! example, it is difficult to know whether the name
   //! should be destroyed.
   Standard_EXPORT static occ::handle<TNaming_NamedShape> NamedShape(const TopoDS_Shape& aShape,
                                                                     const TDF_Label&    anAcces);
 
   //! Returns the entities stored in the named shape attribute NS.
   //! If there is only one old-new pair, the new shape
   //! is returned. Otherwise, a Compound is returned.
   //! This compound is made out of all the new shapes found.
   //! Each call to this function creates a new compound.
   Standard_EXPORT static TopoDS_Shape GetShape(const occ::handle<TNaming_NamedShape>& NS);
 
   //! Returns the shape contained as OldShape in <NS>
   Standard_EXPORT static TopoDS_Shape OriginalShape(const occ::handle<TNaming_NamedShape>& NS);
 
   //! Returns the shape generated from S or by a
   //! modification of S and contained in the named
   //! shape Generation.
   Standard_EXPORT static TopoDS_Shape GeneratedShape(
     const TopoDS_Shape&                    S,
     const occ::handle<TNaming_NamedShape>& Generation);
 
   Standard_EXPORT static void Collect(const occ::handle<TNaming_NamedShape>&            NS,
                                       NCollection_Map<occ::handle<TNaming_NamedShape>>& Labels,
                                       const bool OnlyModif = true);
 
   //! Returns True if <aShape> appears under a label.(DP)
   Standard_EXPORT static bool HasLabel(const TDF_Label& access, const TopoDS_Shape& aShape);
 
   //! Returns the label of the first apparition  of
   //! <aShape>. Transdef is a value of the transaction
   //! of the first apparition of <aShape>.
   Standard_EXPORT static TDF_Label Label(const TDF_Label&    access,
                                          const TopoDS_Shape& aShape,
                                          int&                TransDef);
 
   //! Returns the shape created from the shape
   //! aShape contained in the attribute anAcces.
   Standard_EXPORT static TopoDS_Shape InitialShape(const TopoDS_Shape&          aShape,
                                                    const TDF_Label&             anAcces,
                                                    NCollection_List<TDF_Label>& Labels);
 
   //! Returns the last transaction where the creation of S
   //! is valid.
   Standard_EXPORT static int ValidUntil(const TDF_Label& access, const TopoDS_Shape& S);
 
   //! Returns the current shape (a Wire or a Shell) built (in the data framework)
   //! from the shapes of the argument named shape.
   //! It is used for IDENTITY name type computation.
   Standard_EXPORT static void FindShape(const NCollection_Map<TDF_Label>&      Valid,
                                         const NCollection_Map<TDF_Label>&      Forbiden,
                                         const occ::handle<TNaming_NamedShape>& Arg,
                                         TopoDS_Shape&                          S);
 
   friend class TNaming_Localizer;
   friend class TNaming_NamedShape;
   friend class TNaming_OldShapeIterator;
 
 private:
   //! Returns True if <aShape> appears under a label.
   Standard_EXPORT static bool HasLabel(const occ::handle<TNaming_UsedShapes>& Shapes,
                                        const TopoDS_Shape&                    aShape);
 
   //! Returns the last transaction where the creation of S
   //! is valid.
   Standard_EXPORT static int ValidUntil(const TopoDS_Shape&                    S,
                                         const occ::handle<TNaming_UsedShapes>& US);
 
   //! Returns the label of the first apparition of
   //! <aShape>. Transdef is a value of the transaction
   //! of the first apparition of <aShape>.
   Standard_EXPORT static TDF_Label Label(const occ::handle<TNaming_UsedShapes>& Shapes,
                                          const TopoDS_Shape&                    aShape,
                                          int&                                   TransDef);
 
   Standard_EXPORT static void FirstOlds(
     const occ::handle<TNaming_UsedShapes>&                         Shapes,
     const TopoDS_Shape&                                            S,
     TNaming_OldShapeIterator&                                      it,
     NCollection_IndexedMap<TopoDS_Shape, TopTools_ShapeMapHasher>& MS,
     NCollection_List<TDF_Label>&                                   Labels);
 };
 
 #endif // _TNaming_Tool_HeaderFile

This page was automatically generated by the 2.3.7 LXR engine. The LXR team