src/Selector/Selector_Selector.cpp

   1 // Copyright (C) 2014-2017  CEA/DEN, EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License, or (at your option) any later version.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or
  18 // email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
  19 //
  20
  21 #include <Selector_Selector.h>
  22
  23 #include <Selector_NameGenerator.h>
  24 #include <Selector_NExplode.h>
  25
  26 #include <TDF_ChildIDIterator.hxx>
  27 #include <TopoDS_Iterator.hxx>
  28 #include <TopoDS_Builder.hxx>
  29 #include <TopExp_Explorer.hxx>
  30 #include <TNaming_Tool.hxx>
  31 #include <TNaming_NewShapeIterator.hxx>
  32 #include <TNaming_OldShapeIterator.hxx>
  33 #include <TNaming_SameShapeIterator.hxx>
  34 #include <TNaming_Iterator.hxx>
  35 #include <TNaming_Builder.hxx>
  36 #include <TopTools_MapOfShape.hxx>
  37
  38 #include <TDataStd_Integer.hxx>
  39 #include <TDataStd_ReferenceArray.hxx>
  40 #include <TDataStd_IntegerArray.hxx>
  41 #include <TDataStd_Name.hxx>
  42
  43 #include <list>
  44
  45 /// type of the selection, integerm keeps the Selector_Type value
  46 static const Standard_GUID kSEL_TYPE("db174d59-c2e3-4a90-955e-55544df090d6");
  47 /// type of the shape, stored in case it is intersection or container
  48 static const Standard_GUID kSHAPE_TYPE("864b3267-cb9d-4107-bf58-c3ce1775b171");
  49 //  reference attribute that contains the reference to labels where the "from" or "base" shapes
  50 // of selection are located
  51 static const Standard_GUID kBASE_ARRAY("7c515b1a-9549-493d-9946-a4933a22f45f");
  52 // array of the neighbor levels
  53 static const Standard_GUID kLEVELS_ARRAY("ee4c4b45-e859-4e86-aa4f-6eac68e0ca1f");
  54 // weak index (integer) of the sub-shape
  55 static const Standard_GUID kWEAK_INDEX("e9373a61-cabc-4ee8-aabf-aea47c62ed87");
  56
  57 Selector_Selector::Selector_Selector(TDF_Label theLab) : myLab(theLab)
  58 {
  59   myWeakIndex = -1;
  60 }
  61
  62 TDF_Label Selector_Selector::label()
  63 {
  64   return myLab;
  65 }
  66
  67 // adds to theResult all labels that contain initial shapes for theValue located in theFinal
  68 static void findBases(Handle(TNaming_NamedShape) theFinal, const TopoDS_Shape& theValue,
  69   bool aMustBeAtFinal, TDF_LabelList& theResult)
  70 {
  71   TNaming_SameShapeIterator aLabIter(theValue, theFinal->Label());
  72   for(; aLabIter.More(); aLabIter.Next()) {
  73     Handle(TNaming_NamedShape) aNS;
  74     aLabIter.Label().FindAttribute(TNaming_NamedShape::GetID(), aNS);
  75     if (aMustBeAtFinal && aNS != theFinal)
  76       continue; // looking for old at the same final label only
  77     TNaming_Evolution anEvolution = aNS->Evolution();
  78     if (anEvolution == TNaming_PRIMITIVE) {
  79       // check that this is not in the results already
  80       const TDF_Label aResult = aNS->Label();
  81       TDF_LabelList::Iterator aResIter(theResult);
  82       for(; aResIter.More(); aResIter.Next()) {
  83         if (aResIter.Value().IsEqual(aResult))
  84           break;
  85       }
  86       if (!aResIter.More()) // not found, so add this new
  87         theResult.Append(aResult);
  88     }
  89     if (anEvolution == TNaming_GENERATED || anEvolution == TNaming_MODIFY) {
  90       for(TNaming_Iterator aThisIter(aNS); aThisIter.More(); aThisIter.Next()) {
  91         if (aThisIter.NewShape().IsSame(theValue)) {
  92           // continue recursively, null NS means that any NS are ok
  93           findBases(theFinal, aThisIter.OldShape(), false, theResult);
  94         }
  95       }
  96     }
  97   }
  98 }
  99
 100 // returns the sub-shapes of theSubType which belong to all theShapes (so, common or intersection)
 101 static void commonShapes(const TopoDS_ListOfShape& theShapes, TopAbs_ShapeEnum theSubType,
 102   TopoDS_ListOfShape& theResults)
 103 {
 104   TopoDS_ListOfShape::iterator aSubSel = theShapes.begin();
 105   for(; aSubSel != theShapes.end(); aSubSel++) {
 106     TopTools_MapOfShape aCurrentMap;
 107     for(TopExp_Explorer anExp(*aSubSel, theSubType); anExp.More(); anExp.Next()) {
 108       if (aCurrentMap.Add(anExp.Current()) && aSubSel == theShapes.begin())
 109         theResults.Append(anExp.Current());
 110     }
 111     if (aSubSel != theShapes.begin()) { // remove from common shapes not in aCurrentMap
 112       for(TopoDS_ListOfShape::Iterator aComIter(theResults); aComIter.More(); ) {
 113         if (aCurrentMap.Contains(aComIter.Value()))
 114           aComIter.Next();
 115         else
 116           theResults.Remove(aComIter);
 117       }
 118     }
 119   }
 120 }
 121
 122 /// Searches neighbor of theLevel of neighborhood to theValue in theContex
 123 static void findNeighbors(const TopoDS_Shape theContext, const TopoDS_Shape theValue,
 124   const int theLevel, TopTools_MapOfShape& theResult)
 125 {
 126   TopAbs_ShapeEnum aConnectorType = TopAbs_VERTEX; // type of the connector sub-shapes
 127   if (theValue.ShapeType() == TopAbs_FACE)
 128     aConnectorType = TopAbs_EDGE;
 129   TopTools_MapOfShape aNBConnectors; // connector shapes that already belong to neighbors
 130   for(TopExp_Explorer aValExp(theValue, aConnectorType); aValExp.More(); aValExp.Next()) {
 131     aNBConnectors.Add(aValExp.Current());
 132   }
 133
 134   TopTools_MapOfShape alreadyProcessed;
 135   alreadyProcessed.Add(theValue);
 136
 137   for(int aLevel = 1; aLevel <= theLevel; aLevel++) {
 138     TopoDS_ListOfShape aGoodCandidates;
 139     TopExp_Explorer aCandidate(theContext, theValue.ShapeType());
 140     for(; aCandidate.More(); aCandidate.Next()) {
 141       if (alreadyProcessed.Contains(aCandidate.Current()))
 142         continue;
 143       TopExp_Explorer aCandConnector(aCandidate.Current(), aConnectorType);
 144       for(; aCandConnector.More(); aCandConnector.Next()) {
 145         if (aNBConnectors.Contains(aCandConnector.Current())) // candidate is neighbor
 146           break;
 147       }
 148       if (aCandConnector.More()) {
 149         if (aLevel == theLevel) { // add a NB into result: it is connected to other neighbors
 150           theResult.Add(aCandidate.Current());
 151         } else { // add to the NB of the current level
 152           aGoodCandidates.Append(aCandidate.Current());
 153         }
 154       }
 155     }
 156     if (aLevel != theLevel) { // good candidates are added to neighbor of this level by connectors
 157       for(TopoDS_ListOfShape::Iterator aGood(aGoodCandidates); aGood.More(); aGood.Next()) {
 158         TopExp_Explorer aGoodConnector(aGood.Value(), aConnectorType);
 159         for(; aGoodConnector.More(); aGoodConnector.Next()) {
 160           aNBConnectors.Add(aGoodConnector.Current());
 161         }
 162         alreadyProcessed.Add(aGood.Value());
 163       }
 164     }
 165   }
 166 }
 167
 168 /// Searches the neighbor shape by neighbors defined in theNB in theContext shape
 169 static const TopoDS_Shape findNeighbor(const TopoDS_Shape theContext,
 170   const std::list<std::pair<TopoDS_Shape, int> >& theNB)
 171 {
 172   // searching for neighbors with minimum level
 173   int aMinLevel = 0;
 174   std::list<std::pair<TopoDS_Shape, int> >::const_iterator aNBIter = theNB.cbegin();
 175   for(; aNBIter != theNB.cend(); aNBIter++) {
 176     if (aMinLevel == 0 || aNBIter->second < aMinLevel) {
 177       aMinLevel = aNBIter->second;
 178     }
 179   }
 180   // collect all neighbors which are neighbors of sub-shapes with minimum level
 181   bool aFirst = true;
 182   TopoDS_ListOfShape aMatches;
 183   for(aNBIter = theNB.cbegin(); aNBIter != theNB.cend(); aNBIter++) {
 184     if (aNBIter->second == aMinLevel) {
 185       TopTools_MapOfShape aThisNBs;
 186       findNeighbors(theContext, aNBIter->first, aMinLevel, aThisNBs);
 187       // aMatches must contain common part of all NBs lists
 188       for(TopTools_MapOfShape::Iterator aThisNB(aThisNBs); aThisNB.More(); aThisNB.Next()) {
 189         if (aFirst) {
 190           aMatches.Append(aThisNB.Value());
 191         } else {
 192           // remove all in aMatches which are not in this NBs
 193           for(TopoDS_ListOfShape::Iterator aMatch(aMatches); aMatch.More(); ) {
 194             if (aThisNBs.Contains(aMatch.Value())) {
 195               aMatch.Next();
 196             } else {
 197               aMatches.Remove(aMatch);
 198             }
 199           }
 200         }
 201       }
 202       aFirst = false;
 203     }
 204   }
 205   if (aMatches.IsEmpty())
 206     return TopoDS_Shape(); // not found any candidate
 207   if (aMatches.Extent() == 1)
 208     return aMatches.First(); // already found good candidate
 209   // iterate all matches to find by other (higher level) neighbors the best candidate
 210   TopoDS_Shape aGoodCandidate;
 211   for(TopoDS_ListOfShape::Iterator aCandidate(aMatches); aCandidate.More(); aCandidate.Next()) {
 212     bool aValidCadidate = true;
 213     for(int aLevel = aMinLevel + 1; true; aLevel++) {
 214       bool aFooundHigherLevel = false;
 215       TopoDS_ListOfShape aLevelNBs;
 216       for(aNBIter = theNB.cbegin(); aNBIter != theNB.cend(); aNBIter++) {
 217         if (aNBIter->second == aLevel)
 218           aLevelNBs.Append(aNBIter->first);
 219         else if (aNBIter->second >= aLevel)
 220           aFooundHigherLevel = true;
 221       }
 222       if (!aFooundHigherLevel && aLevelNBs.IsEmpty()) { // iterated all, so, good candidate
 223         if (aGoodCandidate.IsNull()) {
 224           aGoodCandidate = aCandidate.Value();
 225         } else { // too many good candidates
 226           return TopoDS_Shape();
 227         }
 228       }
 229       if (!aLevelNBs.IsEmpty()) {
 230         TopTools_MapOfShape aNBsOfCandidate;
 231         findNeighbors(theContext, aCandidate.Value(), aLevel, aNBsOfCandidate);
 232         // check all stored neighbors are in the map of real neighbors
 233         for(TopoDS_ListOfShape::Iterator aLevIter(aLevelNBs); aLevIter.More(); aLevIter.Next()) {
 234           if (!aNBsOfCandidate.Contains(aLevIter.Value())) {
 235             aValidCadidate = false;
 236             break;
 237           }
 238         }
 239       }
 240       if (!aValidCadidate) // candidate is not valid, break the checking
 241         break;
 242     }
 243   }
 244   return aGoodCandidate;
 245 }
 246
 247 bool Selector_Selector::select(const TopoDS_Shape theContext, const TopoDS_Shape theValue,
 248   const bool theUseNeighbors)
 249 {
 250   if (theValue.IsNull() || theContext.IsNull())
 251     return false;
 252   // check the value shape can be named as it is, or it is needed to construct it from the
 253   // higher level shapes (like a box vertex by faces that form this vertex)
 254   if (!TNaming_Tool::HasLabel(myLab, theValue)) {
 255     TopAbs_ShapeEnum aSelectionType = theValue.ShapeType();
 256     myShapeType = aSelectionType;
 257     if (aSelectionType == TopAbs_COMPOUND || aSelectionType == TopAbs_COMPSOLID ||
 258         aSelectionType == TopAbs_SHELL || aSelectionType == TopAbs_WIRE)
 259     { // iterate all sub-shapes and select them on sublabels
 260       for(TopoDS_Iterator aSubIter(theValue); aSubIter.More(); aSubIter.Next()) {
 261         if (!selectBySubSelector(theContext, aSubIter.Value())) {
 262           return false; // if some selector is failed, everything is failed
 263         }
 264       }
 265       myType = SELTYPE_CONTAINER;
 266       return true;
 267     }
 268
 269     // try to find the shape of the higher level type in the context shape
 270     bool aFacesTried = false; // for identification of vertices, faces are tried, then edges
 271     while(aSelectionType != TopAbs_FACE || !aFacesTried) {
 272       if (aSelectionType == TopAbs_FACE) {
 273         if (theValue.ShapeType() != TopAbs_VERTEX)
 274           break;
 275         aFacesTried = true;
 276         aSelectionType = TopAbs_EDGE;
 277       } else
 278         aSelectionType = TopAbs_FACE;
 279       TopTools_MapOfShape anIntersectors; // shapes of aSelectionType that contain theValue
 280       TopoDS_ListOfShape anIntList; // same as anIntersectors
 281       for(TopExp_Explorer aSelExp(theContext, aSelectionType); aSelExp.More(); aSelExp.Next()) {
 282         TopExp_Explorer aSubExp(aSelExp.Current(), theValue.ShapeType());
 283         for(; aSubExp.More(); aSubExp.Next()) {
 284           if (aSubExp.Current().IsSame(theValue)) {
 285             if (anIntersectors.Add(aSelExp.Current()))
 286               anIntList.Append(aSelExp.Current());
 287             break;
 288           }
 289         }
 290       }
 291       // check that solution is only one
 292       TopoDS_ListOfShape aCommon;
 293       commonShapes(anIntList, theValue.ShapeType(), aCommon);
 294       if (aCommon.Extent() == 1 && aCommon.First().IsSame(theValue)) {
 295         // name the intersectors
 296         std::list<Selector_Selector> aSubSelList;
 297         TopTools_MapOfShape::Iterator anInt(anIntersectors);
 298         for (; anInt.More(); anInt.Next()) {
 299           if (!selectBySubSelector(theContext, anInt.Value())) {
 300             break; // if some selector is failed, stop and search another solution
 301           }
 302         }
 303         if (!anInt.More()) { // all intersectors were correctly named
 304           myType = SELTYPE_INTERSECT;
 305           return true;
 306         }
 307       }
 308     }
 309
 310     if (!theUseNeighbors)
 311       return false;
 312
 313     // searching by neighbours
 314     std::list<std::pair<TopoDS_Shape, int> > aNBs; /// neighbor sub-shape -> level of neighborhood
 315     for(int aLevel = 1; true; aLevel++) {
 316       TopTools_MapOfShape aNewNB;
 317       findNeighbors(theContext, theValue, aLevel, aNewNB);
 318       if (aNewNB.Extent() == 0) { // there are no neighbors of the given level, stop iteration
 319         break;
 320       }
 321       // check which can be named correctly, without by neighbors type
 322       for(TopTools_MapOfShape::Iterator aNBIter(aNewNB); aNBIter.More(); ) {
 323         Selector_Selector aSelector(myLab.FindChild(1));
 324         if (aSelector.select(theContext, aNBIter.Value(), false)) { // add to the list of good NBs
 325           aNBs.push_back(std::pair<TopoDS_Shape, int>(aNBIter.Value(), aLevel));
 326         }
 327         aNewNB.Remove(aNBIter.Key());
 328         aNBIter.Initialize(aNewNB);
 329       }
 330       TopoDS_Shape aResult = findNeighbor(theContext, aNBs);
 331       if (!aResult.IsNull() && aResult.IsSame(theValue)) {
 332         std::list<std::pair<TopoDS_Shape, int> >::iterator aNBIter = aNBs.begin();
 333         for(; aNBIter != aNBs.end(); aNBIter++) {
 334           if (!selectBySubSelector(theContext, aNBIter->first, false)) {
 335             return false; // something is wrong because before this selection was ok
 336           }
 337           myNBLevel.push_back(aNBIter->second);
 338
 339         }
 340         myType = SELTYPE_FILTER_BY_NEIGHBOR;
 341         return true;
 342       }
 343     }
 344     return false;
 345   }
 346   // searching for the base shapes of the value
 347   Handle(TNaming_NamedShape) aPrimitiveNS;
 348   NCollection_List<Handle(TNaming_NamedShape)> aModifList;
 349   for(TNaming_SameShapeIterator aShapes(theValue, myLab); aShapes.More(); aShapes.Next())
 350   {
 351     Handle(TNaming_NamedShape) aNS;
 352     if (aShapes.Label().FindAttribute(TNaming_NamedShape::GetID(), aNS)) {
 353       TNaming_Evolution anEvolution = aNS->Evolution();
 354       if (anEvolution == TNaming_PRIMITIVE) { // the value shape is declared as PRIMITIVE
 355         aPrimitiveNS = aNS;
 356         break;
 357       } else if (anEvolution == TNaming_GENERATED || anEvolution == TNaming_MODIFY) {
 358         // check this is a new shape
 359         TNaming_Iterator aNSIter(aNS);
 360         for(; aNSIter.More(); aNSIter.Next())
 361           if (aNSIter.NewShape().IsSame(theValue))
 362             break;
 363         if (aNSIter.More()) // new was found
 364           aModifList.Append(aNS);
 365       }
 366     }
 367   }
 368
 369   if (!aPrimitiveNS.IsNull()) {
 370     myType = SELTYPE_PRIMITIVE;
 371     myFinal = aPrimitiveNS->Label();
 372     return true;
 373   }
 374
 375   if (aModifList.Extent() > 1) { // searching for the best modification result: by context
 376     Handle(TNaming_NamedShape) aCandidate;
 377     NCollection_List<Handle(TNaming_NamedShape)>::Iterator aModIter(aModifList);
 378     for(; !aModifList.IsEmpty() && aModIter.More(); aModIter.Next()) {
 379        aCandidate = aModIter.Value();
 380       TDF_Label aFatherLab = aCandidate->Label().Father();
 381       Handle(TNaming_NamedShape) aFatherNS;
 382       if (aFatherLab.FindAttribute(TNaming_NamedShape::GetID(), aFatherNS)) {
 383         for(TNaming_Iterator anIter(aFatherNS); anIter.More(); anIter.Next()) {
 384           if (theContext.IsSame(anIter.NewShape())) { // found the best modification
 385             aModifList.Clear();
 386             break;
 387           }
 388         }
 389       }
 390     }
 391     // take the best candidate, or the last in the iteration
 392     aModifList.Clear();
 393     aModifList.Append(aCandidate);
 394   }
 395
 396   if (!aModifList.IsEmpty()) {
 397     // searching for all the base shapes of this modification
 398     findBases(aModifList.First(), theValue, true, myBases);
 399     if (!myBases.IsEmpty()) {
 400       myFinal = aModifList.First()->Label();
 401       TopoDS_ListOfShape aCommon;
 402       findModificationResult(aCommon);
 403       // trying to search by neighbours
 404       if (aCommon.Extent() > 1) { // more complicated selection
 405         if (!theUseNeighbors)
 406           return false;
 407
 408         // searching by neighbours
 409         std::list<std::pair<TopoDS_Shape, int> > aNBs; /// neighbor sub-shape -> level of neighborhood
 410         for(int aLevel = 1; true; aLevel++) {
 411           TopTools_MapOfShape aNewNB;
 412           findNeighbors(theContext, theValue, aLevel, aNewNB);
 413           if (aNewNB.Extent() == 0) { // there are no neighbors of the given level, stop iteration
 414             break;
 415           }
 416           // check which can be named correctly, without by neighbors type
 417           for(TopTools_MapOfShape::Iterator aNBIter(aNewNB); aNBIter.More(); ) {
 418             Selector_Selector aSelector(myLab.FindChild(1));
 419             if (aSelector.select(theContext, aNBIter.Value(), false)) { // add to the list of good NBs
 420               aNBs.push_back(std::pair<TopoDS_Shape, int>(aNBIter.Value(), aLevel));
 421             }
 422             aNewNB.Remove(aNBIter.Key());
 423             aNBIter.Initialize(aNewNB);
 424           }
 425           TopoDS_Shape aResult = findNeighbor(theContext, aNBs);
 426           if (!aResult.IsNull() && aResult.IsSame(theValue)) {
 427             std::list<std::pair<TopoDS_Shape, int> >::iterator aNBIter = aNBs.begin();
 428             for(; aNBIter != aNBs.end(); aNBIter++) {
 429               if (!selectBySubSelector(theContext, aNBIter->first)) {
 430                 return false; // something is wrong because before this selection was ok
 431               }
 432               myNBLevel.push_back(aNBIter->second);
 433
 434             }
 435             myType = SELTYPE_FILTER_BY_NEIGHBOR;
 436             return true;
 437           }
 438         }
 439         // filter by neighbours did not help
 440         if (aCommon.Extent() > 1) { // weak naming between the common results
 441           Selector_NExplode aNexp(aCommon);
 442           myWeakIndex = aNexp.index(theValue);
 443           if (myWeakIndex == -1)
 444             return false;
 445         }
 446       }
 447     }
 448     myType = SELTYPE_MODIFICATION;
 449     if (myBases.IsEmpty()) { // selection based on the external shape, weak name by finals compound
 450       TopoDS_ListOfShape aCommon;
 451       myFinal = aModifList.First()->Label();
 452       Handle(TNaming_NamedShape) aNS;
 453       myFinal.FindAttribute(TNaming_NamedShape::GetID(), aNS);
 454       for(TNaming_Iterator aFinalIter(aNS); aFinalIter.More(); aFinalIter.Next()) {
 455         const TopoDS_Shape& aNewShape = aFinalIter.NewShape();
 456         if (!aNewShape.IsNull())
 457           aCommon.Append(aNewShape);
 458       }
 459       Selector_NExplode aNexp(aCommon);
 460       myWeakIndex = aNexp.index(theValue);
 461       if (myWeakIndex == -1)
 462         return false;
 463     }
 464     return true;
 465   }
 466
 467   // not found a good result
 468   return false;
 469 }
 470
 471 void Selector_Selector::store()
 472 {
 473   myLab.ForgetAllAttributes(true); // remove old naming data
 474   TDataStd_Integer::Set(myLab, kSEL_TYPE, (int)myType);
 475   switch(myType) {
 476   case SELTYPE_CONTAINER:
 477   case SELTYPE_INTERSECT: {
 478     TDataStd_Integer::Set(myLab, kSHAPE_TYPE, (int)myShapeType);
 479     // store also all sub-selectors
 480     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 481     for(; aSubSel != mySubSelList.end(); aSubSel++) {
 482       aSubSel->store();
 483     }
 484     break;
 485   }
 486   case SELTYPE_PRIMITIVE: {
 487     Handle(TDataStd_ReferenceArray) anArray =
 488       TDataStd_ReferenceArray::Set(myLab, kBASE_ARRAY, 0, 0);
 489     anArray->SetValue(0, myFinal);
 490     break;
 491   }
 492   case SELTYPE_MODIFICATION: {
 493     Handle(TDataStd_ReferenceArray) anArray =
 494       TDataStd_ReferenceArray::Set(myLab, kBASE_ARRAY, 0, myBases.Extent());
 495     TDF_LabelList::Iterator aBIter(myBases);
 496     for(int anIndex = 0; aBIter.More(); aBIter.Next(), anIndex++) {
 497       anArray->SetValue(anIndex, aBIter.Value());
 498     }
 499     anArray->SetValue(myBases.Extent(), myFinal); // final is in the end of array
 500     if (myWeakIndex != -1) {
 501       TDataStd_Integer::Set(myLab, kWEAK_INDEX, myWeakIndex);
 502     }
 503     break;
 504   }
 505   case SELTYPE_FILTER_BY_NEIGHBOR: {
 506     TDataStd_Integer::Set(myLab, kSHAPE_TYPE, (int)myShapeType);
 507     // store numbers of levels corresponded to the neighbors in sub-selectors
 508     Handle(TDataStd_IntegerArray) anArray =
 509       TDataStd_IntegerArray::Set(myLab, kLEVELS_ARRAY, 0, int(myNBLevel.size()) - 1);
 510     std::list<int>::iterator aLevel = myNBLevel.begin();
 511     for(int anIndex = 0; aLevel != myNBLevel.end(); aLevel++, anIndex++) {
 512       anArray->SetValue(anIndex, *aLevel);
 513     }
 514     // store all sub-selectors
 515     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 516     for(; aSubSel != mySubSelList.end(); aSubSel++) {
 517       aSubSel->store();
 518     }
 519   }
 520   default: { // unknown case
 521     break;
 522   }
 523   }
 524 }
 525
 526 bool Selector_Selector::restore()
 527 {
 528   Handle(TDataStd_Integer) aTypeAttr;
 529   if (!myLab.FindAttribute(kSEL_TYPE, aTypeAttr))
 530     return false;
 531   myType = Selector_Type(aTypeAttr->Get());
 532   switch(myType) {
 533   case SELTYPE_CONTAINER:
 534   case SELTYPE_INTERSECT: {
 535     Handle(TDataStd_Integer) aShapeTypeAttr;
 536     if (!myLab.FindAttribute(kSHAPE_TYPE, aShapeTypeAttr))
 537       return false;
 538     myShapeType = TopAbs_ShapeEnum(aShapeTypeAttr->Get());
 539     // restore sub-selectors
 540     bool aSubResult = true;
 541     mySubSelList.clear();
 542     for(TDF_ChildIDIterator aSub(myLab, kSEL_TYPE, false); aSub.More(); aSub.Next()) {
 543       mySubSelList.push_back(Selector_Selector(aSub.Value()->Label()));
 544       if (!mySubSelList.back().restore())
 545         aSubResult = false;
 546     }
 547     return aSubResult;
 548   }
 549   case SELTYPE_PRIMITIVE: {
 550     Handle(TDataStd_ReferenceArray) anArray;
 551     if (myLab.FindAttribute(kBASE_ARRAY, anArray)) {
 552       myFinal = anArray->Value(0);
 553       return true;
 554     }
 555     return false;
 556   }
 557   case SELTYPE_MODIFICATION: {
 558     Handle(TDataStd_ReferenceArray) anArray;
 559     if (myLab.FindAttribute(kBASE_ARRAY, anArray)) {
 560       int anUpper = anArray->Upper();
 561       for(int anIndex = 0; anIndex < anUpper; anIndex++) {
 562         myBases.Append(anArray->Value(anIndex));
 563       }
 564       myFinal = anArray->Value(anUpper);
 565       Handle(TDataStd_Integer) aWeakInt;
 566       if (myLab.FindAttribute(kWEAK_INDEX, aWeakInt)) {
 567         myWeakIndex = aWeakInt->Get();
 568       }
 569       return true;
 570     }
 571     return false;
 572   }
 573   case SELTYPE_FILTER_BY_NEIGHBOR: {
 574     Handle(TDataStd_Integer) aShapeTypeAttr;
 575     if (!myLab.FindAttribute(kSHAPE_TYPE, aShapeTypeAttr))
 576       return false;
 577     myShapeType = TopAbs_ShapeEnum(aShapeTypeAttr->Get());
 578     // restore sub-selectors
 579     bool aSubResult = true;
 580     mySubSelList.clear();
 581     for(TDF_ChildIDIterator aSub(myLab, kSEL_TYPE, false); aSub.More(); aSub.Next()) {
 582       mySubSelList.push_back(Selector_Selector(aSub.Value()->Label()));
 583       if (!mySubSelList.back().restore())
 584         aSubResult = false;
 585     }
 586     // restore levels indices
 587     Handle(TDataStd_IntegerArray) anArray;
 588     if (!myLab.FindAttribute(kLEVELS_ARRAY, anArray))
 589       return false;
 590     for(int anIndex = 0; anIndex <= anArray->Upper(); anIndex++) {
 591       myNBLevel.push_back(anArray->Value(anIndex));
 592     }
 593     return true;
 594   }
 595   default: { // unknown case
 596   }
 597   }
 598   return false;
 599 }
 600
 601 /// Returns in theResults all shapes with history started in theBase and ended in theFinal
 602 static void findFinals(const TopoDS_Shape& theBase, const TDF_Label& theFinal,
 603   TopTools_MapOfShape& theResults)
 604 {
 605   for(TNaming_NewShapeIterator aBaseIter(theBase, theFinal); aBaseIter.More(); aBaseIter.Next()) {
 606     TNaming_Evolution anEvolution = aBaseIter.NamedShape()->Evolution();
 607     if (anEvolution == TNaming_GENERATED || anEvolution == TNaming_MODIFY) {
 608       if (aBaseIter.NamedShape()->Label().IsEqual(theFinal)) {
 609         theResults.Add(aBaseIter.Shape());
 610       } else {
 611         findFinals(aBaseIter.Shape(), theFinal, theResults);
 612       }
 613     }
 614   }
 615 }
 616
 617 void Selector_Selector::findModificationResult(TopoDS_ListOfShape& theCommon) {
 618   for(TDF_LabelList::Iterator aBase(myBases); aBase.More(); aBase.Next()) {
 619     TopTools_MapOfShape aFinals;
 620     for(TNaming_Iterator aBaseShape(aBase.Value()); aBaseShape.More(); aBaseShape.Next())
 621       findFinals(aBaseShape.NewShape(), myFinal, aFinals);
 622     if (!aFinals.IsEmpty()) {
 623       if (theCommon.IsEmpty()) { // just copy all to common
 624         for(TopTools_MapOfShape::Iterator aFinal(aFinals); aFinal.More(); aFinal.Next()) {
 625           theCommon.Append(aFinal.Key());
 626         }
 627       } else { // keep only shapes presented in both lists
 628         for(TopoDS_ListOfShape::Iterator aCommon(theCommon); aCommon.More(); ) {
 629           if (aFinals.Contains(aCommon.Value())) {
 630             aCommon.Next();
 631           } else { // common is not found, remove it
 632             theCommon.Remove(aCommon);
 633           }
 634         }
 635       }
 636     }
 637   }
 638 }
 639
 640 bool Selector_Selector::solve(const TopoDS_Shape& theContext)
 641 {
 642   TopoDS_Shape aResult; // null if invalid
 643   switch(myType) {
 644   case SELTYPE_CONTAINER: {
 645     TopoDS_Builder aBuilder;
 646     switch(myShapeType) {
 647     case TopAbs_COMPOUND: {
 648       TopoDS_Compound aComp;
 649       aBuilder.MakeCompound(aComp);
 650       aResult = aComp;
 651       break;
 652       }
 653     case TopAbs_COMPSOLID: {
 654       TopoDS_CompSolid aComp;
 655       aBuilder.MakeCompSolid(aComp);
 656       aResult = aComp;
 657       break;
 658     }
 659     case TopAbs_SHELL: {
 660       TopoDS_Shell aShell;
 661       aBuilder.MakeShell(aShell);
 662       aResult = aShell;
 663       break;
 664     }
 665     case TopAbs_WIRE: {
 666       TopoDS_Wire aWire;
 667       aBuilder.MakeWire(aWire);
 668       aResult = aWire;
 669       break;
 670     }
 671     }
 672     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 673     for(; aSubSel != mySubSelList.end(); aSubSel++) {
 674       if (!aSubSel->solve(theContext)) {
 675         return false;
 676       }
 677       aBuilder.Add(aResult, aSubSel->value());
 678     }
 679     break;
 680   }
 681   case SELTYPE_INTERSECT: {
 682     TopoDS_ListOfShape aSubSelectorShapes;
 683     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 684     for(; aSubSel != mySubSelList.end(); aSubSel++) {
 685       if (!aSubSel->solve(theContext)) {
 686         return false;
 687       }
 688       aSubSelectorShapes.Append(aSubSel->value());
 689     }
 690     TopoDS_ListOfShape aCommon; // common sub shapes in each sub-selector (a result)
 691     commonShapes(aSubSelectorShapes, myShapeType, aCommon);
 692     if (aCommon.Extent() != 1)
 693       return false;
 694     aResult = aCommon.First();
 695     break;
 696   }
 697   case SELTYPE_PRIMITIVE: {
 698     Handle(TNaming_NamedShape) aNS;
 699     if (myFinal.FindAttribute(TNaming_NamedShape::GetID(), aNS)) {
 700       aResult = aNS->Get();
 701     }
 702     break;
 703   }
 704   case SELTYPE_MODIFICATION: {
 705     if (myBases.IsEmpty() && myWeakIndex) { // weak name by the final shapes index
 706       TopoDS_ListOfShape aCommon;
 707       Handle(TNaming_NamedShape) aNS;
 708       myFinal.FindAttribute(TNaming_NamedShape::GetID(), aNS);
 709       for(TNaming_Iterator aFinalIter(aNS); aFinalIter.More(); aFinalIter.Next()) {
 710         const TopoDS_Shape& aNewShape = aFinalIter.NewShape();
 711         if (!aNewShape.IsNull())
 712           aCommon.Append(aNewShape);
 713       }
 714       Selector_NExplode aNexp(aCommon);
 715       aResult = aNexp.shape(myWeakIndex);
 716     } else { // standard case
 717       TopoDS_ListOfShape aFinalsCommon; // final shapes presented in all results from bases
 718       findModificationResult(aFinalsCommon);
 719       if (aFinalsCommon.Extent() == 1) // only in this case result is valid: found only one shape
 720         aResult = aFinalsCommon.First();
 721       else if (aFinalsCommon.Extent() > 1 && myWeakIndex) {
 722         Selector_NExplode aNExp(aFinalsCommon);
 723         aResult = aNExp.shape(myWeakIndex);
 724       }
 725     }
 726     break;
 727   }
 728   case SELTYPE_FILTER_BY_NEIGHBOR: {
 729     std::list<std::pair<TopoDS_Shape, int> > aNBs; /// neighbor sub-shape -> level of neighborhood
 730     std::list<int>::iterator aLevel = myNBLevel.begin();
 731     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 732     for(; aSubSel != mySubSelList.end(); aSubSel++, aLevel++) {
 733       if (!aSubSel->solve(theContext)) {
 734         return false;
 735       }
 736       aNBs.push_back(std::pair<TopoDS_Shape, int>(aSubSel->value(), *aLevel));
 737     }
 738     aResult = findNeighbor(theContext, aNBs);
 739   }
 740   default: { // unknown case
 741   }
 742   }
 743
 744   TNaming_Builder aBuilder(myLab);
 745   if (!aResult.IsNull()) {
 746     aBuilder.Select(aResult, aResult);
 747     return true;
 748   }
 749   return false; // builder just erases the named shape in case of error
 750 }
 751
 752 TopoDS_Shape Selector_Selector::value()
 753 {
 754   Handle(TNaming_NamedShape) aNS;
 755   if (myLab.FindAttribute(TNaming_NamedShape::GetID(), aNS))
 756     return aNS->Get();
 757   return TopoDS_Shape(); // empty, error shape
 758 }
 759
 760 static const std::string kWEAK_NAME_IDENTIFIER = "weak_name_";
 761
 762 std::string Selector_Selector::name(Selector_NameGenerator* theNameGenerator) {
 763   switch(myType) {
 764   case SELTYPE_CONTAINER:
 765   case SELTYPE_INTERSECT: {
 766     std::string aResult;
 767     // add names of sub-components one by one in "[]"
 768     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 769     for(; aSubSel != mySubSelList.end(); aSubSel++) {
 770       aResult += '[';
 771       aResult += aSubSel->name(theNameGenerator);
 772       aResult += ']';
 773     }
 774     return aResult;
 775   }
 776   case SELTYPE_PRIMITIVE: {
 777     Handle(TDataStd_Name) aName;
 778     if (!myFinal.FindAttribute(TDataStd_Name::GetID(), aName))
 779       return "";
 780     return theNameGenerator->contextName(myFinal) + "/" +
 781       std::string(TCollection_AsciiString(aName->Get()).ToCString());
 782   }
 783   case SELTYPE_MODIFICATION: {
 784     // final&base1&base2 +optionally: [weak_name_1]
 785     std::string aResult;
 786     Handle(TDataStd_Name) aName;
 787     if (!myFinal.FindAttribute(TDataStd_Name::GetID(), aName))
 788       return "";
 789     aResult += theNameGenerator->contextName(myFinal) + "/" +
 790       std::string(TCollection_AsciiString(aName->Get()).ToCString());
 791     for(TDF_LabelList::iterator aBase = myBases.begin(); aBase != myBases.end(); aBase++) {
 792       if (!aBase->FindAttribute(TDataStd_Name::GetID(), aName))
 793         return "";
 794       aResult += theNameGenerator->contextName(*aBase) + "/" +
 795         std::string(TCollection_AsciiString(aName->Get()).ToCString());
 796     }
 797     if (myWeakIndex != -1) {
 798       std::ostringstream aWeakStr;
 799       aWeakStr<<"&"<<kWEAK_NAME_IDENTIFIER<<myWeakIndex;
 800       aResult += aWeakStr.str();
 801     }
 802     return aResult;
 803   }
 804   case SELTYPE_FILTER_BY_NEIGHBOR: {
 805     // (nb1)level_if_more_than_1(nb2)level_if_more_than_1(nb3)level_if_more_than_1
 806     std::string aResult;
 807     std::list<int>::iterator aLevel = myNBLevel.begin();
 808     std::list<Selector_Selector>::iterator aSubSel = mySubSelList.begin();
 809     for(; aSubSel != mySubSelList.end(); aSubSel++, aLevel++) {
 810       aResult += "(" + aSubSel->name(theNameGenerator) + ")";
 811       if (*aLevel > 1)
 812         aResult += *aLevel;
 813     }
 814     return aResult;
 815   }
 816   default: { // unknown case
 817   }
 818   };
 819   return "";
 820 }
 821
 822 TDF_Label Selector_Selector::restoreByName(
 823   std::string theName, const TopAbs_ShapeEnum theShapeType,
 824   Selector_NameGenerator* theNameGenerator)
 825 {
 826   if (theName[0] == '[') { // intersection or container
 827     switch(theShapeType) {
 828     case TopAbs_COMPOUND:
 829     case TopAbs_COMPSOLID:
 830     case TopAbs_SHELL:
 831     case TopAbs_WIRE:
 832       myType = SELTYPE_CONTAINER;
 833       break;
 834     case TopAbs_VERTEX:
 835     case TopAbs_EDGE:
 836     case TopAbs_FACE:
 837       myType = SELTYPE_INTERSECT;
 838       break;
 839     default:
 840       return TDF_Label(); // unknown case
 841     }
 842     myShapeType = theShapeType;
 843     TDF_Label aContext;
 844     for(size_t aStart = 0; aStart != std::string::npos;
 845         aStart = theName.find('[', aStart + 1)) {
 846       size_t anEndPos = theName.find(']', aStart + 1);
 847       if (anEndPos != std::string::npos) {
 848         std::string aSubStr = theName.substr(aStart + 1, anEndPos - aStart - 1);
 849         mySubSelList.push_back(Selector_Selector(myLab.FindChild(int(mySubSelList.size()) + 1)));
 850         TDF_Label aSubContext =
 851           mySubSelList.back().restoreByName(aSubStr, theShapeType, theNameGenerator);
 852         if (aSubContext.IsNull())
 853           return aSubContext; // invalid sub-selection parsing
 854         if (!aContext.IsNull() && !aContext.IsEqual(aSubContext)) {
 855           if (!theNameGenerator->isLater(aContext, aSubContext))
 856             aContext = aSubContext;
 857         } else {
 858           aContext = aSubContext;
 859         }
 860       } else
 861         return TDF_Label(); // invalid parentheses
 862     }
 863     return aContext;
 864   } else if (theName[0] == '(') { // filter by neighbours
 865     myType = SELTYPE_FILTER_BY_NEIGHBOR;
 866     TDF_Label aContext;
 867     for(size_t aStart = 0; aStart != std::string::npos;
 868       aStart = theName.find('(', aStart + 1)) {
 869       size_t anEndPos = theName.find(')', aStart + 1);
 870       if (anEndPos != std::string::npos) {
 871         std::string aSubStr = theName.substr(aStart + 1, anEndPos - aStart - 1);
 872         mySubSelList.push_back(Selector_Selector(myLab.FindChild(int(mySubSelList.size()) + 1)));
 873         TDF_Label aSubContext =
 874           mySubSelList.back().restoreByName(aSubStr, theShapeType, theNameGenerator);
 875         if (aSubContext.IsNull())
 876           return aSubContext; // invalid sub-selection parsing
 877         if (!aContext.IsNull() && !aContext.IsEqual(aSubContext)) {
 878           if (!theNameGenerator->isLater(aContext, aSubContext))
 879             aContext = aSubContext;
 880         } else {
 881           aContext = aSubContext;
 882         }
 883         // searching for the level index
 884         std::string aLevel;
 885         for(anEndPos++; anEndPos != std::string::npos &&
 886                         theName[anEndPos] != '(' && theName[anEndPos] != 0;
 887             anEndPos++) {
 888           aLevel += theName[anEndPos];
 889         }
 890         if (aLevel.empty())
 891           myNBLevel.push_back(1); // by default it is 1
 892         else {
 893           int aNum = atoi(aLevel.c_str());
 894           if (aNum > 0)
 895             myNBLevel.push_back(aNum);
 896           else
 897             return TDF_Label(); // invalid number
 898         }
 899       } else
 900         return TDF_Label(); // invalid parentheses
 901     }
 902     return aContext;
 903   } else if (theName.find('&') == std::string::npos) { // wihtout '&' it can be only primitive
 904     myType = SELTYPE_PRIMITIVE;
 905     TDF_Label aContext;
 906     if (theNameGenerator->restoreContext(theName, aContext, myFinal)) {
 907       if (!myFinal.IsNull())
 908         return aContext;
 909     }
 910   } else { // modification
 911     myType = SELTYPE_MODIFICATION;
 912     TDF_Label aContext;
 913     for(size_t anEnd, aStart = 0; aStart != std::string::npos; aStart = anEnd) {
 914       if (aStart != 0)
 915         aStart++;
 916       anEnd = theName.find('&', aStart);
 917       std::string aSubStr =
 918         theName.substr(aStart, anEnd == std::string::npos ? anEnd : anEnd - aStart);
 919       if (aSubStr.find(kWEAK_NAME_IDENTIFIER) == 0) { // weak name identifier
 920         std::string aWeakIndex = aSubStr.substr(kWEAK_NAME_IDENTIFIER.size());
 921         myWeakIndex = atoi(aWeakIndex.c_str());
 922         continue;
 923       }
 924       TDF_Label aSubContext, aValue;
 925       if (!theNameGenerator->restoreContext(aSubStr, aSubContext, aValue))
 926         return TDF_Label(); // can not restore
 927       if(aSubContext.IsNull() || aValue.IsNull())
 928         return TDF_Label(); // can not restore
 929       if (myFinal.IsNull()) {
 930         myFinal = aValue;
 931         aContext = aSubContext;
 932       } else
 933         myBases.Append(aValue);
 934     }
 935     return aContext;
 936   }
 937   return TDF_Label();
 938 }
 939
 940 bool Selector_Selector::selectBySubSelector(
 941   const TopoDS_Shape theContext, const TopoDS_Shape theValue, const bool theUseNeighbors)
 942 {
 943   mySubSelList.push_back(Selector_Selector(myLab.FindChild(int(mySubSelList.size()) + 1)));
 944   if (!mySubSelList.back().select(theContext, theValue, theUseNeighbors)) {
 945     mySubSelList.clear(); // if one of the selector is failed, all become invalid
 946     return false;
 947   }
 948   return true;
 949 }