Inheritance diagram for chartdldr_pi:

Public Member Functions
	chartdldr_pi (void *ppimgr)

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

bool	DeInit (void)
	Clean up plugin resources.

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	OnSetupOptions (void)
	Allows plugin to add pages to global Options dialog.

void	OnCloseToolboxPanel (int page_sel, int ok_apply_cancel)
	Handles preference page closure.

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

bool	SaveConfig (void)

bool	ProcessFile (const wxString &aFile, const wxString &aTargetDir, bool aStripPath=true, wxDateTime aMTime=wxDateTime::Now())

bool	ExtractZipFiles (const wxString &aZipFile, const wxString &aTargetDir, bool aStripPath=true, wxDateTime aMTime=wxDateTime::Now(), bool aRemoveZip=false)

bool	ExtractUnarrFiles (const wxString &aRarFile, const wxString &aTargetDir, bool aStripPath=true, wxDateTime aMTime=wxDateTime::Now(), bool aRemoveRar=false)

void	UpdatePrefs (ChartDldrPrefsDlgImpl *dialog)

void	SetSourceId (int id)

int	GetSourceId ()

wxString	GetBaseChartDir ()

Public Member Functions inherited from opencpn_plugin_113
	opencpn_plugin_113 (void *pmgr)

virtual bool	KeyboardEventHook (wxKeyEvent &event)
	Handles keyboard events from main window.

virtual void	OnToolbarToolDownCallback (int id)
	Handles toolbar button press.

virtual void	OnToolbarToolUpCallback (int id)
	Handles toolbar button release.

Public Member Functions inherited from opencpn_plugin_112
	opencpn_plugin_112 (void *pmgr)

virtual bool	MouseEventHook (wxMouseEvent &event)
	Handles mouse events from chart window.

virtual void	SendVectorChartObjectInfo (wxString &chart, wxString &feature, wxString &objname, double lat, double lon, double scale, int nativescale)
	Receives vector chart object information.

Public Member Functions inherited from opencpn_plugin_111
	opencpn_plugin_111 (void *pmgr)

Public Member Functions inherited from opencpn_plugin_110
	opencpn_plugin_110 (void *pmgr)

virtual void	LateInit (void)

Public Member Functions inherited from opencpn_plugin_19
	opencpn_plugin_19 (void *pmgr)

Public Member Functions inherited from opencpn_plugin_18
	opencpn_plugin_18 (void *pmgr)

virtual bool	RenderOverlay (wxDC &dc, PlugIn_ViewPort *vp)

virtual bool	RenderGLOverlay (wxGLContext pcontext, PlugIn_ViewPort vp)
	Renders plugin overlay graphics in OpenGL mode.

virtual void	SetPluginMessage (wxString &message_id, wxString &message_body)

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

virtual bool	RenderOverlay (wxMemoryDC pmdc, PlugIn_ViewPort vp)
	Render plugin overlay graphics using standard device context.

Public Member Functions inherited from opencpn_plugin
	opencpn_plugin (void *pmgr)

virtual void	SetDefaults (void)
	Sets plugin default options.

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

virtual int	GetToolboxPanelCount (void)
	Returns the number of preference pages this plugin provides.

virtual void	SetupToolboxPanel (int page_sel, wxNotebook *pnotebook)
	Creates a plugin preferences page.

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

virtual void	SetCurrentViewPort (PlugIn_ViewPort &vp)
	Notifies plugin of viewport changes.

virtual void	SetPositionFix (PlugIn_Position_Fix &pfix)
	Updates plugin with current position fix data.

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

virtual void	SetAISSentence (wxString &sentence)
	Receive all AIS sentences from OpenCPN.

virtual void	ProcessParentResize (int x, int y)
	Handles parent window resize events.

virtual void	SetColorScheme (PI_ColorScheme cs)
	Updates plugin color scheme.

virtual void	OnToolbarToolCallback (int id)
	Handles toolbar tool clicks.

virtual void	OnContextMenuItemCallback (int id)
	Handles context menu item selection.

virtual void	UpdateAuiStatus (void)
	Updates AUI manager status.

virtual wxArrayString	GetDynamicChartClassNameArray (void)
	Returns array of dynamically loaded chart class names.

Public Attributes
std::vector< std::unique_ptr< ChartSource > >	m_ChartSources

wxWindow *	m_parent_window

ChartCatalog	m_pChartCatalog

ChartSource *	m_pChartSource

bool	m_preselect_new

bool	m_preselect_updated

bool	m_allow_bulk_update

Detailed Description

Definition at line 70 of file chartdldr_pi.h.

Constructor & Destructor Documentation

◆ chartdldr_pi()

chartdldr_pi::chartdldr_pi ( void * ppimgr )

Definition at line 162 of file chartdldr_pi.cpp.

Member Function Documentation

◆ DeInit()

bool chartdldr_pi::DeInit ( void )

virtual

Clean up plugin resources.

Called by OpenCPN when plugin is disabled. Shall release any resources allocated by the plugin. Good place to persist plugin configuration.

Returns: True if cleanup successful, False if error

Reimplemented from opencpn_plugin.

Definition at line 213 of file chartdldr_pi.cpp.

◆ ExtractUnarrFiles()

bool chartdldr_pi::ExtractUnarrFiles	(	const wxString &	aRarFile,
		const wxString &	aTargetDir,
		bool	aStripPath = `true`,
		wxDateTime	aMTime = `wxDateTime::Now()`,
		bool	aRemoveRar = `false`
	)

Definition at line 1907 of file chartdldr_pi.cpp.

◆ ExtractZipFiles()

bool chartdldr_pi::ExtractZipFiles	(	const wxString &	aZipFile,
		const wxString &	aTargetDir,
		bool	aStripPath = `true`,
		wxDateTime	aMTime = `wxDateTime::Now()`,
		bool	aRemoveZip = `false`
	)

Definition at line 1996 of file chartdldr_pi.cpp.

◆ GetAPIVersionMajor()

int chartdldr_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 231 of file chartdldr_pi.cpp.

◆ GetAPIVersionMinor()

int chartdldr_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 233 of file chartdldr_pi.cpp.

◆ GetBaseChartDir()

wxString chartdldr_pi::GetBaseChartDir ( )

inline

Definition at line 125 of file chartdldr_pi.h.

◆ GetCommonName()

wxString chartdldr_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 241 of file chartdldr_pi.cpp.

◆ GetLongDescription()

wxString chartdldr_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 247 of file chartdldr_pi.cpp.

◆ GetPlugInBitmap()

wxBitmap * chartdldr_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 239 of file chartdldr_pi.cpp.

◆ GetPlugInVersionMajor()

int chartdldr_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 235 of file chartdldr_pi.cpp.

◆ GetPlugInVersionMinor()

int chartdldr_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 237 of file chartdldr_pi.cpp.

◆ GetShortDescription()

wxString chartdldr_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 243 of file chartdldr_pi.cpp.

◆ GetSourceId()

int chartdldr_pi::GetSourceId ( )

inline

Definition at line 124 of file chartdldr_pi.h.

◆ Init()

int chartdldr_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 180 of file chartdldr_pi.cpp.

◆ OnCloseToolboxPanel()

void chartdldr_pi::OnCloseToolboxPanel	(	int	page_sel,
		int	ok_apply_cancel
	)

virtual

Handles preference page closure.

This method is called when plugin preference pages are closed. Use it to save settings changes or cleanup resources.

Parameters

page_sel	Index of page being closed
ok_apply_cancel	Result: 0 = OK (apply changes) 1 = APPLY (apply but don't close) 2 = CANCEL (discard changes) @Deprecated Does not invoke any action, will be removed.

Note: Only called if plugin implements SetupToolboxPanel(); Good place to save settings to config

Reimplemented from opencpn_plugin.

Definition at line 275 of file chartdldr_pi.cpp.

◆ OnSetupOptions()

void chartdldr_pi::OnSetupOptions ( void )

virtual

Allows plugin to add pages to global Options dialog.

Called during plugin loading step, after Init(). Plugin can add its own pages to the Options dialog.

Reimplemented from opencpn_plugin_19.

Definition at line 254 of file chartdldr_pi.cpp.

◆ ProcessFile()

bool chartdldr_pi::ProcessFile	(	const wxString &	aFile,
		const wxString &	aTargetDir,
		bool	aStripPath = `true`,
		wxDateTime	aMTime = `wxDateTime::Now()`
	)

Definition at line 1679 of file chartdldr_pi.cpp.

◆ SaveConfig()

bool chartdldr_pi::SaveConfig ( void )

Definition at line 318 of file chartdldr_pi.cpp.

◆ SetSourceId()

void chartdldr_pi::SetSourceId ( int id )

inline

Definition at line 123 of file chartdldr_pi.h.

◆ ShowPreferencesDialog()

void chartdldr_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 395 of file chartdldr_pi.cpp.

◆ UpdatePrefs()

void chartdldr_pi::UpdatePrefs ( ChartDldrPrefsDlgImpl * dialog )

Definition at line 425 of file chartdldr_pi.cpp.

Member Data Documentation

◆ m_allow_bulk_update

bool chartdldr_pi::m_allow_bulk_update

Definition at line 128 of file chartdldr_pi.h.

◆ m_ChartSources

std::vector<std::unique_ptr<ChartSource> > chartdldr_pi::m_ChartSources

Definition at line 119 of file chartdldr_pi.h.

◆ m_parent_window

wxWindow* chartdldr_pi::m_parent_window

Definition at line 120 of file chartdldr_pi.h.

◆ m_pChartCatalog

ChartCatalog chartdldr_pi::m_pChartCatalog

Definition at line 121 of file chartdldr_pi.h.

◆ m_pChartSource

ChartSource* chartdldr_pi::m_pChartSource

Definition at line 122 of file chartdldr_pi.h.

◆ m_preselect_new

bool chartdldr_pi::m_preselect_new

Definition at line 126 of file chartdldr_pi.h.

◆ m_preselect_updated

bool chartdldr_pi::m_preselect_updated

Definition at line 127 of file chartdldr_pi.h.

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

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

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ chartdldr_pi()

Member Function Documentation

◆ DeInit()

◆ ExtractUnarrFiles()

◆ ExtractZipFiles()

◆ GetAPIVersionMajor()

◆ GetAPIVersionMinor()

◆ GetBaseChartDir()

◆ GetCommonName()

◆ GetLongDescription()

◆ GetPlugInBitmap()

◆ GetPlugInVersionMajor()

◆ GetPlugInVersionMinor()

◆ GetShortDescription()

◆ GetSourceId()

◆ Init()

◆ OnCloseToolboxPanel()

◆ OnSetupOptions()

◆ ProcessFile()

◆ SaveConfig()

◆ SetSourceId()

◆ ShowPreferencesDialog()

◆ UpdatePrefs()

Member Data Documentation

◆ m_allow_bulk_update

◆ m_ChartSources

◆ m_parent_window

◆ m_pChartCatalog

◆ m_pChartSource

◆ m_preselect_new

◆ m_preselect_updated