Search for usage in LXR

Marble::GeoDataTrack Class Reference

#include <GeoDataTrack.h>

Inheritance diagram for Marble::GeoDataTrack:

Public Member Functions

 GeoDataTrack (const GeoDataTrack &other)
void addPoint (const QDateTime &when, const GeoDataCoordinates &coord)
void appendAltitude (qreal altitude)
void appendCoordinates (const GeoDataCoordinates &coord)
void appendWhen (const QDateTime &when)
void clear ()
GeoDataCoordinates coordinatesAt (const QDateTime &when) const
GeoDataCoordinates coordinatesAt (int index) const
QVector< GeoDataCoordinatescoordinatesList () const
GeoDataGeometrycopy () const override
GeoDataExtendedDataextendedData ()
const GeoDataExtendedDataextendedData () const
QDateTime firstWhen () const
EnumGeometryId geometryId () const override
bool interpolate () const
QDateTime lastWhen () const
const GeoDataLatLonAltBoxlatLonAltBox () const override
const GeoDataLineStringlineString () const
const char * nodeType () const override
bool operator!= (const GeoDataTrack &other) const
GeoDataTrackoperator= (const GeoDataTrack &other)
bool operator== (const GeoDataTrack &other) const
void pack (QDataStream &stream) const override
void removeAfter (const QDateTime &when)
void removeBefore (const QDateTime &when)
void setExtendedData (const GeoDataExtendedData &extendedData)
void setInterpolate (bool on)
int size () const
void unpack (QDataStream &stream) override
QVector< QDateTimewhenList () const
- Public Member Functions inherited from Marble::GeoDataGeometry
AltitudeMode altitudeMode () const
void detach ()
bool extrude () const
bool operator!= (const GeoDataGeometry &other) const
bool operator== (const GeoDataGeometry &other) const
void pack (QDataStream &stream) const override
void setAltitudeMode (const AltitudeMode altitudeMode)
void setExtrude (bool extrude)
void unpack (QDataStream &stream) override
- Public Member Functions inherited from Marble::GeoDataObject
 GeoDataObject (const GeoDataObject &)
QString id () const
GeoDataObjectoperator= (const GeoDataObject &)
void pack (QDataStream &stream) const override
GeoDataObjectparent ()
const GeoDataObjectparent () const
QString resolvePath (const QString &relativePath) const
void setId (const QString &value)
void setParent (GeoDataObject *parent)
void setTargetId (const QString &value)
QString targetId () const
void unpack (QDataStream &steam) override

Additional Inherited Members

- Protected Member Functions inherited from Marble::GeoDataGeometry
 GeoDataGeometry (const GeoDataGeometry &other)
 GeoDataGeometry (GeoDataGeometryPrivate *priv)
bool equals (const GeoDataGeometry &other) const
virtual bool equals (const GeoDataObject &other) const
GeoDataGeometryoperator= (const GeoDataGeometry &other)
- Protected Attributes inherited from Marble::GeoDataGeometry
GeoDataGeometryPrivate * d_ptr

Detailed Description

A geometry for tracking objects made of (time, coordinates) pairs.

GeoDataTrack implements the Track tag defined in Google's extension of the Open Geospatial Consortium standard KML 2.2 at .

A track is made of points, each point has a coordinates and a time value associated with the coordinates. New points can be added using the addPoint() method. The coordinates of the tracked object at a particular time can be found using coordinatesAt(), you can specify if interpolation should be used using the setInterpolate() function.

By default, a LineString that passes through every coordinates in the track is drawn. You can customize it by changing the GeoDataLineStyle, for example if the GeoDataTrack is the geometry of feature, you can disable the line drawing with:

feature->style()->lineStyle().setPenStyle( Qt::NoPen );

For convenience, the methods appendCoordinates() and appendWhen() are provided. They let you add points by specifying their coordinates and time value separately. When N calls to one of these methods are followed by N calls to the other, the first coordinates will be matched with the first time value, the second coordinates with the second time value, etc. This follows the way "coord" and "when" tags inside the Track tag should be parsed.

Definition at line 50 of file GeoDataTrack.h.

Constructor & Destructor Documentation

◆ GeoDataTrack() [1/2]

Marble::GeoDataTrack::GeoDataTrack ( )

Definition at line 52 of file GeoDataTrack.cpp.

◆ GeoDataTrack() [2/2]

Marble::GeoDataTrack::GeoDataTrack ( const GeoDataTrack & other)

Definition at line 58 of file GeoDataTrack.cpp.

Member Function Documentation

◆ addPoint()

void Marble::GeoDataTrack::addPoint ( const QDateTime & when,
const GeoDataCoordinates & coord )

Add a new point with coordinates coord associated with the time value when.

Definition at line 219 of file GeoDataTrack.cpp.

◆ appendAltitude()

void Marble::GeoDataTrack::appendAltitude ( qreal altitude)

Add altitude information to the last appended coordinates.

Definition at line 247 of file GeoDataTrack.cpp.

◆ appendCoordinates()

void Marble::GeoDataTrack::appendCoordinates ( const GeoDataCoordinates & coord)

Add the coordinates part for a new point.

See this class description for more information.

See also

Definition at line 237 of file GeoDataTrack.cpp.

◆ appendWhen()

void Marble::GeoDataTrack::appendWhen ( const QDateTime & when)

Add the time value part for a new point.

See this class description for more information.

See also

Definition at line 262 of file GeoDataTrack.cpp.

◆ clear()

void Marble::GeoDataTrack::clear ( )

Remove all the points contained in the track.

Definition at line 270 of file GeoDataTrack.cpp.

◆ coordinatesAt() [1/2]

GeoDataCoordinates Marble::GeoDataTrack::coordinatesAt ( const QDateTime & when) const

If interpolate() is true, return the coordinates interpolated from the time values before and after when, otherwise return the coordinates of the point with the closest time value less than or equal to when.

See also

Definition at line 158 of file GeoDataTrack.cpp.

◆ coordinatesAt() [2/2]

GeoDataCoordinates Marble::GeoDataTrack::coordinatesAt ( int index) const

Return coordinates at specified index.

This is useful when the track contains coordinates without time information.

Definition at line 213 of file GeoDataTrack.cpp.

◆ coordinatesList()

QVector< GeoDataCoordinates > Marble::GeoDataTrack::coordinatesList ( ) const

Returns the coordinates of all the points in the map, sorted by their time value.

Definition at line 146 of file GeoDataTrack.cpp.

◆ copy()

GeoDataGeometry * Marble::GeoDataTrack::copy ( ) const

Implements Marble::GeoDataGeometry.

Definition at line 81 of file GeoDataTrack.cpp.

◆ extendedData() [1/2]

GeoDataExtendedData & Marble::GeoDataTrack::extendedData ( )

Definition at line 324 of file GeoDataTrack.cpp.

◆ extendedData() [2/2]

const GeoDataExtendedData & Marble::GeoDataTrack::extendedData ( ) const

Return the ExtendedData assigned to the feature.

Definition at line 332 of file GeoDataTrack.cpp.

◆ firstWhen()

QDateTime Marble::GeoDataTrack::firstWhen ( ) const

Return the time value of the first point in the track, or an invalid QDateTime if the track is empty.

Definition at line 124 of file GeoDataTrack.cpp.

◆ geometryId()

EnumGeometryId Marble::GeoDataTrack::geometryId ( ) const

Implements Marble::GeoDataGeometry.

Definition at line 76 of file GeoDataTrack.cpp.

◆ interpolate()

bool Marble::GeoDataTrack::interpolate ( ) const

Returns true if coordinatesAt() should use interpolation, false otherwise.

The default is false.

See also
setInterpolate, coordinatesAt

Definition at line 110 of file GeoDataTrack.cpp.

◆ lastWhen()

QDateTime Marble::GeoDataTrack::lastWhen ( ) const

Return the time value of the last point in the track, or an invalid QDateTime if the track is empty.

Definition at line 135 of file GeoDataTrack.cpp.

◆ latLonAltBox()

const GeoDataLatLonAltBox & Marble::GeoDataTrack::latLonAltBox ( ) const

Reimplemented from Marble::GeoDataGeometry.

Definition at line 346 of file GeoDataTrack.cpp.

◆ lineString()

const GeoDataLineString * Marble::GeoDataTrack::lineString ( ) const

Return the GeoDataLineString representing the current track.

Definition at line 313 of file GeoDataTrack.cpp.

◆ nodeType()

const char * Marble::GeoDataTrack::nodeType ( ) const

Provides type information for downcasting a GeoNode.

Implements Marble::GeoNode.

Definition at line 71 of file GeoDataTrack.cpp.

◆ operator!=()

bool Marble::GeoDataTrack::operator!= ( const GeoDataTrack & other) const

Definition at line 99 of file GeoDataTrack.cpp.

◆ operator=()

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

Definition at line 64 of file GeoDataTrack.cpp.

◆ operator==()

bool Marble::GeoDataTrack::operator== ( const GeoDataTrack & other) const

: Equality operators.

Definition at line 87 of file GeoDataTrack.cpp.

◆ pack()

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

Definition at line 352 of file GeoDataTrack.cpp.

◆ removeAfter()

void Marble::GeoDataTrack::removeAfter ( const QDateTime & when)

Remove all points from the track whose time value is greater than when.

Definition at line 297 of file GeoDataTrack.cpp.

◆ removeBefore()

void Marble::GeoDataTrack::removeBefore ( const QDateTime & when)

Remove all points from the track whose time value is less than when.

Definition at line 280 of file GeoDataTrack.cpp.

◆ setExtendedData()

void Marble::GeoDataTrack::setExtendedData ( const GeoDataExtendedData & extendedData)

Sets the ExtendedData of the feature.

extendedDatathe new ExtendedData to be used.

Definition at line 338 of file GeoDataTrack.cpp.

◆ setInterpolate()

void Marble::GeoDataTrack::setInterpolate ( bool on)

Set whether coordinatesAt() should use interpolation.

See also
interpolate, coordinatesAt

Definition at line 116 of file GeoDataTrack.cpp.

◆ size()

int Marble::GeoDataTrack::size ( ) const

Returns the number of points in the track.

Definition at line 104 of file GeoDataTrack.cpp.

◆ unpack()

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

Definition at line 357 of file GeoDataTrack.cpp.

◆ whenList()

QVector< QDateTime > Marble::GeoDataTrack::whenList ( ) const

Returns the time value of all the points in the map, in chronological order.


Definition at line 152 of file GeoDataTrack.cpp.

The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Jun 14 2024 11:54:17 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.