X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FHYDROData%2FHYDROData_Image.h;h=5a25af9ee633a20ce5e2f760476b7bd1aa2aa770;hb=a95289fabbb6fbf6f32c06207422c65aafd5bd65;hp=b9db13c6bde1ea88c4ecff3cdca7305ac19896a1;hpb=9723b0802834ab7ee2b9ac3e18e76e46a27c8dca;p=modules%2Fhydro.git diff --git a/src/HYDROData/HYDROData_Image.h b/src/HYDROData/HYDROData_Image.h index b9db13c6..5a25af9e 100644 --- a/src/HYDROData/HYDROData_Image.h +++ b/src/HYDROData/HYDROData_Image.h @@ -1,12 +1,38 @@ +// Copyright (C) 2014-2015 EDF-R&D +// This library is free software; you can redistribute it and/or +// modify it under the terms of the GNU Lesser General Public +// License as published by the Free Software Foundation; either +// version 2.1 of the License, or (at your option) any later version. +// +// This library is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +// Lesser General Public License for more details. +// +// You should have received a copy of the GNU Lesser General Public +// License along with this library; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +// +// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com +// + #ifndef HYDROData_Image_HeaderFile #define HYDROData_Image_HeaderFile -#include +#include + +#ifdef WIN32 + #pragma warning ( disable: 4251 ) +#endif #include #include -DEFINE_STANDARD_HANDLE(HYDROData_Image, HYDROData_Object) +#ifdef WIN32 + #pragma warning ( default: 4251 ) +#endif + +DEFINE_STANDARD_HANDLE(HYDROData_Image, HYDROData_Entity) /**\class HYDROData_Image * \brief Class that stores/retreives information about the image. @@ -14,18 +40,31 @@ DEFINE_STANDARD_HANDLE(HYDROData_Image, HYDROData_Object) * Keeps image as binary array, transformation and other properties * of image with correspondent API for forkind wit hthese properties. */ -class HYDROData_Image : public HYDROData_Object +class HYDROData_Image : public HYDROData_Entity { + +public: + + enum TransformationMode + { + ManualGeodesic = 0, + ManualCartesian, + CartesianFromFile, + ReferenceImage + }; + protected: /** * Enumeration of tags corresponding to the persistent object parameters. */ enum DataTag { - DataTag_First = HYDROData_Object::DataTag_First + 100, ///< first tag, to reserve - DataTag_Operator, ///< name of the operator that must be executed for image update - DataTag_TrsfPoints, ///< image transformation points (3 input + 3 output) - DataTag_FilePath ///< image imported file path + DataTag_First = HYDROData_Entity::DataTag_First + 100, ///< first tag, to reserve + DataTag_Operator, ///< name of the operator that must be executed for image update + DataTag_TrsfMode, ///< transformation mode (0 - Lambert93, 1 - Cartesian, 2 - on other Image) + DataTag_TrsfPoints, ///< image transformation points + DataTag_TrsfImage, ///< reference transformation image + DataTag_FilePath ///< image imported file path }; public: @@ -39,7 +78,34 @@ public: /** * Dump Image object to Python script representation. */ - HYDRODATA_EXPORT virtual QStringList DumpToPython( MapOfTreatedObjects& theTreatedObjects ) const; + HYDRODATA_EXPORT virtual QStringList DumpToPython( const QString& thePyScriptPath, + MapOfTreatedObjects& theTreatedObjects ) const; + + /** + * Updates object state. + * Reimplemented to update an Image object in the data structure. + * Call this method whenever you made changes for operator or reference objects. + * If it is changed, sets "MustBeUpdated" flag to other depended images. + */ + HYDRODATA_EXPORT virtual void Update(); + + /** + * Checks that object has 2D presentation. Reimlemented to retun true. + */ + HYDRODATA_EXPORT virtual bool IsHas2dPrs() const; + + /** + * Returns data of object wrapped to QVariant. + * Reimplemented to wrap and return saved image. + * Transformation are applied to result image. + */ + HYDRODATA_EXPORT virtual QVariant GetDataVariant(); + + /** + * Returns the list of all reference objects of this object. + */ + HYDRODATA_EXPORT virtual HYDROData_SequenceOfObjects GetAllReferenceObjects() const; + /** * Stores the image @@ -81,64 +147,183 @@ public: HYDRODATA_EXPORT QTransform Trsf() const; /** - * Stores the image transformation points (3 input + 3 output) - * \param thePointAIn input point A - * \param thePointBIn input point B - * \param thePointCIn input point C - * \param thePointAOut output point A - * \param thePointBOut output point B - * \param thePointCOut output point C + * Updates the matrix of transformation in accordance with reference points. + * \param theTrsf new transformation + */ + HYDRODATA_EXPORT void UpdateTrsf(); + + + /** + * Returns true if transformation is done by two points only + */ + HYDRODATA_EXPORT bool IsByTwoPoints() const; + + + /** + * Removes all references from this image. + */ + HYDRODATA_EXPORT bool HasReferences() const; + + /** + * Removes all references from this image. + */ + HYDRODATA_EXPORT void RemoveAllReferences(); + + + /** + * Stores the transformation points in local cs of image + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + */ + HYDRODATA_EXPORT void SetLocalPoints( const QPoint& thePointA, + const QPoint& thePointB, + const QPoint& thePointC = QPoint( INT_MIN, INT_MIN ), + const bool theIsUpdate = true ); + + /** + * Returns the transformation points in local cs of image + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + * \return true if all parameters has been set before + */ + HYDRODATA_EXPORT bool GetLocalPoints( QPoint& thePointA, + QPoint& thePointB, + QPoint& thePointC ) const; + + /** + * Returns true if local points has been set before + */ + HYDRODATA_EXPORT bool HasLocalPoints() const; + + + /** + * Stores the transformation points in global cs + * \param theMode transformation mode + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + */ + HYDRODATA_EXPORT void SetGlobalPoints( const TransformationMode& theMode, + const QPointF& thePointA, + const QPointF& thePointB, + const QPointF& thePointC = QPoint( INT_MIN, INT_MIN ), + const bool theIsUpdate = true ); + + /** + * Returns the transformation points in global cs + * \param theMode transformation mode + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + * \return true if all parameters has been set before + */ + HYDRODATA_EXPORT bool GetGlobalPoints( TransformationMode& theMode, + QPointF& thePointA, + QPointF& thePointB, + QPointF& thePointC ) const; + + /** + * Get transformation points from the file and stores them in global cs + * \param theFileName the image georeferencement file name + * \return true in case of success + */ + HYDRODATA_EXPORT bool SetGlobalPointsFromFile( const QString& theFileName ); + + /** + * Returns true if global points has been set before + */ + HYDRODATA_EXPORT bool HasGlobalPoints() const; + + + /** + * Stores the transformation points in reference image local cs + * \param theRefImage reference image + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + */ + HYDRODATA_EXPORT void SetReferencePoints( const Handle(HYDROData_Image)& theRefImage, + const QPointF& thePointA, + const QPointF& thePointB, + const QPointF& thePointC = QPoint( INT_MIN, INT_MIN ), + const bool theIsUpdate = true ); + + /** + * Returns the transformation points in reference image local cs + * \param theRefImage reference image + * \param thePointA point A + * \param thePointB point B + * \param thePointC point C + * \return true if all parameters has been set correctly */ - HYDRODATA_EXPORT void SetTrsfPoints(const QPoint& thePointAIn, - const QPoint& thePointBIn, - const QPoint& thePointCIn, - const QPointF& thePointAOut, - const QPointF& thePointBOut, - const QPointF& thePointCOut); + HYDRODATA_EXPORT bool GetReferencePoints( Handle(HYDROData_Image)& theRefImage, + QPointF& thePointA, + QPointF& thePointB, + QPointF& thePointC ) const; /** - * Returns the image transformation points (3 input + 3 output) - * \param thePointAIn input point A - * \param thePointBIn input point B - * \param thePointCIn input point C - * \param thePointAOut output point A - * \param thePointBOut output point B - * \param thePointCOut output point C + * Returns true if reference points has been set before */ - HYDRODATA_EXPORT void TrsfPoints(QPoint& thePointAIn, - QPoint& thePointBIn, - QPoint& thePointCIn, - QPointF& thePointAOut, - QPointF& thePointBOut, - QPointF& thePointCOut) const; + HYDRODATA_EXPORT bool HasReferencePoints() const; + + + /** + * Stores the reference image for transformation + * \param theRefImage reference image + */ + HYDRODATA_EXPORT void SetTrsfReferenceImage( const Handle(HYDROData_Image)& theRefImage ); + + /** + * Returns the reference image for transformation + */ + HYDRODATA_EXPORT Handle(HYDROData_Image) GetTrsfReferenceImage() const; + + /** + * Removes the reference image for transformation + */ + HYDRODATA_EXPORT void RemoveTrsfReferenceImage(); + /** - * Appends reference to other image. - * \param theReferenced the image referenced by this + * Stores the transformation mode */ - HYDRODATA_EXPORT void AppendReference(Handle(HYDROData_Image) theReferenced); + HYDRODATA_EXPORT void SetTrsfMode( const TransformationMode& theMode ); /** - * Returns the number of referenced images + * Returns the transformation mode + */ + HYDRODATA_EXPORT TransformationMode GetTrsfMode() const; + + + /** + * Returns the number of referenced objects * \return zero if there is no references */ HYDRODATA_EXPORT int NbReferences() const; + /** + * Appends reference to other object (image or polyline). + * \param theReferenced the object referenced by this + */ + HYDRODATA_EXPORT void AppendReference( const Handle(HYDROData_Entity)& theReferenced ); + /** * Returns reference by index. * \param theIndex number of reference [0; NbReference) - * \returns the referenced image, or Null if index is invalid + * \returns the referenced object, or Null if index is invalid */ - HYDRODATA_EXPORT Handle(HYDROData_Image) Reference(const int theIndex) const; + HYDRODATA_EXPORT Handle(HYDROData_Entity) Reference(const int theIndex) const; /** * Updates reference by index. If index is one-bigger than \a NbReferences, * this method appends it to the end (NbReferences is incremented). * \param theIndex number of reference [0; NbReference] - * \param theReferenced the image referenced by this + * \param theReferenced the object referenced by this */ HYDRODATA_EXPORT void ChangeReference( - const int theIndex, Handle(HYDROData_Image) theReferenced); + const int theIndex, Handle(HYDROData_Entity) theReferenced); /** * Removes reference by index @@ -151,6 +336,7 @@ public: */ HYDRODATA_EXPORT void ClearReferences(); + /** * Stores the operator name * \param theOpName name of the operator that must be executed for image update @@ -175,17 +361,24 @@ public: */ HYDRODATA_EXPORT QByteArray Args() const; + /** - * Sets the "MustBeUpdated" flag: if image is depended on updated features. - * \param theFlag is true for images that must be updated, false for up-to-date + * Marks the image as self-split. + * \param theFlag is true for self-plit image */ - HYDRODATA_EXPORT void MustBeUpdated(bool theFlag); + HYDRODATA_EXPORT void SetIsSelfSplit(bool theFlag); /** - * Returns the "MustBeUpdated" flag: is image must be recomputed or not - * \returns false if image is up to date + * Checks that the image is self-split. + * \returns true if image is self-split */ - HYDRODATA_EXPORT bool MustBeUpdated(); + HYDRODATA_EXPORT bool IsSelfSplit() const; + +private: + + QPointF generateThirdPoint( const QPointF& thePointA, + const QPointF& thePointB, + const bool& theIsLocal ) const; protected: @@ -195,12 +388,12 @@ protected: * Creates new object in the internal data structure. Use higher level objects * to create objects with real content. */ - HYDROData_Image(); + HYDRODATA_EXPORT HYDROData_Image(); /** * Destructs properties of the object and object itself, removes it from the document. */ - ~HYDROData_Image(); + HYDRODATA_EXPORT ~HYDROData_Image(); };