geo/tcGlobe.h

   1 /***************************************************************************
   2  *   This file is part of Tecorrec.                                        *
   3  *   Copyright 2008 James Hogan <james@albanarts.com>                      *
   4  *                                                                         *
   5  *   Tecorrec is free software: you can redistribute it and/or modify      *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation, either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   Tecorrec is distributed in the hope that it will be useful,           *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with Tecorrec.  If not, write to the Free Software Foundation,  *
  17  *   Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.   *
  18  ***************************************************************************/
  19
  20 #ifndef _tcGlobe_h_
  21 #define _tcGlobe_h_
  22
  23 /**
  24  * @file tcGlobe.h
  25  * @brief Manages data for a globe.
  26  */
  27
  28 #include <QList>
  29
  30 class tcGeo;
  31 class tcPhotographyData;
  32 class tcObserver;
  33 class tcSrtmModel;
  34
  35 /** Manages data for a globe.
  36  * Holds terrain elevation and imagery data.
  37  */
  38 class tcGlobe
  39 {
  40   public:
  41
  42     /*
  43      * Enumerations
  44      */
  45
  46     /// Elevation modes.
  47     enum ElevationMode
  48     {
  49       NoElevation,
  50       RawElevation,
  51       CorrectedElevation
  52     };
  53
  54     /*
  55      * Constructors + destructor
  56      */
  57
  58     /// Primary constructor.
  59     tcGlobe(double meanRadius);
  60
  61     /// Destructor.
  62     virtual ~tcGlobe();
  63
  64     /*
  65      * Data sets
  66      */
  67
  68     /// Add a dataset to the globe.
  69     void addDataSet(tcPhotographyData* data);
  70
  71     /*
  72      * Rendering
  73      */
  74
  75     /// Render from the POV of an observer.
  76     void render(tcObserver* const observer);
  77
  78     /// Set the elevation mode to render in.
  79     void setElevationMode(ElevationMode mode);
  80
  81     /// Set the level of correction to show.
  82     void setElevationCorrection(float correction);
  83
  84     /*
  85      * Accessors
  86      */
  87
  88     /// Get the mean radius.
  89     double meanRadius() const;
  90
  91   private:
  92
  93     /*
  94      * Rendering
  95      */
  96
  97     /// Draw a line of latitude.
  98     void drawLineOfLatitude(double latitude) const;
  99
 100     /// Render a cell.
 101     void renderCell(tcObserver* const observer, const tcGeo& swCorner, const tcGeo& neCorner) const;
 102
 103   private:
 104
 105     /*
 106      * Variables
 107      */
 108
 109     /// Mean radius in metres.
 110     double m_meanRadius;
 111
 112     /// Elevation model.
 113     tcSrtmModel* m_elevation;
 114
 115     /// List of geo data sets.
 116     QList<tcPhotographyData*> m_data;
 117
 118     /*
 119      * Rendering options
 120      */
 121
 122     /// Current elevation mode.
 123     ElevationMode m_elevationMode;
 124
 125     /// Current level of elevation correction.
 126     float m_elevationCorrection;
 127 };
 128
 129 #endif
 130