TiePointLocatorWidget.h

Go to the documentation of this file.

/*  Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.

    This file is part of the TerraLib - a Framework for building GIS enabled applications.

    TerraLib 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 3 of the License,
    or (at your option) any later version.

    TerraLib 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 TerraLib. See COPYING. If not, write to
    TerraLib Team at <terralib-team@terralib.org>.
 */

/*!
  \file terralib/qt/widgets/rp/TiePointLocatorWidget.h

  \brief This file has the TiePointLocatorWidget class.
*/

#ifndef __TERRALIB_QT_WIDGETS_RP_INTERNAL_TIEPOINTLOCATORWIDGET_H
#define __TERRALIB_QT_WIDGETS_RP_INTERNAL_TIEPOINTLOCATORWIDGET_H

// TerraLib
#include "../../../color/RGBAColor.h"
#include "../../../geometry/Coord2D.h"
#include "../../../geometry/GTParameters.h"
#ifndef Q_MOC_RUN
#include "../../../maptools/AbstractLayer.h"
#include "../../../rp/TiePointsLocator.h"
#endif
#include "../Config.h"

// STL
#include <map>
#include <memory>
#include <set>

// Qt
#include <QTableWidgetItem>
#include <QWidget>

namespace Ui { class TiePointLocatorWidgetForm; }

namespace te
{

  namespace se { class Mark; }

  namespace qt
  {
    namespace widgets
    {
      class MapDisplay;
      class RasterNavigatorWidget;
      class TiePointLocatorParametersWidget;

        /*! \class TiePointData Tie Point data. */
        class TiePointData
        {
          public :
              
            /*! \enum TiePointAcquisitionType Tie point acquisition type. */
            enum TiePointAcquisitionType 
            { 
              InvalidAcquisitionT,  //!< Invalid acquisition type.
              ManualAcquisitionT,   //!< Manual acquisition type.
              AutomaticAcquisitionT //!< Automatic acquisition type.
            };              
              
            TiePointAcquisitionType m_acqType;          //!< Acquisition type.
            te::gm::GTParameters::TiePoint m_tiePoint;  //!< Tie point coordinates  - std::pair< Reference Raster Line/Col Coord,. Adjust Raster Line/Col Coord >.
            bool m_selected;                            //!< Tie point selection status;
              
            TiePointData();

            TiePointData( const TiePointData& other );

            ~TiePointData();

            const TiePointData& operator=( const TiePointData& other );

            typedef std::map< unsigned int, TiePointData >  TPContainerT; //!< Tie-pints container type definition.

        };

      /*!
        \class TiePointLocatorWidget

        \brief This class is used to define a widget for tie point acquirement.
      */
      class TEQTWIDGETSEXPORT TiePointLocatorWidget : public QWidget
      {
        Q_OBJECT

        public:

          enum FirstCoordType
          {
            None,        //!< None first coord picked
            Reference,   //!< Reference first coord was picked
            Adjust       //!< Adjust first coord was picked
          };

          TiePointLocatorWidget(QWidget* parent = 0, Qt::WindowFlags f = 0);

          ~TiePointLocatorWidget();

          Ui::TiePointLocatorWidgetForm* getForm() const;

        public:

          /*! 
            \brief Get the current acquired tie-points. 

            \param tiePoints The current acquired tie-points (TiePoint.first=adjust raster lines/cols, TiePoint.second=the related correct X/Y coords under the output SRID).
          */
          void getTiePoints( std::vector< te::gm::GTParameters::TiePoint >& tiePoints ) const;

          /*! 
            \brief Get the current acquired tie-points. 

            \param tiePoints The current acquired tie-points.
          */
          void getTiePointsIdxCoords( std::vector< te::gm::GTParameters::TiePoint >& tiePoints ) const;

          /*! 
            \brief Get tie point data container.

            \return  The tie point data container.
          */
          const te::qt::widgets::TiePointData::TPContainerT& getTiePointContainer();

          /*! 
            \brief Get tie point reference coord that does not have an adjust coordenate or 
            \ tie point adjust coord that does not have an reference coordenate
            \param firstCoord  The tie point reference or adjsut coord.

            \return The m_tiePointHasFirstCoord type (None, Reference  or Adjust).
          */
          FirstCoordType getFirstTiePointCoord(te::gm::Coord2D& firstCoord);

          /*!
            \brief This method is used to set the selected layer used to be the reference layer
            
            \param layer The layer ptr 

            \note This layer MUST HAVE a valid raster object.
          */
          void setReferenceLayer(te::map::AbstractLayerPtr layer);

          /*!
            \brief This method is used to set the selected layer used to be the adjust layer
            
            \param layer The layer ptr 

            \note This layer MUST HAVE a valid raster object.
          */
          void setAdjustLayer(te::map::AbstractLayerPtr layer);

          void getOutputSRID(int& srid);
          
          void getOutputResolution(double& resX, double& resY);
          
          std::string getTransformationName() const;
          
          te::rst::Interpolator::Method getInterpolatorMethod() const;

        protected:

          void refCoordPicked(double x, double y);

          void adjCoordPicked(double x, double y);

          void refCoordMoved(double xorig, double yorig, double xnew, double ynew);

          void adjCoordMoved(double xorig, double yorig, double xnew, double ynew);

          void setTiePointMarkLegend(QPixmap p);

          void setSelectedTiePointMarkLegend(QPixmap p);

          void setReferenceTiePointMarkLegend(QPixmap p);

          void createSelection(int initialIdx, int nPos);

          bool shotSecondtPoint();

          bool shotFirstPoint();

          protected slots:

          void onAutoAcquireTiePointsToolButtonClicked();

          void onSelectAllToolButtonClicked();

          void onUnselectAllToolButtonClicked();

          void onDeleteSelectedToolButtonClicked();

          void onAddToolButtonClicked();

          void onTiePointsTableWidgetItemSelectionChanged();

          void onRefreshToolButtonClicked();

          void onDoneToolButtonClicked();

          void onRefMapDisplayExtentChanged();

          void onAdjMapDisplayExtentChanged();

          void onRefPointPicked(double x, double y);

          void onAdjPointPicked(double x, double y);

          void onRefPointMoved(double xorig, double yorig, double xnew, double ynew);

          void onAdjPointMoved(double xorig, double yorig, double xnew, double ynew);

          void onTiePointsUpdated();

          void onSRIDPushButtonClicked();
          
          void onLoadTiePointsToolButtonClicked();
          
          void onSaveTiePointsToolButtonClicked();

          void onTiePointsTableWidgetItemChanged(QTableWidgetItem*);

        protected:

          /*! \brief Uptate the tie-points table widget. */
          void tiePointsTableUpdate();
          
          /*! \brief Uptate the current transformation information widgets. */
          void transformationInfoUpdate();

          void startUpNavigators();

          void drawTiePoints();

          QPixmap getPixmap(te::color::RGBAColor** rgba);

          void reset();

          /*!
             \brief Returns the rasters pixel sizes relation.
             \param pixelSizeXRelation X Relation.
             \param pixelSizeYRelation Y Relation.
             \note PixelSizeRelation = Reference_Raster_Pixel_Size / Adjust_Raster_Pixel_Size
          */
          void getRastersPixelSizesRelation( double& pixelSizeXRelation,
            double& pixelSizeYRelation ) const;

          /*!
             \brief Returns the rasters pixel size relation ().
             \note PixelSizeRelation = Reference_Raster_Mean_Pixel_Size / Adjust_Raster_Mean_Pixel_Size
          */
          double getRastersMeanPixelSizeRelation() const;

        signals:

          void tiePointsUpdated();

          void doneAcquiredTiePoints();

        private:

          std::unique_ptr<Ui::TiePointLocatorWidgetForm> m_ui;

          te::qt::widgets::TiePointLocatorParametersWidget* m_tiePointParameters;     //!<Tie Point parameters widget

          te::map::AbstractLayerPtr m_refLayer;                         //!< Layer with reference imagem
          te::map::AbstractLayerPtr m_adjLayer;                         //!< Layer with adjust imagem

          te::qt::widgets::TiePointData::TPContainerT m_tiePoints;       //!< Internal tie-points container..

          te::gm::GTParameters::TiePoint m_currentTiePoint;             //!< The current tie-point.
          FirstCoordType m_tiePointFirstCoord;                          //!< Type of coord if the tie-point has the first part set;
          unsigned int m_tiePointIdCounter;                             //!< A ID counter for new tie pointes inserted into m_tiePoints;

          std::set<int> m_tiePointsSelected;                            //!< List of selected tie points.

          te::qt::widgets::RasterNavigatorWidget* m_refNavigator;     //!< Reference raster navigator
          te::qt::widgets::RasterNavigatorWidget* m_adjNavigator;     //!< Adjust raster navigator

          te::color::RGBAColor** m_rgbaMarkSelected;                  //!< Represents the pattern of a selected tie point
          te::color::RGBAColor** m_rgbaMarkUnselected;                //!< Represents the pattern of a unselected tie point
          te::color::RGBAColor** m_rgbaMarkRef;                       //!< Represents the pattern of reference tie point
          te::se::Mark* m_markSelected;                               //!< Represents the mark of a selected tie point
          te::se::Mark* m_markUnselected;                             //!< Represents the mark of a unselected tie point
          te::se::Mark* m_markRef;                                    //!< Represents the mark of a reference tie point
          std::map< unsigned int, QPointF > m_refPoints;              //!< Display reference coordinates
          std::map< unsigned int, QPointF > m_adjPoints;              //!< Display adjust coordinates
      }; 

    } // end namespace widgets
  }   // end namespace qt
}     // end namespace te

#endif  // __TERRALIB_QT_WIDGETS_RP_INTERNAL_TIEPOINTLOCATORWIDGET_H