Inheritance diagram for dashboard_pi:

Public Member Functions
	dashboard_pi (void *ppimgr)

int	Init (void)
	Initialize the plugin and declare its capabilities.

bool	DeInit (void)
	Clean up plugin resources.

void	Notify ()

int	GetAPIVersionMajor ()
	Returns the major version number of the plugin API that this plugin supports.

int	GetAPIVersionMinor ()
	Returns the minor version number of the plugin API that this plugin supports.

int	GetPlugInVersionMajor ()
	Returns the major version number of the plugin itself.

int	GetPlugInVersionMinor ()
	Returns the minor version number of the plugin itself.

wxBitmap *	GetPlugInBitmap ()
	Get the plugin's icon bitmap.

wxString	GetCommonName ()
	Get the plugin's common (short) name.

wxString	GetShortDescription ()
	Get a brief description of the plugin.

wxString	GetLongDescription ()
	Get detailed plugin information.

void	SetNMEASentence (wxString &sentence)
	Receive all NMEA 0183 sentences from OpenCPN.

void	SetPositionFixEx (PlugIn_Position_Fix_Ex &pfix)
	Updates plugin with extended position fix data.

void	SetCursorLatLon (double lat, double lon)
	Receives cursor lat/lon position updates.

int	GetToolbarToolCount (void)
	Returns the number of toolbar tools this plugin provides.

void	OnToolbarToolCallback (int id)
	Handles toolbar tool clicks.

void	ShowPreferencesDialog (wxWindow *parent)
	Shows the plugin preferences dialog.

void	SetColorScheme (PI_ColorScheme cs)
	Updates plugin color scheme.

void	OnPaneClose (wxAuiManagerEvent &event)

void	UpdateAuiStatus (void)
	Updates AUI manager status.

bool	SaveConfig (void)

void	PopulateContextMenu (wxMenu *menu)

void	ShowDashboard (size_t id, bool visible)

int	GetToolbarItemId ()

int	GetDashboardWindowShownCount ()

void	SetPluginMessage (wxString &message_id, wxString &message_body)

Detailed Description

Definition at line 209 of file dashboard_pi.h.

Constructor & Destructor Documentation

◆ dashboard_pi()

dashboard_pi::dashboard_pi ( void * ppimgr )

Definition at line 488 of file dashboard_pi.cpp.

◆ ~dashboard_pi()

dashboard_pi::~dashboard_pi ( void )

Definition at line 495 of file dashboard_pi.cpp.

Member Function Documentation

◆ DeInit()

bool dashboard_pi::DeInit ( void )

virtual

Clean up plugin resources.

This required method is called by OpenCPN during plugin unloading or program shutdown. It should release any resources allocated by the plugin.

Returns: True if cleanup successful, False if error

Reimplemented from opencpn_plugin.

Definition at line 698 of file dashboard_pi.cpp.

◆ GetAPIVersionMajor()

int dashboard_pi::GetAPIVersionMajor ( )

virtual

Returns the major version number of the plugin API that this plugin supports.

This method must be implemented by all plugins to declare compatibility with a specific major version of the OpenCPN plugin API.

Returns: Integer value representing the major API version (e.g., 1)

Note: Major version changes indicate incompatible API changes; Current API major version is defined by API_VERSION_MAJOR

Reimplemented from opencpn_plugin.

Definition at line 940 of file dashboard_pi.cpp.

◆ GetAPIVersionMinor()

int dashboard_pi::GetAPIVersionMinor ( )

virtual

Returns the minor version number of the plugin API that this plugin supports.

This method must be implemented by all plugins to declare compatibility with a specific minor version of the OpenCPN plugin API.

Returns: Integer value representing the minor API version (e.g., 19)

Note: Minor version changes indicate backward-compatible API additions; Current API minor version is defined by API_VERSION_MINOR

Reimplemented from opencpn_plugin.

Definition at line 942 of file dashboard_pi.cpp.

◆ GetCommonName()

wxString dashboard_pi::GetCommonName ( )

virtual

Get the plugin's common (short) name.

This required method should return a short name used to identify the plugin in lists and menus.

Returns: wxString containing plugin name (e.g., "Dashboard")

Note: Should be valid and meaningful even before Init() is called; Used by the plugin manager GUI

Reimplemented from opencpn_plugin.

Definition at line 950 of file dashboard_pi.cpp.

◆ GetDashboardWindowShownCount()

int dashboard_pi::GetDashboardWindowShownCount ( )

Definition at line 3325 of file dashboard_pi.cpp.

◆ GetLongDescription()

wxString dashboard_pi::GetLongDescription ( )

virtual

Get detailed plugin information.

This required method should return a longer description including:

Detailed feature list
Version information
Author/copyright details

Returns: wxString containing detailed plugin information

Note: Should be valid before Init() is called; Used in plugin manager details view

Reimplemented from opencpn_plugin.

Definition at line 956 of file dashboard_pi.cpp.

◆ GetPlugInBitmap()

wxBitmap * dashboard_pi::GetPlugInBitmap ( )

virtual

Get the plugin's icon bitmap.

FIXME static wxBitmap* LoadSVG(const wxString filename, unsigned int width, unsigned int height) { if (!gFrame) return new wxBitmap(width, height); // We are headless.

This method should return a wxBitmap containing the plugin's icon for display in the plugin manager and other UI elements.

Returns: Pointer to wxBitmap containing icon, NULL for default icon

Note: The bitmap should be square, typically 32x32 pixels; Ownership of the bitmap remains with the plugin; Icon should be visible on both light and dark backgrounds

#ifdef ANDROID return loadAndroidSVG(filename, width, height); #elif defined(ocpnUSE_SVG) wxSVGDocument svgDoc; if (svgDoc.Load(filename)) return new wxBitmap(svgDoc.Render(width, height, NULL, true, true)); else return new wxBitmap(width, height); #else return new wxBitmap(width, height); #endif }

wxBitmap* opencpn_plugin::GetPlugInBitmap() { auto bitmap = PluginLoader::GetInstance()->GetPluginDefaultIcon(); return const_cast<wxBitmap*>(bitmap); }

Reimplemented from opencpn_plugin.

Definition at line 948 of file dashboard_pi.cpp.

◆ GetPlugInVersionMajor()

int dashboard_pi::GetPlugInVersionMajor ( )

virtual

Returns the major version number of the plugin itself.

This method should return the plugin's own major version number, which is used by OpenCPN for plugin version management and display.

Returns: Integer value representing the plugin's major version

Note: Part of semantic version (major.minor.patch); Major version changes indicate incompatible API changes

Reimplemented from opencpn_plugin.

Definition at line 944 of file dashboard_pi.cpp.

◆ GetPlugInVersionMinor()

int dashboard_pi::GetPlugInVersionMinor ( )

virtual

Returns the minor version number of the plugin itself.

This method should return the plugin's own minor version number, which is used by OpenCPN for plugin version management and display.

Returns: Integer value representing the plugin's minor version

Note: Part of semantic version (major.minor.patch); Minor version changes indicate backward-compatible feature additions

Reimplemented from opencpn_plugin.

Definition at line 946 of file dashboard_pi.cpp.

◆ GetShortDescription()

wxString dashboard_pi::GetShortDescription ( )

virtual

Get a brief description of the plugin.

This required method should return a short description (1-2 sentences) explaining the plugin's basic functionality.

Returns: wxString containing brief description

Note: Should be valid before Init() is called; Used in plugin manager list view

Reimplemented from opencpn_plugin.

Definition at line 952 of file dashboard_pi.cpp.

◆ GetToolbarItemId()

int dashboard_pi::GetToolbarItemId ( )

inline

Definition at line 242 of file dashboard_pi.h.

◆ GetToolbarToolCount()

int dashboard_pi::GetToolbarToolCount ( void )

virtual

Returns the number of toolbar tools this plugin provides.

This method should return how many toolbar buttons/tools the plugin will add. Must be implemented if plugin sets INSTALLS_TOOLBAR_TOOL capability flag.

Returns: Number of toolbar items to be added

Note: Return 0 if no toolbar items; Each tool needs unique ID for callbacks; Called during plugin initialization

Reimplemented from opencpn_plugin.

Definition at line 3243 of file dashboard_pi.cpp.

◆ Init()

int dashboard_pi::Init ( void )

virtual

Initialize the plugin and declare its capabilities.

This required method is called by OpenCPN during plugin loading. It should:

Set up any required plugin resources
Register capabilities by returning a bitwise OR of WANTS_ and INSTALLS_ flags

Returns

Integer capability flags indicating plugin features:

WANTS_OVERLAY_CALLBACK
WANTS_CURSOR_LATLON
WANTS_TOOLBAR_CALLBACK
etc. (see enum definitions)

Reimplemented from opencpn_plugin.

Definition at line 504 of file dashboard_pi.cpp.

◆ Notify()

void dashboard_pi::Notify ( )

Definition at line 740 of file dashboard_pi.cpp.

◆ OnPaneClose()

void dashboard_pi::OnPaneClose ( wxAuiManagerEvent & event )

Definition at line 3339 of file dashboard_pi.cpp.

◆ OnToolbarToolCallback()

void dashboard_pi::OnToolbarToolCallback ( int id )

virtual

Handles toolbar tool clicks.

Called when the user clicks a plugin's toolbar button. Must be implemented if plugin declares WANTS_TOOLBAR_CALLBACK capability.

Parameters

id	The tool ID assigned when tool was added via InsertPlugInTool()

Reimplemented from opencpn_plugin.

Definition at line 3361 of file dashboard_pi.cpp.

◆ PopulateContextMenu()

void dashboard_pi::PopulateContextMenu ( wxMenu * menu )

Definition at line 4068 of file dashboard_pi.cpp.

◆ SaveConfig()

bool dashboard_pi::SaveConfig ( void )

Definition at line 3797 of file dashboard_pi.cpp.

◆ SetColorScheme()

void dashboard_pi::SetColorScheme ( PI_ColorScheme cs )

virtual

Updates plugin color scheme.

Called when OpenCPN's color scheme changes between day, dusk and night modes. Plugins should update their UI colors to match the new scheme.

Parameters

cs	New color scheme to use: PI_GLOBAL_COLOR_SCHEME_DAY PI_GLOBAL_COLOR_SCHEME_DUSK PI_GLOBAL_COLOR_SCHEME_NIGHT

Reimplemented from opencpn_plugin.

Definition at line 3316 of file dashboard_pi.cpp.

◆ SetCursorLatLon()

void dashboard_pi::SetCursorLatLon	(	double	lat,
		double	lon
	)

virtual

Receives cursor lat/lon position updates.

This method is called when the cursor moves over the chart. Must be implemented if plugin sets WANTS_CURSOR_LATLON flag.

Parameters

lat	Cursor latitude in decimal degrees
lon	Cursor longitude in decimal degrees

Note: High frequency updates - keep processing quick; Only called when cursor over chart window

Reimplemented from opencpn_plugin.

Definition at line 3206 of file dashboard_pi.cpp.

◆ SetNMEASentence()

void dashboard_pi::SetNMEASentence ( wxString & sentence )

virtual

Receive all NMEA 0183 sentences from OpenCPN.

Plugins can implement this method to receive all NMEA 0183 sentences. They must set the WANTS_NMEA_SENTENCES capability flag to receive updates.

Parameters

sentence The NMEA 0183 sentence

Note: For handling NMEA/SignalK messages, a newer recommended message API is available: Plugin Message API Documentation

Reimplemented from opencpn_plugin.

Definition at line 1000 of file dashboard_pi.cpp.

◆ SetPluginMessage()

void dashboard_pi::SetPluginMessage	(	wxString &	message_id,
		wxString &	message_body
	)

virtual

Reimplemented from opencpn_plugin_18.

Definition at line 3211 of file dashboard_pi.cpp.

◆ SetPositionFixEx()

void dashboard_pi::SetPositionFixEx ( PlugIn_Position_Fix_Ex & pfix )

virtual

Updates plugin with extended position fix data.

Called by OpenCPN when a new position fix with heading data is received. Extends SetPositionFix() by adding true heading information.

Parameters

pfix	Extended position fix data containing: All basic position fix fields from SetPositionFix() Hdm: Magnetic heading in degrees Hdt: True heading in degrees

Note: Only called if plugin declares WANTS_NMEA_EVENTS capability; HDT/HDM sentences must be available for heading data

Reimplemented from opencpn_plugin_18.

Definition at line 3131 of file dashboard_pi.cpp.

◆ ShowDashboard()

void dashboard_pi::ShowDashboard	(	size_t	id,
		bool	visible
	)

Definition at line 4083 of file dashboard_pi.cpp.

◆ ShowPreferencesDialog()

void dashboard_pi::ShowPreferencesDialog ( wxWindow * parent )

virtual

Shows the plugin preferences dialog.

This method is called when the user requests the plugin preferences through the OpenCPN options dialog. Must be implemented if plugin sets WANTS_PREFERENCES flag.

Parameters

parent Parent window to use for dialog

Note: Different from toolbox panel preferences; Use for simple plugin-specific settings; Modal dialog recommended

Reimplemented from opencpn_plugin.

Definition at line 3245 of file dashboard_pi.cpp.

◆ UpdateAuiStatus()

void dashboard_pi::UpdateAuiStatus ( void )

virtual

Updates AUI manager status.

Called to notify plugins using wxAUI interface that they should update their AUI managed windows and panes. Must be implemented if plugin declares USES_AUI_MANAGER capability.

Reimplemented from opencpn_plugin.

Definition at line 3449 of file dashboard_pi.cpp.

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

/home/runner/work/main/main/opencpn/plugins/dashboard_pi/src/dashboard_pi.h
/home/runner/work/main/main/opencpn/plugins/dashboard_pi/src/dashboard_pi.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ dashboard_pi()

◆ ~dashboard_pi()

Member Function Documentation

◆ DeInit()

◆ GetAPIVersionMajor()

◆ GetAPIVersionMinor()

◆ GetCommonName()

◆ GetDashboardWindowShownCount()

◆ GetLongDescription()

◆ GetPlugInBitmap()

◆ GetPlugInVersionMajor()

◆ GetPlugInVersionMinor()

◆ GetShortDescription()

◆ GetToolbarItemId()

◆ GetToolbarToolCount()

◆ Init()

◆ Notify()

◆ OnPaneClose()

◆ OnToolbarToolCallback()

◆ PopulateContextMenu()

◆ SaveConfig()

◆ SetColorScheme()

◆ SetCursorLatLon()

◆ SetNMEASentence()

◆ SetPluginMessage()

◆ SetPositionFixEx()

◆ ShowDashboard()

◆ ShowPreferencesDialog()

◆ UpdateAuiStatus()