src/GEOM/GEOM_Engine.hxx

   1 // Copyright (C) 2007-2014  CEA/DEN, EDF R&D, OPEN CASCADE
   2 //
   3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
   4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
   5 //
   6 // This library is free software; you can redistribute it and/or
   7 // modify it under the terms of the GNU Lesser General Public
   8 // License as published by the Free Software Foundation; either
   9 // version 2.1 of the License, or (at your option) any later version.
  10 //
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 // Lesser General Public License for more details.
  15 //
  16 // You should have received a copy of the GNU Lesser General Public
  17 // License along with this library; if not, write to the Free Software
  18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19 //
  20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  21 //
  22
  23 #ifndef _GEOM_Engine_HXX_
  24 #define _GEOM_Engine_HXX_
  25
  26 #include "GEOM_Application.hxx"
  27 #include "GEOM_Object.hxx"
  28 #include "GEOM_DataMapOfAsciiStringTransient.hxx"
  29
  30 #include <Basics_OCCTVersion.hxx>
  31
  32 #if OCC_VERSION_LARGE > 0x06040000 // Porting to OCCT6.5.1
  33 #include <TColStd_DataMapOfIntegerTransient.hxx>
  34 #else
  35 #include <Interface_DataMapOfIntegerTransient.hxx>
  36 #endif
  37
  38 #include <Resource_DataMapOfAsciiStringAsciiString.hxx>
  39 #include <TDocStd_Document.hxx>
  40 #include <TColStd_HArray1OfInteger.hxx>
  41 #include <TColStd_HSequenceOfAsciiString.hxx>
  42 #include <TColStd_MapOfInteger.hxx>
  43 #include <TDF_Label.hxx>
  44
  45 #include <map>
  46 #include <list>
  47 #include <vector>
  48 #include <string>
  49
  50 /*!
  51  * \brief Data of GEOM_Object
  52  */
  53 struct TObjectData
  54 {
  55   TCollection_AsciiString _entry;
  56   TCollection_AsciiString _studyEntry;
  57   TCollection_AsciiString _name;
  58   TCollection_AsciiString _pyName;
  59   bool                    _unpublished;
  60 };
  61
  62 #if OCC_VERSION_LARGE > 0x06040000 // Porting to OCCT6.5.1
  63 class Handle_TColStd_HArray1OfByte;
  64 #else
  65 class Handle_TDataStd_HArray1OfByte;
  66 #endif
  67
  68 struct TVariable{
  69   TCollection_AsciiString myVariable;
  70   bool isVariable;
  71
  72   TVariable(const TCollection_AsciiString& theVariable, bool theFlag = true):
  73     myVariable(theVariable),
  74     isVariable(theFlag){}
  75 };
  76
  77 typedef std::vector<TVariable> TState;
  78 typedef std::vector<TState>    TAllStates;
  79
  80 class ObjectStates
  81 {
  82 public:
  83   Standard_EXPORT ObjectStates();
  84   ~ObjectStates();
  85
  86   TAllStates GetAllStates() const { return _states; }
  87
  88   TState GetCurrectState() const;
  89   Standard_EXPORT void AddState(const TState &theState);
  90   void IncrementState();
  91
  92 private:
  93   TAllStates              _states;
  94   int                     _dumpstate;
  95 };
  96
  97 typedef std::map<TCollection_AsciiString, ObjectStates* > TVariablesList;
  98
  99 typedef std::map<int, std::list<TDF_Label> > TFreeLabelsList;
 100
 101 class GEOM_Engine
 102 {
 103  public:
 104   Standard_EXPORT GEOM_Engine();
 105   Standard_EXPORT virtual ~GEOM_Engine();
 106
 107   //Retuns the engine
 108   Standard_EXPORT static GEOM_Engine* GetEngine();
 109
 110   //Returns the OCAF document by its ID, if document doesn't exists it will be created
 111   Standard_EXPORT Handle(TDocStd_Document) GetDocument(int theDocID, bool force=true);
 112
 113   //Returns the ID of the given OCAF document
 114   Standard_EXPORT int GetDocID(Handle(TDocStd_Document) theDocument);
 115
 116   //Returns the OCAF appliaction
 117   Standard_EXPORT Handle(TDocStd_Application) GetApplication() { return _OCAFApp; }
 118
 119   //Returns a pointer to GEOM_BaseObject defined by a document and the entry
 120   Standard_EXPORT Handle(GEOM_BaseObject) GetObject(int         theDocID,
 121                                                     const char* theEntry,
 122                                                     bool        force=true);
 123
 124   //Adds a new object of the type theType in the OCAF document
 125   Standard_EXPORT Handle(GEOM_BaseObject) AddBaseObject(int theDocID, int theType);
 126
 127   //Adds a new object of the type theType in the OCAF document
 128   Standard_EXPORT Handle(GEOM_Object) AddObject(int theDocID, int theType);
 129
 130   //Removes the object from the OCAF document
 131   Standard_EXPORT bool RemoveObject(Handle(GEOM_BaseObject)& theObject);
 132
 133   //Saves the OCAF document with ID = theDocID with file with name theFileName
 134   Standard_EXPORT bool Save(int theDocID, const char* theFileName);
 135
 136   //Loads the OCAF document into the application and assigns to it an ID = theDocID
 137   Standard_EXPORT bool Load(int theDocID, const char* theFileName);
 138
 139   //Closes the document with ID =  theDocID
 140   Standard_EXPORT void Close(int theDocID);
 141
 142   //Sets the number of Undos (default value = 10)
 143   Standard_EXPORT void SetUndoLimit(int theLimit) { _UndoLimit = theLimit; }
 144
 145   //Applies an Undo to document with ID = theDocID
 146   Standard_EXPORT void Undo(int theDocID);
 147
 148   //Applies an Redo to document with ID = theDocID
 149   Standard_EXPORT void Redo(int theDocID);
 150
 151   //Adds a new sub-shape object of the MainShape object
 152   Standard_EXPORT Handle(GEOM_Object) AddSubShape(Handle(GEOM_Object) theMainShape,
 153                                                   Handle(TColStd_HArray1OfInteger) theIndices,
 154                                                   bool isStandaloneOperation = false);
 155
 156   Standard_EXPORT TCollection_AsciiString DumpPython(int theDocID,
 157                                                      std::vector<TObjectData>& theObjectData,
 158                                                      TVariablesList theVariables,
 159                                                      bool isPublished,
 160                                                      bool isMultiFile,
 161                                                      bool& aValidScript);
 162
 163   Standard_EXPORT const char* GetDumpName (const char* theStudyEntry) const;
 164
 165   Standard_EXPORT Handle(TColStd_HSequenceOfAsciiString) GetAllDumpNames() const;
 166
 167   Standard_EXPORT int addTexture(int theDocID, int theWidth, int theHeight,
 168                                  const Handle(TColStd_HArray1OfByte)& theTexture,
 169                                  const TCollection_AsciiString& theFileName = "");
 170
 171   Standard_EXPORT Handle(TColStd_HArray1OfByte) getTexture(int  theDocID, int theTextureID,
 172                                                            int& theWidth, int& theHeight,
 173                                                            TCollection_AsciiString& theFileName);
 174
 175   Standard_EXPORT std::list<int> getAllTextures(int theDocID);
 176
 177   static const Standard_GUID& GetTextureGUID();
 178
 179   Standard_EXPORT void healPyName( TCollection_AsciiString&                  pyName,
 180                                    const TCollection_AsciiString&            anEntry,
 181                                    Resource_DataMapOfAsciiStringAsciiString& aNameToEntry);
 182
 183   Standard_EXPORT void DocumentModified(const int theDocId, const bool isModified);
 184
 185   Standard_EXPORT bool DocumentModified(const int theDocId);
 186
 187  protected:
 188   Standard_EXPORT static void SetEngine(GEOM_Engine* theEngine);
 189
 190  private:
 191
 192   Handle(GEOM_Application)  _OCAFApp;
 193   TColStd_DataMapOfIntegerTransient _mapIDDocument;
 194   TColStd_MapOfInteger _mapModifiedDocs; // keeps the identifiers of the modified document ids
 195
 196   int _UndoLimit;
 197   GEOM_DataMapOfAsciiStringTransient _objects;
 198
 199   Resource_DataMapOfAsciiStringAsciiString _studyEntry2NameMap;
 200
 201   TFreeLabelsList                          _freeLabels;
 202 };
 203
 204 #endif