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	SetEditorName (const wxString &aFileName)
virtual const wxString &	GetEditorName (bool aCanShowFileChooser=true)
	Return the preferred editor name. 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 fromthe 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 (const ENV_VAR_MAP &aEnvVarMap)
	Set the internal local environment variable map to aEnvVarMap, updates the entries in the .kicad_common configuration file and sets the environment variable to the new settings. More...
virtual const 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 ()
	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

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
wxSingleInstanceChecker *	m_pgm_checker
	prevents multiple instances of a program from being run at the same time. More...
wxString	m_bin_dir
	full path to this program More...
wxString	m_kicad_env
	The KICAD system environment variable. More...
wxLocale *	m_locale
	The current locale. More...
int	m_language_id
	The current language setting. More...
bool	m_use_system_pdf_browser
	true to use the selected PDF browser, if exists, or false to use the default More...
wxString	m_pdf_browser
	The file name of the the program selected for browsing pdf files. More...
wxString	m_editor_name
wxSize	m_help_size
ENV_VAR_MAP	m_local_env_vars
	Local environment variable expansion settings such as KICAD6_FOOTPRINT_DIR, and KICAD6_3DMODEL_DIR. More...
bool	m_show_env_var_dialog
	Flag to indicate if the environment variable overwrite warning dialog should be shown. 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 140 of file pgm_base.cpp.

{
    wxASSERT( wxTheApp );
    return *wxTheApp;
}

Referenced by PGM_BASE::InitPgm(), PGM_KICAD::MacOpenFile(), PGM_TEST_FRAME::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 192 of file pgm_base.cpp.

{
    // Create a mask representing the executable files in the current platform
#ifdef __WINDOWS__
    wxString mask( _( "Executable file (*.exe)|*.exe" ) );
#else
    wxString mask( _( "Executable file (*)|*" ) );
#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 EDA_FILE_SELECTOR( _( "Select Preferred Editor" ), path,
                              name, ext, mask,
                              NULL, wxFD_OPEN | wxFD_FILE_MUST_EXIST,
                              true );
}

References _, EDA_FILE_SELECTOR(), name, and NULL.

Referenced by PGM_BASE::GetEditorName().

Destroy()

void PGM_BASE::Destroy ( )

inherited

Definition at line 129 of file pgm_base.cpp.

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

    delete m_locale;
    m_locale = 0;
}

References PGM_BASE::m_locale, and PGM_BASE::m_pgm_checker.

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 219 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 583 of file pgm_base.cpp.

{
    return GetSettingsManager().GetCommonSettings();
}

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

Referenced by PGM_BASE::InitPgm(), PGM_BASE::loadCommonSettings(), PGM_BASE::ReadPdfBrowserInfos(), PGM_BASE::SaveCommonSettings(), PGM_BASE::SetEditorName(), PGM_BASE::SetLanguage(), and PGM_BASE::WritePdfBrowserInfos().

GetEditorName()

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

virtualinherited

Return the preferred editor name.

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 155 of file pgm_base.cpp.

{
    wxString editorname = m_editor_name;

    if( !editorname )
    {
        if( !wxGetEnv( "EDITOR", &editorname ) )
        {
            // If there is no EDITOR variable set, try the desktop default
#ifdef __WXMAC__
            editorname = "/usr/bin/open";
#elif __WXX11__
            editorname = "/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( NULL,
                            _( "No default editor found, you must choose it" ) );

        editorname = AskUserForPreferredEditor();
    }

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

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

References _, PGM_BASE::AskUserForPreferredEditor(), DisplayInfoMessage(), PGM_BASE::m_editor_name, NULL, and PGM_BASE::SetEditorName().

GetExecutablePath()

virtual const wxString& PGM_BASE::GetExecutablePath ( ) const

inlinevirtualinherited

Definition at line 198 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 196 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 200 of file pgm_base.h.

{ return m_locale; }

References PGM_BASE::m_locale.

GetLocalEnvVariables()

virtual const ENV_VAR_MAP& PGM_BASE::GetLocalEnvVariables ( ) const

inlinevirtualinherited

Definition at line 290 of file pgm_base.h.

    {
        return m_local_env_vars;
    }

References PGM_BASE::m_local_env_vars.

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

GetPdfBrowserName()

virtual const wxString& PGM_BASE::GetPdfBrowserName ( ) const

inlinevirtualinherited

Definition at line 202 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 253 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 167 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(), PGE::IFACE::OnKifaceStart(), CV::IFACE::OnKifaceStart(), GERBV::IFACE::OnKifaceStart(), PCB::IFACE::OnKifaceStart(), SCH::IFACE::OnKifaceStart(), PGM_KICAD::OnPgmInit(), SCH::readSchematicFromFile(), and PGM_BASE::SetLanguage().

InitPgm()

bool PGM_BASE::InitPgm ( )

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.

Returns

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

Definition at line 215 of file pgm_base.cpp.

{
    wxFileName pgm_name( App().argv[0] );

    wxInitAllImageHandlers();

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

    m_pgm_checker = new wxSingleInstanceChecker( pgm_name.GetName().Lower() + wxT( "-" ) +
                                                 wxGetUserId(), GetKicadLockFilePath() );

    if( m_pgm_checker->IsAnotherRunning() )
    {
        wxString quiz =
                wxString::Format( _( "%s is already running. Continue?" ), pgm_name.GetName() );

        if( !IsOK( NULL, quiz ) )
            return false;
    }

    // Init KiCad environment
    // the environment variable KICAD (if exists) gives the kicad path:
    // something like set KICAD=d:\kicad
    bool isDefined = wxGetEnv( "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( "KiCad" );
    App().SetAppName( pgm_name.GetName().Lower() );

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

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

    if( wxImage::FindHandler( wxBITMAP_TYPE_JPEG ) == NULL )
        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>();

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

    wxFileName baseSharePath;
#if defined( __WXMSW__ )
    // Make the paths relative to the executable dir as KiCad might be installed anywhere
    // It follows the Windows installer paths scheme, where binaries are installed in
    // PATH/bin and extra files in PATH/share/kicad
    baseSharePath.AssignDir( m_bin_dir + "\\.." );
    baseSharePath.Normalize();
#else
    baseSharePath.AssignDir( wxString( wxT( DEFAULT_INSTALL_PATH ) ) );
#endif

#if !defined( __WXMAC__ )
    baseSharePath.AppendDir( "share" );
    baseSharePath.AppendDir( "kicad" );
#endif

    // KICAD6_FOOTPRINT_DIR
    wxString envVarName = wxT( "KICAD6_FOOTPRINT_DIR" );
    ENV_VAR_ITEM envVarItem;
    wxString envValue;
    wxFileName tmpFileName;

    if( wxGetEnv( envVarName, &envValue ) == true && !envValue.IsEmpty() )
    {
        tmpFileName.AssignDir( envValue );
        envVarItem.SetDefinedExternally( true );
        wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Found entry %s externally", envVarName );
    }
    else
    {
        tmpFileName = baseSharePath;
        tmpFileName.AppendDir( "modules" );
        envVarItem.SetDefinedExternally( false );
    }

    envVarItem.SetValue( tmpFileName.GetPath() );
    wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Setting entry %s = %s",
                envVarName, envVarItem.GetValue() );
    m_local_env_vars[ envVarName ] = envVarItem;

    // KICAD6_3DMODEL_DIR
    envVarName = wxT( "KICAD6_3DMODEL_DIR" );

    if( wxGetEnv( envVarName, &envValue ) == true && !envValue.IsEmpty() )
    {
        tmpFileName.AssignDir( envValue );
        envVarItem.SetDefinedExternally( true );
        wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Found entry %s externally", envVarName );
    }
    else
    {
        tmpFileName = baseSharePath;
        tmpFileName.AppendDir( "3dmodels" );
        envVarItem.SetDefinedExternally( false );
    }

    envVarItem.SetValue( tmpFileName.GetFullPath() );
    wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Setting entry %s = %s",
                envVarName, envVarItem.GetValue() );
    m_local_env_vars[ envVarName ] = envVarItem;

    // KICAD6_TEMPLATE_DIR
    envVarName = "KICAD6_TEMPLATE_DIR";

    if( wxGetEnv( envVarName, &envValue ) == true && !envValue.IsEmpty() )
    {
        tmpFileName.AssignDir( envValue );
        envVarItem.SetDefinedExternally( true );
        wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Found entry %s externally", envVarName );
    }
    else
    {
        // Attempt to find the best default template path.
        SEARCH_STACK bases;
        SEARCH_STACK templatePaths;

        SystemDirsAppend( &bases );

        for( unsigned i = 0; i < bases.GetCount(); ++i )
        {
            wxFileName fn( bases[i], wxEmptyString );

            // Add KiCad template file path to search path list.
            fn.AppendDir( "template" );

            // Only add path if exists and can be read by the user.
            if( fn.DirExists() && fn.IsDirReadable() )
            {
                wxLogTrace( tracePathsAndFiles, "Checking template path '%s' exists",
                            fn.GetPath() );
                templatePaths.AddPaths( fn.GetPath() );
            }
        }

        if( templatePaths.IsEmpty() )
        {
            tmpFileName = baseSharePath;
            tmpFileName.AppendDir( "template" );
        }
        else
        {
            // Take the first one.  There may be more but this will likely be the best option.
            tmpFileName.AssignDir( templatePaths[0] );
        }

        envVarItem.SetDefinedExternally( false );
    }

    envVarItem.SetValue( tmpFileName.GetPath() );
    wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Setting entry %s = %s", envVarName,
                envVarItem.GetValue() );
    m_local_env_vars[ envVarName ] = envVarItem;

    // KICAD_USER_TEMPLATE_DIR
    envVarName = "KICAD_USER_TEMPLATE_DIR";

    if( wxGetEnv( envVarName, &envValue ) == true && !envValue.IsEmpty() )
    {
        tmpFileName.AssignDir( envValue );
        envVarItem.SetDefinedExternally( true );
        wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Found entry %s externally", envVarName );
    }
    else
    {
        // Default user template path.
        tmpFileName.AssignDir( PATHS::GetUserTemplatesPath() );
        envVarItem.SetDefinedExternally( false );
    }

    envVarItem.SetValue( tmpFileName.GetPath() );
    wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Setting entry %s = %s",
                envVarName, envVarItem.GetValue() );
    m_local_env_vars[ envVarName ] = envVarItem;

    // KICAD_SYMBOLS
    envVarName = wxT( "KICAD6_SYMBOL_DIR" );

    if( wxGetEnv( envVarName, &envValue ) == true && !envValue.IsEmpty() )
    {
        tmpFileName.AssignDir( envValue );
        envVarItem.SetDefinedExternally( true );
        wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Found entry %s externally", envVarName );
    }
    else
    {
        tmpFileName = baseSharePath;
        tmpFileName.AppendDir( "library" );
        envVarItem.SetDefinedExternally( false );
    }

    envVarItem.SetValue( tmpFileName.GetPath() );
    wxLogTrace( traceEnvVars, "PGM_BASE::InitPgm: Setting entry %s = %s",
                envVarName, envVarItem.GetValue() );
    m_local_env_vars[ envVarName ] = envVarItem;

    GetSettingsManager().Load( GetCommonSettings() );

    // Init user language *before* calling loadCommonSettings, 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 );

    loadCommonSettings();

    ReadPdfBrowserInfos();      // needs GetCommonSettings()

#ifdef __WXMAC__
    // Always show filters on Open dialog to be able to choose plugin
    wxSystemOptions::SetOption( wxOSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1 );
#endif

    // 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 _, SEARCH_STACK::AddPaths(), PGM_BASE::App(), DisplayErrorMessage(), Format(), PGM_BASE::GetCommonSettings(), GetKicadLockFilePath(), PGM_BASE::GetSettingsManager(), PATHS::GetUserTemplatesPath(), ENV_VAR_ITEM::GetValue(), IsOK(), SETTINGS_MANAGER::Load(), PGM_BASE::loadCommonSettings(), SETTINGS_MANAGER::LoadProject(), PGM_BASE::m_bin_dir, PGM_BASE::m_kicad_env, PGM_BASE::m_local_env_vars, PGM_BASE::m_pgm_checker, PGM_BASE::m_settings_manager, NULL, PGM_BASE::ReadPdfBrowserInfos(), PGM_BASE::SetDefaultLanguage(), ENV_VAR_ITEM::SetDefinedExternally(), PGM_BASE::setExecutablePath(), PGM_BASE::SetLanguage(), PGM_BASE::SetLanguagePath(), ENV_VAR_ITEM::SetValue(), SystemDirsAppend(), traceEnvVars, tracePathsAndFiles, UNIX_STRING_DIR_SEP, and WIN_STRING_DIR_SEP.

Referenced by PGM_KICAD::OnPgmInit(), and PGM_TEST_FRAME::OnPgmInit().

IsKicadEnvVariableDefined()

virtual bool PGM_BASE::IsKicadEnvVariableDefined ( ) const

inlinevirtualinherited

Definition at line 194 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 508 of file pgm_base.cpp.

{
    m_help_size.x = 500;
    m_help_size.y = 400;

    m_show_env_var_dialog = GetCommonSettings()->m_Env.show_warning_dialog;
    m_editor_name = GetCommonSettings()->m_System.editor_name;

    for( const auto& it : GetCommonSettings()->m_Env.vars )
    {
        wxString key( it.first.c_str(), wxConvUTF8 );
        wxLogTrace( traceEnvVars, "PGM_BASE::loadCommonSettings: Found entry %s = %s",
                    key, it.second );

        // 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( key == PROJECT_VAR_NAME )
            continue;

        if( m_local_env_vars[ key ].GetDefinedExternally() )
            continue;

        wxLogTrace( traceEnvVars, "PGM_BASE::loadCommonSettings: Updating entry %s = %s",
                    key, it.second );

        m_local_env_vars[ key ] = ENV_VAR_ITEM( it.second, wxGetEnv( it.first, nullptr ) );
    }

    for( auto& m_local_env_var : m_local_env_vars )
        SetLocalEnvVariable( m_local_env_var.first, m_local_env_var.second.GetValue() );
}

References COMMON_SETTINGS::SYSTEM::editor_name, PGM_BASE::GetCommonSettings(), PGM_BASE::m_editor_name, COMMON_SETTINGS::m_Env, PGM_BASE::m_help_size, PGM_BASE::m_local_env_vars, PGM_BASE::m_show_env_var_dialog, COMMON_SETTINGS::m_System, PROJECT_VAR_NAME, PGM_BASE::SetLocalEnvVariable(), COMMON_SETTINGS::ENVIRONMENT::show_warning_dialog, 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(), APP_SINGLE_TOP::OnInit(), and APP_SINGLE_TOP::OnRun().

OnPgmInit()

bool PGM_SINGLE_TOP::OnPgmInit

(

)

Definition at line 313 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

    if( !InitPgm() )
    {
        // 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* getter = &KIFACE_GETTER;

    int  kiface_version;

    // Get the KIFACE.
    KIFACE* kiface = 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 },
        { wxT( "" ),       FRAME_T_COUNT }
    };

    wxString frameName;

    if( parser.Found( "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.

    // 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, 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 42 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 541 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();
        GetCommonSettings()->m_Env.show_warning_dialog = m_show_env_var_dialog;

        // remove only the old env vars that do not exist in list.
        // We do not clear the full list because some are defined externally,
        // and we cannot modify or delete them
        std::map<std::string, wxString>& curr_vars = GetCommonSettings()->m_Env.vars;

        for( auto it = curr_vars.begin(); it != curr_vars.end(); )
        {
            const std::string& key = it->first;

            if( m_local_env_vars.find( key ) == m_local_env_vars.end() )
                it = curr_vars.erase( it );     // This entry no longer exists in new list
            else
                it++;
        }

       // Save the local environment variables.
        for( auto& m_local_env_var : m_local_env_vars )
        {
            if( m_local_env_var.second.GetDefinedExternally() )
                continue;

            wxLogTrace( traceEnvVars,
                        "PGM_BASE::SaveCommonSettings: Saving environment variable config "
                        "entry %s as %s",
                        m_local_env_var.first, m_local_env_var.second.GetValue() );

            std::string key( m_local_env_var.first.ToUTF8() );
            GetCommonSettings()->m_Env.vars[ key ] = m_local_env_var.second.GetValue();
        }
    }
}

References PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_Env, PGM_BASE::m_local_env_vars, PGM_BASE::m_show_env_var_dialog, COMMON_SETTINGS::m_System, COMMON_SETTINGS::ENVIRONMENT::show_warning_dialog, traceEnvVars, COMMON_SETTINGS::ENVIRONMENT::vars, and COMMON_SETTINGS::SYSTEM::working_dir.

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

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 messsage(s) in

Returns

false if the language could not be set

Definition at line 684 of file pgm_base.cpp.

{
    setLanguageId( wxLANGUAGE_DEFAULT );

    // dictionary file name without extend (full name is kicad.mo)
    wxString dictionaryName( "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, "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().

SetEditorName()

void PGM_BASE::SetEditorName ( const wxString &  aFileName )

virtualinherited

Definition at line 147 of file pgm_base.cpp.

{
    m_editor_name = aFileName;
    wxASSERT( GetCommonSettings() );
    GetCommonSettings()->m_System.editor_name = aFileName;
}

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

Referenced by PGM_BASE::GetEditorName().

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 466 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 589 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( "kicad" );

    delete m_locale;
    m_locale = new wxLocale;

    if( !m_locale->Init( m_language_id ) )
    {
        wxLogTrace( traceLocale, "This language is not supported by the system." );

        setLanguageId( wxLANGUAGE_DEFAULT );
        delete m_locale;

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

        aErrMsg = _( "This language is not supported by the operating system." );
        return false;
    }
    else if( !first_time )
    {
        wxLogTrace( traceLocale, "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, "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::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 340 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 fromthe 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 722 of file pgm_base.cpp.

{
    wxLogTrace( traceLocale, "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 738 of file pgm_base.cpp.

{
    SEARCH_STACK    guesses;

    SystemDirsAppend( &guesses );

    // Add our internat dir to the wxLocale catalog of paths
    for( unsigned i = 0; i < guesses.GetCount(); i++ )
    {
        wxFileName fn( guesses[i], wxEmptyString );

        // Append path for Windows and unix KiCad package install
        fn.AppendDir( "share" );
        fn.AppendDir( "internat" );

        if( fn.IsDirReadable() )
        {
            wxLogTrace( traceLocale, "Adding locale lookup path: " + fn.GetPath() );
            wxLocale::AddCatalogLookupPathPrefix( fn.GetPath() );
        }

        // Append path for unix standard install
        fn.RemoveLastDir();
        fn.AppendDir( "kicad" );
        fn.AppendDir( "internat" );

        if( fn.IsDirReadable() )
        {
            wxLogTrace( traceLocale, "Adding locale lookup path: " + fn.GetPath() );
            wxLocale::AddCatalogLookupPathPrefix( fn.GetPath() );
        }

    // Append path for macOS install
        fn.RemoveLastDir();
        fn.RemoveLastDir();
        fn.RemoveLastDir();
        fn.AppendDir( "internat" );

        if( fn.IsDirReadable() )
        {
            wxLogTrace( traceLocale, "Adding locale lookup path: " + fn.GetPath() );
            wxLocale::AddCatalogLookupPathPrefix( fn.GetPath() );
        }
    }

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

References PGM_BASE::GetExecutablePath(), Pgm(), SystemDirsAppend(), and traceLocale.

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 793 of file pgm_base.cpp.

{
    wxString env;

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

    wxLogTrace( traceEnvVars,
                "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 ( const ENV_VAR_MAP &  aEnvVarMap )

virtualinherited

Set the internal local environment variable map to aEnvVarMap, updates the entries in the .kicad_common configuration file and sets the environment variable to the new settings.

Parameters

aEnvVarMap

is a ENV_VAR_MAP object containing the new environment variables.

Definition at line 814 of file pgm_base.cpp.

{
    m_local_env_vars.clear();
    m_local_env_vars = aEnvVarMap;

    SaveCommonSettings();

    // Overwrites externally defined environment variable until the next time the application
    // is run.
    for( auto& m_local_env_var : m_local_env_vars )
    {
        wxLogTrace( traceEnvVars,
                    "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::m_local_env_vars, PGM_BASE::SaveCommonSettings(), and traceEnvVars.

SetPdfBrowserName()

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

inlinevirtualinherited

Definition at line 204 of file pgm_base.h.

{ m_pdf_browser = aFileName; }

References PGM_BASE::m_pdf_browser.

Referenced by PGM_BASE::ReadPdfBrowserInfos().

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 211 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 49 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

full path to this program

Definition at line 355 of file pgm_base.h.

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

m_editor_name

wxString PGM_BASE::m_editor_name

protectedinherited

Definition at line 371 of file pgm_base.h.

Referenced by PGM_BASE::GetEditorName(), PGM_BASE::loadCommonSettings(), and PGM_BASE::SetEditorName().

m_help_size

wxSize PGM_BASE::m_help_size

protectedinherited

Definition at line 372 of file pgm_base.h.

Referenced by PGM_BASE::loadCommonSettings().

m_kicad_env

wxString PGM_BASE::m_kicad_env

protectedinherited

The KICAD system environment variable.

Definition at line 358 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

The current language setting.

Definition at line 364 of file pgm_base.h.

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

m_local_env_vars

ENV_VAR_MAP PGM_BASE::m_local_env_vars

protectedinherited

Local environment variable expansion settings such as KICAD6_FOOTPRINT_DIR, and KICAD6_3DMODEL_DIR.

Definition at line 375 of file pgm_base.h.

Referenced by PGM_BASE::GetLocalEnvVariables(), PGM_BASE::InitPgm(), PGM_BASE::loadCommonSettings(), PGM_BASE::SaveCommonSettings(), and PGM_BASE::SetLocalEnvVariables().

m_locale

wxLocale* PGM_BASE::m_locale

protectedinherited

The current locale.

Definition at line 361 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 333 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

The file name of the the program selected for browsing pdf files.

Definition at line 370 of file pgm_base.h.

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

m_pgm_checker

wxSingleInstanceChecker* PGM_BASE::m_pgm_checker

protectedinherited

prevents multiple instances of a program from being run at the same time.

Definition at line 352 of file pgm_base.h.

Referenced by PGM_BASE::Destroy(), PGM_BASE::InitPgm(), and PGM_BASE::PGM_BASE().

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 331 of file pgm_base.h.

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

m_settings_manager

std::unique_ptr<SETTINGS_MANAGER> PGM_BASE::m_settings_manager

protectedinherited

Definition at line 349 of file pgm_base.h.

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

m_show_env_var_dialog

bool PGM_BASE::m_show_env_var_dialog

protectedinherited

Flag to indicate if the environment variable overwrite warning dialog should be shown.

Definition at line 378 of file pgm_base.h.

Referenced by PGM_BASE::loadCommonSettings(), PGM_BASE::PGM_BASE(), and PGM_BASE::SaveCommonSettings().

m_use_system_pdf_browser

bool PGM_BASE::m_use_system_pdf_browser

protectedinherited

true to use the selected PDF browser, if exists, or false to use the default

Definition at line 367 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 302 of file pgm_base.h.

---

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

• single_top.cpp