Marble::MercatorProjection Class Reference

#include <MercatorProjection.h>

Inheritance diagram for Marble::MercatorProjection:

Public Member Functions
	MercatorProjection ()
QString	description () const override
bool	geoCoordinates (const int x, const int y, const ViewportParams *params, qreal &lon, qreal &lat, GeoDataCoordinates::Unit=GeoDataCoordinates::Degree) const override
QIcon	icon () const override
GeoDataLatLonAltBox	latLonAltBox (const QRect &screenRect, const ViewportParams *viewport) const override
bool	mapCoversViewport (const ViewportParams *viewport) const override
qreal	maxValidLat () const override
qreal	minValidLat () const override
QString	name () const override
PreservationType	preservationType () const override
bool	screenCoordinates (const GeoDataCoordinates &coordinates, const ViewportParams *params, qreal &x, qreal &y, bool &globeHidesPoint) const override
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 GeoDataCoordinates &coordinates, const ViewportParams *viewport, qreal *x, qreal &y, int &pointRepeatNum, const QSizeF &size, bool &globeHidesPoint) const override
bool	screenCoordinates (const GeoDataCoordinates &geopoint, const ViewportParams *viewport, qreal &x, qreal &y) const
virtual bool	screenCoordinates (const GeoDataCoordinates &geopoint, const ViewportParams *viewport, qreal &x, qreal &y, bool &globeHidesPoint) const =0
virtual bool	screenCoordinates (const GeoDataLineString &lineString, const ViewportParams *viewport, QVector< QPolygonF * > &polygons) const =0
bool	screenCoordinates (const GeoDataLineString &lineString, const ViewportParams *viewport, QVector< QPolygonF * > &polygons) const override
bool	screenCoordinates (const qreal lon, const qreal lat, const ViewportParams *viewport, qreal &x, qreal &y) const
Public Member Functions inherited from Marble::CylindricalProjection
QPainterPath	mapShape (const ViewportParams *viewport) const override
bool	repeatableX () const override
bool	screenCoordinates (const GeoDataCoordinates &geopoint, const ViewportParams *viewport, qreal &x, qreal &y) const
bool	screenCoordinates (const qreal lon, const qreal lat, const ViewportParams *viewport, qreal &x, qreal &y) const
SurfaceType	surfaceType () const override
bool	traversableDateLine () const override
bool	traversablePoles () const override
Public Member Functions inherited from Marble::AbstractProjection
	AbstractProjection ()
virtual qreal	clippingRadius () const
virtual bool	isClippedToSphere () const
virtual bool	isOrientedNormal () const
QRegion	mapRegion (const ViewportParams *viewport) const
qreal	maxLat () const
qreal	minLat () const
bool	screenCoordinates (const GeoDataCoordinates &geopoint, const ViewportParams *viewport, qreal &x, qreal &y) const
bool	screenCoordinates (const qreal lon, const qreal lat, const ViewportParams *viewport, qreal &x, qreal &y) const
void	setMaxLat (qreal maxLat)
void	setMinLat (qreal minLat)

Additional Inherited Members
Public Types inherited from Marble::AbstractProjection
enum	PreservationType { NoPreservation , Conformal , EqualArea }
enum	SurfaceType {   Cylindrical , Pseudocylindrical , Hybrid , Conical ,   Pseudoconical , Azimuthal }
Protected Member Functions inherited from Marble::CylindricalProjection
	CylindricalProjection (CylindricalProjectionPrivate *dd)
Protected Member Functions inherited from Marble::AbstractProjection
	AbstractProjection (AbstractProjectionPrivate *dd)
Protected Attributes inherited from Marble::AbstractProjection
const QScopedPointer< AbstractProjectionPrivate >	d_ptr

Detailed Description

A class to implement the Mercator projection.

Definition at line 29 of file MercatorProjection.h.

Constructor & Destructor Documentation

MercatorProjection()

MercatorProjection::MercatorProjection

(

)

Construct a new MercatorProjection.

Definition at line 25 of file MercatorProjection.cpp.

~MercatorProjection()

MercatorProjection::~MercatorProjection ( )

override

Definition at line 34 of file MercatorProjection.cpp.

Member Function Documentation

description()

QString MercatorProjection::description ( ) const

overridevirtual

Returns a short user description of the projection that can be used in tooltips or dialogs.

Implements Marble::AbstractProjection.

Definition at line 43 of file MercatorProjection.cpp.

geoCoordinates()

bool MercatorProjection::geoCoordinates ( const int x, const int y, const ViewportParams * params, qreal & lon, qreal & lat, GeoDataCoordinates::Unit unit = GeoDataCoordinates::Degree ) const

overridevirtual

Get the earth coordinates corresponding to a pixel in the map.

If the pixel (x, y) is outside the globe, only lon will be calculated, and lat will be unchanged.

Parameters

x	the x coordinate of the pixel
y	the y coordinate of the pixel
params	the viewport parameters
lon	the longitude angle is returned through this parameter
lat	the latitude angle is returned through this parameter
unit	the unit

Returns

true if the pixel (x, y) is within the globe false if the pixel (x, y) is outside the globe, i.e. in space.

Implements Marble::AbstractProjection.

Definition at line 163 of file MercatorProjection.cpp.

icon()

QIcon MercatorProjection::icon ( ) const

overridevirtual

Returns an icon for the projection.

Implements Marble::AbstractProjection.

Definition at line 48 of file MercatorProjection.cpp.

latLonAltBox()

GeoDataLatLonAltBox MercatorProjection::latLonAltBox ( const QRect & screenRect, const ViewportParams * viewport ) const

overridevirtual

Returns a GeoDataLatLonAltBox bounding box of the given screenrect inside the given viewport.

Reimplemented from Marble::AbstractProjection.

Definition at line 213 of file MercatorProjection.cpp.

mapCoversViewport()

bool MercatorProjection::mapCoversViewport ( const ViewportParams * viewport ) const

overridevirtual

Returns whether the projected data fully obstructs the current viewport.

In this case there are no black areas visible around the actual map. This case allows for performance optimizations.

Implements Marble::AbstractProjection.

Definition at line 251 of file MercatorProjection.cpp.

maxValidLat()

qreal MercatorProjection::maxValidLat ( ) const

overridevirtual

Returns the maximum (northern) latitude that is mathematically defined and reasonable.

Example: For many projections the value will represent +90 degrees in Radian. In the case of Mercator this value will equal +85.05113 degrees in Radian.

Reimplemented from Marble::AbstractProjection.

Definition at line 53 of file MercatorProjection.cpp.

minValidLat()

qreal MercatorProjection::minValidLat ( ) const

overridevirtual

Returns the minimum (southern) latitude that is mathematically defined and reasonable.

Example: For many projections the value will represent -90 degrees in Radian. In the case of Mercator this value will equal -85.05113 degrees in Radian.

Reimplemented from Marble::AbstractProjection.

Definition at line 59 of file MercatorProjection.cpp.

name()

QString MercatorProjection::name ( ) const

overridevirtual

Returns the user-visible name of the projection.

Implements Marble::AbstractProjection.

Definition at line 38 of file MercatorProjection.cpp.

preservationType()

PreservationType Marble::MercatorProjection::preservationType ( ) const

inlineoverridevirtual

Reimplemented from Marble::AbstractProjection.

Definition at line 60 of file MercatorProjection.h.

screenCoordinates() [1/8]

bool MercatorProjection::screenCoordinates ( const GeoDataCoordinates & coordinates, const ViewportParams * params, qreal & x, qreal & y, bool & globeHidesPoint ) const

overridevirtual

Get the screen coordinates corresponding to geographical coordinates in the map.

Parameters

coordinates	the coordinates of the requested pixel position
params	the viewport parameters
x	the x coordinate of the pixel is returned through this parameter
y	the y coordinate of the pixel is returned through this parameter
globeHidesPoint	whether the globe hides the point

Returns

true if the geographical coordinates are visible on the screen false if the geographical coordinates are not visible on the screen

Reimplemented from Marble::CylindricalProjection.

Definition at line 65 of file MercatorProjection.cpp.

screenCoordinates() [2/8]

virtual bool Marble::AbstractProjection::screenCoordinates ( const GeoDataCoordinates & coordinates, const ViewportParams * viewport, qreal * x, qreal & y, int & pointRepeatNum, const QSizeF & size, bool & globeHidesPoint ) const

virtual

Get the coordinates of screen points for geographical coordinates in the map.

Parameters

coordinates	the point on earth, including altitude, that we want the coordinates for.
viewport	the viewport parameters
x	the x coordinates of the pixels are returned through this parameter
y	the y coordinate of the pixel is returned through this parameter
pointRepeatNum	the amount of times that a single geographical point gets represented on the map
size	the size
globeHidesPoint	whether the point gets hidden on the far side of the earth

Returns

true if the geographical coordinates are visible on the screen false if the geographical coordinates are not visible on the screen

See also

ViewportParams

Reimplemented from Marble::CylindricalProjection.

screenCoordinates() [3/8]

bool MercatorProjection::screenCoordinates ( const GeoDataCoordinates & coordinates, const ViewportParams * viewport, qreal * x, qreal & y, int & pointRepeatNum, const QSizeF & size, bool & globeHidesPoint ) const

overridevirtual

Get the coordinates of screen points for geographical coordinates in the map.

Parameters

coordinates	the point on earth, including altitude, that we want the coordinates for.
viewport	the viewport parameters
x	the x coordinates of the pixels are returned through this parameter
y	the y coordinate of the pixel is returned through this parameter
pointRepeatNum	the amount of times that a single geographical point gets represented on the map
size	the size
globeHidesPoint	whether the point gets hidden on the far side of the earth

Returns

true if the geographical coordinates are visible on the screen false if the geographical coordinates are not visible on the screen

See also

ViewportParams

Reimplemented from Marble::CylindricalProjection.

Definition at line 103 of file MercatorProjection.cpp.

screenCoordinates() [4/8]

bool AbstractProjection::screenCoordinates	(	const GeoDataCoordinates &	geopoint,
		const ViewportParams *	viewport,
		qreal &	x,
		qreal &	y ) const

Definition at line 48 of file AbstractProjection.cpp.

screenCoordinates() [5/8]

virtual bool Marble::AbstractProjection::screenCoordinates ( const GeoDataCoordinates & geopoint, const ViewportParams * viewport, qreal & x, qreal & y, bool & globeHidesPoint ) const

virtual

Get the screen coordinates corresponding to geographical coordinates in the map.

Parameters

geopoint	the point on earth, including altitude, that we want the coordinates for.
viewport	the viewport parameters
x	the x coordinate of the pixel is returned through this parameter
y	the y coordinate of the pixel is returned through this parameter
globeHidesPoint	whether the point gets hidden on the far side of the earth

Returns

true if the geographical coordinates are visible on the screen false if the geographical coordinates are not visible on the screen

See also

ViewportParams

Reimplemented from Marble::CylindricalProjection.

screenCoordinates() [6/8]

virtual bool Marble::AbstractProjection::screenCoordinates ( const GeoDataLineString & lineString, const ViewportParams * viewport, QVector< QPolygonF * > & polygons ) const

virtual

Reimplemented from Marble::CylindricalProjection.

screenCoordinates() [7/8]

bool Marble::CylindricalProjection::screenCoordinates ( const GeoDataLineString & lineString, const ViewportParams * viewport, QVector< QPolygonF * > & polygons ) const

overridevirtual

Reimplemented from Marble::CylindricalProjection.

Definition at line 44 of file CylindricalProjection.cpp.

screenCoordinates() [8/8]

bool AbstractProjection::screenCoordinates	(	const qreal	lon,
		const qreal	lat,
		const ViewportParams *	viewport,
		qreal &	x,
		qreal &	y ) const

Get the screen coordinates corresponding to geographical coordinates in the map.

Parameters

lon	the lon coordinate of the requested pixel position in radians
lat	the lat coordinate of the requested pixel position in radians
viewport	the viewport parameters
x	the x coordinate of the pixel is returned through this parameter
y	the y coordinate of the pixel is returned through this parameter

Returns

true if the geographical coordinates are visible on the screen false if the geographical coordinates are not visible on the screen

See also

ViewportParams

Definition at line 48 of file AbstractProjection.cpp.

---

The documentation for this class was generated from the following files:

• MercatorProjection.h
• MercatorProjection.cpp