// Created on: 2017-02-10 // Created by: Sergey NIKONOV // Copyright (c) 2000-2017 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 #include #include #include #include #include #include #include #include #include #include #include #include IMPLEMENT_STANDARD_RTTIEXT(XCAFDoc_NotesTool, TDF_Attribute) enum NotesTool_RootLabels { NotesTool_NotesRoot = 1, NotesTool_AnnotatedItemsRoot }; const Standard_GUID& XCAFDoc_NotesTool::GetID() { static Standard_GUID s_ID("8F8174B1-6125-47a0-B357-61BD2D89380C"); return s_ID; } Handle(XCAFDoc_NotesTool) XCAFDoc_NotesTool::Set(const TDF_Label& theLabel) { Handle(XCAFDoc_NotesTool) aTool; if (!theLabel.IsNull() && !theLabel.FindAttribute(XCAFDoc_NotesTool::GetID(), aTool)) { aTool = new XCAFDoc_NotesTool(); theLabel.AddAttribute(aTool); } return aTool; } XCAFDoc_NotesTool::XCAFDoc_NotesTool() { } TDF_Label XCAFDoc_NotesTool::GetNotesLabel() const { return Label().FindChild(NotesTool_NotesRoot); } TDF_Label XCAFDoc_NotesTool::GetAnnotatedItemsLabel() const { return Label().FindChild(NotesTool_AnnotatedItemsRoot); } Standard_Integer XCAFDoc_NotesTool::NbNotes() const { Standard_Integer nbNotes = 0; for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { const TDF_Label aLabel = anIter.Value(); if (!XCAFDoc_Note::Get(aLabel).IsNull()) ++nbNotes; } return nbNotes; } Standard_Integer XCAFDoc_NotesTool::NbAnnotatedItems() const { Standard_Integer nbItems = 0; for (TDF_ChildIDIterator anIter(GetAnnotatedItemsLabel(), XCAFDoc_AssemblyItemRef::GetID()); anIter.More(); anIter.Next()) { ++nbItems; } return nbItems; } void XCAFDoc_NotesTool::GetNotes(TDF_LabelSequence& theNoteLabels) const { for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { const TDF_Label aLabel = anIter.Value(); if (!XCAFDoc_Note::Get(aLabel).IsNull()) theNoteLabels.Append(aLabel); } } void XCAFDoc_NotesTool::GetAnnotatedItems(TDF_LabelSequence& theItemLabels) const { for (TDF_ChildIDIterator anIter(GetAnnotatedItemsLabel(), XCAFDoc_AssemblyItemRef::GetID()); anIter.More(); anIter.Next()) { theItemLabels.Append(anIter.Value()->Label()); } } Standard_Boolean XCAFDoc_NotesTool::IsAnnotatedItem(const XCAFDoc_AssemblyItemId& theItemId) const { return !FindAnnotatedItem(theItemId).IsNull(); } TDF_Label XCAFDoc_NotesTool::FindAnnotatedItem(const XCAFDoc_AssemblyItemId& theItemId) const { for (TDF_ChildIDIterator anIter(GetAnnotatedItemsLabel(), XCAFDoc_AssemblyItemRef::GetID()); anIter.More(); anIter.Next()) { Handle(XCAFDoc_AssemblyItemRef) anItemRef = Handle(XCAFDoc_AssemblyItemRef)::DownCast(anIter.Value()); if (!anItemRef.IsNull() && anItemRef->GetItem().IsEqual(theItemId) && !anItemRef->HasExtraRef()) return anItemRef->Label(); } return TDF_Label(); } TDF_Label XCAFDoc_NotesTool::FindAnnotatedItemGUID(const XCAFDoc_AssemblyItemId& theItemId, const Standard_GUID& theGUID) const { for (TDF_ChildIDIterator anIter(GetAnnotatedItemsLabel(), XCAFDoc_AssemblyItemRef::GetID()); anIter.More(); anIter.Next()) { Handle(XCAFDoc_AssemblyItemRef) anItemRef = Handle(XCAFDoc_AssemblyItemRef)::DownCast(anIter.Value()); if (!anItemRef.IsNull() && anItemRef->GetItem().IsEqual(theItemId) && anItemRef->HasExtraRef() && anItemRef->GetGUID() == theGUID) return anItemRef->Label(); } return TDF_Label(); } TDF_Label XCAFDoc_NotesTool::FindAnnotatedItemSubshape(const XCAFDoc_AssemblyItemId& theItemId, Standard_Integer theSubshapeIndex) const { for (TDF_ChildIDIterator anIter(GetAnnotatedItemsLabel(), XCAFDoc_AssemblyItemRef::GetID()); anIter.More(); anIter.Next()) { Handle(XCAFDoc_AssemblyItemRef) anItemRef = Handle(XCAFDoc_AssemblyItemRef)::DownCast(anIter.Value()); if (!anItemRef.IsNull() && anItemRef->GetItem().IsEqual(theItemId) && anItemRef->HasExtraRef() && anItemRef->GetSubshapeIndex() == theSubshapeIndex) return anItemRef->Label(); } return TDF_Label(); } Handle(XCAFDoc_Note) XCAFDoc_NotesTool::CreateComment(const TCollection_ExtendedString& theUserName, const TCollection_ExtendedString& theTimeStamp, const TCollection_ExtendedString& theComment) { TDF_Label aNoteLabel; TDF_TagSource aTag; aNoteLabel = aTag.NewChild(GetNotesLabel()); return XCAFDoc_NoteComment::Set(aNoteLabel, theUserName, theTimeStamp, theComment); } Handle(XCAFDoc_Note) XCAFDoc_NotesTool::CreateBinData(const TCollection_ExtendedString& theUserName, const TCollection_ExtendedString& theTimeStamp, const TCollection_ExtendedString& theTitle, const TCollection_AsciiString& theMIMEtype, OSD_File& theFile) { TDF_Label aNoteLabel; TDF_TagSource aTag; aNoteLabel = aTag.NewChild(GetNotesLabel()); return XCAFDoc_NoteBinData::Set(aNoteLabel, theUserName, theTimeStamp, theTitle, theMIMEtype, theFile); } Handle(XCAFDoc_Note) XCAFDoc_NotesTool::CreateBinData(const TCollection_ExtendedString& theUserName, const TCollection_ExtendedString& theTimeStamp, const TCollection_ExtendedString& theTitle, const TCollection_AsciiString& theMIMEtype, const Handle(TColStd_HArray1OfByte)& theData) { TDF_Label aNoteLabel; TDF_TagSource aTag; aNoteLabel = aTag.NewChild(GetNotesLabel()); return XCAFDoc_NoteBinData::Set(aNoteLabel, theUserName, theTimeStamp, theTitle, theMIMEtype, theData); } Standard_Integer XCAFDoc_NotesTool::GetNotes(const XCAFDoc_AssemblyItemId& theItemId, TDF_LabelSequence& theNoteLabels) const { TDF_Label anAnnotatedItem = FindAnnotatedItem(theItemId); if (anAnnotatedItem.IsNull()) return 0; Handle(XCAFDoc_GraphNode) aChild; if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) return 0; Standard_Integer nbFathers = aChild->NbFathers(); for (Standard_Integer iFather = 1; iFather <= nbFathers; ++iFather) { Handle(XCAFDoc_GraphNode) aFather = aChild->GetFather(iFather); theNoteLabels.Append(aFather->Label()); } return theNoteLabels.Length(); } Handle(XCAFDoc_AssemblyItemRef) XCAFDoc_NotesTool::AddNote(const TDF_Label& theNoteLabel, const XCAFDoc_AssemblyItemId& theItemId) { Handle(XCAFDoc_AssemblyItemRef) anItemRef; if (!XCAFDoc_Note::IsMine(theNoteLabel)) return anItemRef; Handle(XCAFDoc_GraphNode) aChild; TDF_Label anAnnotatedItem = FindAnnotatedItem(theItemId); if (anAnnotatedItem.IsNull()) { TDF_TagSource aTag; anAnnotatedItem = aTag.NewChild(GetAnnotatedItemsLabel()); if (anAnnotatedItem.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) { aChild = XCAFDoc_GraphNode::Set(anAnnotatedItem, XCAFDoc::NoteRefGUID()); if (aChild.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc_AssemblyItemRef::GetID(), anItemRef)) { anItemRef = XCAFDoc_AssemblyItemRef::Set(anAnnotatedItem, theItemId); if (anItemRef.IsNull()) return anItemRef; } Handle(XCAFDoc_GraphNode) aFather; if (!theNoteLabel.FindAttribute(XCAFDoc::NoteRefGUID(), aFather)) { aFather = XCAFDoc_GraphNode::Set(theNoteLabel, XCAFDoc::NoteRefGUID()); if (aFather.IsNull()) return anItemRef; } aChild->SetFather(aFather); aFather->SetChild(aChild); return anItemRef; } Handle(XCAFDoc_AssemblyItemRef) XCAFDoc_NotesTool::AddNoteToAttr(const TDF_Label& theNoteLabel, const XCAFDoc_AssemblyItemId& theItemId, const Standard_GUID& theGUID) { Handle(XCAFDoc_AssemblyItemRef) anItemRef; if (!XCAFDoc_Note::IsMine(theNoteLabel)) return anItemRef; Handle(XCAFDoc_GraphNode) aChild; TDF_Label anAnnotatedItem = FindAnnotatedItemGUID(theItemId, theGUID); if (anAnnotatedItem.IsNull()) { TDF_TagSource aTag; anAnnotatedItem = aTag.NewChild(GetAnnotatedItemsLabel()); if (anAnnotatedItem.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) { aChild = XCAFDoc_GraphNode::Set(anAnnotatedItem, XCAFDoc::NoteRefGUID()); if (aChild.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc_AssemblyItemRef::GetID(), anItemRef)) { anItemRef = XCAFDoc_AssemblyItemRef::Set(anAnnotatedItem, theItemId); if (anItemRef.IsNull()) return anItemRef; } Handle(XCAFDoc_GraphNode) aFather; if (!theNoteLabel.FindAttribute(XCAFDoc::NoteRefGUID(), aFather)) { aFather = XCAFDoc_GraphNode::Set(theNoteLabel, XCAFDoc::NoteRefGUID()); if (aFather.IsNull()) return anItemRef; } aChild->SetFather(aFather); aFather->SetChild(aChild); anItemRef->SetGUID(theGUID); return anItemRef; } Handle(XCAFDoc_AssemblyItemRef) XCAFDoc_NotesTool::AddNoteToSubshape(const TDF_Label& theNoteLabel, const XCAFDoc_AssemblyItemId& theItemId, Standard_Integer theSubshapeIndex) { Handle(XCAFDoc_AssemblyItemRef) anItemRef; if (!XCAFDoc_Note::IsMine(theNoteLabel)) return anItemRef; Handle(XCAFDoc_GraphNode) aChild; TDF_Label anAnnotatedItem = FindAnnotatedItemSubshape(theItemId, theSubshapeIndex); if (anAnnotatedItem.IsNull()) { TDF_TagSource aTag; anAnnotatedItem = aTag.NewChild(GetAnnotatedItemsLabel()); if (anAnnotatedItem.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) { aChild = XCAFDoc_GraphNode::Set(anAnnotatedItem, XCAFDoc::NoteRefGUID()); if (aChild.IsNull()) return anItemRef; } if (!anAnnotatedItem.FindAttribute(XCAFDoc_AssemblyItemRef::GetID(), anItemRef)) { anItemRef = XCAFDoc_AssemblyItemRef::Set(anAnnotatedItem, theItemId); if (anItemRef.IsNull()) return anItemRef; } Handle(XCAFDoc_GraphNode) aFather; if (!theNoteLabel.FindAttribute(XCAFDoc::NoteRefGUID(), aFather)) { aFather = XCAFDoc_GraphNode::Set(theNoteLabel, XCAFDoc::NoteRefGUID()); if (aFather.IsNull()) return anItemRef; } aChild->SetFather(aFather); aFather->SetChild(aChild); anItemRef->SetSubshapeIndex(theSubshapeIndex); return anItemRef; } Standard_Boolean XCAFDoc_NotesTool::RemoveNote(const TDF_Label& theNoteLabel, const XCAFDoc_AssemblyItemId& theItemId, Standard_Boolean theDelIfOrphan) { Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(theNoteLabel); if (aNote.IsNull()) return Standard_False; Handle(XCAFDoc_GraphNode) aFather; if (!theNoteLabel.FindAttribute(XCAFDoc::NoteRefGUID(), aFather)) return Standard_False; TDF_Label anAnnotatedItem = FindAnnotatedItem(theItemId); if (anAnnotatedItem.IsNull()) return Standard_False; Handle(XCAFDoc_GraphNode) aChild; if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) return Standard_False; aChild->UnSetFather(aFather); if (aChild->NbFathers() == 0) anAnnotatedItem.ForgetAllAttributes(); if (theDelIfOrphan && aNote->IsOrphan()) DeleteNote(theNoteLabel); return Standard_True; } Standard_Boolean XCAFDoc_NotesTool::RemoveAllNotes(const XCAFDoc_AssemblyItemId& theItemId, Standard_Boolean theDelIfOrphan) { TDF_Label anAnnotatedItem = FindAnnotatedItem(theItemId); if (anAnnotatedItem.IsNull()) return Standard_False; Handle(XCAFDoc_GraphNode) aChild; if (!anAnnotatedItem.FindAttribute(XCAFDoc::NoteRefGUID(), aChild)) return Standard_False; Standard_Integer nbFathers = aChild->NbFathers(); for (Standard_Integer iFather = 1; iFather <= nbFathers; ++iFather) { Handle(XCAFDoc_GraphNode) aFather = aChild->GetFather(iFather); Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(aFather->Label()); if (!aNote.IsNull()) { aFather->UnSetChild(aChild); if (theDelIfOrphan && aNote->IsOrphan()) DeleteNote(aFather->Label()); } } anAnnotatedItem.ForgetAllAttributes(); return Standard_True; } Standard_Boolean XCAFDoc_NotesTool::DeleteNote(const TDF_Label& theNoteLabel) { Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(theNoteLabel); if (!aNote.IsNull()) { Handle(XCAFDoc_GraphNode) aFather; if (theNoteLabel.FindAttribute(XCAFDoc::NoteRefGUID(), aFather) && !aFather.IsNull()) { Standard_Integer nbChildren = aFather->NbChildren(); for (Standard_Integer iChild = 1; iChild <= nbChildren; ++iChild) { Handle(XCAFDoc_GraphNode) aChild = aFather->GetChild(iChild); aFather->UnSetChild(iChild); if (aChild->NbFathers() == 0) aChild->Label().ForgetAttribute(aChild); } } theNoteLabel.ForgetAllAttributes(Standard_True); return Standard_True; } return Standard_False; } Standard_Integer XCAFDoc_NotesTool::DeleteNotes(TDF_LabelSequence& theNoteLabels) { Standard_Integer nbNotes = 0; for (TDF_LabelSequence::Iterator anIter(theNoteLabels); anIter.More(); anIter.Next()) { if (DeleteNote(anIter.Value())) ++nbNotes; } return nbNotes; } Standard_Integer XCAFDoc_NotesTool::DeleteAllNotes() { Standard_Integer nbNotes = 0; for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { if (DeleteNote(anIter.Value())) ++nbNotes; } return nbNotes; } Standard_Integer XCAFDoc_NotesTool::NbOrphanNotes() const { Standard_Integer nbNotes = 0; for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { const TDF_Label aLabel = anIter.Value(); Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(aLabel); if (!aNote.IsNull() && aNote->IsOrphan()) ++nbNotes; } return nbNotes; } void XCAFDoc_NotesTool::GetOrphanNotes(TDF_LabelSequence& theNoteLabels) const { for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { const TDF_Label aLabel = anIter.Value(); Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(aLabel); if (!aNote.IsNull() && aNote->IsOrphan()) theNoteLabels.Append(aLabel); } } Standard_Integer XCAFDoc_NotesTool::DeleteOrphanNotes() { Standard_Integer nbNotes = 0; for (TDF_ChildIterator anIter(GetNotesLabel()); anIter.More(); anIter.Next()) { const TDF_Label aLabel = anIter.Value(); Handle(XCAFDoc_Note) aNote = XCAFDoc_Note::Get(aLabel); if (!aNote.IsNull() && aNote->IsOrphan() && DeleteNote(aLabel)) ++nbNotes; } return nbNotes; } const Standard_GUID& XCAFDoc_NotesTool::ID() const { return GetID(); } Handle(TDF_Attribute) XCAFDoc_NotesTool::NewEmpty() const { return new XCAFDoc_NotesTool(); } void XCAFDoc_NotesTool::Restore(const Handle(TDF_Attribute)& /*theAttr*/) { } void XCAFDoc_NotesTool::Paste(const Handle(TDF_Attribute)& /*theAttrInto*/, const Handle(TDF_RelocationTable)& /*theRT*/) const { } Standard_OStream& XCAFDoc_NotesTool::Dump(Standard_OStream& theOS) const { theOS << "Notes : " << NbNotes() << "\n" << "Annotated items : " << NbAnnotatedItems() << "\n" ; return theOS; }