Interface for Objects responsible for the route creations. More...

Inheritance diagram for VgMyRouteCreator:

Public Types
enum	RoutePoint { eStart, eStop0, eStop1, eStop2, eStop3, eStop4, eStop5, eStopMax = 7, eEnd }
	The points that a route may have. More...

Public Member Functions
virtual bool	setRoutePoint (RoutePoint pPoint, const std::string &pPlaceID)=0
	Sets a RoutePoint to a specific place. More...

virtual bool	setRoutePoint (RoutePoint pPoint, const VgEngine::VgPosition &pPosition)=0
	Sets a RoutePoint to a position within the map. More...

virtual void	resetRoutePoint (RoutePoint pPoint)=0
	Resets the place ID associated with a point. More...

virtual bool	isRoutePointSet (RoutePoint pPoint)=0

virtual void	computeRoute ()=0
	Computes a route. More...

virtual VgRoutingModule::VgIRouteRequestParameters *	editRoutingRequestParameters ()=0
	Returns a reference to the routing request parameters that computeRoute uses. More...

virtual void	resetRoutingRequestParameters ()=0
	Resets the routing request parameters to their initial state. More...

virtual VgRoutingModule::VgIRoutingNodeParameters *	editRoutingNodeParameters ()=0
	Returns a reference to the routing node parameters that getRoutingNode for a position uses. More...

virtual void	resetRoutingNodeParameters ()=0
	Resets the routing node parameters to their initial state. More...

virtual VgEngine::VgRefPtr < VgEngine::VgAnimationDescriptor >	getRoutePointHighlightAnimationDescriptor ()=0
	Returns the descriptor of an animation intended to emphasize routing points. More...

virtual void	setAvoidStairs (bool pDisabledFriendly)=0
	Sets up the routing request parameters to include/exclude non disabled-friendly attributes. More...

virtual void	setRouteStyle (VgMyRouteStyler::RouteStyle pRouteStyle, bool pRecomputeRoute=true)=0
	Change the routing style of lines generated by the routing helper. More...

virtual VgMyRouteStyler::RouteStyle	getRouteStyle () const =0
	get the current route style More...

virtual void	setRouteWidth (float pWidth)=0
	Determines the width of the created route. More...

virtual float	getRouteWidth ()=0
	Returns the current width of the created route. More...

virtual void	setRouteMarkerHeight (float pHeight)=0
	Set route marker height. More...

Detailed Description

Interface for Objects responsible for the route creations.

These methods are called if the VgMyRouteCreator sub-class has been registered with the setRouteCreator() method within VgMyBasicApplicationController.

Examples:: /Users/hbriceno/src/visioglobe/mobile/Projects/SDK/VisioDevKit/samples/navigationModule/Inc/Apple/VgMyViewController.h.

Member Enumeration Documentation

enum VgMyRouteCreator::RoutePoint

The points that a route may have.

Enumerator
eStart	Route start point.
eStop0
eStop1
eStop2
eStop3
eStop4
eStop5
eStopMax
eEnd	Route end point.

Member Function Documentation

virtual void VgMyRouteCreator::computeRoute ( )

pure virtual

Computes a route.

Remarks: Works only if both end points are set.; Calling this method often will result in poor performance of the map.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual VgRoutingModule::VgIRoutingNodeParameters* VgMyRouteCreator::editRoutingNodeParameters ( )

pure virtual

Returns a reference to the routing node parameters that getRoutingNode for a position uses.

Used for special configurations, for example you may want to use eRoutingNodeOptionsOnEdge and exclude the modality "shuttle" on edges.

Returns: a reference to the routing node parameters to be used on the next getRoutingNode for a position.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual VgRoutingModule::VgIRouteRequestParameters* VgMyRouteCreator::editRoutingRequestParameters ( )

pure virtual

Returns a reference to the routing request parameters that computeRoute uses.

Returns: a reference to the routing request parameters to be used on the next computeRoute.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual VgEngine::VgRefPtr< VgEngine::VgAnimationDescriptor > VgMyRouteCreator::getRoutePointHighlightAnimationDescriptor ( )

pure virtual

Returns the descriptor of an animation intended to emphasize routing points.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual VgMyRouteStyler::RouteStyle VgMyRouteCreator::getRouteStyle ( ) const

pure virtual

get the current route style

Returns: current route style.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual float VgMyRouteCreator::getRouteWidth ( )

pure virtual

Returns the current width of the created route.

Returns: The current width in meters

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual bool VgMyRouteCreator::isRoutePointSet ( RoutePoint pPoint )

pure virtual

Parameters

pPoint RoutePoint to test.

Returns: True if the specified point is already set.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::resetRoutePoint ( RoutePoint pPoint )

pure virtual

Resets the place ID associated with a point.

Parameters

pPoint RoutePoint to reset.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::resetRoutingNodeParameters ( )

pure virtual

Resets the routing node parameters to their initial state.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::resetRoutingRequestParameters ( )

pure virtual

Resets the routing request parameters to their initial state.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::setAvoidStairs ( bool pDisabledFriendly )

pure virtual

Sets up the routing request parameters to include/exclude non disabled-friendly attributes.

Parameters

pDisabledFriendly True if disabled friendly routing is wanted, false if not

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::setRouteMarkerHeight ( float pHeight )

pure virtual

Set route marker height.

Adjust so that the marker appears to be anchored to the top of desired surface.

Parameters

pHeight The height of the route markers in meters.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual bool VgMyRouteCreator::setRoutePoint	(	RoutePoint	pPoint,
		const std::string &	pPlaceID
	)

pure virtual

Sets a RoutePoint to a specific place.

Parameters

pPoint	RoutePoint to set
pPlaceID	Place to associates with pPoint.

Returns: False if the specified placeID is not routable.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual bool VgMyRouteCreator::setRoutePoint	(	RoutePoint	pPoint,
		const VgEngine::VgPosition &	pPosition
	)

pure virtual

Sets a RoutePoint to a position within the map.

Finds the closest routing node from the routing network to the given position.

pPosition.getMZOrAltitude() is used to determine what layer the position is associated to.
Use the method VgMapModule::VgIMapModule::getHeightRangeForLayer() to find the appropriate altitude value for pPosition. For example:
...

double lFloorHeight = 0.0;

float pHeightMax;

float pHeightMin;

std::sring lLayerName = "0";

if ( mMapModule->getHeightRangeForLayer(pLayer, pHeightMax, pHeightMin))

{

lFloorHeight = ((pHeightMax + pHeightMin) / 2);

}

lPosition.mZOrAltitude = lFloorHeight;

...

Parameters

pPoint RoutePoint to set

pPosition Position to associates with pPoint.

Returns
False if the pPosition is not routable.

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::setRouteStyle	(	VgMyRouteStyler::RouteStyle	pRouteStyle,
		bool	pRecomputeRoute = `true`
	)

pure virtual

Change the routing style of lines generated by the routing helper.

Parameters

pRouteStyle	route style
pRecomputeRoute

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

virtual void VgMyRouteCreator::setRouteWidth ( float pWidth )

pure virtual

Determines the width of the created route.

Parameters

pWidth The width of the route in meters

Implemented in VgMyBasicApplicationController, and VgMyRoutingHelper.

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

VgMyRouteCreator.h

pPoint	RoutePoint to set
pPosition	Position to associates with pPoint.

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

Member Function Documentation