/usr/include/marble/AbstractProjection.h is in libmarble-dev 4:4.8.2-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 | //
// This file is part of the Marble Virtual Globe.
//
// This program is free software licensed under the GNU LGPL. You can
// find a copy of this license in LICENSE.txt in the top directory of
// the source code.
//
// Copyright 2007-2008 Inge Wallin <ingwa@kde.org>
// Copyright 2007-2009 Torsten Rahn <rahn@kde.org>
//
#ifndef MARBLE_ABSTRACTPROJECTION_H
#define MARBLE_ABSTRACTPROJECTION_H
/** @file
* This file contains the headers for AbstractProjection.
*
* @author Inge Wallin <inge@lysator.liu.se>
* @author Torsten Rahn <rahn@kde.org>
*/
#include <QtCore/QRect>
#include <QtCore/QVector>
#include <QtGui/QPainterPath>
#include <QtGui/QPolygonF>
#include "GeoDataLatLonAltBox.h"
#include "GeoDataCoordinates.h"
#include "marble_export.h"
namespace Marble
{
// The manhattan distance in pixels at which extra nodes get created for tessellation.
static const int tessellationPrecision = 10;
static const int latLonAltBoxSamplingRate = 4;
class GeoDataLineString;
class ViewportParams;
class AbstractProjectionPrivate;
/**
* @short A base class for all projections in Marble.
*/
class MARBLE_EXPORT AbstractProjection
{
// Not a QObject so far because we don't need to send signals.
public:
enum SurfaceType {
Cylindrical,
Pseudocylindrical,
Hybrid,
Conical,
Pseudoconical,
Azimuthal
};
enum PreservationType {
NoPreservation,
Conformal,
EqualArea
};
/**
* @brief Construct a new AbstractProjection.
*/
AbstractProjection();
virtual ~AbstractProjection();
virtual qreal maxValidLat() const;
qreal maxLat() const;
void setMaxLat( qreal maxLat );
virtual qreal minValidLat() const;
qreal minLat() const;
void setMinLat( qreal minLat );
virtual bool repeatableX() const;
bool repeatX() const;
void setRepeatX( bool repeatX );
virtual bool traversablePoles() const { return false; }
virtual bool traversableDateLine() const { return false; }
virtual SurfaceType surfaceType() const = 0;
virtual PreservationType preservationType() const { return NoPreservation; }
// The projection surface can have different orientations:
// - normal: the surface's axis of symmetry matches the Earth's axis
// - transverse: orthogonally oriented compared to the Earth's axis
// - oblique: somewhere in between
virtual bool isOrientedNormal() const { return true; }
/**
* @brief Get the screen coordinates corresponding to geographical coordinates in the map.
* @param lon the lon coordinate of the requested pixel position in radians
* @param lat the lat coordinate of the requested pixel position in radians
* @param viewport the viewport parameters
* @param x the x coordinate of the pixel is returned through this parameter
* @param y the y coordinate of the pixel is returned through this parameter
* @return @c true if the geographical coordinates are visible on the screen
* @c false if the geographical coordinates are not visible on the screen
*
* @see ViewportParams
*/
virtual bool screenCoordinates( const qreal lon, const qreal lat,
const ViewportParams *viewport,
qreal& x, qreal& y ) const = 0;
/**
* @brief Get the screen coordinates corresponding to geographical coordinates in the map.
*
* @param geopoint the point on earth, including altitude, that we want the coordinates for.
* @param viewport the viewport parameters
* @param x the x coordinate of the pixel is returned through this parameter
* @param y the y coordinate of the pixel is returned through this parameter
* @param globeHidesPoint whether the point gets hidden on the far side of the earth
*
* @return @c true if the geographical coordinates are visible on the screen
* @c false if the geographical coordinates are not visible on the screen
*
* @see ViewportParams
*/
virtual bool screenCoordinates( const GeoDataCoordinates &geopoint,
const ViewportParams *viewport,
qreal &x, qreal &y,
bool &globeHidesPoint ) const = 0;
// Will just call the virtual version with a dummy globeHidesPoint.
bool screenCoordinates( const GeoDataCoordinates &geopoint,
const ViewportParams *viewport,
qreal &x, qreal &y ) const;
bool screenCoordinates( const GeoDataCoordinates &geopoint,
const ViewportParams *viewport,
QPointF &screenpoint ) const;
/**
* @brief Get the coordinates of screen points for geographical coordinates in the map.
*
* @param coordinates the point on earth, including altitude, that we want the coordinates for.
* @param viewport the viewport parameters
* @param x the x coordinates of the pixels are returned through this parameter
* @param y the y coordinate of the pixel is returned through this parameter
* @param pointRepeatNum the amount of times that a single geographical
point gets represented on the map
* @param globeHidesPoint whether the point gets hidden on the far side of the earth
*
* @return @c true if the geographical coordinates are visible on the screen
* @c false if the geographical coordinates are not visible on the screen
*
* @see ViewportParams
*/
bool screenCoordinates( const GeoDataCoordinates &coordinates,
const ViewportParams *viewport,
qreal *x, qreal &y, int &pointRepeatNum,
bool &globeHidesPoint ) const;
virtual bool screenCoordinates( const GeoDataCoordinates &coordinates,
const ViewportParams *viewport,
qreal *x, qreal &y, int &pointRepeatNum,
const QSizeF& size,
bool &globeHidesPoint ) const = 0;
bool screenCoordinates( const GeoDataLineString &lineString,
const ViewportParams *viewport,
QVector<QPolygonF*> &polygons ) const;
/**
* @brief Get the earth coordinates corresponding to a pixel in the map.
* @param x the x coordinate of the pixel
* @param y the y coordinate of the pixel
* @param viewport the viewport parameters
* @param lon the longitude angle is returned through this parameter
* @param lat the latitude angle is returned through this parameter
* @param unit the unit of the angles for lon and lat.
* @return @c true if the pixel (x, y) is within the globe
* @c false if the pixel (x, y) is outside the globe, i.e. in space.
*/
virtual bool geoCoordinates( const int x, const int y,
const ViewportParams *viewport,
qreal& lon, qreal& lat,
GeoDataCoordinates::Unit unit = GeoDataCoordinates::Degree ) const = 0;
virtual GeoDataLatLonAltBox latLonAltBox( const QRect& screenRect,
const ViewportParams *viewport ) const;
virtual bool mapCoversViewport( const ViewportParams *viewport ) const = 0;
virtual QPainterPath mapShape( const ViewportParams *viewport ) const = 0;
QRegion mapRegion( const ViewportParams *viewport ) const;
// these methods will be removed in Marble 1.4:
MARBLE_DEPRECATED( bool exceedsLatitudeRange( const GeoDataCoordinates& coords ) const );
MARBLE_DEPRECATED( bool exceedsLatitudeRange( const GeoDataLineString& lineString ) const );
/**
* @deprecated
* use @see screenCoordinates(qreal,qreal,const ViewportParams*,qreal&,qreal&)
*/
MARBLE_DEPRECATED( bool screenCoordinates( qreal lon, qreal lat,
const ViewportParams *viewport,
int& x, int& y ) const );
MARBLE_DEPRECATED( bool screenCoordinates( const GeoDataCoordinates &geopoint,
const ViewportParams *viewport,
int &x, int &y, bool &globeHidesPoint ) const );
private:
Q_DISABLE_COPY( AbstractProjection )
AbstractProjectionPrivate * const d;
};
}
#endif
|