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     }
  81
  82     return aRes;
  83   }
  84
  85   Handle(HYDROData_Object) createHandle( HYDROData_Object* theObject )
  86   {
  87     Handle(HYDROData_Object) aRes = copyObject( theObject );
  88     return aRes;
  89   }
  90
  91   HYDROData_Object* createPointer( const Handle(HYDROData_Object)& theObject )
  92   {
  93     HYDROData_Object* aRes = NULL;
  94
  95     if ( !theObject.IsNull() )
  96       aRes = copyObject( theObject.operator->() );
  97
  98     return aRes;
  99   }
 100
 101 %End
 102
 103 public:
 104
 105   //! Returns the existing document or creates new if it is not exist
 106   static HYDROData_Document Document( const int theStudyID ) [Handle_HYDROData_Document (const int)] ;
 107   %MethodCode
 108
 109     Handle(HYDROData_Document) aDocument;
 110
 111     Py_BEGIN_ALLOW_THREADS
 112     aDocument = HYDROData_Document::Document( a0 );
 113     Py_END_ALLOW_THREADS
 114
 115     if ( !aDocument.IsNull() )
 116       sipRes = aDocument.operator->();
 117
 118   %End
 119
 120   //! Returns true if data model contains document for this study
 121   static bool HasDocument( const int theStudyID );
 122
 123   //! Loads the OCAF document from the file.
 124   //! \param theFileName full name of the file to load
 125   //! \param theStudyID identifier of the SALOME study to associate with loaded file
 126   //! \returns error status (OK in case of success)
 127   static Data_DocError Load( const char* theFileName, const int theStudyID );
 128
 129   //! Saves the OCAF document to the file.
 130   //! \param theFileName full name of the file to store
 131   //! \returns error status (OK in case of success)
 132   Data_DocError Save( const char* theFileName );
 133
 134   //! Removes document data
 135   void Close();
 136
 137   //! Starts a new operation (opens a tansaction)
 138   void StartOperation();
 139
 140   //! Finishes the previously started operation (closes the transaction)
 141   //void CommitOperation(
 142   //  const TCollection_ExtendedString& theName = TCollection_ExtendedString() );
 143
 144   //! Aborts the operation
 145   void AbortOperation();
 146
 147   //! Returns true if operation has been started, but not yet finished or aborted
 148   bool IsOperation();
 149
 150   //! Returns true if document was modified (since creation/opening)
 151   bool IsModified();
 152
 153   //! Returns True if there are available Undos
 154   bool CanUndo();
 155
 156   //! Returns a list of stored undo actions
 157   //const TDF_DeltaList& GetUndos();
 158
 159   //! Clears a list of stored undo actions
 160   void ClearUndos();
 161
 162   //! Undoes last operation
 163   void Undo();
 164
 165   //! Returns True if there are available Redos
 166   bool CanRedo();
 167
 168   //! Returns a list of stored undo actions
 169   //const TDF_DeltaList& GetRedos();
 170
 171   //! Clears a list of stored undo actions
 172   void ClearRedos();
 173
 174   //! Redoes last operation
 175   void Redo();
 176
 177   //! Creates and locates in the document a new object
 178   //! \param theKind kind of the created object, can not be UNKNOWN
 179   //! \returns the created object
 180   HYDROData_Object CreateObject( const ObjectKind theKind ) [Handle_HYDROData_Object (const ObjectKind)] ;
 181   %MethodCode
 182
 183     Handle(HYDROData_Object) anObject;
 184     Py_BEGIN_ALLOW_THREADS
 185     anObject =  sipSelfWasArg ? sipCpp->HYDROData_Document::CreateObject( a0 ) :
 186                                 sipCpp->CreateObject( a0 );
 187     Py_END_ALLOW_THREADS
 188
 189     sipRes = createPointer( anObject );
 190
 191   %End
 192
 193 protected:
 194
 195   //! Creates new document: private because "Document" method must be used instead of direct creation.
 196   HYDROData_Document();
 197
 198   //! Deletes all high-level data, managed this document
 199   ~HYDROData_Document();
 200
 201 };