src/HYDROPy/HYDROData_Document.sip

   1 // Copyright (C) 2007-2013  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.
  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 %ExportedHeaderCode
  24 #include <HYDROData_Document.h>
  25 %End
  26
  27 %ModuleHeaderCode
  28 HYDROData_Object* copyObject( HYDROData_Object* theObject );
  29 Handle(HYDROData_Object) createHandle( HYDROData_Object* theObject );
  30 HYDROData_Object* createPointer( const Handle(HYDROData_Object)& theObject );
  31 %End
  32
  33 enum Data_DocError {
  34   DocError_OK = 0, ///< success
  35   DocError_ResourcesProblem, ///< resources files are invalid or not found
  36   DocError_CanNotOpen, ///< can not open file for reading or writing
  37   DocError_InvalidVersion, ///< version of document is different than expected
  38   DocError_InvalidFormat, ///< format of the document is bad
  39   DocError_UnknownProblem ///< problem has unknown nature
  40 };
  41
  42 class HYDROData_Document
  43 {
  44 %TypeHeaderCode
  45 #include <HYDROData_Document.h>
  46 %End
  47
  48 %ConvertToSubClassCode
  49     if ( !Handle(HYDROData_Document)::DownCast( sipCpp ).IsNull() )
  50       sipClass = sipClass_HYDROData_Document;
  51     else
  52       sipClass = NULL;
  53 %End
  54
  55 %TypeCode
  56
  57   HYDROData_Object* copyObject( HYDROData_Object* theObject )
  58   {
  59     HYDROData_Object* aRes = NULL;
  60     if ( theObject == NULL )
  61       return aRes;
  62
  63     switch( theObject->GetKind() )
  64     {
  65       case KIND_IMAGE:
  66       {
  67         aRes = new HYDROData_Image( *dynamic_cast<HYDROData_Image*>( theObject ) );
  68         break;
  69       }
  70       case KIND_POLYLINE:
  71       {
  72         aRes = new HYDROData_Polyline( *dynamic_cast<HYDROData_Polyline*>( theObject ) );
  73         break;
  74       }
  75       case KIND_BATHYMETRY:
  76       {
  77         aRes = new HYDROData_Bathymetry( *dynamic_cast<HYDROData_Bathymetry*>( theObject ) );
  78         break;
  79       }
  80       case KIND_CALCULATION:
  81       {
  82         aRes = new HYDROData_Calculation( *dynamic_cast<HYDROData_Calculation*>( theObject ) );
  83         break;
  84       }
  85       case KIND_ZONE:
  86       {
  87         aRes = new HYDROData_Zone( *dynamic_cast<HYDROData_Zone*>( theObject ) );
  88         break;
  89       }
  90     }
  91
  92     return aRes;
  93   }
  94
  95   Handle(HYDROData_Object) createHandle( HYDROData_Object* theObject )
  96   {
  97     Handle(HYDROData_Object) aRes = copyObject( theObject );
  98     return aRes;
  99   }
 100
 101   HYDROData_Object* createPointer( const Handle(HYDROData_Object)& theObject )
 102   {
 103     HYDROData_Object* aRes = NULL;
 104
 105     if ( !theObject.IsNull() )
 106       aRes = copyObject( theObject.operator->() );
 107
 108     return aRes;
 109   }
 110
 111 %End
 112
 113 public:
 114
 115   //! Returns the existing document or creates new if it is not exist
 116   static HYDROData_Document Document( const int theStudyID ) [Handle_HYDROData_Document (const int)] ;
 117   %MethodCode
 118
 119     Handle(HYDROData_Document) aDocument;
 120
 121     Py_BEGIN_ALLOW_THREADS
 122     aDocument = HYDROData_Document::Document( a0 );
 123     Py_END_ALLOW_THREADS
 124
 125     if ( !aDocument.IsNull() )
 126       sipRes = aDocument.operator->();
 127
 128   %End
 129
 130   //! Returns true if data model contains document for this study
 131   static bool HasDocument( const int theStudyID );
 132
 133   //! Loads the OCAF document from the file.
 134   //! \param theFileName full name of the file to load
 135   //! \param theStudyID identifier of the SALOME study to associate with loaded file
 136   //! \returns error status (OK in case of success)
 137   static Data_DocError Load( const char* theFileName, const int theStudyID );
 138
 139   //! Saves the OCAF document to the file.
 140   //! \param theFileName full name of the file to store
 141   //! \returns error status (OK in case of success)
 142   Data_DocError Save( const char* theFileName );
 143
 144   //! Removes document data
 145   void Close();
 146
 147   //! Starts a new operation (opens a tansaction)
 148   void StartOperation();
 149
 150   //! Finishes the previously started operation (closes the transaction)
 151   //void CommitOperation(
 152   //  const TCollection_ExtendedString& theName = TCollection_ExtendedString() );
 153
 154   //! Aborts the operation
 155   void AbortOperation();
 156
 157   //! Returns true if operation has been started, but not yet finished or aborted
 158   bool IsOperation();
 159
 160   //! Returns true if document was modified (since creation/opening)
 161   bool IsModified();
 162
 163   //! Returns True if there are available Undos
 164   bool CanUndo();
 165
 166   //! Returns a list of stored undo actions
 167   //const TDF_DeltaList& GetUndos();
 168
 169   //! Clears a list of stored undo actions
 170   void ClearUndos();
 171
 172   //! Undoes last operation
 173   void Undo();
 174
 175   //! Returns True if there are available Redos
 176   bool CanRedo();
 177
 178   //! Returns a list of stored undo actions
 179   //const TDF_DeltaList& GetRedos();
 180
 181   //! Clears a list of stored undo actions
 182   void ClearRedos();
 183
 184   //! Redoes last operation
 185   void Redo();
 186
 187   //! Creates and locates in the document a new object
 188   //! \param theKind kind of the created object, can not be UNKNOWN
 189   //! \returns the created object
 190   HYDROData_Object CreateObject( const ObjectKind theKind ) [Handle_HYDROData_Object (const ObjectKind)] ;
 191   %MethodCode
 192
 193     Handle(HYDROData_Object) anObject;
 194     Py_BEGIN_ALLOW_THREADS
 195     anObject =  sipSelfWasArg ? sipCpp->HYDROData_Document::CreateObject( a0 ) :
 196                                 sipCpp->CreateObject( a0 );
 197     Py_END_ALLOW_THREADS
 198
 199     sipRes = createPointer( anObject );
 200
 201   %End
 202
 203 protected:
 204
 205   //! Creates new document: private because "Document" method must be used instead of direct creation.
 206   HYDROData_Document();
 207
 208   //! Deletes all high-level data, managed this document
 209   ~HYDROData_Document();
 210
 211 };