startwizard.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2023 Mark Roszko <[email protected]>
 * Copyright (C) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
#include <build_version.h>
#include <confirm.h>
#include <eda_base_frame.h>
#include <kiface_base.h>
#include <pgm_base.h>
#include <wx/display.h>
#include <wx/statline.h>
#include <wx/wx.h>
#include <wx/wizard.h>
#include <startwizard/startwizard.h>
#include <startwizard/startwizard_provider.h>
#include <startwizard/startwizard_provider_libraries.h>
#include <startwizard/startwizard_provider_privacy.h>
#include <startwizard/startwizard_provider_settings.h>
#include <ui_events.h>
#include <wx/hyperlink.h>
 
 
class STARTWIZARD_PAGE : public wxWizardPageSimple
{
public:
    STARTWIZARD_PAGE( wxWizard* aParent, const wxString& aPageTitle ) :
            wxWizardPageSimple( aParent )
    {
        wxBoxSizer* outerSizer = new wxBoxSizer( wxVERTICAL );
 
        m_scrolledWindow = new wxScrolledWindow( this, wxID_ANY, wxDefaultPosition, wxDefaultSize,
                                                 wxVSCROLL | wxBORDER_NONE );
        m_scrolledWindow->SetScrollRate( 0, 5 );
 
        m_mainSizer = new wxBoxSizer( wxVERTICAL );
 
        wxStaticText* pageTitle = new wxStaticText( m_scrolledWindow, -1, aPageTitle );
        pageTitle->SetFont(
                wxFont( 14, wxFONTFAMILY_DEFAULT, wxFONTSTYLE_NORMAL, wxFONTWEIGHT_BOLD ) );
        m_mainSizer->Add( pageTitle, 0, wxALIGN_CENTRE | wxALL, 5 );
 
        wxStaticLine* pageDivider = new wxStaticLine( m_scrolledWindow, wxID_ANY,
                                                      wxDefaultPosition, wxDefaultSize,
                                                      wxLI_HORIZONTAL );
        m_mainSizer->Add( pageDivider, 0, wxEXPAND | wxALL, 5 );
 
        m_scrolledWindow->SetSizer( m_mainSizer );
 
        outerSizer->Add( m_scrolledWindow, 1, wxEXPAND );
        SetSizer( outerSizer );
    }
 
    // Returns the scrolled content area; use this as the parent for panel content
    // so the content is scrollable when the wizard is smaller than the page requires.
    wxWindow* GetContentParent() const { return m_scrolledWindow; }
 
    void AddContent( wxPanel* aContent )
    {
        m_mainSizer->Add( aContent, 0, wxEXPAND );
        m_scrolledWindow->FitInside();
    }
 
    // Returns the minimum size of the scrolled content, independent of the page size.
    wxSize GetContentMinSize() const { return m_mainSizer->CalcMin(); }
 
private:
    wxScrolledWindow* m_scrolledWindow;
    wxBoxSizer*       m_mainSizer;
};
 
 
class STARTWIZARD_WELCOME_PAGE : public wxWizardPageSimple
{
public:
    STARTWIZARD_WELCOME_PAGE( wxWizard* aParent ) : wxWizardPageSimple( aParent )
    {
        m_mainSizer = new wxBoxSizer( wxVERTICAL );
 
        wxStaticText* pageTitle = new wxStaticText(
                this, -1, wxString::Format( _( "Welcome to KiCad %s" ), GetMajorMinorVersion() ) );
        pageTitle->SetFont(
                wxFont( 14, wxFONTFAMILY_DEFAULT, wxFONTSTYLE_NORMAL, wxFONTWEIGHT_BOLD ) );
        m_mainSizer->Add( pageTitle, 0, wxALIGN_CENTRE | wxALL, 5 );
 
        wxStaticLine* pageDivider = new wxStaticLine( this, wxID_ANY, wxDefaultPosition,
                                                      wxDefaultSize, wxLI_HORIZONTAL );
        m_mainSizer->Add( pageDivider, 0, wxEXPAND | wxALL, 5 );
 
        m_welcomeText = new wxStaticText( this, -1,
            _( "KiCad is starting for the first time, or some of its configuration files are missing.\n\n"
               "Let's take a moment to configure some basic settings.  You can always modify these "
               "settings later by opening the Preferences dialog." ) );
        m_mainSizer->Add( m_welcomeText, 0, wxEXPAND | wxALL, 5 );
 
        wxBoxSizer* helpSizer = new wxBoxSizer( wxHORIZONTAL );
        wxStaticText* helpLabel = new wxStaticText( this, -1, _( "For help, please visit " ) );
        wxString docsUrl = wxString::Format( "https://go.kicad.org/docs/%s", GetMajorMinorVersion() );
        wxHyperlinkCtrl* helpLink = new wxHyperlinkCtrl( this, -1, wxT( "docs.kicad.org" ), docsUrl );
        helpSizer->Add( helpLabel, 0, wxLEFT | wxTOP | wxBOTTOM | wxALIGN_CENTER_VERTICAL, 5 );
        helpSizer->Add( helpLink, 0, wxRIGHT | wxTOP | wxBOTTOM | wxALIGN_CENTER_VERTICAL, 5 );
        m_mainSizer->Add( helpSizer, 0, wxEXPAND, 5 );
 
        SetSizerAndFit( m_mainSizer );
    }
 
    void SetWrap( int aWidth ) const
    {
        m_welcomeText->Wrap( aWidth );
    }
 
private:
    wxBoxSizer* m_mainSizer;
    wxStaticText* m_welcomeText;
};
 
 
STARTWIZARD::STARTWIZARD() :
    m_wizard( nullptr )
{
}
 
 
STARTWIZARD::~STARTWIZARD()
{
}
 
 
STARTWIZARD_PROVIDER* STARTWIZARD::GetProvider( const wxString& aName )
{
    if( auto it = std::ranges::find_if( m_providers,
                                        [&]( const std::unique_ptr<STARTWIZARD_PROVIDER>& aProvider )
                                        {
                                            return aProvider->Name() == aName;
                                        } ); it != m_providers.end() )
    {
        return it->get();
    }
 
    return nullptr;
}
 
 
void STARTWIZARD::CheckAndRun( wxWindow* aParent )
{
    m_providers.clear();
 
    m_providers.push_back( std::make_unique<STARTWIZARD_PROVIDER_SETTINGS>() );
    m_providers.push_back( std::make_unique<STARTWIZARD_PROVIDER_LIBRARIES>() );
    m_providers.push_back( std::make_unique<STARTWIZARD_PROVIDER_PRIVACY>() );
    //providers.push_back( std::make_unique<STARTWIZARD_PROVIDER_LOOK_AND_FEEL>() );
 
    if( m_providers.size() == 0 )
        return;
 
    bool wizardRequired = std::ranges::any_of( std::as_const( m_providers ),
                                               []( const std::unique_ptr<STARTWIZARD_PROVIDER>& aProvider ) -> bool
                                               {
                                                   return aProvider->NeedsUserInput();
                                               } );
 
    if( !wizardRequired )
        return;
 
    Pgm().HideSplash();
 
    m_wizard = new wxWizard( aParent, wxID_ANY, _( "KiCad Setup" ) );
    m_wizard->SetWindowStyleFlag( wxRESIZE_BORDER );
 
    STARTWIZARD_WELCOME_PAGE* firstPage = new STARTWIZARD_WELCOME_PAGE( m_wizard );
    wxWizardPageSimple* lastPage = nullptr;
    wxSize minPageSize;
 
    for( std::unique_ptr<STARTWIZARD_PROVIDER>& provider : m_providers )
    {
        if( !provider->NeedsUserInput() )
            continue;
 
        provider->SetWasShown( true );
 
        STARTWIZARD_PAGE* page = new STARTWIZARD_PAGE( m_wizard, provider->GetPageName() );
        wxPanel*          panel = provider->GetWizardPanel( page->GetContentParent(), this );
        page->AddContent( panel );
 
        if( lastPage != nullptr )
        {
            lastPage->Chain( page );
        }
        else
        {
            firstPage->Chain( page );
        }
 
        lastPage = page;
 
        wxSize size = page->GetContentMinSize();
 
        if( size.x > minPageSize.x )
            minPageSize.x = size.x;
 
        if( size.y > minPageSize.y )
            minPageSize.y = size.y;
    }
 
    // Clamp the page size to the available display area so the wizard is fully
    // accessible on small or low-resolution screens.  Reserve space for the
    // wizard title bar, the Back/Next/Cancel button row, and a small margin.
    static constexpr int WIZARD_CHROME_HEIGHT = 120;
    static constexpr int WIZARD_MARGIN = 40;
 
    wxSize pageSize = minPageSize + wxSize( 20, 20 );
 
    int displayIdx = wxDisplay::GetFromWindow( aParent ? aParent : wxTheApp->GetTopWindow() );
 
    if( displayIdx == wxNOT_FOUND )
        displayIdx = 0;
 
    wxRect displayArea = wxDisplay( (unsigned int) displayIdx ).GetClientArea();
    int maxPageHeight = displayArea.GetHeight() - WIZARD_CHROME_HEIGHT - WIZARD_MARGIN;
 
    if( maxPageHeight > 0 && pageSize.y > maxPageHeight )
        pageSize.y = maxPageHeight;
 
    m_wizard->SetPageSize( pageSize );
    firstPage->SetWrap( pageSize.x );
 
    m_wizard->Bind( wxEVT_WIZARD_CANCEL,
            [&]( wxWizardEvent& aEvt )
            {
                if( IsOK( aParent, _( "Are you sure?  If you cancel KiCad setup, default settings "
                                      "will be chosen for you." ) ) )
                {
                    for( std::unique_ptr<STARTWIZARD_PROVIDER>& provider : m_providers )
                    {
                        provider->ApplyDefaults();
                    }
                }
                else
                {
                    aEvt.Veto();
                }
            } );
 
    int languageBefore = Pgm().GetSelectedLanguageIdentifier();
 
    if( m_wizard->RunWizard( firstPage ) )
    {
        for( std::unique_ptr<STARTWIZARD_PROVIDER>& provider : m_providers )
        {
            if( !provider->WasShown() )
                continue;
 
            provider->Finish();
        }
    }
 
    m_wizard->Destroy();
    m_wizard = nullptr;
 
    // Settings import can switch the language after the parent frame was already built in the
    // system locale, so retranslate it to avoid requiring a restart.
    if( Pgm().GetSelectedLanguageIdentifier() != languageBefore && aParent )
    {
        // A dynamic_cast could be better, but creates link issues because EDA_BASE_FRAME lives in
        // the common library while this code lives in kicommon, so a static_cast is used.  Every
        // caller passes an EDA_BASE_FRAME-derived frame.
        EDA_BASE_FRAME* frame = static_cast<EDA_BASE_FRAME*>( aParent );
 
        frame->ShowChangedLanguage();
 
        wxCommandEvent e( EDA_LANG_CHANGED );
        frame->GetEventHandler()->ProcessEvent( e );
    }
}