Public Member Functions
	Routeman (struct RoutePropDlgCtx prop_dlg_ctx, struct RoutemanDlgCtx route_dlg_ctx)

bool	DeleteTrack (Track *pTrack)

bool	DeleteRoute (Route *pRoute)

void	DeleteAllRoutes ()

bool	IsRouteValid (Route *pRoute)

Route *	FindRouteByGUID (const wxString &guid)

Track *	FindTrackByGUID (const wxString &guid)

Route *	FindRouteContainingWaypoint (RoutePoint *pWP)

Route *	FindRouteContainingWaypoint (const std::string &guid)

Route *	FindVisibleRouteContainingWaypoint (RoutePoint *pWP)

wxArrayPtrVoid *	GetRouteArrayContaining (RoutePoint *pWP)
	Find all routes that contain the given waypoint.

bool	DoesRouteContainSharedPoints (Route *pRoute)

void	RemovePointFromRoute (RoutePoint point, Route route, int route_state)

bool	ActivateRoute (Route pRouteToActivate, RoutePoint pStartPoint=NULL)
	Activates a route for navigation.

bool	ActivateRoutePoint (Route pA, RoutePoint pRP)
	Activates a specific waypoint within a route for navigation.

bool	ActivateNextPoint (Route *pr, bool skipped)
	Activates the next waypoint in a route when the current waypoint is reached.

RoutePoint *	FindBestActivatePoint (Route *pR, double lat, double lon, double cog, double sog)

bool	UpdateAutopilot ()

bool	DeactivateRoute (bool b_arrival=false)

bool	IsAnyRouteActive (void)

bool	GetArrival ()

Route *	GetpActiveRoute ()

RoutePoint *	GetpActiveRouteSegmentBeginPoint ()

RoutePoint *	GetpActivePoint ()

double	GetCurrentRngToActivePoint ()

double	GetCurrentBrgToActivePoint ()

double	GetCurrentRngToActiveNormalArrival ()

double	GetCurrentXTEToActivePoint ()

void	ZeroCurrentXTEToActivePoint ()

double	GetCurrentSegmentCourse ()

int	GetXTEDir ()

void	SetColorScheme (ColorScheme cs, double displayDPmm)

wxPen *	GetRoutePen (void)

wxPen *	GetTrackPen (void)

wxPen *	GetSelectedRoutePen (void)

wxPen *	GetActiveRoutePen (void)

wxPen *	GetActiveRoutePointPen (void)

wxPen *	GetRoutePointPen (void)

wxBrush *	GetRouteBrush (void)

wxBrush *	GetSelectedRouteBrush (void)

wxBrush *	GetActiveRouteBrush (void)

wxBrush *	GetActiveRoutePointBrush (void)

wxBrush *	GetRoutePointBrush (void)

wxString	GetRouteReverseMessage (void)

wxString	GetRouteResequenceMessage (void)

struct RoutemanDlgCtx &	GetDlgContext ()

NMEA0183	GetNMEA0183 ()

EventVar &	GetMessageSentEventVar ()

std::vector< DriverHandle >	GetOutpuDriverArray ()

Public Attributes
bool	m_bDataValid

EventVar	json_msg
	Notified with message targeting all plugins.

EventVar	json_leg_info
	Notified with a shared_ptr<ActiveLegDat>, leg info to all plugins.

EventVar	on_message_sent
	Notified when a message available as GetString() is sent to garmin.

EventVar	on_routes_update
	Notified when list of routes is updated (no data in event)

Friends
class	RoutemanGui

Detailed Description

Definition at line 115 of file routeman.h.

Constructor & Destructor Documentation

◆ Routeman()

Routeman::Routeman	(	struct RoutePropDlgCtx	prop_dlg_ctx,
		struct RoutemanDlgCtx	route_dlg_ctx
	)

Definition at line 108 of file routeman.cpp.

◆ ~Routeman()

Routeman::~Routeman ( )

Definition at line 123 of file routeman.cpp.

Member Function Documentation

◆ ActivateNextPoint()

bool Routeman::ActivateNextPoint	(	Route *	pr,
		bool	skipped
	)

Activates the next waypoint in a route when the current waypoint is reached.

This function handles the transition between waypoints by:

Deactivating the current waypoint
Sending arrival notifications to plugins
Finding and activating the next waypoint in sequence
Setting up visual indicators for the new active waypoint
Resetting arrival detection parameters

This function is called automatically when a waypoint arrival is detected, or manually when skipping a waypoint.

Parameters

pr	Pointer to the active route
skipped	Boolean indicating if this is a manual skip (true) or normal arrival (false)

Returns: true if successfully activated the next waypoint, false if at the end of the route

if (pRoutePropDialog && pRoutePropDialog->IsShown()) { if (pRoutePropDialog->GetRoute() == pr) { pRoutePropDialog->SetEnroutePoint(pActivePoint); } }

Definition at line 413 of file routeman.cpp.

◆ ActivateRoute()

bool Routeman::ActivateRoute	(	Route *	pRouteToActivate,
		RoutePoint *	pStartPoint = `NULL`
	)

Activates a route for navigation.

This function sets up a route for active navigation by:

Setting up the route for plugin notifications
Configuring output drivers for navigation data
Creating a "virtual" waypoint at the vessel's current position if starting at the beginning of the route
Activating the first/selected waypoint as the active navigation target
Initializing arrival detection parameters

When a route is activated, OpenCPN starts providing navigation data to autopilot systems and plugins, updating the display to show the active route, and monitoring for waypoint arrivals.

Parameters

pRouteToActivate	Pointer to the Route object to activate
pStartPoint	Optional pointer to a specific RoutePoint to start from (if NULL, starts from the first point in the route)

Returns: true if route was successfully activated

Definition at line 279 of file routeman.cpp.

◆ ActivateRoutePoint()

bool Routeman::ActivateRoutePoint	(	Route *	pA,
		RoutePoint *	pRP
	)

Activates a specific waypoint within a route for navigation.

This function sets up navigation to a specific waypoint by:

Setting up waypoint plugin notifications
Establishing the active waypoint and its preceding segment
Creating a "virtual" waypoint at the vessel's current position if this is the first point in the route
Setting up visual indicators (making the active point blink)
Initializing arrival detection parameters

This function is called by ActivateRoute() and is also used when manually changing the active waypoint during navigation.

Parameters

pA	Pointer to the route containing the waypoint
pRP_target	Pointer to the RoutePoint to set as the active target

Returns: true if waypoint was successfully activated

if (pRoutePropDialog && pRoutePropDialog->IsShown()) { if (pRoutePropDialog->GetRoute() == pA) { pRoutePropDialog->SetEnroutePoint(pActivePoint); } }

Definition at line 338 of file routeman.cpp.

◆ DeactivateRoute()

bool Routeman::DeactivateRoute ( bool b_arrival = false )

Definition at line 465 of file routeman.cpp.

◆ DeleteAllRoutes()

void Routeman::DeleteAllRoutes ( )

Definition at line 931 of file routeman.cpp.

◆ DeleteRoute()

bool Routeman::DeleteRoute ( Route * pRoute )

if (pRoutePropDialog && (pRoutePropDialog->IsShown()) && (pRoute == pRoutePropDialog->GetRoute())) { pRoutePropDialog->Hide(); }

Definition at line 856 of file routeman.cpp.

◆ DeleteTrack()

bool Routeman::DeleteTrack ( Track * pTrack )

Definition at line 823 of file routeman.cpp.

◆ DoesRouteContainSharedPoints()

bool Routeman::DoesRouteContainSharedPoints ( Route * pRoute )

Definition at line 785 of file routeman.cpp.

◆ FindBestActivatePoint()

RoutePoint * Routeman::FindBestActivatePoint	(	Route *	pR,
		double	lat,
		double	lon,
		double	cog,
		double	sog
	)

Definition at line 248 of file routeman.cpp.

◆ FindRouteByGUID()

Route * Routeman::FindRouteByGUID ( const wxString & guid )

Definition at line 1012 of file routeman.cpp.

◆ FindRouteContainingWaypoint() [1/2]

Route * Routeman::FindRouteContainingWaypoint ( const std::string & guid )

Definition at line 156 of file routeman.cpp.

◆ FindRouteContainingWaypoint() [2/2]

Route * Routeman::FindRouteContainingWaypoint ( RoutePoint * pWP )

Definition at line 137 of file routeman.cpp.

◆ FindTrackByGUID()

Track * Routeman::FindTrackByGUID ( const wxString & guid )

Definition at line 1024 of file routeman.cpp.

◆ FindVisibleRouteContainingWaypoint()

Route * Routeman::FindVisibleRouteContainingWaypoint ( RoutePoint * pWP )

Definition at line 175 of file routeman.cpp.

◆ GetActiveRouteBrush()

wxBrush * Routeman::GetActiveRouteBrush ( void )

inline

Definition at line 244 of file routeman.h.

◆ GetActiveRoutePen()

wxPen * Routeman::GetActiveRoutePen ( void )

inline

Definition at line 239 of file routeman.h.

◆ GetActiveRoutePointBrush()

wxBrush * Routeman::GetActiveRoutePointBrush ( void )

inline

Definition at line 245 of file routeman.h.

◆ GetActiveRoutePointPen()

wxPen * Routeman::GetActiveRoutePointPen ( void )

inline

Definition at line 240 of file routeman.h.

◆ GetArrival()

bool Routeman::GetArrival ( )

inline

Definition at line 217 of file routeman.h.

◆ GetCurrentBrgToActivePoint()

double Routeman::GetCurrentBrgToActivePoint ( )

inline

Definition at line 226 of file routeman.h.

◆ GetCurrentRngToActiveNormalArrival()

double Routeman::GetCurrentRngToActiveNormalArrival ( )

inline

Definition at line 227 of file routeman.h.

◆ GetCurrentRngToActivePoint()

double Routeman::GetCurrentRngToActivePoint ( )

inline

Definition at line 225 of file routeman.h.

◆ GetCurrentSegmentCourse()

double Routeman::GetCurrentSegmentCourse ( )

inline

Definition at line 232 of file routeman.h.

◆ GetCurrentXTEToActivePoint()

double Routeman::GetCurrentXTEToActivePoint ( )

inline

Definition at line 230 of file routeman.h.

◆ GetDlgContext()

struct RoutemanDlgCtx & Routeman::GetDlgContext ( )

inline

Definition at line 250 of file routeman.h.

◆ GetMessageSentEventVar()

EventVar & Routeman::GetMessageSentEventVar ( )

inline

Definition at line 252 of file routeman.h.

◆ GetNMEA0183()

NMEA0183 Routeman::GetNMEA0183 ( )

inline

Definition at line 251 of file routeman.h.

◆ GetOutpuDriverArray()

std::vector< DriverHandle > Routeman::GetOutpuDriverArray ( )

inline

Definition at line 253 of file routeman.h.

◆ GetpActivePoint()

RoutePoint * Routeman::GetpActivePoint ( )

inline

Definition at line 224 of file routeman.h.

◆ GetpActiveRoute()

Route * Routeman::GetpActiveRoute ( )

inline

Definition at line 219 of file routeman.h.

◆ GetpActiveRouteSegmentBeginPoint()

RoutePoint * Routeman::GetpActiveRouteSegmentBeginPoint ( )

inline

Definition at line 220 of file routeman.h.

◆ GetRouteArrayContaining()

wxArrayPtrVoid * Routeman::GetRouteArrayContaining ( RoutePoint * pWP )

Find all routes that contain the given waypoint.

This function searches through all routes in the route list and returns an array of route pointers for each route that contains the specified waypoint.

Parameters

pWP	Pointer to the waypoint to search for.

Returns: Pointer to wxArrayPtrVoid containing routes, or nullptr if no routes contain the waypoint. The caller is responsible for deleting the returned array when done with it.

Definition at line 194 of file routeman.cpp.

◆ GetRouteBrush()

wxBrush * Routeman::GetRouteBrush ( void )

inline

Definition at line 242 of file routeman.h.

◆ GetRoutePen()

wxPen * Routeman::GetRoutePen ( void )

inline

Definition at line 236 of file routeman.h.

◆ GetRoutePointBrush()

wxBrush * Routeman::GetRoutePointBrush ( void )

inline

Definition at line 246 of file routeman.h.

◆ GetRoutePointPen()

wxPen * Routeman::GetRoutePointPen ( void )

inline

Definition at line 241 of file routeman.h.

◆ GetRouteResequenceMessage()

wxString Routeman::GetRouteResequenceMessage ( void )

Definition at line 1006 of file routeman.cpp.

◆ GetRouteReverseMessage()

wxString Routeman::GetRouteReverseMessage ( void )

Definition at line 1000 of file routeman.cpp.

◆ GetSelectedRouteBrush()

wxBrush * Routeman::GetSelectedRouteBrush ( void )

inline

Definition at line 243 of file routeman.h.

◆ GetSelectedRoutePen()

wxPen * Routeman::GetSelectedRoutePen ( void )

inline

Definition at line 238 of file routeman.h.

◆ GetTrackPen()

wxPen * Routeman::GetTrackPen ( void )

inline

Definition at line 237 of file routeman.h.

◆ GetXTEDir()

int Routeman::GetXTEDir ( )

inline

Definition at line 233 of file routeman.h.

◆ IsAnyRouteActive()

bool Routeman::IsAnyRouteActive ( void )

inline

Definition at line 216 of file routeman.h.

◆ IsRouteValid()

bool Routeman::IsRouteValid ( Route * pRoute )

Definition at line 127 of file routeman.cpp.

◆ RemovePointFromRoute()

void Routeman::RemovePointFromRoute	(	RoutePoint *	point,
		Route *	route,
		int	route_state
	)

Definition at line 225 of file routeman.cpp.

◆ SetColorScheme()

void Routeman::SetColorScheme	(	ColorScheme	cs,
		double	displayDPmm
	)

Definition at line 955 of file routeman.cpp.

◆ UpdateAutopilot()

bool Routeman::UpdateAutopilot ( )

Definition at line 501 of file routeman.cpp.

◆ ZeroCurrentXTEToActivePoint()

void Routeman::ZeroCurrentXTEToActivePoint ( )

Definition at line 1032 of file routeman.cpp.

Friends And Related Symbol Documentation

◆ RoutemanGui

friend class RoutemanGui

friend

Definition at line 116 of file routeman.h.

Member Data Documentation

◆ json_leg_info

EventVar Routeman::json_leg_info

Notified with a shared_ptr<ActiveLegDat>, leg info to all plugins.

Definition at line 263 of file routeman.h.

◆ json_msg

EventVar Routeman::json_msg

Notified with message targeting all plugins.

Contains a message type string and a wxJSONValue shared_ptr.

Definition at line 260 of file routeman.h.

◆ m_bDataValid

bool Routeman::m_bDataValid

Definition at line 254 of file routeman.h.

◆ on_message_sent

EventVar Routeman::on_message_sent

Notified when a message available as GetString() is sent to garmin.

Definition at line 266 of file routeman.h.

◆ on_routes_update

EventVar Routeman::on_routes_update

Notified when list of routes is updated (no data in event)

Definition at line 269 of file routeman.h.

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

/home/runner/work/main/main/opencpn/model/include/model/routeman.h
/home/runner/work/main/main/opencpn/model/src/routeman.cpp

Public Member Functions

Public Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ Routeman()

◆ ~Routeman()

Member Function Documentation

◆ ActivateNextPoint()

◆ ActivateRoute()

◆ ActivateRoutePoint()

◆ DeactivateRoute()

◆ DeleteAllRoutes()

◆ DeleteRoute()

◆ DeleteTrack()

◆ DoesRouteContainSharedPoints()

◆ FindBestActivatePoint()

◆ FindRouteByGUID()

◆ FindRouteContainingWaypoint() [1/2]

◆ FindRouteContainingWaypoint() [2/2]

◆ FindTrackByGUID()

◆ FindVisibleRouteContainingWaypoint()

◆ GetActiveRouteBrush()

◆ GetActiveRoutePen()

◆ GetActiveRoutePointBrush()

◆ GetActiveRoutePointPen()

◆ GetArrival()

◆ GetCurrentBrgToActivePoint()

◆ GetCurrentRngToActiveNormalArrival()

◆ GetCurrentRngToActivePoint()

◆ GetCurrentSegmentCourse()

◆ GetCurrentXTEToActivePoint()

◆ GetDlgContext()

◆ GetMessageSentEventVar()

◆ GetNMEA0183()

◆ GetOutpuDriverArray()

◆ GetpActivePoint()

◆ GetpActiveRoute()

◆ GetpActiveRouteSegmentBeginPoint()

◆ GetRouteArrayContaining()

◆ GetRouteBrush()

◆ GetRoutePen()

◆ GetRoutePointBrush()

◆ GetRoutePointPen()

◆ GetRouteResequenceMessage()

◆ GetRouteReverseMessage()

◆ GetSelectedRouteBrush()

◆ GetSelectedRoutePen()

◆ GetTrackPen()

◆ GetXTEDir()

◆ IsAnyRouteActive()

◆ IsRouteValid()

◆ RemovePointFromRoute()

◆ SetColorScheme()

◆ UpdateAutopilot()

◆ ZeroCurrentXTEToActivePoint()

Friends And Related Symbol Documentation

◆ RoutemanGui

Member Data Documentation

◆ json_leg_info

◆ json_msg

◆ m_bDataValid

◆ on_message_sent

◆ on_routes_update