Represents a collection of location points (ILocation). More...

#include <ITrack.h>

Inheritance diagram for Glympse::ITrack:

Public Member Functions
virtual int32	length ()=0
	A number of location points in main portion of a trail (returned by getLocations()).

virtual GList< GLocation >::ptr	getLocations ()=0
	Returns the list of location that make up the trail. More...

virtual GList< GLocation >::ptr	getNewLocations ()=0
	Returns new portion of the trail (pulled from server during latest sync). More...

virtual int32	getDistance ()=0
	Gets track distance in meters. More...

Public Member Functions inherited from Glympse::ICommon
virtual int32	retain ()=0
	Add a reference to our object in a COM-like way.

virtual int32	release ()=0
	Release a reference to our object in a COM-like way.

virtual int32	hold ()=0
	Add a reference to our object in a COM-like way.

virtual int32	unhold ()=0
	Release a reference to our object in a COM-like way.

virtual int32	hashCode ()=0
	Returns an integer hash code for this object.

virtual bool	equals (const GCommonObj &o)=0
	Compares this instance with the specified object and indicates if they are equal. More...

virtual GString	toString ()=0
	Returns a string containing a concise, human-readable description of this object. More...

virtual void	attachObject (const GCommon &obj)=0
	Asociates arbitrary object with the instance.

virtual GCommon	extractObject ()=0
	Extracts associated object or NULL if no association is established.

Additional Inherited Members
Protected Member Functions inherited from Glympse::ICommon
virtual	~ICommon ()
	Destructor is protected to deny explicit object deallocation. More...

Detailed Description

Represents a collection of location points (ILocation).

Notes to map control implementors:

Trail can be modified (and trimmed) by the library in unpredicteable way. Any part of it can be changed at any time.
The safest way to draw the trail is to use getLocations() method and update the whole trail during each drawing cycle.
It is stil possible to rely on updates (coming from getNewLocations()).
The entire trail needs to be redrawn, if getNewLocations() returns NULL or empty list while GE::TICKET_TRACK_CHANGED is being spread.

Member Function Documentation

virtual int32 Glympse::ITrack::getDistance ( )

pure virtual

Gets track distance in meters.

virtual GList<GLocation>::ptr Glympse::ITrack::getLocations ( )

pure virtual

Returns the list of location that make up the trail.

Returns: List object containint trail. The object cannot be NULL, but can be empty.

virtual GList<GLocation>::ptr Glympse::ITrack::getNewLocations ( )

pure virtual

Returns new portion of the trail (pulled from server during latest sync).

Returns: List object containing new portion of the trail. The object can be NULL.

The documentation for this struct was generated from the following file: