#include <GeoDataCoordinates.h>

Inheritance diagram for Marble::GeoDataCoordinates:

Public Types
enum	BearingType { InitialBearing, FinalBearing }

enum	Notation { Decimal, DMS, DM, UTM, Astro }

typedef QVector < GeoDataCoordinates * >	PtrVector

enum	Unit { Radian, Degree }

typedef QVector < GeoDataCoordinates >	Vector

Public Member Functions
	GeoDataCoordinates (const GeoDataCoordinates &other)

	GeoDataCoordinates ()

	GeoDataCoordinates (qreal lon, qreal lat, qreal alt=0, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian, int detail=0)

virtual	~GeoDataCoordinates ()

qreal	altitude () const

qreal	bearing (const GeoDataCoordinates &other, Unit unit=Radian, BearingType type=InitialBearing) const

virtual void	detach ()

int	detail () const

void	geoCoordinates (qreal &lon, qreal &lat, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian) const

void	geoCoordinates (qreal &lon, qreal &lat, qreal &alt, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian) const

GeoDataCoordinates	interpolate (const GeoDataCoordinates &target, double t) const

GeoDataCoordinates	interpolate (const GeoDataCoordinates &before, const GeoDataCoordinates &target, const GeoDataCoordinates &after, double t) const

bool	isPole (Pole=AnyPole) const

bool	isValid () const

qreal	latitude (GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian) const

QString	latToString () const

qreal	longitude (GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian) const

QString	lonToString () const

GeoDataCoordinates	moveByBearing (qreal bearing, qreal distance) const

virtual bool	operator!= (const GeoDataCoordinates &) const

GeoDataCoordinates &	operator= (const GeoDataCoordinates &other)

virtual bool	operator== (const GeoDataCoordinates &) const

virtual void	pack (QDataStream &stream) const

const Quaternion &	quaternion () const

void	set (qreal lon, qreal lat, qreal alt=0, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian)

void	setAltitude (const qreal altitude)

void	setDetail (const int det)

void	setLatitude (qreal lat, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian)

void	setLongitude (qreal lon, GeoDataCoordinates::Unit unit=GeoDataCoordinates::Radian)

QString	toString () const

QString	toString (GeoDataCoordinates::Notation notation, int precision=-1) const

virtual void	unpack (QDataStream &stream)

Static Public Member Functions
static GeoDataCoordinates::Notation	defaultNotation ()

static GeoDataCoordinates	fromString (const QString &string, bool &successful)

static QString	latToString (qreal lat, GeoDataCoordinates::Notation notation, GeoDataCoordinates::Unit unit=Radian, int precision=-1, char format= 'f')

static QString	lonToString (qreal lon, GeoDataCoordinates::Notation notation, GeoDataCoordinates::Unit unit=Radian, int precision=-1, char format= 'f')

static qreal	normalizeLat (qreal lat, GeoDataCoordinates::Unit=GeoDataCoordinates::Radian)

static qreal	normalizeLon (qreal lon, GeoDataCoordinates::Unit=GeoDataCoordinates::Radian)

static void	normalizeLonLat (qreal &lon, qreal &lat, GeoDataCoordinates::Unit=GeoDataCoordinates::Radian)

static void	setDefaultNotation (GeoDataCoordinates::Notation notation)

Protected Attributes
GeoDataCoordinatesPrivate *	d

Detailed Description

A 3d point representation.

GeoDataCoordinates is the simple representation of a single three dimensional point. It can be used all through out marble as the data type for three dimensional objects. it comprises of a Quaternion for speed issues. This class was introduced to reflect the difference between a simple 3d point and the GeoDataGeometry object containing such a point. The latter is a GeoDataPoint and is simply derived from GeoDataCoordinates.

See also: GeoDataPoint

Definition at line 52 of file GeoDataCoordinates.h.

Member Typedef Documentation

typedef QVector<GeoDataCoordinates*> Marble::GeoDataCoordinates::PtrVector

Definition at line 103 of file GeoDataCoordinates.h.

typedef QVector<GeoDataCoordinates> Marble::GeoDataCoordinates::Vector

Definition at line 102 of file GeoDataCoordinates.h.

Member Enumeration Documentation

enum Marble::GeoDataCoordinates::BearingType

The BearingType enum specifies where to measure the bearing along great circle arcs.

When traveling along a great circle arc defined by the two points A and B, the bearing varies along the arc. The "InitialBearing" bearing corresponds to the bearing value at A, the "FinalBearing" bearing to that at B.

Enumerator
InitialBearing
FinalBearing

Definition at line 96 of file GeoDataCoordinates.h.

enum Marble::GeoDataCoordinates::Notation

enum used to specify the notation / numerical system

For degrees there exist two notations: "Decimal" (base-10) and the "Sexagesimal DMS" (base-60) which is traditionally used in cartography. Decimal notation uses floating point numbers to specify parts of a degree. The Sexagesimal DMS notation uses integer based Degrees-(Arc)Minutes-(Arc)Seconds to describe parts of a degree.

Enumerator
Decimal	"Decimal" notation (base-10)
DMS	"Sexagesimal DMS" notation (base-60)
DM	"Sexagesimal DM" notation (base-60)
UTM
Astro	< "RA and DEC" notation (used for astronomical sky coordinates)

Definition at line 79 of file GeoDataCoordinates.h.

enum Marble::GeoDataCoordinates::Unit

enum used constructor to specify the units used

Internally we always use radian for mathematical convenience. However the Marble's interfaces to the outside should default to degrees.

Enumerator
Radian
Degree

Definition at line 64 of file GeoDataCoordinates.h.

Constructor & Destructor Documentation

Marble::GeoDataCoordinates::GeoDataCoordinates ( const GeoDataCoordinates & other )

Definition at line 596 of file GeoDataCoordinates.cpp.

Marble::GeoDataCoordinates::GeoDataCoordinates ( )

constructs an invalid instance

Constructs an invalid instance such that calling isValid() on it will return

false

.

Definition at line 605 of file GeoDataCoordinates.cpp.

Marble::GeoDataCoordinates::GeoDataCoordinates	(	qreal	lon,
		qreal	lat,
		qreal	alt = `0`,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`,
		int	detail = `0`
	)

create a geocoordinate from longitude and latitude

Parameters

_lon	longitude
_lat	latitude
alt	altitude in meters (default: 0)
_unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)
_detail	detail (default: 0)

Definition at line 587 of file GeoDataCoordinates.cpp.

Marble::GeoDataCoordinates::~GeoDataCoordinates ( )

virtual

Definition at line 615 of file GeoDataCoordinates.cpp.

Member Function Documentation

qreal Marble::GeoDataCoordinates::altitude ( ) const

return the altitude of the Point in meters

Definition at line 1197 of file GeoDataCoordinates.cpp.

qreal Marble::GeoDataCoordinates::bearing	(	const GeoDataCoordinates &	other,
		Unit	unit = `Radian`,
		BearingType	type = `InitialBearing`
	)		const

Returns the bearing (true bearing, the angle between the line defined by this point and the other and the prime meridian)

Parameters

other	The second point that, together with this point, defines a line
unit	Unit of the result

Returns: The true bearing in the requested unit, not range normalized, in clockwise direction, with the value 0 corresponding to north

Definition at line 1213 of file GeoDataCoordinates.cpp.

GeoDataCoordinates::Notation Marble::GeoDataCoordinates::defaultNotation ( )

static

return Notation of string representation

Definition at line 764 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::detach ( )

virtual

Definition at line 636 of file GeoDataCoordinates.cpp.

int Marble::GeoDataCoordinates::detail ( ) const

return the detail flag detail range: 0 for most important points, 5 for least important

Definition at line 1202 of file GeoDataCoordinates.cpp.

GeoDataCoordinates Marble::GeoDataCoordinates::fromString	(	const QString &	string,
		bool &	successful
	)

static

try to parse the string into a coordinate pair

Parameters

successful becomes true if the conversion succeeds

Returns: the geodatacoordinates

Definition at line 909 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::geoCoordinates	(	qreal &	lon,
		qreal &	lat,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)		const

use this function to get the longitude and latitude with one call - use the unit parameter to switch between Radian and DMS

Parameters

lon	longitude
lat	latitude
unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Definition at line 715 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::geoCoordinates	(	qreal &	lon,
		qreal &	lat,
		qreal &	alt,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)		const

use this function to get the longitude, latitude and altitude with one call - use the unit parameter to switch between Radian and DMS

Parameters

lon	longitude
lat	latitude
alt	altitude in meters
unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Definition at line 732 of file GeoDataCoordinates.cpp.

GeoDataCoordinates Marble::GeoDataCoordinates::interpolate	(	const GeoDataCoordinates &	target,
		double	t
	)		const

slerp (spherical linear) interpolation between this coordinate and the given target coordinate

Parameters

target	Destination coordinate
t	Fraction 0..1 to weight between this and target

Returns: Interpolated coordinate between this (t<=0.0) and target (t>=1.0)

Definition at line 1241 of file GeoDataCoordinates.cpp.

GeoDataCoordinates Marble::GeoDataCoordinates::interpolate	(	const GeoDataCoordinates &	before,
		const GeoDataCoordinates &	target,
		const GeoDataCoordinates &	after,
		double	t
	)		const

squad (spherical and quadrangle) interpolation between b and c

Parameters

before	First base point
target	Third base point (second interpolation point)
after	Fourth base point
t	Offset between b (t<=0) and c (t>=1)

Definition at line 1251 of file GeoDataCoordinates.cpp.

bool Marble::GeoDataCoordinates::isPole ( Pole pole = AnyPole ) const

return whether our coordinates represent a pole This method can be used to check whether the coordinate equals one of the poles.

Definition at line 1266 of file GeoDataCoordinates.cpp.

bool Marble::GeoDataCoordinates::isValid ( ) const

Returns.

true

if the coordinate is valid,

false

otherwise.

Returns: whether the coordinate is valid

A coordinate is valid, if at least one component has been set and the last assignment was not an invalid GeoDataCoordinates object.

Definition at line 624 of file GeoDataCoordinates.cpp.

qreal Marble::GeoDataCoordinates::latitude ( GeoDataCoordinates::Unit unit = GeoDataCoordinates::Radian ) const

retrieves the latitude of the GeoDataCoordinates object use the unit parameter to switch between Radian and DMS

Parameters

unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Returns: latitude

Definition at line 751 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::latToString	(	qreal	lat,
		GeoDataCoordinates::Notation	notation,
		GeoDataCoordinates::Unit	unit = `Radian`,
		int	precision = `-1`,
		char	format = `'f'`
	)

static

Definition at line 1080 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::latToString ( ) const

return a string representation of latitude of the coordinate convenience function that uses the default notation

Definition at line 1176 of file GeoDataCoordinates.cpp.

qreal Marble::GeoDataCoordinates::longitude ( GeoDataCoordinates::Unit unit = GeoDataCoordinates::Radian ) const

retrieves the longitude of the GeoDataCoordinates object use the unit parameter to switch between Radian and DMS

Parameters

unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Returns: longitude

Definition at line 739 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::lonToString	(	qreal	lon,
		GeoDataCoordinates::Notation	notation,
		GeoDataCoordinates::Unit	unit = `Radian`,
		int	precision = `-1`,
		char	format = `'f'`
	)

static

Definition at line 933 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::lonToString ( ) const

return a string representation of longitude of the coordinate convenience function that uses the default notation

Definition at line 1075 of file GeoDataCoordinates.cpp.

GeoDataCoordinates Marble::GeoDataCoordinates::moveByBearing	(	qreal	bearing,
		qreal	distance
	)		const

Returns the coordinates of the resulting point after moving this point according to the distance and bearing parameters.

Parameters

bearing	the same as above
distance	the distance on a unit sphere

Definition at line 1226 of file GeoDataCoordinates.cpp.

qreal Marble::GeoDataCoordinates::normalizeLat	(	qreal	lat,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

static

normalize latitude to always be in -M_PI / 2.

<= lat <= +M_PI / 2 (Radian).

Parameters

lat latitude

Definition at line 799 of file GeoDataCoordinates.cpp.

qreal Marble::GeoDataCoordinates::normalizeLon	(	qreal	lon,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

static

normalize the longitude to always be -M_PI <= lon <= +M_PI (Radian).

Parameters

lon longitude

Definition at line 776 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::normalizeLonLat	(	qreal &	lon,
		qreal &	lat,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

static

normalize both longitude and latitude at the same time This method normalizes both latitude and longitude, so that the latitude and the longitude stay within the "usual" range.

NOTE: If the latitude exceeds M_PI/2 (+90.0 deg) or -M_PI/2 (-90.0 deg) then this will be interpreted as a pole traversion where the point will end up on the opposite side of the globe. Therefore the longitude will change by M_PI (180 deg). If you don't want this behaviour use both normalizeLat() and normalizeLon() instead.

Parameters

lon	the longitude value
lat	the latitude value

Definition at line 845 of file GeoDataCoordinates.cpp.

bool Marble::GeoDataCoordinates::operator!= ( const GeoDataCoordinates & rhs ) const

virtual

Definition at line 1186 of file GeoDataCoordinates.cpp.

GeoDataCoordinates & Marble::GeoDataCoordinates::operator= ( const GeoDataCoordinates & other )

Definition at line 1322 of file GeoDataCoordinates.cpp.

bool Marble::GeoDataCoordinates::operator== ( const GeoDataCoordinates & rhs ) const

virtual

Definition at line 1181 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::pack ( QDataStream & stream ) const

virtual

Serialize the contents of the feature to stream.

Definition at line 1328 of file GeoDataCoordinates.cpp.

const Quaternion & Marble::GeoDataCoordinates::quaternion ( ) const

return a Quaternion with the used coordinates

Definition at line 1236 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::set	(	qreal	lon,
		qreal	lat,
		qreal	alt = `0`,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

(re)set the coordinates in a GeoDataCoordinates object

Parameters

_lon	longitude
_lat	latitude
alt	altitude in meters (default: 0)
_unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Definition at line 657 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::setAltitude ( const qreal altitude )

set the altitude of the Point in meters

Parameters

altitude altitude

Definition at line 1191 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::setDefaultNotation ( GeoDataCoordinates::Notation notation )

static

set the Notation of the string representation

Parameters

notation Notation

Definition at line 770 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::setDetail ( const int det )

set the detail flag

Parameters

det detail

Definition at line 1207 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::setLatitude	(	qreal	lat,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

set the longitude in a GeoDataCoordinates object

Parameters

_lat	longitude
_unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Definition at line 699 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::setLongitude	(	qreal	lon,
		GeoDataCoordinates::Unit	unit = `GeoDataCoordinates::Radian`
	)

set the longitude in a GeoDataCoordinates object

Parameters

_lon	longitude
_unit	units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

Definition at line 679 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::toString ( ) const

return a string representation of the coordinate this is a convenience function which uses the default notation

Definition at line 921 of file GeoDataCoordinates.cpp.

QString Marble::GeoDataCoordinates::toString	(	GeoDataCoordinates::Notation	notation,
		int	precision = `-1`
	)		const

return a string with the notation given by notation

Parameters

notation	set a notation different from the default one
precision	set the number of digits below degrees. The precision depends on the current notation: For Decimal representation the precision is the number of digits after the decimal point. In DMS a precision of 1 or 2 shows the arc minutes; a precision of 3 or 4 will show arc seconds. A precision beyond that will increase the number of digits after the arc second decimal point.

Definition at line 926 of file GeoDataCoordinates.cpp.

void Marble::GeoDataCoordinates::unpack ( QDataStream & stream )

virtual

Unserialize the contents of the feature from stream.

Definition at line 1335 of file GeoDataCoordinates.cpp.

Member Data Documentation

GeoDataCoordinatesPrivate* Marble::GeoDataCoordinates::d

protected

Definition at line 381 of file GeoDataCoordinates.h.

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

marble

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

marble

kdeedu API Reference

Search