X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FModel%2FModel_Document.h;h=db04509ba5e941d98f11140deda59744ad2577f8;hb=07bc7fd1c59cbe7a2d916654edf77409670f215b;hp=ce16a5de7b9874df9af7fe58d63758d26d2add71;hpb=8e193b0425317ba19a21a752accaaf59909f52b2;p=modules%2Fshaper.git diff --git a/src/Model/Model_Document.h b/src/Model/Model_Document.h index ce16a5de7..db04509ba 100644 --- a/src/Model/Model_Document.h +++ b/src/Model/Model_Document.h @@ -1,28 +1,42 @@ +// Copyright (C) 2014-20xx CEA/DEN, EDF R&D + // File: Model_Document.h // Created: 28 Feb 2014 // Author: Mikhail PONIKAROV -#ifndef Model_Document_HeaderFile -#define Model_Document_HeaderFile +#ifndef Model_Document_H_ +#define Model_Document_H_ #include #include +#include +#include #include +#include +#include #include #include class Handle_Model_Document; +// for TDF_Label map usage +static Standard_Integer HashCode(const TDF_Label& theLab, const Standard_Integer theUpper); +static Standard_Boolean IsEqual(const TDF_Label& theLab1, const TDF_Label& theLab2); + /**\class Model_Document * \ingroup DataModel * \brief Document for internal data structure of any object storage. * Document contains all data that must be stored/retrived in the file. * Also it provides acces to this data: open/save, transactions management etc. */ -class Model_Document: public ModelAPI_Document +class Model_Document : public ModelAPI_Document { -public: + public: + //! Returns the kind of the document: "PartSet", "Part", or something else. + //! This kind is used for feature buttons enable/disable depending on active document + //! (it uses workbench "document" identifier in XML configuration file for this) + MODEL_EXPORT virtual const std::string& kind() const {return myKind;} //! Loads the OCAF document from the file. //! \param theFileName full name of the file to load @@ -32,11 +46,13 @@ public: //! Saves the OCAF document to the file. //! \param theFileName full name of the file to store + //! \param theResults the result full file names that were stored by "save" //! \returns true if file was stored successfully - MODEL_EXPORT virtual bool save(const char* theFileName); + MODEL_EXPORT virtual bool save(const char* theFileName, std::list& theResults); //! Removes document data - MODEL_EXPORT virtual void close(); + //! \param theForever if it is false, document is just hiden (to keep possibility make it back on Undo/Redo) + MODEL_EXPORT virtual void close(const bool theForever = false); //! Starts a new operation (opens a tansaction) MODEL_EXPORT virtual void startOperation(); @@ -61,66 +77,136 @@ public: //! Adds to the document the new feature of the given feature id //! \param creates feature and puts it in the document - MODEL_EXPORT virtual boost::shared_ptr addFeature(std::string theID); + MODEL_EXPORT virtual FeaturePtr addFeature(std::string theID); + + //! Removes the feature from the document (with result) + //! \param theCheck if it is false, do not check the references + MODEL_EXPORT virtual void removeFeature(FeaturePtr theFeature, const bool theCheck = true); //! Returns the existing feature by the label //! \param theLabel base label of the feature - MODEL_EXPORT virtual boost::shared_ptr feature(TDF_Label& theLabel); + MODEL_EXPORT virtual FeaturePtr feature(TDF_Label& theLabel); + + //! Returns the existing object: result or feature + //! \param theLabel base label of the object + MODEL_EXPORT virtual ObjectPtr object(TDF_Label theLabel); //! Adds a new sub-document by the identifier, or returns existing one if it is already exist - MODEL_EXPORT virtual boost::shared_ptr subDocument(std::string theDocID); + MODEL_EXPORT virtual std::shared_ptr subDocument(std::string theDocID); + + //! Internal sub-document by ID + MODEL_EXPORT virtual std::shared_ptr subDoc(std::string theDocID); ///! Returns the id of hte document - MODEL_EXPORT virtual const std::string& id() const {return myID;} + MODEL_EXPORT virtual const std::string& id() const + { + return myID; + } //! Returns the feature in the group by the index (started from zero) //! \param theGroupID group that contains a feature //! \param theIndex zero-based index of feature in the group //! \param isOperation if it is true, returns feature (not Object) - MODEL_EXPORT virtual boost::shared_ptr - feature(const std::string& theGroupID, const int theIndex, const bool isOperation = false); + //! \param theHidden if it is true, it counts also the features that are not in tree + MODEL_EXPORT virtual ObjectPtr object(const std::string& theGroupID, const int theIndex, + const bool theHidden = false); //! Returns the number of features in the group - MODEL_EXPORT virtual int size(const std::string& theGroupID); - -protected: - - //! Returns (creates if needed) the group label - TDF_Label groupLabel(const std::string theGroup); + //! If theHidden is true, it counts also the features that are not in tree + MODEL_EXPORT virtual int size(const std::string& theGroupID, const bool theHidden = false); + + /// Creates a construction cresults + MODEL_EXPORT virtual std::shared_ptr createConstruction( + const std::shared_ptr& theFeatureData, const int theIndex = 0); + /// Creates a body results + MODEL_EXPORT virtual std::shared_ptr createBody( + const std::shared_ptr& theFeatureData, const int theIndex = 0); + /// Creates a part results + MODEL_EXPORT virtual std::shared_ptr createPart( + const std::shared_ptr& theFeatureData, const int theIndex = 0); + /// Creates a group results + MODEL_EXPORT virtual std::shared_ptr createGroup( + const std::shared_ptr& theFeatureData, const int theIndex = 0); + + //! Returns a feature by result (owner of result) + MODEL_EXPORT virtual std::shared_ptr + feature(const std::shared_ptr& theResult); + + ///! Returns true if parametric updater need to execute feature on recomputartion + ///! On abort, undo or redo it is not necessary: results in document are updated automatically + bool executeFeatures() {return myExecuteFeatures;} + + protected: + + //! Returns (creates if needed) the features label + TDF_Label featuresLabel(); //! Initializes feature with a unique name in this group (unique name is generated as //! feature type + "_" + index - void setUniqueName(boost::shared_ptr theFeature); - - //! Adds to the document the new feature - void addFeature(const boost::shared_ptr theFeature); - - //! Returns the object by the feature - boost::shared_ptr objectByFeature( - const boost::shared_ptr theFeature); + void setUniqueName(FeaturePtr theFeature); //! Synchronizes myFeatures list with the updated document - void synchronizeFeatures(); + //! \param theMarkUpdated causes the "update" event for all features + //! \param theUpdateReferences causes the update of back-references + void synchronizeFeatures(const bool theMarkUpdated, const bool theUpdateReferences); + //! Synchronizes the BackReferences list in Data of Features and Results + void synchronizeBackRefs(); //! Creates new document with binary file format - Model_Document(const std::string theID); + Model_Document(const std::string theID, const std::string theKind); - friend class Model_Application; + Handle_TDocStd_Document document() + { + return myDoc; + } + + //! performs compactification of all nested operations into one + //! \returns true if resulting transaction is not empty and can be undoed + bool compactNested(); + + //! Initializes the data fields of the feature + void initData(ObjectPtr theObj, TDF_Label theLab, const int theTag); + + //! Allows to store the result in the data tree of the document (attaches 'data' of result to tree) + MODEL_EXPORT virtual void storeResult(std::shared_ptr theFeatureData, + std::shared_ptr theResult, + const int theResultIndex = 0); -private: - std::string myID; ///< identifier of the document in the application - Handle_TDocStd_Document myDoc; ///< OCAF document - /// number of transactions after the last "save" call, used for "IsModified" method - int myTransactionsAfterSave; - /// number of myTransactionsAfterSave for the nested transaction start - int myNestedStart; + //! returns the label of result by index; creates this label if it was not created before + TDF_Label resultLabel(const std::shared_ptr& theFeatureData, const int theResultIndex); + + //! Updates the results list of the feature basing on the current data tree + void updateResults(FeaturePtr theFeature); + + //! Returns all sub documents + const std::set& subDocuments() const {return mySubs;} + + friend class Model_Application; + friend class Model_Session; + friend class Model_Update; + friend class Model_AttributeReference; + friend class DFBrowser; + + private: + std::string myID; ///< identifier of the document in the application + std::string myKind; ///< kind of the document in the application + Handle_TDocStd_Document myDoc; ///< OCAF document + /// counter of transactions + int myTransactionsCounter; + /// counter value of transaction on the last "save" call, used for "IsModified" method + int myTransactionSave; + /// number of nested transactions performed (or -1 if not nested) + int myNestedNum; /// All features managed by this document (not only in history of OB) - std::vector > myFeatures; + /// For optimization mapped by labels + NCollection_DataMap myObjs; ///< set of identifiers of sub-documents of this document std::set mySubs; /// transaction indexes (related to myTransactionsAfterSave) which were empty in this doc std::map myIsEmptyTr; + /// If it is true, features are not executed on update (on abort, undo, redo) + bool myExecuteFeatures; }; #endif