PGM_SINGLE_TOP Struct Reference

Struct PGM_SINGLE_TOP implements PGM_BASE with its own OnPgmInit() and OnPgmExit(). More...

Inheritance diagram for PGM_SINGLE_TOP:

Public Member Functions
bool	OnPgmInit ()
void	OnPgmExit ()
void	MacOpenFile (const wxString &aFileName) override
	Specific to MacOSX (not used under Linux or Windows). More...
virtual SETTINGS_MANAGER &	GetSettingsManager () const
virtual COMMON_SETTINGS *	GetCommonSettings () const
virtual void	SetTextEditor (const wxString &aFileName)
virtual const wxString &	GetTextEditor (bool aCanShowFileChooser=true)
	Return the path to the preferred text editor application. More...
virtual const wxString	AskUserForPreferredEditor (const wxString &aDefaultEditor=wxEmptyString)
	Shows a dialog that instructs the user to select a new preferred editor. More...
virtual bool	IsKicadEnvVariableDefined () const
virtual const wxString &	GetKicadEnvVariable () const
virtual const wxString &	GetExecutablePath () const
virtual wxLocale *	GetLocale ()
virtual const wxString &	GetPdfBrowserName () const
virtual void	SetPdfBrowserName (const wxString &aFileName)
virtual bool	UseSystemPdfBrowser () const
virtual void	ForceSystemPdfBrowser (bool aFlg)
	Force the use of system PDF browser, even if a preferred PDF browser is set. More...
virtual bool	SetLanguage (wxString &aErrMsg, bool first_time=false)
	Set the dictionary file name for internationalization. More...
bool	SetDefaultLanguage (wxString &aErrMsg)
	Set the default language without reference to any preferences. More...
virtual void	SetLanguageIdentifier (int menu_id)
	Set in .m_language_id member the wxWidgets language identifier ID from the KiCad menu id (internal menu identifier). More...
virtual int	GetSelectedLanguageIdentifier () const
virtual void	SetLanguagePath ()
virtual void	ReadPdfBrowserInfos ()
	Read the PDF browser choice from the common configuration. More...
virtual void	WritePdfBrowserInfos ()
	Save the PDF browser choice to the common configuration. More...
virtual bool	SetLocalEnvVariable (const wxString &aName, const wxString &aValue)
	Sets the environment variable aName to aValue. More...
virtual void	SetLocalEnvVariables ()
	Updates the local environment with the contents of the current ENV_VAR_MAP stored in the COMMON_SETTINGS. More...
virtual ENV_VAR_MAP &	GetLocalEnvVariables () const
virtual wxApp &	App ()
	Returns a bare naked wxApp which may come from wxPython, SINGLE_TOP, or kicad.exe. More...
bool	InitPgm (bool aHeadless=false, bool aSkipPyInit=false)
	Initialize this program. More...
void	Destroy ()
void	SaveCommonSettings ()
	Save the program (process) settings subset which are stored .kicad_common. More...

Public Attributes
bool	m_Printing
	wxWidgets on MSW tends to crash if you spool up more than one print job at a time. More...
int	m_ModalDialogCount
bool	m_Quitting

Static Public Attributes
static const wxChar	workingDirKey []

Protected Member Functions
void	loadCommonSettings ()
	Loads internal settings from COMMON_SETTINGS. More...
void	setLanguageId (int aId)
	Trap all changes in here, simplifies debugging. More...
bool	setExecutablePath ()
	Find the path to the executable and stores it in PGM_BASE::m_bin_dir. More...

Protected Attributes
std::unique_ptr< SETTINGS_MANAGER >	m_settings_manager
std::unique_ptr< SCRIPTING >	m_python_scripting
wxString	m_bin_dir
wxString	m_kicad_env
	full path to this program More...
wxLocale *	m_locale
	The KICAD system environment variable. More...
int	m_language_id
bool	m_use_system_pdf_browser
wxString	m_pdf_browser
wxString	m_text_editor
	Filename of the app selected for browsing PDFs. More...

Detailed Description

Struct PGM_SINGLE_TOP implements PGM_BASE with its own OnPgmInit() and OnPgmExit().

Definition at line 66 of file single_top.cpp.

Member Function Documentation

App()

wxApp & PGM_BASE::App ( )

virtualinherited

Returns a bare naked wxApp which may come from wxPython, SINGLE_TOP, or kicad.exe.

This should return what wxGetApp() returns.

Definition at line 135 of file pgm_base.cpp.

{
 wxASSERT( wxTheApp );
 return *wxTheApp;
}

Referenced by PGM_BASE::InitPgm(), PGM_KICAD::MacOpenFile(), MacOpenFile(), PGM_MOCK_EESCHEMA_FRAME::MacOpenFile(), and PGM_KICAD::OnPgmInit().

AskUserForPreferredEditor()

const wxString PGM_BASE::AskUserForPreferredEditor ( const wxString &  aDefaultEditor = wxEmptyString )

virtualinherited

Shows a dialog that instructs the user to select a new preferred editor.

Parameters

aDefaultEditor

Default full path for the default editor this dialog should show by default.

Returns

Returns the full path of the editor, or an empty string if no editor was chosen.

Definition at line 185 of file pgm_base.cpp.

{
 // Create a mask representing the executable files in the current platform
#ifdef __WINDOWS__
 wxString mask( _( "Executable file" ) + wxT( " (*.exe)|*.exe" ) );
#else
 wxString mask( _( "Executable file" ) + wxT( " (*)|*" ) );
#endif

 // Extract the path, name and extension from the default editor (even if the editor's
 // name was empty, this method will succeed and return empty strings).
 wxString path, name, ext;
 wxFileName::SplitPath( aDefaultEditor, &path, &name, &ext );

 // Show the modal editor and return the file chosen (may be empty if the user cancels
 // the dialog).
 return wxFileSelector( _( "Select Preferred Editor" ), path, name, wxT( "." ) + ext,
 mask, wxFD_OPEN | wxFD_FILE_MUST_EXIST, nullptr );
}

References _, name, and path.

Referenced by PGM_BASE::GetTextEditor().

Destroy()

void PGM_BASE::Destroy ( )

inherited

Definition at line 127 of file pgm_base.cpp.

{
 // unlike a normal destructor, this is designed to be called more than once safely:
 delete m_locale;
 m_locale = nullptr;
}

References PGM_BASE::m_locale.

Referenced by CreateWindow(), PGM_KICAD::Destroy(), OnPgmExit(), and PGM_BASE::~PGM_BASE().

ForceSystemPdfBrowser()

virtual void PGM_BASE::ForceSystemPdfBrowser ( bool  aFlg )

inlinevirtualinherited

Force the use of system PDF browser, even if a preferred PDF browser is set.

Definition at line 181 of file pgm_base.h.

{ m_use_system_pdf_browser = aFlg; }

References PGM_BASE::m_use_system_pdf_browser.

Referenced by PGM_BASE::PGM_BASE().

GetCommonSettings()

COMMON_SETTINGS * PGM_BASE::GetCommonSettings ( ) const

virtualinherited

Definition at line 385 of file pgm_base.cpp.

{
 return m_settings_manager ? GetSettingsManager().GetCommonSettings() : nullptr;
}

References SETTINGS_MANAGER::GetCommonSettings(), PGM_BASE::GetSettingsManager(), and PGM_BASE::m_settings_manager.

Referenced by PGM_BASE::GetLocalEnvVariables(), PGM_BASE::InitPgm(), PGM_BASE::loadCommonSettings(), PGM_BASE::ReadPdfBrowserInfos(), PGM_BASE::SaveCommonSettings(), PGM_BASE::SetLanguage(), PGM_BASE::SetLocalEnvVariables(), PGM_BASE::SetTextEditor(), and PGM_BASE::WritePdfBrowserInfos().

GetExecutablePath()

virtual const wxString& PGM_BASE::GetExecutablePath ( ) const

inlinevirtualinherited

Definition at line 160 of file pgm_base.h.

{ return m_bin_dir; }

References PGM_BASE::m_bin_dir.

Referenced by OnPgmInit(), and PGM_BASE::SetLanguagePath().

GetKicadEnvVariable()

virtual const wxString& PGM_BASE::GetKicadEnvVariable ( ) const

inlinevirtualinherited

Definition at line 158 of file pgm_base.h.

{ return m_kicad_env; }

References PGM_BASE::m_kicad_env.

GetLocale()

virtual wxLocale* PGM_BASE::GetLocale ( )

inlinevirtualinherited

Definition at line 162 of file pgm_base.h.

{ return m_locale; }

References PGM_BASE::m_locale.

GetLocalEnvVariables()

ENV_VAR_MAP & PGM_BASE::GetLocalEnvVariables ( ) const

virtualinherited

Definition at line 600 of file pgm_base.cpp.

{
 return GetCommonSettings()->m_Env.vars;
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_Env, and COMMON_SETTINGS::ENVIRONMENT::vars.

Referenced by FILENAME_RESOLVER::GetKicadPaths(), and PGM_KICAD::OnPgmInit().

GetPdfBrowserName()

virtual const wxString& PGM_BASE::GetPdfBrowserName ( ) const

inlinevirtualinherited

Definition at line 164 of file pgm_base.h.

{ return m_pdf_browser; }

References PGM_BASE::m_pdf_browser.

Referenced by PGM_BASE::WritePdfBrowserInfos().

GetSelectedLanguageIdentifier()

virtual int PGM_BASE::GetSelectedLanguageIdentifier ( ) const

inlinevirtualinherited

Returns

the wxWidgets language identifier Id of the language currently selected.

Definition at line 215 of file pgm_base.h.

{ return m_language_id; }

References PGM_BASE::m_language_id.

GetSettingsManager()

virtual SETTINGS_MANAGER& PGM_BASE::GetSettingsManager ( ) const

inlinevirtualinherited

Definition at line 129 of file pgm_base.h.

{ return *m_settings_manager; }

References PGM_BASE::m_settings_manager.

Referenced by PGM_BASE::GetCommonSettings(), PGM_BASE::InitPgm(), LIB_PIN::LIB_PIN(), PCBCALC::IFACE::OnKifaceStart(), CV::IFACE::OnKifaceStart(), PGE::IFACE::OnKifaceStart(), GERBV::IFACE::OnKifaceStart(), PCB::IFACE::OnKifaceStart(), SCH::IFACE::OnKifaceStart(), PGM_KICAD::OnPgmInit(), SCH::readSchematicFromFile(), and PGM_BASE::SetLanguage().

GetTextEditor()

const wxString & PGM_BASE::GetTextEditor ( bool  aCanShowFileChooser = true )

virtualinherited

Return the path to the preferred text editor application.

Parameters

aCanShowFileChooser

If no editor is currently set and this argument is 'true' then this method will show a file chooser dialog asking for the editor's executable.

Returns

Returns the full path of the editor, or an empty string if no editor has been set.

Definition at line 149 of file pgm_base.cpp.

{
 wxString editorname = m_text_editor;

 if( !editorname )
 {
 if( !wxGetEnv( wxT( "EDITOR" ), &editorname ) )
 {
 // If there is no EDITOR variable set, try the desktop default
#ifdef __WXMAC__
 editorname = wxT( "/usr/bin/open -e" );
#elif __WXX11__
 editorname = wxT( "/usr/bin/xdg-open" );
#endif
 }
 }

 // If we still don't have an editor name show a dialog asking the user to select one
 if( !editorname && aCanShowFileChooser )
 {
 DisplayInfoMessage( nullptr, _( "No default editor found, you must choose one." ) );

 editorname = AskUserForPreferredEditor();
 }

 // If we finally have a new editor name request it to be copied to m_text_editor and
 // saved to the preferences file.
 if( !editorname.IsEmpty() )
 SetTextEditor( editorname );

 // m_text_editor already has the same value that editorname, or empty if no editor was
 // found/chosen.
 return m_text_editor;
}

References _, PGM_BASE::AskUserForPreferredEditor(), DisplayInfoMessage(), PGM_BASE::m_text_editor, and PGM_BASE::SetTextEditor().

InitPgm()

bool PGM_BASE::InitPgm ( bool  aHeadless = false, bool  aSkipPyInit = false  )

inherited

Initialize this program.

Initialize the process in a KiCad standard way using some generalized techniques:

• Default paths (help, libs, bin) and configuration file names
• Language and locale
• fonts

Note

Do not initialize anything relating to DSOs or projects.

Parameters

aHeadless	If true, run in headless mode (e.g. for unit tests)
aSkipPyInit	If true, do not init python stuff. Useful in application that do not use python, to disable python dependency at run time

Returns

true if success, false if failure and program is to terminate.

Should never happen but boost unit_test isn't playing nicely in some cases

Definition at line 206 of file pgm_base.cpp.

{
 wxString pgm_name;

 if( App().argc == 0 )
 pgm_name = wxT( "kicad" );
 else
 pgm_name = wxFileName( App().argv[0] ).GetName().Lower();

 wxInitAllImageHandlers();

#ifndef __WINDOWS__
 if( wxString( wxGetenv( wxT( "HOME" ) ) ).IsEmpty() )
 {
 DisplayErrorMessage( nullptr, _( "Environment variable HOME is empty. "
 "Unable to continue." ) );
 return false;
 }
#endif

 // Init KiCad environment
 // the environment variable KICAD (if exists) gives the kicad path:
 // something like set KICAD=d:\kicad
 bool isDefined = wxGetEnv( wxT( "KICAD" ), &m_kicad_env );

 if( isDefined ) // ensure m_kicad_env ends by "/"
 {
 m_kicad_env.Replace( WIN_STRING_DIR_SEP, UNIX_STRING_DIR_SEP );

 if( !m_kicad_env.IsEmpty() && m_kicad_env.Last() != '/' )
 m_kicad_env += UNIX_STRING_DIR_SEP;
 }

 // Init parameters for configuration
 App().SetVendorName( wxT( "KiCad" ) );
 App().SetAppName( pgm_name );

 // Install some image handlers, mainly for help
 if( wxImage::FindHandler( wxBITMAP_TYPE_PNG ) == nullptr )
 wxImage::AddHandler( new wxPNGHandler );

 if( wxImage::FindHandler( wxBITMAP_TYPE_GIF ) == nullptr )
 wxImage::AddHandler( new wxGIFHandler );

 if( wxImage::FindHandler( wxBITMAP_TYPE_JPEG ) == nullptr )
 wxImage::AddHandler( new wxJPEGHandler );

 wxFileSystem::AddHandler( new wxZipFSHandler );

 // Analyze the command line & initialize the binary path
 wxString tmp;
 setExecutablePath();
 SetLanguagePath();
 SetDefaultLanguage( tmp );

 m_settings_manager = std::make_unique<SETTINGS_MANAGER>( aHeadless );

 // Something got in the way of settings load: can't continue
 if( !m_settings_manager->IsOK() )
 return false;

 // Set up built-in environment variables (and override them from the system environment if set)
 GetCommonSettings()->InitializeEnvironment();

 // Load color settings after env is initialized
 m_settings_manager->ReloadColorSettings();

 // Load common settings from disk after setting up env vars
 GetSettingsManager().Load( GetCommonSettings() );

 // Init user language *before* calling loadSettings, because
 // env vars could be incorrectly initialized on Linux
 // (if the value contains some non ASCII7 chars, the env var is not initialized)
 SetLanguage( tmp, true );

 // Now that translations are available, inform the user if the OS is unsupported
 WarnUserIfOperatingSystemUnsupported();

 loadCommonSettings();

 ReadPdfBrowserInfos(); // needs GetCommonSettings()

 // Create the python scripting stuff
 // Skip it fot applications that do not use it
 if( !aSkipPyInit )
 m_python_scripting = std::make_unique<SCRIPTING>();

 // TODO(JE): Remove this if apps are refactored to not assume Prj() always works
 // Need to create a project early for now (it can have an empty path for the moment)
 GetSettingsManager().LoadProject( "" );

 // TODO: Move tooltips into KIPLATFORM
 // This sets the maximum tooltip display duration to 10s (up from 5) but only affects
 // Windows as other platforms display tooltips while the mouse is not moving
 wxToolTip::SetAutoPop( 10000 );

 return true;
}

References _, PGM_BASE::App(), DisplayErrorMessage(), PGM_BASE::GetCommonSettings(), PGM_BASE::GetSettingsManager(), COMMON_SETTINGS::InitializeEnvironment(), SETTINGS_MANAGER::Load(), PGM_BASE::loadCommonSettings(), SETTINGS_MANAGER::LoadProject(), PGM_BASE::m_kicad_env, PGM_BASE::m_python_scripting, PGM_BASE::m_settings_manager, PGM_BASE::ReadPdfBrowserInfos(), PGM_BASE::SetDefaultLanguage(), PGM_BASE::setExecutablePath(), PGM_BASE::SetLanguage(), PGM_BASE::SetLanguagePath(), UNIX_STRING_DIR_SEP, WarnUserIfOperatingSystemUnsupported(), and WIN_STRING_DIR_SEP.

Referenced by PGM_KICAD::OnPgmInit().

IsKicadEnvVariableDefined()

virtual bool PGM_BASE::IsKicadEnvVariableDefined ( ) const

inlinevirtualinherited

Definition at line 156 of file pgm_base.h.

{ return !m_kicad_env.IsEmpty(); }

References PGM_BASE::m_kicad_env.

loadCommonSettings()

void PGM_BASE::loadCommonSettings ( )

protectedinherited

Loads internal settings from COMMON_SETTINGS.

Definition at line 349 of file pgm_base.cpp.

{
 m_text_editor = GetCommonSettings()->m_System.text_editor;

 for( const std::pair<wxString, ENV_VAR_ITEM> it : GetCommonSettings()->m_Env.vars )
 {
 wxLogTrace( traceEnvVars, wxT( "PGM_BASE::loadSettings: Found entry %s = %s" ),
 it.first, it.second.GetValue() );

 // Do not store the env var PROJECT_VAR_NAME ("KIPRJMOD") definition if for some reason
 // it is found in config. (It is reserved and defined as project path)
 if( it.first == PROJECT_VAR_NAME )
 continue;

 // Don't set bogus empty entries in the environment
 if( it.first.IsEmpty() )
 continue;

 // Do not overwrite vars set by the system environment with values from the settings file
 if( it.second.GetDefinedExternally() )
 continue;

 SetLocalEnvVariable( it.first, it.second.GetValue() );
 }
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_System, PGM_BASE::m_text_editor, PROJECT_VAR_NAME, PGM_BASE::SetLocalEnvVariable(), COMMON_SETTINGS::SYSTEM::text_editor, and traceEnvVars.

Referenced by PGM_BASE::InitPgm().

MacOpenFile()

void PGM_SINGLE_TOP::MacOpenFile ( const wxString &  aFileName )

inlineoverridevirtual

Specific to MacOSX (not used under Linux or Windows).

MacOSX requires it for file association.

See also

http://wiki.wxwidgets.org/WxMac-specific_topics

Implements PGM_BASE.

Definition at line 85 of file single_top.cpp.

 {
 wxFileName filename( aFileName );

 if( filename.FileExists() )
 {
 #if 0
 // this pulls in EDA_DRAW_FRAME type info, which we don't want in
 // the single_top link image.
 KIWAY_PLAYER* frame = dynamic_cast<KIWAY_PLAYER*>( App().GetTopWindow() );
 #else
 KIWAY_PLAYER* frame = (KIWAY_PLAYER*) App().GetTopWindow();
 #endif
 if( frame )
 frame->OpenProjectFiles( std::vector<wxString>( 1, aFileName ) );
 }
 }

References PGM_BASE::App(), and KIWAY_PLAYER::OpenProjectFiles().

OnPgmExit()

void PGM_SINGLE_TOP::OnPgmExit ( )

inline

Definition at line 70 of file single_top.cpp.

 {
 Kiway.OnKiwayEnd();

 if( m_settings_manager && m_settings_manager->IsOK() )
 {
 SaveCommonSettings();
 m_settings_manager->Save();
 }

 // Destroy everything in PGM_BASE, especially wxSingleInstanceCheckerImpl
 // earlier than wxApp and earlier than static destruction would.
 PGM_BASE::Destroy();
 }

References PGM_BASE::Destroy(), Kiway, PGM_BASE::m_settings_manager, KIWAY::OnKiwayEnd(), and PGM_BASE::SaveCommonSettings().

Referenced by APP_SINGLE_TOP::OnExit(), and APP_SINGLE_TOP::OnInit().

OnPgmInit()

bool PGM_SINGLE_TOP::OnPgmInit

(

)

Definition at line 272 of file single_top.cpp.

{
#if defined(DEBUG)
 wxString absoluteArgv0 = wxStandardPaths::Get().GetExecutablePath();

 if( !wxIsAbsolutePath( absoluteArgv0 ) )
 {
 wxLogError( wxT( "No meaningful argv[0]" ) );
 return false;
 }
#endif

 // Not all kicad applications use the python stuff. skip python init
 // for these apps.
 bool skip_python_initialization = false;
#if defined( BITMAP_2_CMP ) || defined( PL_EDITOR ) || defined( GERBVIEW ) ||\
 defined( PCB_CALCULATOR_BUILD )
 skip_python_initialization = true;
#endif

 if( !InitPgm( false, skip_python_initialization ) )
 {
 // Clean up
 OnPgmExit();
 return false;
 }

#if !defined(BUILD_KIWAY_DLL)

 // Only bitmap2component and pcb_calculator use this code currently, as they
 // are not split to use single_top as a link image separate from a *.kiface.
 // i.e. they are single part link images so don't need to load a *.kiface.

 // Get the getter, it is statically linked into this binary image.
 KIFACE_GETTER_FUNC* ki_getter = &KIFACE_GETTER;

 int kiface_version;

 // Get the KIFACE.
 KIFACE* kiface = ki_getter( &kiface_version, KIFACE_VERSION, this );

 // Trick the KIWAY into thinking it loaded a KIFACE, by recording the KIFACE
 // in the KIWAY. It needs to be there for KIWAY::OnKiwayEnd() anyways.
 Kiway.set_kiface( KIWAY::KifaceType( TOP_FRAME ), kiface );
#endif

 static const wxCmdLineEntryDesc desc[] = {
 { wxCMD_LINE_OPTION, "f", "frame", "Frame to load", wxCMD_LINE_VAL_STRING, 0 },
 { wxCMD_LINE_PARAM, nullptr, nullptr, "File to load", wxCMD_LINE_VAL_STRING,
 wxCMD_LINE_PARAM_MULTIPLE | wxCMD_LINE_PARAM_OPTIONAL },
 { wxCMD_LINE_NONE, nullptr, nullptr, nullptr, wxCMD_LINE_VAL_NONE, 0 }
 };

 wxCmdLineParser parser( App().argc, App().argv );
 parser.SetDesc( desc );
 parser.Parse( false );

 FRAME_T appType = TOP_FRAME;

 const struct
 {
 wxString name;
 FRAME_T type;
 } frameTypes[] = {
 { wxT( "pcb" ), FRAME_PCB_EDITOR },
 { wxT( "fpedit" ), FRAME_FOOTPRINT_EDITOR },
 { wxEmptyString, FRAME_T_COUNT }
 };

 wxString frameName;

 if( parser.Found( wxT( "frame" ), &frameName ) )
 {
 appType = FRAME_T_COUNT;

 for( const auto& it : frameTypes )
 {
 if( it.name == frameName )
 appType = it.type;
 }

 if( appType == FRAME_T_COUNT )
 {
 wxLogError( wxT( "Unknown frame: %s" ), frameName );
 // Clean up
 OnPgmExit();
 return false;
 }
 }

 // Tell the settings manager about the current Kiway
 GetSettingsManager().SetKiway( &Kiway );

 // Use KIWAY to create a top window, which registers its existence also.
 // "TOP_FRAME" is a macro that is passed on compiler command line from CMake,
 // and is one of the types in FRAME_T.
 KIWAY_PLAYER* frame = Kiway.Player( appType, true );

 if( frame == nullptr )
 {
 return false;
 }

 Kiway.SetTop( frame );

 App().SetTopWindow( frame ); // wxApp gets a face.
 App().SetAppDisplayName( frame->GetAboutTitle() );

 // Allocate a slice of time to show the frame and update wxWidgets widgets
 // (especially setting valid sizes) after creating frame and before calling
 // OpenProjectFiles() that can update/use some widgets.
 // The 2 calls to wxSafeYield are needed on wxGTK for best results.
 wxSafeYield();
 frame->Show();
 wxSafeYield();

 // Individual frames may provide additional option/switch processing, but for compatibility,
 // any positional arguments are treated as a list of files to pass to OpenProjectFiles
 frame->ParseArgs( parser );

 // Now after the frame processing, the rest of the positional args are files
 std::vector<wxString> fileArgs;

 if( parser.GetParamCount() )
 {
 /*
 gerbview handles multiple project data files, i.e. gerber files on
 cmd line. Others currently do not, they handle only one. For common
 code simplicity we simply pass all the arguments in however, each
 program module can do with them what they want, ignore, complain
 whatever. We don't establish policy here, as this is a multi-purpose
 launcher.
 */

 for( size_t i = 0; i < parser.GetParamCount(); i++ )
 fileArgs.push_back( parser.GetParam( i ) );

 // special attention to a single argument: argv[1] (==argSet[0])
 if( fileArgs.size() == 1 )
 {
 wxFileName argv1( fileArgs[0] );

#if defined(PGM_DATA_FILE_EXT)
 // PGM_DATA_FILE_EXT, if present, may be different for each compile,
 // it may come from CMake on the compiler command line, but often does not.
 // This facility is mostly useful for those program footprints
 // supporting a single argv[1].
 if( !argv1.GetExt() )
 argv1.SetExt( wxT( PGM_DATA_FILE_EXT ) );
#endif
 argv1.MakeAbsolute();

 fileArgs[0] = argv1.GetFullPath();
 }

 // Use the KIWAY_PLAYER::OpenProjectFiles() API function:
 if( !frame->OpenProjectFiles( fileArgs ) )
 {
 // OpenProjectFiles() API asks that it report failure to the UI.
 // Nothing further to say here.

 // We've already initialized things at this point, but wx won't call OnExit if
 // we fail out. Call our own cleanup routine here to ensure the relevant resources
 // are freed at the right time (if they aren't, segfaults will occur).
 OnPgmExit();

 // Fail the process startup if the file could not be opened,
 // although this is an optional choice, one that can be reversed
  // also in the KIFACE specific OpenProjectFiles() return value.
 return false;
 }
 }

 return true;
}

References FRAME_FOOTPRINT_EDITOR, FRAME_PCB_EDITOR, FRAME_T_COUNT, EDA_BASE_FRAME::GetAboutTitle(), PGM_BASE::GetExecutablePath(), GetSettingsManager(), kiface, KIFACE_GETTER, KIFACE_VERSION, KIWAY::KifaceType(), Kiway, name, KIWAY_PLAYER::OpenProjectFiles(), KIWAY_PLAYER::ParseArgs(), KIWAY::Player(), KIWAY::set_kiface(), SETTINGS_MANAGER::SetKiway(), and KIWAY::SetTop().

Referenced by APP_SINGLE_TOP::OnInit().

ReadPdfBrowserInfos()

void PGM_BASE::ReadPdfBrowserInfos ( )

virtualinherited

Read the PDF browser choice from the common configuration.

Definition at line 37 of file eda_doc.cpp.

{
 SetPdfBrowserName( GetCommonSettings()->m_System.pdf_viewer_name );
 m_use_system_pdf_browser = GetCommonSettings()->m_System.use_system_pdf_viewer;
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_System, PGM_BASE::m_use_system_pdf_browser, PGM_BASE::SetPdfBrowserName(), and COMMON_SETTINGS::SYSTEM::use_system_pdf_viewer.

Referenced by PGM_BASE::InitPgm().

SaveCommonSettings()

void PGM_BASE::SaveCommonSettings ( )

inherited

Save the program (process) settings subset which are stored .kicad_common.

Definition at line 376 of file pgm_base.cpp.

{
 // GetCommonSettings() is not initialized until fairly late in the
 // process startup: InitPgm(), so test before using:
 if( GetCommonSettings() )
 GetCommonSettings()->m_System.working_dir = wxGetCwd();
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_System, and COMMON_SETTINGS::SYSTEM::working_dir.

Referenced by PGM_KICAD::OnPgmExit(), and OnPgmExit().

SetDefaultLanguage()

bool PGM_BASE::SetDefaultLanguage ( wxString &  aErrMsg )

inherited

Set the default language without reference to any preferences.

Can be used to set the language for dialogs that show before preferences are loaded

Parameters

aErrMsg

String to return the error message(s) in

Returns

false if the language could not be set

Definition at line 488 of file pgm_base.cpp.

{
 setLanguageId( wxLANGUAGE_DEFAULT );

 // dictionary file name without extend (full name is kicad.mo)
 wxString dictionaryName( wxT( "kicad" ) );

 delete m_locale;
 m_locale = new wxLocale;
 m_locale->Init();

 // Try adding the dictionary if it is not currently loaded
 if( !m_locale->IsLoaded( dictionaryName ) )
 m_locale->AddCatalog( dictionaryName );

 // Verify the Kicad dictionary was loaded properly
 // However, for the English language, the dictionary is not mandatory, as
 // all messages are already in English, just restricted to ASCII7 chars,
 // the verification is skipped.
 if( !m_locale->IsLoaded( dictionaryName ) && m_language_id != wxLANGUAGE_ENGLISH )
 {
 wxLogTrace( traceLocale, wxT( "Unable to load dictionary %s.mo in %s" ),
 dictionaryName, m_locale->GetName() );

 setLanguageId( wxLANGUAGE_DEFAULT );
 delete m_locale;

 m_locale = new wxLocale;
 m_locale->Init();

 aErrMsg = _( "The KiCad language file for this language is not installed." );
 return false;
 }

 return true;
}

References _, PGM_BASE::m_language_id, PGM_BASE::m_locale, PGM_BASE::setLanguageId(), and traceLocale.

Referenced by PGM_BASE::InitPgm().

setExecutablePath()

bool PGM_BASE::setExecutablePath ( )

protectedinherited

Find the path to the executable and stores it in PGM_BASE::m_bin_dir.

Returns

true if success, else false.

Definition at line 307 of file pgm_base.cpp.

{
 m_bin_dir = wxStandardPaths::Get().GetExecutablePath();

#ifdef __WXMAC__
 // On OSX Pgm().GetExecutablePath() will always point to main
 // bundle directory, e.g., /Applications/kicad.app/

 wxFileName fn( m_bin_dir );

 if( fn.GetName() == wxT( "kicad" ) )
 {
 // kicad launcher, so just remove the Contents/MacOS part
 fn.RemoveLastDir();
 fn.RemoveLastDir();
 }
 else
 {
 // standalone binaries live in Contents/Applications/<standalone>.app/Contents/MacOS
 fn.RemoveLastDir();
 fn.RemoveLastDir();
 fn.RemoveLastDir();
 fn.RemoveLastDir();
 fn.RemoveLastDir();
 }

 m_bin_dir = fn.GetPath() + wxT( "/" );
#else
 // Use unix notation for paths. I am not sure this is a good idea,
 // but it simplifies compatibility between Windows and Unices.
 // However it is a potential problem in path handling under Windows.
 m_bin_dir.Replace( WIN_STRING_DIR_SEP, UNIX_STRING_DIR_SEP );

 // Remove file name form command line:
 while( m_bin_dir.Last() != '/' && !m_bin_dir.IsEmpty() )
 m_bin_dir.RemoveLast();
#endif

 return true;
}

References PGM_BASE::m_bin_dir, UNIX_STRING_DIR_SEP, and WIN_STRING_DIR_SEP.

Referenced by PGM_BASE::InitPgm().

SetLanguage()

bool PGM_BASE::SetLanguage ( wxString &  aErrMsg, bool  first_time = false  )

virtualinherited

Set the dictionary file name for internationalization.

The files are in kicad/internat/xx or kicad/internat/xx_XX and are named kicad.mo

Parameters

aErrMsg	is the string to return the error message it.
first_time	must be set to true the first time this function is called, false otherwise.

Returns

false if there was an error setting the language.

Definition at line 391 of file pgm_base.cpp.

{
 if( first_time )
 {
 setLanguageId( wxLANGUAGE_DEFAULT );
 // First time SetLanguage is called, the user selected language id is set
 // from common user config settings
 wxString languageSel = GetCommonSettings()->m_System.language;

 // Search for the current selection
 for( unsigned ii = 0; LanguagesList[ii].m_KI_Lang_Identifier != 0; ii++ )
 {
 if( LanguagesList[ii].m_Lang_Label == languageSel )
 {
 setLanguageId( LanguagesList[ii].m_WX_Lang_Identifier );
 break;
 }
 }
 }

 // dictionary file name without extend (full name is kicad.mo)
 wxString dictionaryName( wxT( "kicad" ) );

 delete m_locale;
 m_locale = new wxLocale;

 // don't use wxLOCALE_LOAD_DEFAULT flag so that Init() doesn't return
 // false just because it failed to load wxstd catalog
 if( !m_locale->Init( m_language_id, wxLOCALE_DONT_LOAD_DEFAULT ) )
 {
 wxLogTrace( traceLocale, wxT( "This language is not supported by the system." ) );

 setLanguageId( wxLANGUAGE_DEFAULT );
 delete m_locale;

 m_locale = new wxLocale;
 m_locale->Init( wxLANGUAGE_DEFAULT, wxLOCALE_DONT_LOAD_DEFAULT);

 aErrMsg = _( "This language is not supported by the operating system." );
 return false;
 }
 else if( !first_time )
 {
 wxLogTrace( traceLocale, wxT( "Search for dictionary %s.mo in %s" ),
 dictionaryName, m_locale->GetName() );
 }

 if( !first_time )
 {
 // If we are here, the user has selected another language.
 // Therefore the new preferred language name is stored in common config.
 // Do NOT store the wxWidgets language Id, it can change between wxWidgets
 // versions, for a given language
 wxString languageSel;

 // Search for the current selection language name
 for( unsigned ii = 0; LanguagesList[ii].m_KI_Lang_Identifier != 0; ii++ )
 {
 if( LanguagesList[ii].m_WX_Lang_Identifier == m_language_id )
 {
 languageSel = LanguagesList[ii].m_Lang_Label;
 break;
 }
 }

 COMMON_SETTINGS* cfg = GetCommonSettings();
 cfg->m_System.language = languageSel;
 cfg->SaveToFile( GetSettingsManager().GetPathForSettingsFile( cfg ) );
 }

 // Try adding the dictionary if it is not currently loaded
 if( !m_locale->IsLoaded( dictionaryName ) )
 m_locale->AddCatalog( dictionaryName );

 // Verify the Kicad dictionary was loaded properly
 // However, for the English language, the dictionary is not mandatory, as
 // all messages are already in English, just restricted to ASCII7 chars,
 // the verification is skipped.
 if( !m_locale->IsLoaded( dictionaryName ) && m_language_id != wxLANGUAGE_ENGLISH )
 {
 wxLogTrace( traceLocale, wxT( "Unable to load dictionary %s.mo in %s" ),
 dictionaryName, m_locale->GetName() );

 setLanguageId( wxLANGUAGE_DEFAULT );
 delete m_locale;

 m_locale = new wxLocale;
 m_locale->Init( wxLANGUAGE_DEFAULT, wxLOCALE_DONT_LOAD_DEFAULT);

 aErrMsg = _( "The KiCad language file for this language is not installed." );
 return false;
 }

 return true;
}

References _, PGM_BASE::GetCommonSettings(), PGM_BASE::GetSettingsManager(), COMMON_SETTINGS::SYSTEM::language, LanguagesList, LANGUAGE_DESCR::m_KI_Lang_Identifier, LANGUAGE_DESCR::m_Lang_Label, PGM_BASE::m_language_id, PGM_BASE::m_locale, COMMON_SETTINGS::m_System, JSON_SETTINGS::SaveToFile(), PGM_BASE::setLanguageId(), and traceLocale.

Referenced by PGM_BASE::InitPgm().

setLanguageId()

void PGM_BASE::setLanguageId ( int  aId )

inlineprotectedinherited

Trap all changes in here, simplifies debugging.

Definition at line 302 of file pgm_base.h.

{ m_language_id = aId; }

References PGM_BASE::m_language_id.

Referenced by PGM_BASE::PGM_BASE(), PGM_BASE::SetDefaultLanguage(), PGM_BASE::SetLanguage(), and PGM_BASE::SetLanguageIdentifier().

SetLanguageIdentifier()

void PGM_BASE::SetLanguageIdentifier ( int  menu_id )

virtualinherited

Set in .m_language_id member the wxWidgets language identifier ID from the KiCad menu id (internal menu identifier).

Parameters

menu_id

The KiCad menuitem id (returned by Menu Event, when clicking on a menu item)

Definition at line 526 of file pgm_base.cpp.

{
 wxLogTrace( traceLocale, wxT( "Select language ID %d from %d possible languages." ),
 menu_id, (int)arrayDim( LanguagesList )-1 );

 for( unsigned ii = 0; LanguagesList[ii].m_KI_Lang_Identifier != 0; ii++ )
 {
 if( menu_id == LanguagesList[ii].m_KI_Lang_Identifier )
 {
 setLanguageId( LanguagesList[ii].m_WX_Lang_Identifier );
 break;
 }
 }
}

References arrayDim(), LanguagesList, LANGUAGE_DESCR::m_KI_Lang_Identifier, PGM_BASE::setLanguageId(), and traceLocale.

SetLanguagePath()

void PGM_BASE::SetLanguagePath ( )

virtualinherited

Definition at line 542 of file pgm_base.cpp.

{
 wxLocale::AddCatalogLookupPathPrefix( PATHS::GetLocaleDataPath() );

 if( wxGetEnv( wxT( "KICAD_RUN_FROM_BUILD_DIR" ), nullptr ) )
 {
 wxFileName fn( Pgm().GetExecutablePath() );
 fn.RemoveLastDir();
 fn.AppendDir( wxT( "translation" ) );
 wxLocale::AddCatalogLookupPathPrefix( fn.GetPath() );
 }
}

References PGM_BASE::GetExecutablePath(), PATHS::GetLocaleDataPath(), and Pgm().

Referenced by PGM_BASE::InitPgm().

SetLocalEnvVariable()

bool PGM_BASE::SetLocalEnvVariable ( const wxString &  aName, const wxString &  aValue  )

virtualinherited

Sets the environment variable aName to aValue.

This function first checks to see if the environment variable aName is already defined. If it is not defined, then the environment variable aName is set to a value. Otherwise, the environment variable is left unchanged. This allows the user to override environment variables for testing purposes.

Parameters

aName	is a wxString containing the environment variable name.
aValue	is a wxString containing the environment variable value.

Returns

true if the environment variable Name was set to aValue.

Definition at line 556 of file pgm_base.cpp.

{
 wxString env;

 if( aName.IsEmpty() )
 {
 wxLogTrace( traceEnvVars,
 wxT( "PGM_BASE::SetLocalEnvVariable: Attempt to set empty variable to value %s" ),
 aValue );
 return false;
 }

 // Check to see if the environment variable is already set.
 if( wxGetEnv( aName, &env ) )
 {
 wxLogTrace( traceEnvVars,
  wxT( "PGM_BASE::SetLocalEnvVariable: Environment variable %s already set to %s" ),
 aName, env );
 return env == aValue;
 }

 wxLogTrace( traceEnvVars,
 wxT( "PGM_BASE::SetLocalEnvVariable: Setting local environment variable %s to %s" ),
 aName, aValue );

 return wxSetEnv( aName, aValue );
}

References traceEnvVars.

Referenced by PGM_BASE::loadCommonSettings().

SetLocalEnvVariables()

void PGM_BASE::SetLocalEnvVariables ( )

virtualinherited

Updates the local environment with the contents of the current ENV_VAR_MAP stored in the COMMON_SETTINGS.

See also

GetLocalEnvVariables()

Definition at line 585 of file pgm_base.cpp.

{
 // Overwrites externally defined environment variable until the next time the application
 // is run.
 for( const std::pair<wxString, ENV_VAR_ITEM> m_local_env_var : GetCommonSettings()->m_Env.vars )
 {
 wxLogTrace( traceEnvVars,
 wxT( "PGM_BASE::SetLocalEnvVariables: Setting local environment variable %s to %s" ),
 m_local_env_var.first,
 m_local_env_var.second.GetValue() );
 wxSetEnv( m_local_env_var.first, m_local_env_var.second.GetValue() );
 }
}

References PGM_BASE::GetCommonSettings(), and traceEnvVars.

SetPdfBrowserName()

virtual void PGM_BASE::SetPdfBrowserName ( const wxString &  aFileName )

inlinevirtualinherited

Definition at line 166 of file pgm_base.h.

{ m_pdf_browser = aFileName; }

References PGM_BASE::m_pdf_browser.

Referenced by PGM_BASE::ReadPdfBrowserInfos().

SetTextEditor()

void PGM_BASE::SetTextEditor ( const wxString &  aFileName )

virtualinherited

Definition at line 142 of file pgm_base.cpp.

{
 m_text_editor = aFileName;
 GetCommonSettings()->m_System.text_editor = aFileName;
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_System, PGM_BASE::m_text_editor, and COMMON_SETTINGS::SYSTEM::text_editor.

Referenced by PGM_BASE::GetTextEditor().

UseSystemPdfBrowser()

virtual bool PGM_BASE::UseSystemPdfBrowser ( ) const

inlinevirtualinherited

Returns

true if the PDF browser is the default (system) PDF browser and false if the PDF browser is the preferred (selected) browser, else returns false if there is no selected browser.

Definition at line 173 of file pgm_base.h.

 {
 return m_use_system_pdf_browser || m_pdf_browser.IsEmpty();
 }

References PGM_BASE::m_pdf_browser, and PGM_BASE::m_use_system_pdf_browser.

WritePdfBrowserInfos()

void PGM_BASE::WritePdfBrowserInfos ( )

virtualinherited

Save the PDF browser choice to the common configuration.

Definition at line 44 of file eda_doc.cpp.

{
 GetCommonSettings()->m_System.pdf_viewer_name = GetPdfBrowserName();
 GetCommonSettings()->m_System.use_system_pdf_viewer = m_use_system_pdf_browser;
}

References PGM_BASE::GetCommonSettings(), PGM_BASE::GetPdfBrowserName(), COMMON_SETTINGS::m_System, PGM_BASE::m_use_system_pdf_browser, COMMON_SETTINGS::SYSTEM::pdf_viewer_name, and COMMON_SETTINGS::SYSTEM::use_system_pdf_viewer.

Member Data Documentation

m_bin_dir

wxString PGM_BASE::m_bin_dir

protectedinherited

Definition at line 316 of file pgm_base.h.

Referenced by PGM_BASE::GetExecutablePath(), and PGM_BASE::setExecutablePath().

m_kicad_env

wxString PGM_BASE::m_kicad_env

protectedinherited

full path to this program

Definition at line 317 of file pgm_base.h.

Referenced by PGM_BASE::GetKicadEnvVariable(), PGM_BASE::InitPgm(), and PGM_BASE::IsKicadEnvVariableDefined().

m_language_id

int PGM_BASE::m_language_id

protectedinherited

Definition at line 320 of file pgm_base.h.

Referenced by PGM_BASE::GetSelectedLanguageIdentifier(), PGM_BASE::SetDefaultLanguage(), PGM_BASE::SetLanguage(), and PGM_BASE::setLanguageId().

m_locale

wxLocale* PGM_BASE::m_locale

protectedinherited

The KICAD system environment variable.

Definition at line 319 of file pgm_base.h.

Referenced by PGM_BASE::Destroy(), PGM_BASE::GetLocale(), PGM_BASE::PGM_BASE(), PGM_BASE::SetDefaultLanguage(), and PGM_BASE::SetLanguage().

m_ModalDialogCount

int PGM_BASE::m_ModalDialogCount

inherited

Definition at line 293 of file pgm_base.h.

Referenced by APP_KICAD::FilterEvent(), and PGM_BASE::PGM_BASE().

m_pdf_browser

wxString PGM_BASE::m_pdf_browser

protectedinherited

Definition at line 323 of file pgm_base.h.

Referenced by PGM_BASE::GetPdfBrowserName(), PGM_BASE::SetPdfBrowserName(), and PGM_BASE::UseSystemPdfBrowser().

m_Printing

bool PGM_BASE::m_Printing

inherited

wxWidgets on MSW tends to crash if you spool up more than one print job at a time.

Definition at line 291 of file pgm_base.h.

Referenced by BOARD::ComputeBoundingBox(), and PGM_BASE::PGM_BASE().

m_python_scripting

std::unique_ptr<SCRIPTING> PGM_BASE::m_python_scripting

protectedinherited

Definition at line 314 of file pgm_base.h.

Referenced by PGM_BASE::InitPgm().

m_Quitting

bool PGM_BASE::m_Quitting

inherited

Definition at line 295 of file pgm_base.h.

Referenced by PGM_BASE::PGM_BASE().

m_settings_manager

std::unique_ptr<SETTINGS_MANAGER> PGM_BASE::m_settings_manager

protectedinherited

Definition at line 312 of file pgm_base.h.

Referenced by PGM_BASE::GetCommonSettings(), PGM_BASE::GetSettingsManager(), PGM_BASE::InitPgm(), PGM_KICAD::OnPgmExit(), and OnPgmExit().

m_text_editor

wxString PGM_BASE::m_text_editor

protectedinherited

Filename of the app selected for browsing PDFs.

Definition at line 325 of file pgm_base.h.

Referenced by PGM_BASE::GetTextEditor(), PGM_BASE::loadCommonSettings(), and PGM_BASE::SetTextEditor().

m_use_system_pdf_browser

bool PGM_BASE::m_use_system_pdf_browser

protectedinherited

Definition at line 322 of file pgm_base.h.

Referenced by PGM_BASE::ForceSystemPdfBrowser(), PGM_BASE::ReadPdfBrowserInfos(), PGM_BASE::UseSystemPdfBrowser(), and PGM_BASE::WritePdfBrowserInfos().

workingDirKey

const wxChar PGM_BASE::workingDirKey[]

staticinherited

Definition at line 259 of file pgm_base.h.

---

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

• single_top.cpp