X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FHYDROData%2FHYDROData_Object.h;h=302f5580e813fe8b45b2712cc2a79fc383f47da0;hb=191c33b8fd827caa9af8886728e9df22ae55451e;hp=04e83ed99649a275f942dacc065f26d9be85a3bb;hpb=5bdd5a07050d0879edb5efdc7e009850a46c64f8;p=modules%2Fhydro.git diff --git a/src/HYDROData/HYDROData_Object.h b/src/HYDROData/HYDROData_Object.h index 04e83ed9..302f5580 100644 --- a/src/HYDROData/HYDROData_Object.h +++ b/src/HYDROData/HYDROData_Object.h @@ -1,47 +1,22 @@ + #ifndef HYDROData_Object_HeaderFile #define HYDROData_Object_HeaderFile -#include - -#include -#include -#include - -class QString; -class QVariant; -class QStringList; -class Handle(TDataStd_ReferenceList); -class Handle_HYDROData_Object; - -///! Kind of an object in a document -typedef int ObjectKind; -///! Unrecognized object -const ObjectKind KIND_UNKNOWN = 0; -const ObjectKind KIND_IMAGE = 1; -const ObjectKind KIND_POLYLINE = 2; -const ObjectKind KIND_VISUAL_STATE = 3; -const ObjectKind KIND_BATHYMETRY = 4; -const ObjectKind KIND_CALCULATION = 5; -const ObjectKind KIND_PROFILE = 6; -const ObjectKind KIND_PROFILES_GROUP = 7; -const ObjectKind KIND_GUIDE_LINE = 8; -const ObjectKind KIND_ZONE = 9; +#include -DEFINE_STANDARD_HANDLE(HYDROData_Object, MMgt_TShared) -typedef QMap MapOfTreatedObjects; - -typedef NCollection_Sequence HYDROData_SequenceOfObjects; +DEFINE_STANDARD_HANDLE(HYDROData_Object, HYDROData_Entity) +class TopoDS_Shape; +class Handle(HYDROData_IAltitudeObject); +class Handle(HYDROData_DummyObject3D); +class Handle(HYDROData_ShapesGroup); /**\class HYDROData_Object - * \brief Generic class of any object in the data model. + * \brief The base class for all geometrical objects in the HYDRO module. * - * Interface for getting access to the object that belong to the data model. - * Managed by Document. Provides access to the common properties: - * kind of an object, name. */ -class HYDROData_Object : public MMgt_TShared +class HYDROData_Object : public HYDROData_Entity { protected: /** @@ -49,80 +24,136 @@ protected: */ enum DataTag { - DataTag_First = 0 ///< first tag, to reserve - // ... + DataTag_First = HYDROData_Entity::DataTag_First + 100, ///< first tag, to reserve + DataTag_TopShape, + DataTag_Shape3D, + DataTag_AltitudeObject, ///< reference altitude object + DataTag_FillingColor, ///< filling color of geometrical object + DataTag_BorderColor, ///< border color of geometrical object + DataTag_Object3D, ///< child 3D object + DataTag_EdgesGroup, ///< child group objects + DataTag_ChildAltitudeObject, ///< child altitude object }; public: DEFINE_STANDARD_RTTI(HYDROData_Object); /** - * Returns the kind of this object. Must be redefined in all objects of known type. + * Updates the name of this object. + * Reimplemented to update the names child groups. */ - HYDRODATA_EXPORT virtual const ObjectKind GetKind() const {return KIND_UNKNOWN;} + HYDRODATA_EXPORT virtual void SetName( const QString& theName ); /** - * Returns the name of this object. + * Update the geometry object. + * Call this method whenever you made changes for object data. */ - HYDRODATA_EXPORT QString GetName() const; + HYDRODATA_EXPORT virtual void Update(); /** - * Updates the name of this object. + * Returns the list of all reference objects of this object. + */ + HYDRODATA_EXPORT virtual HYDROData_SequenceOfObjects GetAllReferenceObjects() const; + + /** + * Sets the "MustBeUpdated" flag: if object is depended on updated features. + * Reimplemented to update the state of child 3D object. + */ + HYDRODATA_EXPORT virtual void SetToUpdate( bool theFlag ); + + + /** + * Sets the top(2d projection) shape of the object. + */ + HYDRODATA_EXPORT virtual void SetTopShape( const TopoDS_Shape& theShape ); + + /** + * Returns the top shape of the object. + */ + HYDRODATA_EXPORT virtual TopoDS_Shape GetTopShape() const = 0; + + /** + * Sets the 3d shape of the object. + */ + HYDRODATA_EXPORT virtual void SetShape3D( const TopoDS_Shape& theShape ); + + /** + * Returns the 3d shape of the object. + */ + HYDRODATA_EXPORT virtual TopoDS_Shape GetShape3D() const = 0; + + + /** + * Returns reference object which represent the 3D shape of object. */ - HYDRODATA_EXPORT void SetName(const QString& theName); + HYDRODATA_EXPORT virtual Handle(HYDROData_DummyObject3D) GetObject3D() const; + /** - * Dump object to Python script representation. - * Base implementation returns empty list, - * You should reimplement this function in your derived class if it - * has Python API and can be imported/exported from/to Python script. + * Returns sequence of object groups. */ - HYDRODATA_EXPORT virtual QStringList DumpToPython( MapOfTreatedObjects& theTreatedObjects ) const; + HYDRODATA_EXPORT virtual HYDROData_SequenceOfObjects GetGroups() const; /** - * Updates object state. - * Base implementation dose nothing. - * \param theIsForce force reupdating of data object + * Returns group data model object by it id. */ - HYDRODATA_EXPORT virtual void Update( const bool theIsForce = true ); + HYDRODATA_EXPORT virtual Handle(HYDROData_ShapesGroup) GetGroup( const int theGroupId ) const; /** - * Returns data of object wrapped to QVariant. - * Base implementation returns null value. + * Returns group id by data model object. */ - HYDRODATA_EXPORT virtual QVariant GetDataVariant(); + HYDRODATA_EXPORT virtual int GetGroupId( const Handle(HYDROData_ShapesGroup)& theGroup ) const; + /** - * Checks is object exists in the data structure. - * \returns true is object is not exists in the data model + * Set reference altitude object for geometry object. */ - HYDRODATA_EXPORT bool IsRemoved() const; + HYDRODATA_EXPORT virtual bool SetAltitudeObject( const Handle(HYDROData_IAltitudeObject)& theAltitude ); /** - * Removes object from the data structure. + * Returns reference altitude object of geometry object. */ - HYDRODATA_EXPORT void Remove(); + HYDRODATA_EXPORT virtual Handle(HYDROData_IAltitudeObject) GetAltitudeObject() const; /** - * Returns unique integer identifier of the object (may be used for ordering of objects) + * Clear the reference altitude object for geometry object. */ - HYDRODATA_EXPORT inline int ID() const {return myLab.Tag();} + HYDRODATA_EXPORT virtual void RemoveAltitudeObject(); + + + /** + * Sets filling color for object. + */ + HYDRODATA_EXPORT virtual void SetFillingColor( const QColor& theColor ); /** - * Copies all properties of this to the destinated object. - * Objects must be the same type. - * \param theDestination initialized object (from any document) - target of copying + * Returns filling color of object. + */ + HYDRODATA_EXPORT virtual QColor GetFillingColor() const; + + /** + * Sets border color for object. */ - HYDRODATA_EXPORT void CopyTo(Handle_HYDROData_Object theDestination) const; + HYDRODATA_EXPORT virtual void SetBorderColor( const QColor& theColor ); /** - * Returns the label of this object. + * Returns border color of object. */ - HYDRODATA_EXPORT TDF_Label& Label() {return myLab;} + HYDRODATA_EXPORT virtual QColor GetBorderColor() const; protected: - friend class HYDROData_Iterator; + /** + * Returns default filling color for new object. + */ + HYDRODATA_EXPORT virtual QColor getDefaultFillingColor() const; + + /** + * Returns default border color for new object. + */ + HYDRODATA_EXPORT virtual QColor getDefaultBorderColor() const; + +protected: /** * Creates new object in the internal data structure. Use higher level objects @@ -135,94 +166,74 @@ protected: */ virtual HYDRODATA_EXPORT ~HYDROData_Object(); +protected: + /** - * Put the object to the label of the document. - * \param theLabel new label of the object + * Dump the initial object creation to a Python script. + * Reimplemented to dump the object colors. */ - HYDRODATA_EXPORT virtual void SetLabel(TDF_Label theLabel); + HYDRODATA_EXPORT virtual QStringList dumpObjectCreation( MapOfTreatedObjects& theTreatedObjects ) const; + /** - * Internal method that used to store the byte array attribute - * \param theTag tag of a label to store attribute (for 0 this is myLab) - * \param theData pointer to bytes array - * \param theLen number of bytes in byte array that must be stored + * Checks and if necessary create child 3D object. + * Reimplement this function in your subclass if you + * do not want to create child 3D object. */ - void SaveByteArray(const int theTag, const char* theData, const int theLen); + HYDRODATA_EXPORT virtual void checkAndSetObject3D(); + /** - * Internal method that used to retreive the content of byte array attribute - * \param theTag tag of a label that keeps the attribute (for 0 this is myLab) - * \param theLen number of bytes in byte array - * \returns pointer to the internal data structure wit harray content, - * or NULL if array size is zero + * Returns the type of child altitude object. + * Base implementation returns KIND_UNKNOWN, it means that child altitude + * object will not be created inside of checkAndSetAltitudeObject() function. + * Reimplement this function in your subclass an return correct altitude + * object type if you want to create child altitude object. */ - const char* ByteArray(const int theTag, int& theLen) const; + HYDRODATA_EXPORT virtual ObjectKind getAltitudeObjectType() const; /** - * Internal method that used to store the reference object label attribute - * \param theObj pointer to reference object - * \param theTag tag of a label to store attribute (for 0 this is myLab) + * Checks and if necessary create child altitude object. */ - int NbReferenceObjects( const int theTag = 0 ) const; + HYDRODATA_EXPORT virtual void checkAndSetAltitudeObject(); /** - * Internal method that used to store the reference object label attribute - * \param theObj pointer to reference object - * \param theTag tag of a label to store attribute (for 0 this is myLab) + * Return the child altitude object. */ - void AddReferenceObject( const Handle_HYDROData_Object& theObj, - const int theTag = 0 ); + HYDRODATA_EXPORT virtual Handle(HYDROData_IAltitudeObject) getChildAltitudeObject() const; + /** - * Internal method that used to store the reference object label attribute - * \param theObj pointer to reference object - * \param theTag tag of a label to store attribute (for 0 this is myLab) - * \param theIndex index in the list of references - - if more that len then just append it to the end of list - - if less than zero then prepend to the list - - indexing starts from 0 + * Create new one child group object. */ - void SetReferenceObject( const Handle_HYDROData_Object& theObj, - const int theTag = 0, - const int theIndex = 0 ); + HYDRODATA_EXPORT virtual Handle(HYDROData_ShapesGroup) createGroupObject(); /** - * Internal method that used to retreive the reference object(s) attribute - * \param theTag tag of a label that keeps the attribute (for 0 this is myLab) - * \param theIndex index in the list of references - * - indexing starts from 0 - * \returns pointer to reference object or NULL if label is not set + * Remove all child group objects. */ - Handle_HYDROData_Object GetReferenceObject( const int theTag = 0, - const int theIndex = 0 ) const; + HYDRODATA_EXPORT virtual void removeGroupObjects(); - HYDROData_SequenceOfObjects GetReferenceObjects( const int theTag = 0 ) const; /** - * Internal method that used to remove the reference object attribute - * \param theTag tag of a label that keeps the attribute (for 0 this is myLab) - * \param theIndex index in the list of references - * - indexing starts from 0 + * Retrieve the top shape of the object from data label. */ - void RemoveReferenceObject( const int theTag = 0, const int theIndex = 0 ); + HYDRODATA_EXPORT TopoDS_Shape getTopShape() const; /** - * Internal method that used to clear list of the reference objects attribute - * \param theTag tag of a label that keeps the attribute (for 0 this is myLab) + * Removes the top shape from data label of the object. */ - void ClearReferenceObjects( const int theTag = 0 ); + HYDRODATA_EXPORT void removeTopShape(); -protected: - Handle(TDataStd_ReferenceList) getReferenceList( const int theTag, - const bool theIsCreate ) const; + /** + * Retrieve the 3d shape of the object from data label. + */ + HYDRODATA_EXPORT TopoDS_Shape getShape3D() const; -protected: - /// Array of pointers to the properties of this object; index in this array is returned by \a AddProperty. - TDF_Label myLab; ///< label of this object + /** + * Removes the 3d shape from data label of the object. + */ + HYDRODATA_EXPORT void removeShape3D(); }; -///! Is Equal for HYDROData_Object mapping -HYDRODATA_EXPORT bool IsEqual(const Handle_HYDROData_Object& theObj1, const Handle_HYDROData_Object& theObj2); - #endif