Modeling - New BRrep Graph representation (#1166)

Implement new representation of topology and BRep into OCCT. New foundation represent 2 levels: BRepGraph - public interfaces which making the topology graph representation BRepGraphInc - internal structure which represent topology as an incident tables. The foundation provides basic logic for conversion from TopoDS_Shape to BRepGraph and back. The foundation provides the iteration and exploring interfaces to travel in both directions on any level of topology. The internal id type of inc tables is 'int', which is not for long term and can be updated, better to use typed id aliases, even for the iterations, they provide all necessary operators. The access to the BRepGraph is done using multiple View classes available by methods from main class. The extensions on graphs is possible with 'Layer' and 'Cache', where first is persistent, second - temporary, Some basic operations on graph also provided for compact, analyze and copy.
2026-08-29 14:28:23 +08:00 · 2026-04-03 00:51:20 +01:00
parent 8d2d8650ca
commit c765cb4bd2
117 changed files with 49491 additions and 574 deletions
@@ -0,0 +1,170 @@
+// Copyright (c) 2026 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.
+
+#include <BRepGraph_LayerRegistry.hxx>
+
+#include <Standard_OutOfRange.hxx>
+
+//=================================================================================================
+
+int BRepGraph_LayerRegistry::RegisterLayer(const occ::handle<BRepGraph_Layer>& theLayer)
+{
+  if (theLayer.IsNull())
+    return -1;
+
+  const Standard_GUID& aGUID = theLayer->ID();
+  const int*           aSlot = myGuidToSlot.Seek(aGUID);
+  if (aSlot != nullptr)
+  {
+    myLayers.ChangeValue(*aSlot) = theLayer;
+    recomputeSubscribedKindsMask();
+    return *aSlot;
+  }
+
+  const int aNewSlot = myLayers.Length();
+  myLayers.Append(theLayer);
+  myGuidToSlot.Bind(aGUID, aNewSlot);
+  mySubscribedKindsMask |= theLayer->SubscribedKinds();
+  return aNewSlot;
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::UnregisterLayer(const Standard_GUID& theGUID)
+{
+  const int* aSlotPtr = myGuidToSlot.Seek(theGUID);
+  if (aSlotPtr == nullptr)
+    return;
+
+  const int aSlot     = *aSlotPtr;
+  const int aLastSlot = myLayers.Length() - 1;
+  if (aSlot != aLastSlot)
+  {
+    const occ::handle<BRepGraph_Layer>& aLastLayer = myLayers.Value(aLastSlot);
+    myLayers.ChangeValue(aSlot)                    = aLastLayer;
+    myGuidToSlot.ChangeFind(aLastLayer->ID())      = aSlot;
+  }
+
+  myLayers.EraseLast();
+  myGuidToSlot.UnBind(theGUID);
+  recomputeSubscribedKindsMask();
+}
+
+//=================================================================================================
+
+occ::handle<BRepGraph_Layer> BRepGraph_LayerRegistry::FindLayer(const Standard_GUID& theGUID) const
+{
+  const int* aSlot = myGuidToSlot.Seek(theGUID);
+  return aSlot != nullptr ? myLayers.Value(*aSlot) : occ::handle<BRepGraph_Layer>();
+}
+
+//=================================================================================================
+
+int BRepGraph_LayerRegistry::FindSlot(const Standard_GUID& theGUID) const
+{
+  const int* aSlot = myGuidToSlot.Seek(theGUID);
+  return aSlot != nullptr ? *aSlot : -1;
+}
+
+//=================================================================================================
+
+const occ::handle<BRepGraph_Layer>& BRepGraph_LayerRegistry::Layer(const int theSlot) const
+{
+  Standard_OutOfRange_Raise_if(theSlot < 0 || theSlot >= myLayers.Length(),
+                               "BRepGraph_LayerRegistry::Layer() - invalid slot");
+  return myLayers.Value(theSlot);
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::DispatchOnNodeRemoved(const BRepGraph_NodeId theNode,
+                                                    const BRepGraph_NodeId theReplacement) noexcept
+{
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    aLayer->OnNodeRemoved(theNode, theReplacement);
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::DispatchNodeModified(const BRepGraph_NodeId theNode) noexcept
+{
+  if (!HasModificationSubscribers())
+    return;
+
+  const int aKindBit = BRepGraph_Layer::KindBit(theNode.NodeKind);
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    if ((aLayer->SubscribedKinds() & aKindBit) != 0)
+      aLayer->OnNodeModified(theNode);
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::DispatchNodesModified(
+  const NCollection_Vector<BRepGraph_NodeId>& theModifiedNodes,
+  const int                                   theModifiedKindsMask) noexcept
+{
+  if (!HasModificationSubscribers() || theModifiedKindsMask == 0)
+    return;
+
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    if ((aLayer->SubscribedKinds() & theModifiedKindsMask) != 0)
+      aLayer->OnNodesModified(theModifiedNodes);
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::DispatchOnCompact(
+  const NCollection_DataMap<BRepGraph_NodeId, BRepGraph_NodeId>& theRemapMap) noexcept
+{
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    aLayer->OnCompact(theRemapMap);
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::ClearAll() noexcept
+{
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    aLayer->Clear();
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::InvalidateAll() noexcept
+{
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    aLayer->InvalidateAll();
+  }
+}
+
+//=================================================================================================
+
+void BRepGraph_LayerRegistry::recomputeSubscribedKindsMask()
+{
+  mySubscribedKindsMask = 0;
+  for (const occ::handle<BRepGraph_Layer>& aLayer : myLayers)
+  {
+    mySubscribedKindsMask |= aLayer->SubscribedKinds();
+  }
+}