symbol_viewer_frame.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018 Jean-Pierre Charras, jp.charras at wanadoo.fr
 * Copyright (C) 2008 Wayne Stambaugh <[email protected]>
 * 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 <wx/tokenzr.h>
#include <bitmaps.h>
#include <symbol_library_common.h>
#include <confirm.h>
#include <dialogs/html_message_box.h>
#include <eeschema_id.h>
#include <eeschema_settings.h>
#include <settings/color_settings.h>
#include <gal/graphics_abstraction_layer.h>
#include <kiface_base.h>
#include <kiway.h>
#include <kiway_mail.h>
#include <locale_io.h>
#include <symbol_viewer_frame.h>
#include <symbol_edit_frame.h>
#include <widgets/msgpanel.h>
#include <widgets/wx_listbox.h>
#include <widgets/wx_aui_utils.h>
#include <widgets/wx_progress_reporters.h>
#include <sch_view.h>
#include <sch_painter.h>
#include <symbol_tree_model_adapter.h>
#include <pgm_base.h>
#include <project/project_file.h>
#include <project_sch.h>
#include <settings/settings_manager.h>
#include <tool/action_toolbar.h>
#include <tool/common_control.h>
#include <tool/common_tools.h>
#include <tool/editor_conditions.h>
#include <tool/selection.h>
#include <tool/tool_dispatcher.h>
#include <tool/tool_manager.h>
#include <tool/zoom_tool.h>
#include <tools/sch_actions.h>
#include <tools/sch_selection_tool.h>
#include <tools/symbol_editor_control.h>
#include <tools/sch_inspection_tool.h>
#include <view/view_controls.h>
#include <wx/srchctrl.h>
#include <wx/log.h>
#include <wx/choice.h>
#include <toolbars_symbol_viewer.h>
#include <trace_helpers.h>
 
#include <default_values.h>
#include <string_utils.h>
#include <libraries/symbol_library_adapter.h>
 
#include "eda_pattern_match.h"
 
// Save previous symbol library viewer state.
LIB_ID SYMBOL_VIEWER_FRAME::m_currentSymbol;
 
int SYMBOL_VIEWER_FRAME::m_unit = 1;
int SYMBOL_VIEWER_FRAME::m_bodyStyle = 1;
 
 
BEGIN_EVENT_TABLE( SYMBOL_VIEWER_FRAME, SCH_BASE_FRAME )
    // Window events
    EVT_SIZE( SYMBOL_VIEWER_FRAME::OnSize )
    EVT_ACTIVATE( SYMBOL_VIEWER_FRAME::OnActivate )
 
    // Toolbar events
    EVT_CHOICE( ID_LIBVIEW_SELECT_UNIT_NUMBER, SYMBOL_VIEWER_FRAME::onSelectSymbolUnit )
    EVT_CHOICE( ID_LIBVIEW_SELECT_BODY_STYLE, SYMBOL_VIEWER_FRAME::onSelectSymbolBodyStyle )
    EVT_CHOICE( ID_ON_ZOOM_SELECT, SYMBOL_VIEWER_FRAME::OnSelectZoom )
    EVT_CHOICE( ID_ON_GRID_SELECT, SYMBOL_VIEWER_FRAME::OnSelectGrid )
 
    // listbox events
    EVT_TEXT( ID_LIBVIEW_LIB_FILTER, SYMBOL_VIEWER_FRAME::OnLibFilter )
    EVT_LISTBOX( ID_LIBVIEW_LIB_LIST, SYMBOL_VIEWER_FRAME::ClickOnLibList )
    EVT_TEXT( ID_LIBVIEW_SYM_FILTER, SYMBOL_VIEWER_FRAME::OnSymFilter )
    EVT_LISTBOX( ID_LIBVIEW_SYM_LIST, SYMBOL_VIEWER_FRAME::ClickOnSymbolList )
    EVT_LISTBOX_DCLICK( ID_LIBVIEW_SYM_LIST, SYMBOL_VIEWER_FRAME::DClickOnSymbolList )
 
    // Menu (and/or hotkey) events
    EVT_MENU( wxID_CLOSE, SYMBOL_VIEWER_FRAME::CloseLibraryViewer )
 
END_EVENT_TABLE()
 
 
SYMBOL_VIEWER_FRAME::SYMBOL_VIEWER_FRAME( KIWAY* aKiway, wxWindow* aParent ) :
        SCH_BASE_FRAME( aKiway, aParent, FRAME_SCH_VIEWER, _( "Symbol Library Browser" ), wxDefaultPosition,
                        wxDefaultSize, KICAD_DEFAULT_DRAWFRAME_STYLE, LIB_VIEW_FRAME_NAME ),
        m_unitChoice( nullptr ),
        m_bodyStyleChoice( nullptr ),
        m_libList( nullptr ),
        m_symbolList( nullptr )
{
    m_aboutTitle = _HKI( "KiCad Symbol Library Browser" );
 
    // Force the frame name used in config. the lib viewer frame has a name
    // depending on aFrameType (needed to identify the frame by wxWidgets),
    // but only one configuration is preferable.
    m_configName = LIB_VIEW_FRAME_NAME;
 
    // Give an icon
    wxIcon  icon;
    icon.CopyFromBitmap( KiBitmap( BITMAPS::library_browser ) );
    SetIcon( icon );
 
    m_libListWidth = 200;
    m_symbolListWidth = 300;
    m_listPowerOnly = false;
 
    SetScreen( new SCH_SCREEN );
    GetScreen()->m_Center = true;      // Axis origin centered on screen.
    LoadSettings( config() );
 
    // Ensure axis are always drawn (initial default display was not drawn)
    KIGFX::GAL_DISPLAY_OPTIONS& gal_opts = GetGalDisplayOptions();
    gal_opts.m_axesEnabled = true;
    gal_opts.m_gridMinSpacing = 10.0;
    gal_opts.NotifyChanged();
 
    GetRenderSettings()->LoadColors( GetColorSettings() );
    GetCanvas()->GetGAL()->SetAxesColor( m_colorSettings->GetColor( LAYER_SCHEMATIC_GRID_AXES ) );
 
    GetRenderSettings()->SetDefaultPenWidth( DEFAULT_LINE_WIDTH_MILS * schIUScale.IU_PER_MILS );
 
    setupTools();
    setupUIConditions();
 
    m_toolbarSettings = GetToolbarSettings<SYMBOL_VIEWER_TOOLBAR_SETTINGS>( "symbol_viewer-toolbars" );
    configureToolbars();
    RecreateToolbars();
 
    ReCreateMenuBar();
 
    wxPanel* libPanel = new wxPanel( this );
    wxSizer* libSizer = new wxBoxSizer( wxVERTICAL );
 
    m_libFilter = new wxSearchCtrl( libPanel, ID_LIBVIEW_LIB_FILTER, wxEmptyString, wxDefaultPosition,
                                    wxDefaultSize, wxTE_PROCESS_ENTER );
    m_libFilter->SetDescriptiveText( _( "Filter" ) );
    libSizer->Add( m_libFilter, 0, wxEXPAND, 5 );
 
    m_libList = new WX_LISTBOX( libPanel, ID_LIBVIEW_LIB_LIST, wxDefaultPosition, wxDefaultSize, 0, nullptr,
                                wxLB_HSCROLL | wxNO_BORDER );
    libSizer->Add( m_libList, 1, wxEXPAND, 5 );
 
    libPanel->SetSizer( libSizer );
    libPanel->Fit();
 
    wxPanel* symbolPanel = new wxPanel( this );
    wxSizer* symbolSizer = new wxBoxSizer( wxVERTICAL );
 
    m_symbolFilter = new wxSearchCtrl( symbolPanel, ID_LIBVIEW_SYM_FILTER, wxEmptyString, wxDefaultPosition,
                                       wxDefaultSize, wxTE_PROCESS_ENTER );
    m_symbolFilter->SetDescriptiveText( _( "Filter" ) );
    m_symbolFilter->SetToolTip( _( "Filter on symbol name, keywords, description and pin count.\n"
                                   "Search terms are separated by spaces.  All search terms must match.\n"
                                   "A term which is a number will also match against the pin count." ) );
    symbolSizer->Add( m_symbolFilter, 0, wxEXPAND, 5 );
 
#ifdef __WXGTK__
    // wxSearchCtrl vertical height is not calculated correctly on some GTK setups
    // See https://gitlab.com/kicad/code/kicad/-/issues/9019
    m_libFilter->SetMinSize( wxSize( -1, GetTextExtent( wxT( "qb" ) ).y + 10 ) );
    m_symbolFilter->SetMinSize( wxSize( -1, GetTextExtent( wxT( "qb" ) ).y + 10 ) );
#endif
 
    m_symbolList = new WX_LISTBOX( symbolPanel, ID_LIBVIEW_SYM_LIST, wxDefaultPosition, wxDefaultSize, 0, nullptr,
                                   wxLB_HSCROLL | wxNO_BORDER );
    symbolSizer->Add( m_symbolList, 1, wxEXPAND, 5 );
 
    symbolPanel->SetSizer( symbolSizer );
    symbolPanel->Fit();
 
    // Preload libraries
    ReCreateLibList();
 
    m_selection_changed = false;
 
    DisplayLibInfos();
 
    m_auimgr.SetManagedWindow( this );
 
    CreateInfoBar();
 
    // Manage main toolbar
    m_auimgr.AddPane( m_tbTopMain, EDA_PANE().HToolbar().Name( "TopMainToolbar" ).Top().Layer(6) );
    m_auimgr.AddPane( m_messagePanel, EDA_PANE().Messages().Name( "MsgPanel" ) .Bottom().Layer(6) );
 
    m_auimgr.AddPane( libPanel, EDA_PANE().Palette().Name( "Libraries" ).Left().Layer(2)
                      .CaptionVisible( false ).MinSize( 100, -1 ).BestSize( 200, -1 ) );
    m_auimgr.AddPane( symbolPanel, EDA_PANE().Palette().Name( "Symbols" ).Left().Layer(1)
                      .CaptionVisible( false ).MinSize( 100, -1 ).BestSize( 300, -1 ) );
 
    m_auimgr.AddPane( GetCanvas(), EDA_PANE().Canvas().Name( "DrawFrame" ).Center() );
 
    RestoreAuiLayout();
 
    // Perspectives are sometimes saved with panes marked hidden, and this frame offers no way to
    // bring one back, so a single bad save would leave the browser permanently blank
    for( const wchar_t* pane : { wxS( "Libraries" ), wxS( "Symbols" ), wxS( "MsgPanel" ),
                                 wxS( "DrawFrame" ) } )
    {
        m_auimgr.GetPane( pane ).Show( true );
    }
 
    m_auimgr.Update();
 
    if( m_libListWidth > 0 )
        SetAuiPaneSize( m_auimgr, m_auimgr.GetPane( "Libraries" ), m_libListWidth, -1 );
 
    if( m_symbolListWidth > 0 )
        SetAuiPaneSize( m_auimgr, m_auimgr.GetPane( "Symbols" ), m_symbolListWidth, -1 );
 
    FinishAUIInitialization();
 
    Raise();
    Show( true );
 
    SyncView();
    GetCanvas()->SetCanFocus( false );
 
    setupUnits( config() );
 
    // Set the working/draw area size to display a symbol to a reasonable value:
    // A 450mm x 450mm with a origin at the area center looks like a large working area
    double max_size_x = schIUScale.mmToIU( 450 );
    double max_size_y = schIUScale.mmToIU( 450 );
    BOX2D bbox;
    bbox.SetOrigin( -max_size_x / 2, -max_size_y / 2 );
    bbox.SetSize( max_size_x, max_size_y );
    GetCanvas()->GetView()->SetBoundary( bbox );
    GetToolManager()->RunAction( ACTIONS::zoomFitScreen );
 
    // If a symbol was previously selected in m_symbolList from a previous run, show it
    wxString symbName = m_symbolList->GetStringSelection();
 
    if( !symbName.IsEmpty() )
    {
        SetSelectedSymbol( symbName );
        updatePreviewSymbol();
    }
}
 
 
SYMBOL_VIEWER_FRAME::~SYMBOL_VIEWER_FRAME()
{
    // Shutdown all running tools
    if( m_toolManager )
        m_toolManager->ShutdownAllTools();
 
    if( m_previewItem )
    {
        GetCanvas()->GetView()->Remove( m_previewItem.get() );
        m_previewItem = nullptr;
    }
}
 
 
void SYMBOL_VIEWER_FRAME::setupTools()
{
    // Create the manager and dispatcher & route draw panel events to the dispatcher
    m_toolManager = new TOOL_MANAGER;
    m_toolManager->SetEnvironment( GetScreen(), GetCanvas()->GetView(), GetCanvas()->GetViewControls(), config(),
                                   this );
    m_actions = new SCH_ACTIONS();
    m_toolDispatcher = new TOOL_DISPATCHER( m_toolManager );
 
    // Register tools
    m_toolManager->RegisterTool( new COMMON_TOOLS );
    m_toolManager->RegisterTool( new COMMON_CONTROL );
    m_toolManager->RegisterTool( new ZOOM_TOOL );
    m_toolManager->RegisterTool( new SCH_INSPECTION_TOOL );     // manage show datasheet
    m_toolManager->RegisterTool( new SCH_SELECTION_TOOL );      // manage context menu
    m_toolManager->RegisterTool( new SYMBOL_EDITOR_CONTROL );   // manage render settings
 
    m_toolManager->InitTools();
 
    // Run the selection tool, it is supposed to be always active
    // It also manages the mouse right click to show the context menu
    m_toolManager->InvokeTool( "common.InteractiveSelection" );
 
    GetCanvas()->SetEventDispatcher( m_toolDispatcher );
}
 
 
void SYMBOL_VIEWER_FRAME::setupUIConditions()
{
    SCH_BASE_FRAME::setupUIConditions();
 
    ACTION_MANAGER*   mgr = m_toolManager->GetActionManager();
    EDITOR_CONDITIONS cond( this );
 
    wxASSERT( mgr );
 
#define ENABLE( x ) ACTION_CONDITIONS().Enable( x )
#define CHECK( x )  ACTION_CONDITIONS().Check( x )
 
    mgr->SetConditions( ACTIONS::toggleGrid, CHECK( cond.GridVisible() ) );
 
    auto electricalTypesShownCondition =
            [this]( const SELECTION& aSel )
            {
                return GetRenderSettings() && GetRenderSettings()->m_ShowPinsElectricalType;
            };
 
    auto pinNumbersShownCondition =
            [this]( const SELECTION& )
            {
                return GetRenderSettings() && GetRenderSettings()->m_ShowPinNumbers;
            };
 
    auto haveDatasheetCond =
            [this]( const SELECTION& )
            {
                LIB_SYMBOL* symbol = GetSelectedSymbol();
                return symbol && !symbol->GetDatasheetField().GetText().IsEmpty();
            };
 
    mgr->SetConditions( ACTIONS::showDatasheet,             ENABLE( haveDatasheetCond ) );
    mgr->SetConditions( SCH_ACTIONS::showElectricalTypes,   CHECK( electricalTypesShownCondition ) );
    mgr->SetConditions( SCH_ACTIONS::showPinNumbers,        CHECK( pinNumbersShownCondition ) );
 
#undef CHECK
#undef ENABLE
}
 
 
void SYMBOL_VIEWER_FRAME::SetUnitAndBodyStyle( int aUnit, int aBodyStyle )
{
    m_unit = aUnit > 0 ? aUnit : 1;
    m_bodyStyle = aBodyStyle > 0 ? aBodyStyle : BODY_STYLE::BASE;
    m_selection_changed = false;
 
    updatePreviewSymbol();
}
 
 
LIB_SYMBOL* SYMBOL_VIEWER_FRAME::GetSelectedSymbol() const
{
    LIB_SYMBOL* symbol = nullptr;
 
    if( m_currentSymbol.IsValid() )
    {
        try
        {
            symbol = PROJECT_SCH::SymbolLibAdapter( &Prj() )->LoadSymbol( m_currentSymbol );
        }
        catch( const IO_ERROR& )
        {
            // best efforts
        }
    }
 
    return symbol;
}
 
 
void SYMBOL_VIEWER_FRAME::updatePreviewSymbol()
{
    LIB_SYMBOL* symbol = GetSelectedSymbol();
    KIGFX::SCH_VIEW* view = GetCanvas()->GetView();
 
    if( m_previewItem )
    {
        view->Remove( m_previewItem.get() );
        m_previewItem = nullptr;
    }
 
    ClearMsgPanel();
 
    if( symbol )
    {
        GetRenderSettings()->m_ShowUnit = m_unit;
        GetRenderSettings()->m_ShowBodyStyle = m_bodyStyle;
 
        m_previewItem = symbol->Flatten();
        view->Add( m_previewItem.get() );
 
        wxString parentName;
 
        if( std::shared_ptr<LIB_SYMBOL> parent = symbol->GetParent().lock() )
            parentName = parent->GetName();
 
        AppendMsgPanel( _( "Name" ), UnescapeString( m_previewItem->GetName() ) );
        AppendMsgPanel( _( "Parent" ),  UnescapeString( parentName ) );
        AppendMsgPanel( _( "Description" ), m_previewItem->GetDescription() );
        AppendMsgPanel( _( "Keywords" ), m_previewItem->GetKeyWords() );
    }
 
    m_toolManager->RunAction( ACTIONS::zoomFitScreen );
    GetCanvas()->Refresh();
 
    updateUnitChoice();
    updateBodyStyleChoice();
}
 
 
void SYMBOL_VIEWER_FRAME::doCloseWindow()
{
    SCH_BASE_FRAME::doCloseWindow();
 
    delete m_toolManager;
    m_toolManager = nullptr;
 
    Destroy();
}
 
 
void SYMBOL_VIEWER_FRAME::OnSize( wxSizeEvent& SizeEv )
{
    if( m_auimgr.GetManagedWindow() )
        m_auimgr.Update();
 
    SizeEv.Skip();
}
 
 
void SYMBOL_VIEWER_FRAME::updateUnitChoice()
{
    LIB_SYMBOL* symbol = GetSelectedSymbol();
 
    int unit_count = 1;
 
    if( symbol )
        unit_count = std::max( symbol->GetUnitCount(), 1 );
 
    m_unitChoice->Enable( unit_count > 1 );
    m_unitChoice->Clear();
 
    if( unit_count > 1 )
    {
        // rebuild the unit list if it is not suitable (after a new selection for instance)
        if( unit_count != (int) m_unitChoice->GetCount() )
        {
            for( int ii = 0; ii < unit_count; ii++ )
                m_unitChoice->Append( symbol->GetUnitDisplayName( ii + 1, true ) );
        }
 
        if( m_unitChoice->GetSelection() != std::max( 0, m_unit - 1 ) )
            m_unitChoice->SetSelection( std::max( 0, m_unit - 1 ) );
    }
}
 
 
void SYMBOL_VIEWER_FRAME::updateBodyStyleChoice()
{
    LIB_SYMBOL* symbol = GetSelectedSymbol();
 
    int bodyStyle_count = 1;
 
    if( symbol )
        bodyStyle_count = std::max( symbol->GetBodyStyleCount(), 1 );
 
    m_bodyStyleChoice->Enable( bodyStyle_count > 1 );
    m_bodyStyleChoice->Clear();
 
    if( bodyStyle_count > 1 )
    {
        if( symbol && symbol->HasDeMorganBodyStyles() )
        {
            m_bodyStyleChoice->Append( wxGetTranslation( DEMORGAN_STD ) );
            m_bodyStyleChoice->Append( wxGetTranslation( DEMORGAN_ALT ) );
        }
        else if( symbol )
        {
            for( int i = 0; i < symbol->GetBodyStyleCount(); i++ )
                m_bodyStyleChoice->Append( symbol->GetBodyStyleNames()[i] );
        }
 
        if( m_bodyStyleChoice->GetSelection() != std::max( 0, m_bodyStyle - 1 ) )
            m_bodyStyleChoice->SetSelection( std::max( 0, m_bodyStyle - 1 ) );
    }
}
 
 
void SYMBOL_VIEWER_FRAME::ReCreateLibList()
{
    if( !m_libList )
        return;
 
    m_libList->Clear();
 
    COMMON_SETTINGS*        cfg = Pgm().GetCommonSettings();
    PROJECT_FILE&           project = Kiway().Prj().GetProjectFile();
    SYMBOL_LIBRARY_ADAPTER* adapter = PROJECT_SCH::SymbolLibAdapter( &Prj() );
    std::vector<wxString>   libNicknames = adapter->GetLibraryNames();
    std::vector<wxString>   pinnedMatches;
    std::vector<wxString>   otherMatches;
 
    auto doAddLib =
            [&]( const wxString& aLib )
            {
                if( alg::contains( project.m_PinnedSymbolLibs, aLib )
                    || alg::contains( cfg->m_Session.pinned_symbol_libs, aLib ) )
                {
                    pinnedMatches.push_back( aLib );
                }
                else
                {
                    otherMatches.push_back( aLib );
                }
            };
 
    auto process =
            [&]( const wxString& aLib )
            {
                // Remove not allowed libs, if the allowed lib list is not empty
                if( m_allowedLibs.GetCount() )
                {
                    if( m_allowedLibs.Index( aLib ) == wxNOT_FOUND )
                        return;
                }
 
                // Remove libs which have no power symbols, if this filter is activated
                if( m_listPowerOnly )
                {
                    if( adapter->GetSymbolNames( aLib, SYMBOL_LIBRARY_ADAPTER::SYMBOL_TYPE::POWER_ONLY ).empty() )
                        return;
                }
 
                LIBRARY_TABLE_ROW* row = adapter->GetRow( aLib ).value_or( nullptr );
                wxCHECK( row, /* void */ );
 
                if( row->Hidden() )
                    return;
 
                if( adapter->SupportsSubLibraries( aLib ) )
                {
                    for( const auto& [nickname, description] : adapter->GetSubLibraries( aLib ) )
                    {
                        wxString suffix = nickname.IsEmpty() ? wxString( wxT( "" ) )
                                                             : wxString::Format( wxT( " - %s" ), nickname );
                        wxString name = wxString::Format( wxT( "%s%s" ), aLib, suffix );
 
                        doAddLib( name );
                    }
                }
                else
                {
                    doAddLib( aLib );
                }
            };
 
    if( m_libFilter->GetValue().IsEmpty() )
    {
        for( const wxString& lib : libNicknames )
            process( lib );
    }
    else
    {
        wxStringTokenizer  tokenizer( m_libFilter->GetValue(), " \t\r\n", wxTOKEN_STRTOK );
        std::set<wxString> successfulMatches;
        std::set<wxString> failedMatches;
 
        while( tokenizer.HasMoreTokens() )
        {
            const wxString       term = tokenizer.GetNextToken().Lower();
            EDA_COMBINED_MATCHER matcher( term, CTX_LIBITEM );
 
            for( const wxString& lib : libNicknames )
            {
                if( matcher.Find( lib.Lower() ) )
                    successfulMatches.insert( lib );
                else
                    failedMatches.insert( lib );
            }
        }
 
        for( const wxString& lib : successfulMatches )
        {
            if( !failedMatches.contains( lib ) )
                process( lib );
        }
    }
 
    for( const wxString& name : pinnedMatches )
        m_libList->Append( LIB_TREE_MODEL_ADAPTER::GetPinningSymbol() + UnescapeString( name ) );
 
    for( const wxString& name : otherMatches )
        m_libList->Append( UnescapeString( name ) );
 
    // Search for a previous selection:
    int  index = m_libList->FindString( UnescapeString( m_currentSymbol.GetUniStringLibNickname() ) );
 
    if( index != wxNOT_FOUND )
    {
        m_libList->SetSelection( index, true );
    }
    else
    {
        // If not found, clear current library selection because it can be deleted after a config change.
        m_currentSymbol.SetLibNickname( m_libList->GetCount() > 0 ? m_libList->GetBaseString( 0 )
                                                                  : wxString( wxEmptyString ) );
        m_currentSymbol.SetLibItemName( wxEmptyString );
        m_unit = 1;
        m_bodyStyle = BODY_STYLE::BASE;
    }
 
    ReCreateSymbolList();
}
 
 
void SYMBOL_VIEWER_FRAME::ReCreateSymbolList()
{
    if( m_symbolList == nullptr )
        return;
 
    m_symbolList->Clear();
 
    wxString libName = m_currentSymbol.GetUniStringLibNickname();
 
    if( libName.IsEmpty() )
    {
        updatePreviewSymbol();
        DisplayLibInfos();
        GetCanvas()->Refresh();
        return;
    }
 
    SYMBOL_LIBRARY_ADAPTER* adapter = PROJECT_SCH::SymbolLibAdapter( &Prj() );
    std::vector<LIB_SYMBOL*> symbols = adapter->GetSymbols( libName );
 
    std::sort( symbols.begin(), symbols.end(),
               []( LIB_SYMBOL* a, LIB_SYMBOL* b ) -> bool
               {
                   return StrNumCmp( b->GetName(), a->GetName(), true ) > 0;
               } );
 
    std::set<wxString> excludes;
 
    if( !m_symbolFilter->GetValue().IsEmpty() )
    {
        wxStringTokenizer tokenizer( m_symbolFilter->GetValue(), " \t\r\n", wxTOKEN_STRTOK );
 
        while( tokenizer.HasMoreTokens() )
        {
            const wxString       filterTerm = tokenizer.GetNextToken().Lower();
            EDA_COMBINED_MATCHER matcher( filterTerm, CTX_LIBITEM );
 
            for( LIB_SYMBOL* symbol : symbols )
            {
                int matched = matcher.ScoreTerms( symbol->GetSearchTerms() );
 
                if( filterTerm.IsNumber() && wxAtoi( filterTerm ) == (int)symbol->GetPinCount() )
                    matched++;
 
                if( !matched )
                    excludes.insert( symbol->GetName() );
            }
        }
    }
 
    wxString subLib = m_currentSymbol.GetSubLibraryName();
 
    for( const LIB_SYMBOL* symbol : symbols )
    {
        if( adapter->SupportsSubLibraries( libName ) && !subLib.IsSameAs( symbol->GetLibId().GetSubLibraryName() ) )
            continue;
 
        if( !excludes.count( symbol->GetName() ) )
            m_symbolList->Append( UnescapeString( symbol->GetName() ) );
    }
 
    int  index = m_symbolList->FindString( UnescapeString( m_currentSymbol.GetUniStringLibItemName() ) );
 
    if( index != wxNOT_FOUND )
    {
        m_symbolList->SetSelection( index, true );
    }
    else
    {
        // Select the first library entry (if available) when the previous entry name no longer exists.
        m_symbolList->SetSelection( m_symbolList->IsEmpty() ? -1 : 0, true );
        m_currentSymbol.SetLibItemName( m_symbolList->GetStringSelection() );
        m_bodyStyle = BODY_STYLE::BASE;
        m_unit      = 1;
 
        updatePreviewSymbol();
        DisplayLibInfos();
        GetCanvas()->Refresh();
    }
}
 
 
void SYMBOL_VIEWER_FRAME::ClickOnLibList( wxCommandEvent& event )
{
    int ii = m_libList->GetSelection();
 
    if( ii < 0 )
        return;
 
    m_selection_changed = true;
 
    wxString selection = EscapeString( m_libList->GetBaseString( ii ), CTX_LIBID );
 
    SYMBOL_LIBRARY_ADAPTER* adapter = PROJECT_SCH::SymbolLibAdapter( &Prj() );
 
    if( !adapter->HasLibrary( selection ) && selection.Find( '-' ) != wxNOT_FOUND )
    {
        // Probably a sub-library
        wxString sublib;
        selection = selection.BeforeLast( '-', &sublib ).Trim();
        sublib.Trim( false );
        SetSelectedLibrary( selection, sublib );
    }
    else
    {
        SetSelectedLibrary( selection );
    }
}
 
 
void SYMBOL_VIEWER_FRAME::SetSelectedLibrary( const wxString& aLibraryName, const wxString& aSubLibName )
{
    if( m_currentSymbol.GetUniStringLibNickname() == aLibraryName
        && wxString( m_currentSymbol.GetSubLibraryName().wx_str() ) == aSubLibName )
    {
        return;
    }
 
    m_currentSymbol.SetLibNickname( aLibraryName );
    m_currentSymbol.SetSubLibraryName( aSubLibName );
    ReCreateSymbolList();
    GetCanvas()->Refresh();
    DisplayLibInfos();
 
    // Ensure the corresponding line in m_libList is selected
    // (which is not necessary the case if SetSelectedLibrary is called
    // by another caller than ClickOnLibList.
    m_libList->SetStringSelection( UnescapeString( m_currentSymbol.GetFullLibraryName() ), true );
 
    // The m_libList has now the focus, in order to be able to use arrow keys
    // to navigate inside the list.
    // the gal canvas must not steal the focus to allow navigation
    GetCanvas()->SetStealsFocus( false );
    m_libList->SetFocus();
}
 
 
void SYMBOL_VIEWER_FRAME::ClickOnSymbolList( wxCommandEvent& event )
{
    int ii = m_symbolList->GetSelection();
 
    if( ii < 0 )
        return;
 
    m_selection_changed = true;
 
    SetSelectedSymbol( EscapeString( m_symbolList->GetBaseString( ii ), CTX_LIBID ) );
 
    // The m_symbolList has now the focus, in order to be able to use arrow keys
    // to navigate inside the list.
    // the gal canvas must not steal the focus to allow navigation
    GetCanvas()->SetStealsFocus( false );
    m_symbolList->SetFocus();
}
 
 
void SYMBOL_VIEWER_FRAME::SetSelectedSymbol( const wxString& aSymbolName )
{
    if( m_currentSymbol.GetUniStringLibItemName() != aSymbolName )
    {
        m_currentSymbol.SetLibItemName( aSymbolName );
 
        // Ensure the corresponding line in m_symbolList is selected
        // (which is not necessarily the case if SetSelectedSymbol is called
        // by another caller than ClickOnSymbolList.
        m_symbolList->SetStringSelection( UnescapeString( aSymbolName ), true );
        DisplayLibInfos();
 
        if( m_selection_changed )
        {
            m_unit = 1;
            m_bodyStyle = BODY_STYLE::BASE;
            m_selection_changed = false;
        }
 
        updatePreviewSymbol();
    }
}
 
 
void SYMBOL_VIEWER_FRAME::DClickOnSymbolList( wxCommandEvent& event )
{
    m_toolManager->RunAction( SCH_ACTIONS::addSymbolToSchematic );
}
 
 
void SYMBOL_VIEWER_FRAME::LoadSettings( APP_SETTINGS_BASE* aCfg )
{
    SCH_BASE_FRAME::LoadSettings( GetAppSettings<EESCHEMA_SETTINGS>( "eeschema" ) );
 
    if( EESCHEMA_SETTINGS* cfg = GetAppSettings<EESCHEMA_SETTINGS>( "eeschema" ) )
    {
        // Grid shape, etc.
        GetGalDisplayOptions().ReadWindowSettings( cfg->m_LibViewPanel.window );
 
        m_libListWidth = cfg->m_LibViewPanel.lib_list_width;
        m_symbolListWidth = cfg->m_LibViewPanel.cmp_list_width;
 
        GetRenderSettings()->m_ShowPinsElectricalType = cfg->m_LibViewPanel.show_pin_electrical_type;
        GetRenderSettings()->m_ShowPinNumbers = cfg->m_LibViewPanel.show_pin_numbers;
 
        // Set parameters to a reasonable value.
        int64_t maxWidth = cfg->m_LibViewPanel.window.state.size_x - 80;
        int64_t totalWidth = static_cast<int64_t>( m_libListWidth ) + m_symbolListWidth;
 
        // Multiply before dividing or the integer ratio truncates to zero and starves the library list
        if( totalWidth > 0 && totalWidth > maxWidth )
        {
            m_libListWidth = static_cast<int>( maxWidth * m_libListWidth / totalWidth );
            m_symbolListWidth = static_cast<int>( maxWidth ) - m_libListWidth;
        }
    }
}
 
 
void SYMBOL_VIEWER_FRAME::SaveSettings( APP_SETTINGS_BASE* aCfg)
{
    SCH_BASE_FRAME::SaveSettings( GetAppSettings<EESCHEMA_SETTINGS>( "eeschema" ) );
 
    if( m_libListWidth && m_libList )
        m_libListWidth = m_libList->GetSize().x;
 
    m_symbolListWidth = m_symbolList->GetSize().x;
 
    if( EESCHEMA_SETTINGS* cfg = GetAppSettings<EESCHEMA_SETTINGS>( "eeschema" ) )
    {
        cfg->m_LibViewPanel.lib_list_width = m_libListWidth;
        cfg->m_LibViewPanel.cmp_list_width = m_symbolListWidth;
 
        if( SCH_RENDER_SETTINGS* renderSettings = GetRenderSettings() )
        {
            cfg->m_LibViewPanel.show_pin_electrical_type = renderSettings->m_ShowPinsElectricalType;
            cfg->m_LibViewPanel.show_pin_numbers = renderSettings->m_ShowPinNumbers;
        }
    }
}
 
 
WINDOW_SETTINGS* SYMBOL_VIEWER_FRAME::GetWindowSettings( APP_SETTINGS_BASE* aCfg )
{
    if( EESCHEMA_SETTINGS* cfg = dynamic_cast<EESCHEMA_SETTINGS*>( aCfg ) )
        return &cfg->m_LibViewPanel.window;
 
    wxFAIL_MSG( wxT( "SYMBOL_VIEWER not running with EESCHEMA_SETTINGS" ) );
    return &aCfg->m_Window;     // non-null fail-safe
}
 
 
void SYMBOL_VIEWER_FRAME::CommonSettingsChanged( int aFlags )
{
    SCH_BASE_FRAME::CommonSettingsChanged( aFlags );
 
    if( EESCHEMA_SETTINGS* cfg = GetAppSettings<EESCHEMA_SETTINGS>( "eeschema" ) )
        GetGalDisplayOptions().ReadWindowSettings( cfg->m_LibViewPanel.window );
 
    GetCanvas()->GetGAL()->SetAxesColor( m_colorSettings->GetColor( LAYER_SCHEMATIC_GRID_AXES ) );
    GetCanvas()->GetGAL()->DrawGrid();
    GetCanvas()->ForceRefresh();
 
    if( aFlags & ENVVARS_CHANGED )
        ReCreateLibList();
}
 
 
void SYMBOL_VIEWER_FRAME::OnActivate( wxActivateEvent& event )
{
    if( event.GetActive() )
        ReCreateLibList();
 
    event.Skip();    // required under wxMAC
}
 
 
void SYMBOL_VIEWER_FRAME::CloseLibraryViewer( wxCommandEvent& event )
{
    Close();
}
 
 
const BOX2I SYMBOL_VIEWER_FRAME::GetDocumentExtents( bool aIncludeAllVisible ) const
{
    if( LIB_SYMBOL* symbol = GetSelectedSymbol() )
        return symbol->GetUnitBoundingBox( m_unit, m_bodyStyle );
 
    return BOX2I( VECTOR2I( -200, -200 ), VECTOR2I( 400, 400 ) );
}
 
 
void SYMBOL_VIEWER_FRAME::OnLibFilter( wxCommandEvent& aEvent )
{
    ReCreateLibList();
 
    // Required to avoid interaction with SetHint()
    // See documentation for wxTextEntry::SetHint
    aEvent.Skip();
}
 
 
void SYMBOL_VIEWER_FRAME::OnSymFilter( wxCommandEvent& aEvent )
{
    ReCreateSymbolList();
 
    // Required to avoid interaction with SetHint()
    // See documentation for wxTextEntry::SetHint
    aEvent.Skip();
}
 
 
void SYMBOL_VIEWER_FRAME::OnCharHook( wxKeyEvent& aEvent )
{
    if( aEvent.GetKeyCode() == WXK_UP )
    {
        if( m_libFilter->HasFocus() || m_libList->HasFocus() )
        {
            int prev = m_libList->GetSelection() - 1;
 
            if( prev >= 0 )
            {
                m_libList->SetSelection( prev );
                m_libList->EnsureVisible( prev );
 
                wxCommandEvent dummy;
                ClickOnLibList( dummy );
            }
        }
        else
        {
            SelectPreviousSymbol();
        }
    }
    else if( aEvent.GetKeyCode() == WXK_DOWN )
    {
        if( m_libFilter->HasFocus() || m_libList->HasFocus() )
        {
            int next = m_libList->GetSelection() + 1;
 
            if( next < (int)m_libList->GetCount() )
            {
                m_libList->SetSelection( next );
                m_libList->EnsureVisible( next );
 
                wxCommandEvent dummy;
                ClickOnLibList( dummy );
            }
        }
        else
        {
            SelectNextSymbol();
        }
    }
    else if( aEvent.GetKeyCode() == WXK_TAB && m_libFilter->HasFocus() )
    {
        if( !aEvent.ShiftDown() )
            m_symbolFilter->SetFocus();
        else
            aEvent.Skip();
    }
    else if( aEvent.GetKeyCode() == WXK_TAB && m_symbolFilter->HasFocus() )
    {
        if( aEvent.ShiftDown() )
            m_libFilter->SetFocus();
        else
            aEvent.Skip();
    }
    else if( ( aEvent.GetKeyCode() == WXK_RETURN || aEvent.GetKeyCode() == WXK_NUMPAD_ENTER )
             && m_symbolList->GetSelection() >= 0 )
    {
        wxCommandEvent dummy;
        DClickOnSymbolList( dummy );
    }
    else
    {
        aEvent.Skip();
    }
}
 
 
void SYMBOL_VIEWER_FRAME::SelectNextSymbol()
{
    wxCommandEvent evt( wxEVT_COMMAND_LISTBOX_SELECTED, ID_LIBVIEW_SYM_LIST );
    int            ii = m_symbolList->GetSelection();
 
    // Select the next symbol or stop at the end of the list.
    if( ii != wxNOT_FOUND && ii < (int) ( m_symbolList->GetCount() - 1 ) )
        ii += 1;
 
    m_symbolList->SetSelection( ii );
    ProcessEvent( evt );
}
 
 
void SYMBOL_VIEWER_FRAME::SelectPreviousSymbol()
{
    wxCommandEvent evt( wxEVT_COMMAND_LISTBOX_SELECTED, ID_LIBVIEW_SYM_LIST );
    int            ii = m_symbolList->GetSelection();
 
    // Select the previous symbol or stop at the beginning of list.
    if( ii != wxNOT_FOUND && ii != 0 )
        ii -= 1;
 
    m_symbolList->SetSelection( ii );
    ProcessEvent( evt );
}
 
 
void SYMBOL_VIEWER_FRAME::onSelectSymbolUnit( wxCommandEvent& aEvent )
{
    int ii = m_unitChoice->GetSelection();
 
    if( ii < 0 )
        return;
 
    m_unit = ii + 1;
 
    updatePreviewSymbol();
}
 
 
void SYMBOL_VIEWER_FRAME::onSelectSymbolBodyStyle( wxCommandEvent& aEvent )
{
    int ii = m_bodyStyleChoice->GetSelection();
 
    if( ii < 0 )
        return;
 
    m_bodyStyle = ii + 1;
 
    updatePreviewSymbol();
}
 
 
void SYMBOL_VIEWER_FRAME::DisplayLibInfos()
{
    wxString libName = m_currentSymbol.GetUniStringLibNickname();
 
    if( m_libList && !m_libList->IsEmpty() && !libName.IsEmpty() )
    {
        SYMBOL_LIBRARY_ADAPTER* adapter = PROJECT_SCH::SymbolLibAdapter( &Prj() );
        LIBRARY_TABLE_ROW* row = adapter->GetRow( libName ).value_or( nullptr );
 
        wxString title = row ? LIBRARY_MANAGER::GetFullURI( row, true )
                             : _( "[no library selected]" );
 
        title += wxT( " \u2014 " ) + _( "Symbol Library Browser" );
        SetTitle( title );
    }
}
 
 
SELECTION& SYMBOL_VIEWER_FRAME::GetCurrentSelection()
{
    return m_toolManager->GetTool<SCH_SELECTION_TOOL>()->GetSelection();
}
 
 
void SYMBOL_VIEWER_FRAME::KiwayMailIn( KIWAY_MAIL_EVENT& mail )
{
 
    switch( mail.Command() )
    {
    case MAIL_RELOAD_LIB:
        ReCreateLibList();
        break;
 
    case MAIL_REFRESH_SYMBOL:
    {
        // A library reload can invalidate the LIB_SYMBOL borrowed from the adapter.
        const LIB_ID symbolId = m_currentSymbol;
 
        if( !symbolId.IsValid() )
            break;
 
        SYMBOL_LIBRARY_ADAPTER* adapter = PROJECT_SCH::SymbolLibAdapter( &Prj() );
        wxCHECK2( adapter, break );
 
        LIBRARY_TABLE_ROW* row = adapter->GetRow( symbolId.GetLibNickname() ).value_or( nullptr );
 
        if( !row )
            return;
 
        wxString libfullname = LIBRARY_MANAGER::GetFullURI( row, true );
 
        wxString lib( mail.GetPayload() );
        wxLogTrace( traceLibWatch, "Received refresh symbol request for %s, current symbols is %s", lib, libfullname );
 
        if( lib == libfullname )
        {
            wxLogTrace( traceLibWatch, "Refreshing symbol %s", symbolId.GetLibItemName().wx_str() );
            updatePreviewSymbol();
            GetCanvas()->GetView()->UpdateAllItems( KIGFX::ALL );
        }
 
        break;
    }
    default:;
    }
}