panel_common_settings.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The 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 2
 * 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 <dialogs/panel_common_settings.h>
 
#include <advanced_config.h>
#include <bitmaps.h>
#include <class_draw_panel_gal.h>
#include <dpi_scaling_common.h>
#include <eda_draw_frame.h>
#include <gal/graphics_abstraction_layer.h>
#include <kiface_base.h>
#include <kiplatform/ui.h>
#include <pgm_base.h>
#include <id.h>
#include <settings/common_settings.h>
#include <settings/settings_manager.h>
#include <widgets/std_bitmap_button.h>
#include <wx/filedlg.h>
 
#include <algorithm>
 
/*
 * What follows is a whole lot of ugly to handle various platform GUI deficiences with respect
 * to light/dark mode, DPI scaling, and other foibles.
 *
 * Ugly as it all is, it does improve our usability on various platforms.
 */
 
struct CANVAS_CHOICE
{
    int      type;
    wxString label;
};
 
 
static std::vector<CANVAS_CHOICE> canvasChoices()
{
    return {
        { EDA_DRAW_PANEL_GAL::GAL_TYPE_OPENGL, _( "Accelerated Graphics" ) },
#ifdef __WXMAC__
        { EDA_DRAW_PANEL_GAL::GAL_TYPE_MODERN, _( "RHI Metal (Experimental)" ) },
#else
        { EDA_DRAW_PANEL_GAL::GAL_TYPE_CAIRO, _( "Fallback Graphics" ) },
        { EDA_DRAW_PANEL_GAL::GAL_TYPE_MODERN, _( "RHI Vulkan (Experimental)" ) },
#endif
    };
}
 
 
PANEL_COMMON_SETTINGS::PANEL_COMMON_SETTINGS( wxWindow* aParent ) :
        PANEL_COMMON_SETTINGS_BASE( aParent )
{
    m_canvasType->Clear();
 
    for( const CANVAS_CHOICE& choice : canvasChoices() )
        m_canvasType->Append( choice.label );
 
    m_canvasType->SetSelection( 0 );
 
    ShowFileManagerWidgets( ADVANCED_CFG::GetCfg().m_EnableLibDir );
 
    m_textEditorBtn->SetBitmap( KiBitmapBundle( BITMAPS::small_folder ) );
    m_pdfViewerBtn->SetBitmap( KiBitmapBundle( BITMAPS::small_folder ) );
 
    /*
     * Automatic dark mode detection works fine on Mac, so no need for the explicit options.
     */
#ifdef __WXMAC__
    m_stIconTheme->Show( false );
    m_rbIconThemeLight->Show( false );
    m_rbIconThemeDark->Show( false );
    m_rbIconThemeAuto->Show( false );
#endif
 
    // It's common on Windows to have separate app and system settings for light/dark
#ifndef __WXMSW__
    m_stAppTheme->Show( false );
    m_rbAppThemeLight->Show( false );
    m_rbAppThemeDark->Show( false );
    m_rbAppThemeAuto->Show( false );
#endif
 
    /*
     * Automatic canvas scaling works fine on all supported platforms, so manual scaling is disabled
     */
    if( ADVANCED_CFG::GetCfg().m_AllowManualCanvasScale )
    {
        static constexpr int    dpi_scaling_precision = 1;
        static constexpr double dpi_scaling_increment = 0.5;
 
        m_canvasScaleCtrl->SetRange( DPI_SCALING::GetMinScaleFactor(),
                                     DPI_SCALING::GetMaxScaleFactor() );
        m_canvasScaleCtrl->SetDigits( dpi_scaling_precision );
        m_canvasScaleCtrl->SetIncrement( dpi_scaling_increment );
        m_canvasScaleCtrl->SetValue( DPI_SCALING::GetDefaultScaleFactor() );
 
        m_canvasScaleCtrl->SetToolTip( _( "Set the scale for the canvas."
                                          "\n\n"
                                          "On high-DPI displays on some platforms, KiCad cannot determine the "
                                          "scaling factor. In this case you may need to set this to a value to "
                                          "match your system's DPI scaling. 2.0 is a common value. "
                                          "\n\n"
                                          "If this does not match the system DPI scaling, the canvas will "
                                          "not match the window size and cursor position." ) );
 
        m_canvasScaleAuto->SetToolTip( _( "Use an automatic value for the canvas scale."
                                          "\n\n"
                                          "On some platforms, the automatic value is incorrect and should be "
                                          "set manually." ) );
    }
    else
    {
        m_staticTextCanvasScale->Show( false );
        m_canvasScaleCtrl->Show( false );
        m_canvasScaleCtrl = nullptr;
        m_canvasScaleAuto->Show( false );
    }
 
    m_zoomCorrectionCtrl = new ZOOM_CORRECTION_CTRL( this,
                                                     Pgm().GetCommonSettings()->m_Appearance.zoom_correction_factor,
                                                     ADVANCED_CFG::GetCfg().m_ScreenDPI );
 
    m_scalingSizer->Add( m_zoomCorrectionCtrl, 1, wxEXPAND );
 
    // Hide the option of icons in menus for platforms that do not support them
    m_checkBoxIconsInMenus->Show( KIPLATFORM::UI::AllowIconsInMenus() );
 
    m_scaleFonts->Show( false );
    m_fontScalingHelp->Show( false );
 
    if( m_canvasScaleCtrl )
    {
        m_canvasScaleCtrl->Connect( wxEVT_COMMAND_TEXT_UPDATED,
                                    wxCommandEventHandler( PANEL_COMMON_SETTINGS::OnCanvasScaleChange ),
                                    nullptr, this );
    }
 
    wxSize minSize = m_highContrastCtrl->GetMinSize();
    int    minWidth = m_highContrastCtrl->GetTextExtent( wxT( "XXX.XXX" ) ).GetWidth();
 
    m_highContrastCtrl->SetMinSize( wxSize( minWidth, minSize.GetHeight() ) );
}
 
 
PANEL_COMMON_SETTINGS::~PANEL_COMMON_SETTINGS()
{
    if( m_canvasScaleCtrl )
    {
        m_canvasScaleCtrl->Disconnect( wxEVT_COMMAND_TEXT_UPDATED,
                                       wxCommandEventHandler( PANEL_COMMON_SETTINGS::OnCanvasScaleChange ),
                                       nullptr, this );
    }
}
 
 
bool PANEL_COMMON_SETTINGS::TransferDataToWindow()
{
    COMMON_SETTINGS* commonSettings = Pgm().GetCommonSettings();
 
    applySettingsToPanel( *commonSettings );
 
    m_textCtrlFileManager->SetValue( commonSettings->m_System.file_explorer );
 
    // TODO(JE) Move these into COMMON_SETTINGS probably
    m_textEditorPath->SetValue( Pgm().GetTextEditor( false ) );
    m_defaultPDFViewer->SetValue( Pgm().UseSystemPdfBrowser() );
    m_otherPDFViewer->SetValue( !Pgm().UseSystemPdfBrowser() );
    m_PDFViewerPath->SetValue( Pgm().GetPdfBrowserName() );
    setPdfViewerPathState();
 
    return true;
}
 
 
bool PANEL_COMMON_SETTINGS::TransferDataFromWindow()
{
    COMMON_SETTINGS* commonSettings = Pgm().GetCommonSettings();
 
    commonSettings->m_System.file_explorer = m_textCtrlFileManager->GetValue();
    commonSettings->m_System.file_history_size = m_fileHistorySize->GetValue();
 
    commonSettings->m_Graphics.aa_mode = m_antialiasing->GetSelection();
 
    const std::vector<CANVAS_CHOICE> choices = canvasChoices();
    int                              sel = m_canvasType->GetSelection();
 
    if( sel >= 0 && sel < static_cast<int>( choices.size() ) )
        commonSettings->m_Graphics.canvas_type = choices[sel].type;
    else
        commonSettings->m_Graphics.canvas_type = EDA_DRAW_PANEL_GAL::GAL_TYPE_OPENGL;
 
    if( m_canvasScaleCtrl )
    {
        DPI_SCALING_COMMON dpi( commonSettings, this );
        dpi.SetDpiConfig( m_canvasScaleAuto->GetValue(), m_canvasScaleCtrl->GetValue() );
    }
 
    if( m_rbIconThemeLight->GetValue() )
        commonSettings->m_Appearance.icon_theme = ICON_THEME::LIGHT;
    else if( m_rbIconThemeDark->GetValue() )
        commonSettings->m_Appearance.icon_theme = ICON_THEME::DARK;
    else if( m_rbIconThemeAuto->GetValue() )
        commonSettings->m_Appearance.icon_theme = ICON_THEME::AUTO;
 
    if( m_rbAppThemeLight->GetValue() )
        commonSettings->m_Appearance.app_theme = APP_THEME::LIGHT;
    else if( m_rbAppThemeDark->GetValue() )
        commonSettings->m_Appearance.app_theme = APP_THEME::DARK;
    else if( m_rbAppThemeAuto->GetValue() )
        commonSettings->m_Appearance.app_theme = APP_THEME::AUTO;
 
    if( m_rbIconSizeSmall->GetValue() )
        commonSettings->m_Appearance.toolbar_icon_size = 16;
    else if( m_rbIconSizeNormal->GetValue() )
        commonSettings->m_Appearance.toolbar_icon_size = 24;
    else if( m_rbIconSizeLarge->GetValue() )
        commonSettings->m_Appearance.toolbar_icon_size = 32;
 
    commonSettings->m_Appearance.use_icons_in_menus = m_checkBoxIconsInMenus->GetValue();
    commonSettings->m_Appearance.apply_icon_scale_to_fonts = m_scaleFonts->GetValue();
 
    commonSettings->m_Appearance.show_scrollbars = m_showScrollbars->GetValue();
 
    commonSettings->m_Appearance.grid_striping = m_gridStriping->GetValue();
 
    commonSettings->m_Appearance.use_custom_cursors = !m_disableCustomCursors->GetValue();
 
    commonSettings->m_Appearance.zoom_correction_factor = m_zoomCorrectionCtrl->GetValue();
 
    double dimmingPercent = 80;
    m_highContrastCtrl->GetValue().ToDouble( &dimmingPercent );
    commonSettings->m_Appearance.hicontrast_dimming_factor = dimmingPercent / 100.0f;
 
    commonSettings->m_Input.focus_follow_sch_pcb = m_focusFollowSchPcb->GetValue();
    commonSettings->m_Input.hotkey_feedback      = m_hotkeyFeedback->GetValue();
    commonSettings->m_Input.immediate_actions    = !m_NonImmediateActions->GetValue();
    commonSettings->m_Input.warp_mouse_on_move   = m_warpMouseOnMove->GetValue();
 
    commonSettings->m_Backup.enabled             = m_cbBackupEnabled->GetValue();
    commonSettings->m_Backup.limit_total_size    = m_backupLimitTotalSize->GetValue() * 1024ULL * 1024ULL;
 
    // The radio-box choice order is constructed to match these enum values; if the enum
    // is reordered in common_settings.h the ternaries below silently flip without these.
    static_assert( static_cast<int>( BACKUP_FORMAT::INCREMENTAL ) == 0 );
    static_assert( static_cast<int>( BACKUP_FORMAT::ZIP ) == 1 );
    static_assert( static_cast<int>( BACKUP_LOCATION::PROJECT_DIR ) == 0 );
    static_assert( static_cast<int>( BACKUP_LOCATION::USER_DIR ) == 1 );
 
    commonSettings->m_Backup.format = ( m_choiceBackupFormat->GetSelection() == 0 )
                                              ? BACKUP_FORMAT::INCREMENTAL
                                              : BACKUP_FORMAT::ZIP;
 
    commonSettings->m_Backup.location = ( m_choiceBackupLocation->GetSelection() == 0 )
                                                ? BACKUP_LOCATION::PROJECT_DIR
                                                : BACKUP_LOCATION::USER_DIR;
 
    commonSettings->m_Session.remember_open_files = m_cbRememberOpenFiles->GetValue();
 
    Pgm().SetTextEditor( m_textEditorPath->GetValue());
 
    Pgm().SetPdfBrowserName( m_PDFViewerPath->GetValue() );
    Pgm().ForceSystemPdfBrowser( m_defaultPDFViewer->GetValue() );
    Pgm().WritePdfBrowserInfos();
 
    Pgm().GetSettingsManager().Save( commonSettings );
 
    return true;
}
 
 
void PANEL_COMMON_SETTINGS::ResetPanel()
{
    COMMON_SETTINGS defaultSettings;
 
    defaultSettings.ResetToDefaults();
 
    applySettingsToPanel( defaultSettings );
 
    // TODO(JE) Move these into COMMON_SETTINGS probably
    m_textEditorPath->SetValue( defaultSettings.m_System.text_editor );
    m_defaultPDFViewer->SetValue( defaultSettings.m_System.use_system_pdf_viewer );
    m_otherPDFViewer->SetValue( !defaultSettings.m_System.use_system_pdf_viewer );
    m_PDFViewerPath->SetValue( defaultSettings.m_System.pdf_viewer_name );
    setPdfViewerPathState();
}
 
 
void PANEL_COMMON_SETTINGS::applySettingsToPanel( COMMON_SETTINGS& aSettings )
{
    m_fileHistorySize->SetValue( aSettings.m_System.file_history_size );
 
    m_antialiasing->SetSelection( aSettings.m_Graphics.aa_mode );
 
    // A canvas this platform does not offer shows as the first entry
    const std::vector<CANVAS_CHOICE> choices = canvasChoices();
    const int                        storedType = static_cast<int>(
            EDA_DRAW_PANEL_GAL::ResolveStoredCanvasType( aSettings.m_Graphics.canvas_type ) );
    auto                             it = std::ranges::find( choices, storedType, &CANVAS_CHOICE::type );
 
    m_canvasType->SetSelection( it == choices.end() ? 0 : static_cast<int>( it - choices.begin() ) );
 
    if( m_canvasScaleCtrl )
    {
        const DPI_SCALING_COMMON dpi( &aSettings, this );
        m_canvasScaleCtrl->SetValue( dpi.GetScaleFactor() );
        m_canvasScaleAuto->SetValue( dpi.GetCanvasIsAutoScaled() );
    }
 
    switch( aSettings.m_Appearance.icon_theme )
    {
    case ICON_THEME::LIGHT: m_rbIconThemeLight->SetValue( true );   break;
    case ICON_THEME::DARK:  m_rbIconThemeDark->SetValue( true );    break;
    case ICON_THEME::AUTO:  m_rbIconThemeAuto->SetValue( true );    break;
    }
 
    switch( aSettings.m_Appearance.app_theme )
    {
    case APP_THEME::LIGHT: m_rbAppThemeLight->SetValue( true ); break;
    case APP_THEME::DARK: m_rbAppThemeDark->SetValue( true ); break;
    case APP_THEME::AUTO: m_rbAppThemeAuto->SetValue( true ); break;
    }
 
    switch( aSettings.m_Appearance.toolbar_icon_size )
    {
    case 16: m_rbIconSizeSmall->SetValue( true );   break;
    case 24: m_rbIconSizeNormal->SetValue( true );  break;
    case 32: m_rbIconSizeLarge->SetValue( true );   break;
    }
 
    m_checkBoxIconsInMenus->SetValue( aSettings.m_Appearance.use_icons_in_menus );
    m_scaleFonts->SetValue( aSettings.m_Appearance.apply_icon_scale_to_fonts );
 
    m_gridStriping->SetValue( aSettings.m_Appearance.grid_striping );
 
    m_disableCustomCursors->SetValue( !aSettings.m_Appearance.use_custom_cursors );
 
    m_zoomCorrectionCtrl->SetDisplayedValue( aSettings.m_Appearance.zoom_correction_factor );
 
    double dimmingPercent = aSettings.m_Appearance.hicontrast_dimming_factor * 100.0f;
    m_highContrastCtrl->SetValue( wxString::Format( "%.0f", dimmingPercent ) );
 
    m_focusFollowSchPcb->SetValue( aSettings.m_Input.focus_follow_sch_pcb );
    m_hotkeyFeedback->SetValue( aSettings.m_Input.hotkey_feedback );
    m_warpMouseOnMove->SetValue( aSettings.m_Input.warp_mouse_on_move );
    m_NonImmediateActions->SetValue( !aSettings.m_Input.immediate_actions );
 
    m_cbRememberOpenFiles->SetValue( aSettings.m_Session.remember_open_files );
 
    m_cbBackupEnabled->SetValue( aSettings.m_Backup.enabled );
    m_backupLimitTotalSize->SetValue( aSettings.m_Backup.limit_total_size / ( 1024 * 1024 ) );
 
    m_choiceBackupFormat->SetSelection(
            aSettings.m_Backup.format == BACKUP_FORMAT::INCREMENTAL ? 0 : 1 );
 
    m_choiceBackupLocation->SetSelection(
            aSettings.m_Backup.location == BACKUP_LOCATION::PROJECT_DIR ? 0 : 1 );
 
    m_showScrollbars->SetValue( aSettings.m_Appearance.show_scrollbars );
}
 
 
void PANEL_COMMON_SETTINGS::OnCanvasScaleChange( wxCommandEvent& aEvent )
{
    m_canvasScaleAuto->SetValue( false );
}
 
 
void PANEL_COMMON_SETTINGS::OnCanvasScaleAuto( wxCommandEvent& aEvent )
{
    const bool automatic = m_canvasScaleAuto->GetValue();
 
    if( automatic && m_canvasScaleCtrl )
    {
        // set the scale to the auto value, without consulting the config
        DPI_SCALING_COMMON dpi( nullptr, this );
 
        // update the field (no events sent)
        m_canvasScaleCtrl->SetValue( dpi.GetScaleFactor() );
    }
}
 
 
void PANEL_COMMON_SETTINGS::OnTextEditorClick( wxCommandEvent& event )
{
    // Ask the user to select a new editor, but suggest the current one as the default.
    wxString editorname = Pgm().AskUserForPreferredEditor( m_textEditorPath->GetValue() );
 
    // If we have a new editor name request it to be copied to m_text_editor and saved
    // to the preferences file. If the user cancelled the dialog then the previous
    // value will be retained.
    if( !editorname.IsEmpty() )
        m_textEditorPath->SetValue( editorname );
}
 
 
void PANEL_COMMON_SETTINGS::ShowFileManagerWidgets( bool aBool )
{
    m_staticTextFileManager->Show( aBool );
    m_textCtrlFileManager->Show( aBool );
 
    if( aBool )
    {
#if defined( __WINDOWS__ )
        wxString msg = _( "Default 'explorer.exe /n,/select,%F' for this OS." );
        m_textCtrlFileManager->SetToolTip( msg );
        wxString str = "%F";
#else
        wxString msg = _( "File explorer command.\nexample:" ) + wxS( " 'nemo -n %F'" );
        m_textCtrlFileManager->SetToolTip( msg );
        wxString str= " %F";
#endif
        msg = _( "Explorer command with mandatory '%s' suffix after last entered character." );
        m_staticTextFileManager->SetToolTip( wxString::Format( msg, str ) );
    }
}
 
 
void PANEL_COMMON_SETTINGS::OnPDFViewerClick( wxCommandEvent& event )
{
    wxString mask( wxT( "*" ) );
 
#ifdef __WINDOWS__
    mask += wxT( ".exe" );
#endif
 
    wxString wildcard = _( "Executable files (" ) + mask + wxT( ")|" ) + mask;
 
    Pgm().ReadPdfBrowserInfos();
    wxFileName fn = Pgm().GetPdfBrowserName();
 
    wxWindow* topLevelParent = wxGetTopLevelParent( this );
 
    wxFileDialog dlg( topLevelParent, _( "Select Preferred PDF Viewer" ), fn.GetPath(),
                      fn.GetFullPath(), wildcard, wxFD_OPEN | wxFD_FILE_MUST_EXIST );
 
    KIPLATFORM::UI::AllowNetworkFileSystems( &dlg );
 
    if( dlg.ShowModal() == wxID_CANCEL )
        return;
 
    m_otherPDFViewer->SetValue( true );
    m_PDFViewerPath->SetValue( dlg.GetPath() );
}
 
 
void PANEL_COMMON_SETTINGS::OnRadioButtonPdfViewer( wxCommandEvent& event )
{
    setPdfViewerPathState();
}
 
 
void PANEL_COMMON_SETTINGS::setPdfViewerPathState()
{
    m_PDFViewerPath->Enable( m_otherPDFViewer->GetValue() );
    m_pdfViewerBtn->Enable( m_otherPDFViewer->GetValue() );
}