board_editor_control.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2014 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 * @author Maciej Suminski <[email protected]>
 *
 * 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 "board_editor_control.h"
 
#include <algorithm>
#include <climits>
#include <functional>
#include <memory>
 
#include <pgm_base.h>
#include <executable_names.h>
#include <advanced_config.h>
#include <bitmaps.h>
#include <gestfich.h>
#include <pcb_painter.h>
#include <board.h>
#include <board_commit.h>
#include <board_design_settings.h>
#include <collectors.h>
#include <project/net_settings.h>
#include <pcb_generator.h>
#include <pcb_grid_item.h>
#include <footprint.h>
#include <pad.h>
#include <pcb_target.h>
#include <pcb_track.h>
#include <zone.h>
#include <pcb_marker.h>
#include <confirm.h>
#include <dialogs/dialog_page_settings.h>
#include <dialogs/dialog_update_pcb.h>
#include <dialogs/dialog_assign_netclass.h>
#include <dialogs/dialog_footprint_fields_table.h>
#include <dialog_plot.h>
#include <dialogs/rule_editor_dialog_base.h>
#include <dialogs/dialog_find_by_properties.h>
#include <kiface_base.h>
#include <kiway.h>
#include <netlist_reader/pcb_netlist.h>
#include <origin_viewitem.h>
#include <pcb_edit_frame.h>
#include <pcbnew_id.h>
#include <project.h>
#include <project/project_file.h> // LAST_PATH_TYPE
#include <settings/settings_manager.h>
#include <kiplatform/ui.h>
#include <pcbnew_settings.h>
#include <tool/tool_manager.h>
#include <tool/tool_event.h>
#include <tools/drawing_tool.h>
#include <tools/pcb_actions.h>
#include <tools/pcb_edit_table_tool.h>
#include <tools/pcb_picker_tool.h>
#include <tools/pcb_selection_conditions.h>
#include <tools/pcb_selection_tool.h>
#include <tools/edit_tool.h>
#include <tools/tool_event_utils.h>
#include <tools/zone_filler_tool.h>
#include <richio.h>
#include <router/router_tool.h>
#include <view/view_controls.h>
#include <view/view_group.h>
#include <wildcards_and_files_ext.h>
#include <drawing_sheet/ds_proxy_undo_item.h>
#include <footprint_edit_frame.h>
#include <wx/filedlg.h>
#include <wx/msgdlg.h>
#include <wx/log.h>
 
#include <widgets/legacyfiledlg_netlist_options.h>
 
using namespace std::placeholders;
 
 
namespace
{
 
using ZonePriorityMap = std::map<unsigned, std::vector<ZONE*>>;
 
 
std::vector<ZONE*> getOverlappingZones( BOARD* aBoard, ZONE* aZone )
{
    std::vector<ZONE*> overlapping;
    BOX2I              bbox = aZone->GetBoundingBox();
 
    for( ZONE* candidate : aBoard->Zones() )
    {
        if( candidate == aZone )
            continue;
 
        if( candidate->GetIsRuleArea() || candidate->IsTeardropArea() )
            continue;
 
        if( !( candidate->GetLayerSet() & aZone->GetLayerSet() ).any() )
            continue;
 
        if( !candidate->GetBoundingBox().Intersects( bbox ) )
            continue;
 
        // Check edge collision and containment (one zone entirely inside another)
        SHAPE_POLY_SET aOutline = aZone->GetBoardOutline();
        SHAPE_POLY_SET candidateOutline = candidate->GetBoardOutline();
 
        if( aOutline.Collide( &candidateOutline )
            || ( candidateOutline.TotalVertices() > 0 && aOutline.Contains( candidateOutline.CVertex( 0 ) ) )
            || ( aOutline.TotalVertices() > 0 && candidateOutline.Contains( aOutline.CVertex( 0 ) ) ) )
        {
            overlapping.push_back( candidate );
        }
    }
 
    return overlapping;
}
 
 
ZonePriorityMap buildPriorityMap( BOARD* aBoard, ZONE* aExclude )
{
    ZonePriorityMap byPriority;
 
    for( ZONE* z : aBoard->Zones() )
    {
        if( z == aExclude || z->GetIsRuleArea() || z->IsTeardropArea() )
            continue;
 
        byPriority[z->GetAssignedPriority()].push_back( z );
    }
 
    return byPriority;
}
 

std::vector<ZONE*> findCascadeZones( const ZonePriorityMap& aByPriority,
                                     unsigned aFromPriority, bool aCascadeUp,
                                     bool& aViable )
{
    std::vector<ZONE*> result;
    unsigned           p = aFromPriority;
    aViable = true;
 
    for( auto it = aByPriority.find( p ); it != aByPriority.end();
         it = aByPriority.find( p ) )
    {
        for( ZONE* z : it->second )
            result.push_back( z );
 
        if( aCascadeUp )
        {
            if( p == UINT_MAX )
            {
                aViable = false;
                break;
            }
 
            p++;
        }
        else
        {
            if( p == 0 )
            {
                aViable = false;
                break;
            }
 
            p--;
        }
    }
 
    return result;
}
 
} // anonymous namespace
 
 
class ZONE_PRIORITY_CONTEXT_MENU : public ACTION_MENU
{
public:
    ZONE_PRIORITY_CONTEXT_MENU() :
        ACTION_MENU( true )
    {
        SetIcon( BITMAPS::swap );
        SetTitle( _( "Zone Priority" ) );
 
        Add( PCB_ACTIONS::zonePriorityMoveToTop );
        Add( PCB_ACTIONS::zonePriorityRaise );
        Add( PCB_ACTIONS::zonePriorityLower );
        Add( PCB_ACTIONS::zonePriorityMoveToBottom );
    }
 
protected:
    ACTION_MENU* create() const override
    {
        return new ZONE_PRIORITY_CONTEXT_MENU();
    }
 
    void update() override
    {
        PCB_SELECTION_TOOL* selTool = getToolManager()->GetTool<PCB_SELECTION_TOOL>();
 
        if( !selTool )
            return;
 
        const PCB_SELECTION& selection = selTool->GetSelection();
        bool                 canRaise = false;
        bool                 canLower = false;
 
        if( selection.Size() == 1 )
        {
            ZONE* zone = dynamic_cast<ZONE*>( selection[0] );
 
            if( zone && !zone->GetIsRuleArea() && !zone->IsTeardropArea() )
            {
                BOARD*              board = zone->GetBoard();
                std::vector<ZONE*>  overlapping = getOverlappingZones( board, zone );
 
                for( ZONE* other : overlapping )
                {
                    if( other->GetAssignedPriority() > zone->GetAssignedPriority() )
                        canRaise = true;
 
                    if( other->GetAssignedPriority() < zone->GetAssignedPriority() )
                        canLower = true;
                }
            }
        }
 
        Enable( PCB_ACTIONS::zonePriorityMoveToTop.GetUIId(), canRaise );
        Enable( PCB_ACTIONS::zonePriorityRaise.GetUIId(), canRaise );
        Enable( PCB_ACTIONS::zonePriorityLower.GetUIId(), canLower );
        Enable( PCB_ACTIONS::zonePriorityMoveToBottom.GetUIId(), canLower );
    }
};
 
 
class ZONE_CONTEXT_MENU : public ACTION_MENU
{
public:
    ZONE_CONTEXT_MENU() :
        ACTION_MENU( true )
    {
        SetIcon( BITMAPS::add_zone );
        SetTitle( _( "Zones" ) );
 
        Add( PCB_ACTIONS::zoneFill );
        Add( PCB_ACTIONS::zoneFillAll );
        Add( PCB_ACTIONS::zoneUnfill );
        Add( PCB_ACTIONS::zoneUnfillAll );
 
        AppendSeparator();
 
        Add( PCB_ACTIONS::zoneMerge );
        Add( PCB_ACTIONS::zoneDuplicate );
        Add( PCB_ACTIONS::drawZoneCutout );
        Add( PCB_ACTIONS::drawSimilarZone );
 
        AppendSeparator();
 
        Add( new ZONE_PRIORITY_CONTEXT_MENU() );
 
        AppendSeparator();
 
        Add( PCB_ACTIONS::zonesManager );
    }
 
protected:
    ACTION_MENU* create() const override
    {
        return new ZONE_CONTEXT_MENU();
    }
};
 
 
class LOCK_CONTEXT_MENU : public CONDITIONAL_MENU
{
public:
    LOCK_CONTEXT_MENU( TOOL_INTERACTIVE* aTool ) :
        CONDITIONAL_MENU( aTool )
    {
        SetIcon( BITMAPS::locked );
        SetTitle( _( "Locking" ) );
 
        AddItem( PCB_ACTIONS::lock, PCB_SELECTION_CONDITIONS::HasUnlockedItems );
        AddItem( PCB_ACTIONS::unlock, PCB_SELECTION_CONDITIONS::HasLockedItems );
        AddItem( PCB_ACTIONS::toggleLock, SELECTION_CONDITIONS::ShowAlways );
    }
 
    ACTION_MENU* create() const override
    {
        return new LOCK_CONTEXT_MENU( this->m_tool );
    }
};
 
 
BOARD_EDITOR_CONTROL::BOARD_EDITOR_CONTROL() :
    PCB_TOOL_BASE( "pcbnew.EditorControl" ),
    m_frame( nullptr ),
    m_inPlaceFootprint( false ),
    m_placingFootprint( false )
{
    m_placeOrigin = std::make_unique<KIGFX::ORIGIN_VIEWITEM>( KIGFX::COLOR4D( 0.8, 0.0, 0.0, 1.0 ),
                                                             KIGFX::ORIGIN_VIEWITEM::CIRCLE_CROSS );
}
 
 
BOARD_EDITOR_CONTROL::~BOARD_EDITOR_CONTROL()
{
}
 
 
void BOARD_EDITOR_CONTROL::Reset( RESET_REASON aReason )
{
    m_frame = getEditFrame<PCB_EDIT_FRAME>();
 
    if( aReason == MODEL_RELOAD || aReason == GAL_SWITCH || aReason == REDRAW )
    {
        m_placeOrigin->SetPosition( getModel<BOARD>()->GetDesignSettings().GetAuxOrigin() );
        getView()->Remove( m_placeOrigin.get() );
        getView()->Add( m_placeOrigin.get() );
    }
}
 
// Update left-toolbar Line modes group icon based on current settings
int BOARD_EDITOR_CONTROL::OnAngleSnapModeChanged( const TOOL_EVENT& aEvent )
{
    PCB_EDIT_FRAME* f = getEditFrame<PCB_EDIT_FRAME>();
 
    if( !f )
        return 0;
 
    LEADER_MODE mode = GetAppSettings<PCBNEW_SETTINGS>( "pcbnew" )->m_AngleSnapMode;
 
    switch( mode )
    {
    case LEADER_MODE::DIRECT: f->SelectToolbarAction( PCB_ACTIONS::lineModeFree ); break;
    case LEADER_MODE::DEG90:  f->SelectToolbarAction( PCB_ACTIONS::lineMode90 );   break;
    default:
    case LEADER_MODE::DEG45:  f->SelectToolbarAction( PCB_ACTIONS::lineMode45 );   break;
    }
 
    return 0;
}
 
int BOARD_EDITOR_CONTROL::ChangeLineMode( const TOOL_EVENT& aEvent )
{
    LEADER_MODE mode = aEvent.Parameter<LEADER_MODE>();
    GetAppSettings<PCBNEW_SETTINGS>( "pcbnew" )->m_AngleSnapMode = mode;
    m_toolMgr->PostAction( ACTIONS::refreshPreview );
    m_toolMgr->RunAction( PCB_ACTIONS::angleSnapModeChanged );
    return 0;
}
 
 
bool BOARD_EDITOR_CONTROL::Init()
{
    auto activeToolCondition =
            [this]( const SELECTION& aSel )
            {
                return ( !m_frame->ToolStackIsEmpty() );
            };
 
    auto inactiveStateCondition =
            [this]( const SELECTION& aSel )
            {
                return ( m_frame->ToolStackIsEmpty() && aSel.Size() == 0 );
            };
 
    auto placeModuleCondition =
            [this]( const SELECTION& aSel )
            {
                return m_frame->IsCurrentTool( PCB_ACTIONS::placeFootprint ) && aSel.GetSize() == 0;
            };
 
    auto& ctxMenu = m_menu->GetMenu();
 
    // "Cancel" goes at the top of the context menu when a tool is active
    ctxMenu.AddItem( ACTIONS::cancelInteractive, activeToolCondition, 1 );
    ctxMenu.AddSeparator( 1 );
 
    // "Get and Place Footprint" should be available for Place Footprint tool
    ctxMenu.AddItem( PCB_ACTIONS::getAndPlace, placeModuleCondition, 1000 );
    ctxMenu.AddSeparator( 1000 );
 
    // Finally, add the standard zoom & grid items
    getEditFrame<PCB_BASE_FRAME>()->AddStandardSubMenus( *m_menu.get() );
 
    std::shared_ptr<ZONE_CONTEXT_MENU> zoneMenu = std::make_shared<ZONE_CONTEXT_MENU>();
    zoneMenu->SetTool( this );
 
    std::shared_ptr<LOCK_CONTEXT_MENU> lockMenu = std::make_shared<LOCK_CONTEXT_MENU>( this );
 
    // Add the PCB control menus to relevant other tools
 
    PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
    if( selTool )
    {
        TOOL_MENU&        toolMenu = selTool->GetToolMenu();
        CONDITIONAL_MENU& menu = toolMenu.GetMenu();
 
        // Add "Get and Place Footprint" when Selection tool is in an inactive state
        menu.AddItem( PCB_ACTIONS::getAndPlace, inactiveStateCondition );
        menu.AddSeparator();
 
        toolMenu.RegisterSubMenu( zoneMenu );
        toolMenu.RegisterSubMenu( lockMenu );
 
        menu.AddMenu( lockMenu.get(), SELECTION_CONDITIONS::NotEmpty, 100 );
 
        menu.AddMenu( zoneMenu.get(), SELECTION_CONDITIONS::OnlyTypes( { PCB_ZONE_T } ), 100 );
    }
 
    DRAWING_TOOL* drawingTool = m_toolMgr->GetTool<DRAWING_TOOL>();
 
    if( drawingTool )
    {
        TOOL_MENU&        toolMenu = drawingTool->GetToolMenu();
        CONDITIONAL_MENU& menu = toolMenu.GetMenu();
 
        toolMenu.RegisterSubMenu( zoneMenu );
 
        // Functor to say if the PCB_EDIT_FRAME is in a given mode
        // Capture the tool pointer and tool mode by value
        auto toolActiveFunctor =
                [=]( DRAWING_TOOL::MODE aMode )
                {
                    return [=]( const SELECTION& sel )
                           {
                               return drawingTool->GetDrawingMode() == aMode;
                           };
                };
 
        menu.AddMenu( zoneMenu.get(), toolActiveFunctor( DRAWING_TOOL::MODE::ZONE ), 300 );
    }
 
    // Ensure the left toolbar's Line modes group reflects the current setting at startup
    if( m_toolMgr )
        m_toolMgr->RunAction( PCB_ACTIONS::angleSnapModeChanged );
 
    return true;
}
 
 
int BOARD_EDITOR_CONTROL::Save( const TOOL_EVENT& aEvent )
{
    wxWindow* focus = wxWindow::FindFocus();
 
    if( focus )
    {
        wxWindow* topLevel = focus;
 
        while( topLevel && !topLevel->IsTopLevel() )
            topLevel = topLevel->GetParent();
 
        RULE_EDITOR_DIALOG_BASE* reDlg = dynamic_cast<RULE_EDITOR_DIALOG_BASE*>( topLevel );
 
        if( reDlg )
        {
            wxCommandEvent evt;
            reDlg->OnSave( evt );
            return 0;
        }
    }
 
    m_frame->SaveBoard();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::SaveAs( const TOOL_EVENT& aEvent )
{
    m_frame->SaveBoard( true );
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::SaveCopy( const TOOL_EVENT& aEvent )
{
    m_frame->SaveBoard( true, true );
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ExportFootprints( const TOOL_EVENT& aEvent )
{
    m_frame->ExportFootprintsToLibrary( false );
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::PageSettings( const TOOL_EVENT& aEvent )
{
    PICKED_ITEMS_LIST   undoCmd;
    DS_PROXY_UNDO_ITEM* undoItem = new DS_PROXY_UNDO_ITEM( m_frame );
    ITEM_PICKER         wrapper( nullptr, undoItem, UNDO_REDO::PAGESETTINGS );
 
    undoCmd.PushItem( wrapper );
    undoCmd.SetDescription( _( "Page Settings" ) );
    m_frame->SaveCopyInUndoList( undoCmd, UNDO_REDO::PAGESETTINGS );
 
    DIALOG_PAGES_SETTINGS dlg( m_frame, m_frame->GetBoard()->GetEmbeddedFiles(), pcbIUScale.IU_PER_MILS,
                               VECTOR2I( MAX_PAGE_SIZE_PCBNEW_MILS, MAX_PAGE_SIZE_PCBNEW_MILS ) );
    dlg.SetWksFileName( BASE_SCREEN::m_DrawingSheetFileName );
 
    if( dlg.ShowModal() == wxID_OK )
    {
        m_frame->GetCanvas()->GetView()->UpdateAllItemsConditionally(
                [&]( KIGFX::VIEW_ITEM* aItem ) -> int
                {
                    EDA_TEXT* text = dynamic_cast<EDA_TEXT*>( aItem );
 
                    if( text && text->HasTextVars() )
                    {
                        text->ClearRenderCache();
                        text->ClearBoundingBoxCache();
                        return KIGFX::GEOMETRY | KIGFX::REPAINT;
                    }
 
                    return 0;
                } );
 
        m_frame->OnModify();
    }
    else
    {
        m_frame->RollbackFromUndo();
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::Plot( const TOOL_EVENT& aEvent )
{
    DIALOG_PLOT dlg( m_frame );
    dlg.ShowQuasiModal();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::EditFootprintFields( const TOOL_EVENT& aEvent )
{
    DIALOG_FOOTPRINT_FIELDS_TABLE* dlg = m_frame->GetFootprintFieldsTableDialog();
 
    if( !dlg )
        return 0;
 
    // Needed at least on Windows. Raise() is not enough
    dlg->Show( true );
 
    // Bring it to the top if already open.  Dual monitor users need this.
    dlg->Raise();
 
    dlg->ShowEditTab();
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::GenerateBOM( const TOOL_EVENT& aEvent )
{
    DIALOG_FOOTPRINT_FIELDS_TABLE* dlg = m_frame->GetFootprintFieldsTableDialog();
 
    if( !dlg )
        return 0;
 
    // Needed at least on Windows. Raise() is not enough
    dlg->Show( true );
 
    // Bring it to the top if already open.  Dual monitor users need this.
    dlg->Raise();
 
    dlg->ShowExportTab();
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::Search( const TOOL_EVENT& aEvent )
{
    m_frame->ToggleSearch();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::Find( const TOOL_EVENT& aEvent )
{
    m_frame->ShowFindDialog();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::FindNext( const TOOL_EVENT& aEvent )
{
    m_frame->FindNext( aEvent.IsAction( &ACTIONS::findPrevious ) );
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::FindByProperties( const TOOL_EVENT& aEvent )
{
    m_frame->ShowFindByPropertiesDialog();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::BoardSetup( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ShowBoardSetupDialog();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ImportNetlist( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->InstallNetlistFrame();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ImportSpecctraSession( const TOOL_EVENT& aEvent )
{
    wxString fullFileName = frame()->GetBoard()->GetFileName();
    wxString path;
    wxString name;
    wxString ext;
 
    wxFileName::SplitPath( fullFileName, &path, &name, &ext );
    name += wxT( "." ) + wxString( FILEEXT::SpecctraSessionFileExtension );
 
    fullFileName = wxFileSelector( _( "Specctra Session File" ), path, name,
                                   wxT( "." ) + wxString( FILEEXT::SpecctraSessionFileExtension ),
                                   FILEEXT::SpecctraSessionFileWildcard(), wxFD_OPEN | wxFD_CHANGE_DIR,
                                   frame() );
 
    if( !fullFileName.IsEmpty() )
        getEditFrame<PCB_EDIT_FRAME>()->ImportSpecctraSession( fullFileName );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ExportSpecctraDSN( const TOOL_EVENT& aEvent )
{
    wxString    fullFileName = m_frame->GetLastPath( LAST_PATH_SPECCTRADSN );
    wxFileName  fn;
 
    if( fullFileName.IsEmpty() )
    {
        fn = m_frame->GetBoard()->GetFileName();
        fn.SetExt( FILEEXT::SpecctraDsnFileExtension );
    }
    else
    {
        fn = fullFileName;
    }
 
    fullFileName = wxFileSelector( _( "Specctra DSN File" ), fn.GetPath(), fn.GetFullName(),
                                   FILEEXT::SpecctraDsnFileExtension, FILEEXT::SpecctraDsnFileWildcard(),
                                   wxFD_SAVE | wxFD_OVERWRITE_PROMPT | wxFD_CHANGE_DIR, frame() );
 
    if( !fullFileName.IsEmpty() )
    {
        m_frame->SetLastPath( LAST_PATH_SPECCTRADSN, fullFileName );
        getEditFrame<PCB_EDIT_FRAME>()->ExportSpecctraFile( fullFileName );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ExportNetlist( const TOOL_EVENT& aEvent )
{
    wxCHECK( m_frame, 0 );
 
    wxFileName fn = m_frame->Prj().GetProjectFullName();
 
    // Use a different file extension for the board netlist so the schematic netlist file
    // is accidentally overwritten.
    fn.SetExt( wxT( "pcb_net" ) );
 
    wxFileDialog dlg( m_frame, _( "Export Board Netlist" ), fn.GetPath(), fn.GetFullName(),
                      _( "KiCad board netlist files" ) + AddFileExtListToFilter( { "pcb_net" } ),
                      wxFD_SAVE | wxFD_OVERWRITE_PROMPT );
 
    dlg.SetExtraControlCreator( &LEGACYFILEDLG_NETLIST_OPTIONS::Create );
 
    KIPLATFORM::UI::AllowNetworkFileSystems( &dlg );
 
    if( dlg.ShowModal() == wxID_CANCEL )
        return 0;
 
    fn = dlg.GetPath();
 
    if( !fn.IsDirWritable() )
    {
        DisplayErrorMessage( m_frame, wxString::Format( _( "Insufficient permissions to folder '%s'." ),
                                                        fn.GetPath() ) );
        return 0;
    }
 
    const LEGACYFILEDLG_NETLIST_OPTIONS* noh =
            dynamic_cast<const LEGACYFILEDLG_NETLIST_OPTIONS*>( dlg.GetExtraControl() );
    wxCHECK( noh, 0 );
 
    NETLIST netlist;
 
    for( const FOOTPRINT* footprint : board()->Footprints() )
    {
        COMPONENT* component = new COMPONENT( footprint->GetFPID(), footprint->GetReference(),
                                              footprint->GetValue(), footprint->GetPath(),
                                              { footprint->m_Uuid } );
 
        for( const PAD* pad : footprint->Pads() )
        {
            const wxString& netname = pad->GetShortNetname();
 
            if( !netname.IsEmpty() )
                component->AddNet( pad->GetNumber(), netname, pad->GetPinFunction(), pad->GetPinType() );
        }
 
        nlohmann::ordered_map<wxString, wxString> fields;
 
        for( PCB_FIELD* field : footprint->GetFields() )
        {
            wxCHECK2( field, continue );
 
            fields[field->GetUntranslatedName()] = field->GetText();
        }
 
        component->SetFields( fields );
 
        netlist.AddComponent( component );
    }
 
    try
    {
        FILE_OUTPUTFORMATTER formatter( fn.GetFullPath() );
 
        netlist.Format( "pcb_netlist", &formatter, 0, noh->GetNetlistOptions() );
        formatter.Finish();
    }
    catch( const IO_ERROR& ioe )
    {
        DisplayErrorMessage( m_frame, wxString::Format( _( "Failed to export netlist to '%s': %s" ),
                                                        fn.GetFullPath(), ioe.What() ) );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::GenerateGerbers( const TOOL_EVENT& aEvent )
{
    PCB_PLOT_PARAMS plotSettings = m_frame->GetPlotSettings();
 
    plotSettings.SetFormat( PLOT_FORMAT::GERBER );
 
    m_frame->SetPlotSettings( plotSettings );
 
    DIALOG_PLOT dlg( m_frame );
    dlg.ShowQuasiModal(  );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::RepairBoard( const TOOL_EVENT& aEvent )
{
    int      errors = 0;
    wxString details;
    bool     quiet = aEvent.Parameter<bool>();
 
    int duplicates = board()->RepairDuplicateItemUuids();
 
    if( duplicates )
    {
        errors += duplicates;
        details += wxString::Format( _( "%d duplicate IDs replaced.\n" ), duplicates );
    }
 
    for( FOOTPRINT* footprint : board()->Footprints() )
    {
        for( PAD* pad : footprint->Pads() )
        {
            BOARD_CONNECTED_ITEM* cItem = pad;
 
            if( cItem->GetNetCode() )
            {
                NETINFO_ITEM* netinfo = cItem->GetNet();
 
                if( netinfo && !board()->FindNet( netinfo->GetNetname() ) )
                {
                    board()->Add( netinfo );
 
                    details += wxString::Format( _( "Orphaned net %s re-parented.\n" ),
                                                 netinfo->GetNetname() );
                    errors++;
                }
            }
        }
    }
 
    for( PCB_TRACK* track : board()->Tracks() )
    {
        BOARD_CONNECTED_ITEM* cItem = track;
 
        if( cItem->GetNetCode() )
        {
            NETINFO_ITEM* netinfo = cItem->GetNet();
 
            if( netinfo && !board()->FindNet( netinfo->GetNetname() ) )
            {
                board()->Add( netinfo );
 
                details += wxString::Format( _( "Orphaned net %s re-parented.\n" ),
                                             netinfo->GetNetname() );
                errors++;
            }
        }
    }
 
    /*******************************
     * Your test here
     */
 
    /*******************************
     * Inform the user
     */
 
    if( errors )
    {
        m_frame->OnModify();
 
        wxString msg = wxString::Format( _( "%d potential problems repaired." ), errors );
 
        if( !quiet )
            DisplayInfoMessage( m_frame, msg, details );
    }
    else if( !quiet )
    {
        DisplayInfoMessage( m_frame, _( "No board problems found." ) );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::UpdatePCBFromSchematic( const TOOL_EVENT& aEvent )
{
    NETLIST netlist;
    bool    fetched = false;
 
    RunMainStack(
            [&]()
            {
                fetched = m_frame->FetchNetlistFromSchematic(
                        netlist, _( "Updating PCB requires a fully annotated schematic." ) );
            } );
 
    if( fetched )
    {
        DIALOG_UPDATE_PCB updateDialog( m_frame, &netlist );
        updateDialog.ShowModal();
    }
 
    return 0;
}
 
int BOARD_EDITOR_CONTROL::UpdateSchematicFromPCB( const TOOL_EVENT& aEvent )
{
    if( Kiface().IsSingle() )
    {
        DisplayErrorMessage( m_frame, _( "Cannot update schematic because Pcbnew is opened in "
                                         "stand-alone mode. In order to create or update PCBs "
                                         "from schematics, you must launch the KiCad project "
                                         "manager and create a project." ) );
        return 0;
    }
 
    TOOL_EVENT dummy;
    ShowEeschema( dummy );
 
    KIWAY_PLAYER* frame = m_frame->Kiway().Player( FRAME_SCH, false );
 
    if( frame )
    {
        std::string payload;
 
        if( wxWindow* blocking_win = frame->Kiway().GetBlockingDialog() )
            blocking_win->Close( true );
 
        m_frame->Kiway().ExpressMail( FRAME_SCH, MAIL_SCH_UPDATE, payload, m_frame );
    }
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ShowEeschema( const TOOL_EVENT& aEvent )
{
    wxString        msg;
    PCB_EDIT_FRAME* boardFrame = m_frame;
    PROJECT&        project = boardFrame->Prj();
    wxFileName      schematic( project.GetProjectPath(), project.GetProjectName(),
                               FILEEXT::KiCadSchematicFileExtension );
 
    if( !schematic.FileExists() )
    {
        wxFileName legacySchematic( project.GetProjectPath(), project.GetProjectName(),
                                    FILEEXT::LegacySchematicFileExtension );
 
        if( legacySchematic.FileExists() )
        {
            schematic = legacySchematic;
        }
        else
        {
            msg.Printf( _( "Schematic file '%s' not found." ), schematic.GetFullPath() );
            DisplayErrorMessage( m_frame, msg );
            return 0;
        }
    }
 
    if( Kiface().IsSingle() )
    {
        ExecuteFile( EESCHEMA_EXE, schematic.GetFullPath() );
    }
    else
    {
        RunMainStack(
                [&]()
                {
                    KIWAY_PLAYER* frame = m_frame->Kiway().Player( FRAME_SCH, false );
 
                    // Please: note: DIALOG_EDIT_LIBENTRY_FIELDS_IN_LIB::initBuffers() calls
                    // Kiway.Player( FRAME_SCH, true )
                    // therefore, the schematic editor is sometimes running, but the schematic project
                    // is not loaded, if the library editor was called, and the dialog field editor was used.
                    // On Linux, it happens the first time the schematic editor is launched, if
                    // library editor was running, and the dialog field editor was open
                    // On Windows, it happens always after the library editor was called,
                    // and the dialog field editor was used
                    if( !frame )
                    {
                        try
                        {
                            frame = boardFrame->Kiway().Player( FRAME_SCH, true );
                        }
                        catch( const IO_ERROR& err )
                        {
                            DisplayErrorMessage( boardFrame,
                                                 _( "Eeschema failed to load." ) + wxS( "\n" ) + err.What() );
                            return;
                        }
                    }
 
                    wxEventBlocker blocker( boardFrame );
 
                    // If Kiway() cannot create the eeschema frame, it shows a error message, and
                    // frame is null
                    if( !frame )
                        return;
 
                    if( !frame->IsShownOnScreen() ) // the frame exists, (created by the dialog field editor)
                                                    // but no project loaded.
                    {
                        frame->OpenProjectFiles( std::vector<wxString>( 1, schematic.GetFullPath() ) );
                        frame->Show( true );
                    }
 
                    // On Windows, Raise() does not bring the window on screen, when iconized or not shown
                    // On Linux, Raise() brings the window on screen, but this code works fine
                    if( frame->IsIconized() )
                    {
                        frame->Iconize( false );
 
                        // If an iconized frame was created by Pcbnew, Iconize( false ) is not enough
                        // to show the frame at its normal size: Maximize should be called.
                        frame->Maximize( false );
                    }
 
                    frame->Raise();
                } );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleLayersManager( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleLayersManager();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleProperties( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleProperties();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleNetInspector( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleNetInspector();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleGitCommitPane( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleGitCommitPane();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleLibraryTree( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleLibraryTree();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleSearch( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleSearch();
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleConstraintsPanel( const TOOL_EVENT& aEvent )
{
    getEditFrame<PCB_EDIT_FRAME>()->ToggleConstraintsPanel();
    return 0;
}
 
 
// Track & via size control
int BOARD_EDITOR_CONTROL::TrackWidthInc( const TOOL_EVENT& aEvent )
{
    BOARD_DESIGN_SETTINGS& bds = getModel<BOARD>()->GetDesignSettings();
    PCB_SELECTION&         selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( m_frame->ToolStackIsEmpty()
        && SELECTION_CONDITIONS::OnlyTypes( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T } )( selection ) )
    {
        BOARD_COMMIT commit( this );
 
        for( EDA_ITEM* item : selection )
        {
            if( item->IsType( { PCB_TRACE_T, PCB_ARC_T } ) )
            {
                PCB_TRACK* track = static_cast<PCB_TRACK*>( item );
 
                for( int i = 0; i < (int) bds.m_TrackWidthList.size(); ++i )
                {
                    int candidate = bds.m_NetSettings->GetDefaultNetclass()->GetTrackWidth();
 
                    if( i > 0 )
                        candidate = bds.m_TrackWidthList[ i ];
 
                    if( candidate > track->GetWidth() )
                    {
                        commit.Modify( track );
                        track->SetWidth( candidate );
                        break;
                    }
                }
            }
        }
 
        commit.Push( _( "Increase Track Width" ) );
        return 0;
    }
 
    ROUTER_TOOL* routerTool = m_toolMgr->GetTool<ROUTER_TOOL>();
 
    if( routerTool && routerTool->IsToolActive()
        && routerTool->Router()->Mode() == PNS::PNS_MODE_ROUTE_DIFF_PAIR )
    {
        int widthIndex = bds.GetNextDiffPairIndex( bds.GetDiffPairIndex(), true );
 
        bds.SetDiffPairIndex( widthIndex );
        bds.UseCustomDiffPairDimensions( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
    else
    {
        // Issue #24644: stepping the index unconditionally lets the first press both enter the
        // connected-width override and advance into the list, instead of no-op'ing.
        if( routerTool && routerTool->IsToolActive()
            && routerTool->Router()->GetState() == PNS::ROUTER::RouterState::ROUTE_TRACK
            && bds.m_UseConnectedTrackWidth && !bds.m_TempOverrideTrackWidth )
        {
            bds.m_TempOverrideTrackWidth = true;
        }
 
        bds.SetTrackWidthIndex( bds.GetNextTrackWidthIndex( bds.GetTrackWidthIndex(), true ) );
        bds.UseCustomTrackViaSize( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::TrackWidthDec( const TOOL_EVENT& aEvent )
{
    BOARD_DESIGN_SETTINGS& bds = getModel<BOARD>()->GetDesignSettings();
    PCB_SELECTION&         selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( m_frame->ToolStackIsEmpty()
        && SELECTION_CONDITIONS::OnlyTypes( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T } )( selection ) )
    {
        BOARD_COMMIT commit( this );
 
        for( EDA_ITEM* item : selection )
        {
            if( item->IsType( { PCB_TRACE_T, PCB_ARC_T } ) )
            {
                PCB_TRACK* track = static_cast<PCB_TRACK*>( item );
 
                for( int i = (int) bds.m_TrackWidthList.size() - 1; i >= 0; --i )
                {
                    int candidate = bds.m_NetSettings->GetDefaultNetclass()->GetTrackWidth();
 
                    if( i > 0 )
                        candidate = bds.m_TrackWidthList[ i ];
 
                    if( candidate < track->GetWidth() )
                    {
                        commit.Modify( track );
                        track->SetWidth( candidate );
                        break;
                    }
                }
            }
        }
 
        commit.Push( _( "Decrease Track Width" ) );
        return 0;
    }
 
    ROUTER_TOOL* routerTool = m_toolMgr->GetTool<ROUTER_TOOL>();
 
    if( routerTool && routerTool->IsToolActive()
            && routerTool->Router()->Mode() == PNS::PNS_MODE_ROUTE_DIFF_PAIR )
    {
        int widthIndex = bds.GetNextDiffPairIndex( bds.GetDiffPairIndex(), false );
 
        bds.SetDiffPairIndex( widthIndex );
        bds.UseCustomDiffPairDimensions( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
    else
    {
        // Issue #24644: mirror TrackWidthInc so the first invocation also advances into the
        // predefined list instead of merely flipping the override flag.
        if( routerTool && routerTool->IsToolActive()
            && routerTool->Router()->GetState() == PNS::ROUTER::RouterState::ROUTE_TRACK
            && bds.m_UseConnectedTrackWidth && !bds.m_TempOverrideTrackWidth )
        {
            bds.m_TempOverrideTrackWidth = true;
        }
 
        bds.SetTrackWidthIndex( bds.GetNextTrackWidthIndex( bds.GetTrackWidthIndex(), false ) );
        bds.UseCustomTrackViaSize( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ViaSizeInc( const TOOL_EVENT& aEvent )
{
    BOARD_DESIGN_SETTINGS& bds = getModel<BOARD>()->GetDesignSettings();
    PCB_SELECTION&         selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( m_frame->ToolStackIsEmpty()
        && SELECTION_CONDITIONS::OnlyTypes( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T } )( selection ) )
    {
        int          complexPadstacks = 0;
        int          incremented = 0;
        BOARD_COMMIT commit( this );
 
        for( EDA_ITEM* item : selection )
        {
            if( item->Type() == PCB_VIA_T )
            {
                PCB_VIA* via = static_cast<PCB_VIA*>( item );
 
                if( via->Padstack().Mode() != PADSTACK::MODE::NORMAL )
                {
                    complexPadstacks++;
                    continue;
                }
 
                for( int i = 0; i < (int) bds.m_ViasDimensionsList.size(); ++i )
                {
                    VIA_DIMENSION dims( bds.m_NetSettings->GetDefaultNetclass()->GetViaDiameter(),
                                        bds.m_NetSettings->GetDefaultNetclass()->GetViaDrill() );
 
                    if( i> 0 )
                        dims = bds.m_ViasDimensionsList[ i ];
 
                    if( dims.m_Diameter > via->GetWidth( PADSTACK::ALL_LAYERS ) )
                    {
                        commit.Modify( via );
                        via->SetWidth( PADSTACK::ALL_LAYERS, dims.m_Diameter );
                        via->SetDrill( dims.m_Drill );
                        incremented++;
                        break;
                    }
                }
            }
        }
 
        if( incremented == 0 && complexPadstacks > 0 )
        {
            m_frame->ShowInfoBarError( wxString::Format( _( "%s not supported on complex padstacks." ),
                                                         PCB_ACTIONS::viaSizeInc.GetFriendlyName() ) );
        }
 
        commit.Push( PCB_ACTIONS::viaSizeInc.GetFriendlyName() );
    }
    else
    {
        int sizeIndex = bds.GetNextViaSizeIndex( bds.GetViaSizeIndex(), true );
 
        bds.SetViaSizeIndex( sizeIndex );
        bds.UseCustomTrackViaSize( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ViaSizeDec( const TOOL_EVENT& aEvent )
{
    BOARD_DESIGN_SETTINGS& bds = getModel<BOARD>()->GetDesignSettings();
    PCB_SELECTION&         selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( m_frame->ToolStackIsEmpty()
        && SELECTION_CONDITIONS::OnlyTypes( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T } )( selection ) )
    {
        int          complexPadstacks = 0;
        int          decremented = 0;
        BOARD_COMMIT commit( this );
 
        for( EDA_ITEM* item : selection )
        {
            if( item->Type() == PCB_VIA_T )
            {
                PCB_VIA* via = static_cast<PCB_VIA*>( item );
 
                if( via->Padstack().Mode() != PADSTACK::MODE::NORMAL )
                {
                    complexPadstacks++;
                    continue;
                }
 
                for( int i = (int) bds.m_ViasDimensionsList.size() - 1; i >= 0; --i )
                {
                    VIA_DIMENSION dims( bds.m_NetSettings->GetDefaultNetclass()->GetViaDiameter(),
                                        bds.m_NetSettings->GetDefaultNetclass()->GetViaDrill() );
 
                    if( i > 0 )
                        dims = bds.m_ViasDimensionsList[ i ];
 
                    if( dims.m_Diameter < via->GetWidth( PADSTACK::ALL_LAYERS ) )
                    {
                        commit.Modify( via );
                        via->SetWidth( PADSTACK::ALL_LAYERS, dims.m_Diameter );
                        via->SetDrill( dims.m_Drill );
                        decremented++;
                        break;
                    }
                }
            }
        }
 
        if( decremented == 0 && complexPadstacks > 0 )
        {
            m_frame->ShowInfoBarError( wxString::Format( _( "%s not supported on complex padstacks." ),
                                                         PCB_ACTIONS::viaSizeDec.GetFriendlyName() ) );
        }
 
        commit.Push( PCB_ACTIONS::viaSizeDec.GetFriendlyName() );
    }
    else
    {
        int sizeIndex = 0; // Assume we only have a single via size entry
 
        // If there are more, cycle through them backwards
        if( bds.m_ViasDimensionsList.size() > 0 )
            sizeIndex = bds.GetNextViaSizeIndex( bds.GetViaSizeIndex(), false );
 
        bds.SetViaSizeIndex( sizeIndex );
        bds.UseCustomTrackViaSize( false );
 
        m_toolMgr->RunAction( PCB_ACTIONS::trackViaSizeChanged );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::AutoTrackWidth( const TOOL_EVENT& aEvent )
{
    BOARD_DESIGN_SETTINGS& bds = getModel<BOARD>()->GetDesignSettings();
 
    if( bds.UseCustomTrackViaSize() )
    {
        bds.UseCustomTrackViaSize( false );
        bds.m_UseConnectedTrackWidth = true;
    }
    else
    {
        bds.m_UseConnectedTrackWidth = !bds.m_UseConnectedTrackWidth;
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::PlaceFootprint( const TOOL_EVENT& aEvent )
{
    if( m_inPlaceFootprint )
        return 0;
 
    REENTRANCY_GUARD guard( &m_inPlaceFootprint );
 
    FOOTPRINT*            fp = aEvent.Parameter<FOOTPRINT*>();
    bool                  fromOtherCommand = fp != nullptr;
    KIGFX::VIEW_CONTROLS* controls = getViewControls();
    BOARD_COMMIT          commit( m_frame );
    BOARD*                board = getModel<BOARD>();
    COMMON_SETTINGS*      common_settings = Pgm().GetCommonSettings();
 
    m_toolMgr->RunAction( ACTIONS::selectionClear );
 
    TOOL_EVENT         originalEvent = aEvent;          // This can change out from under us when the event loop runs
    SCOPED_TOOL_PUSHER raii( m_frame, originalEvent );
 
    // Frame angle already applied to fp; recaptured whenever fp is (re)acquired, so
    // stale state can never leak into the next placement.
    EDA_ANGLE prevFrameAngle = ANGLE_0;
 
    auto setCursor =
            [&]()
            {
                m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::PENCIL );
            };
 
    auto cleanup =
            [&] ()
            {
                m_toolMgr->RunAction( ACTIONS::selectionClear );
                commit.Revert();
 
                if( fromOtherCommand )
                {
                    PICKED_ITEMS_LIST* undo = m_frame->PopCommandFromUndoList();
 
                    if( undo )
                    {
                        m_frame->PutDataInPreviousState( undo );
                        m_frame->ClearListAndDeleteItems( undo );
                        delete undo;
                    }
                }
 
                fp = nullptr;
                m_placingFootprint = false;
            };
 
    Activate();
    // Must be done after Activate() so that it gets set into the correct context
    controls->ShowCursor( true );
    // Set initial cursor
    setCursor();
 
    VECTOR2I cursorPos = controls->GetCursorPosition();
    bool     ignorePrimePosition = false;
    bool     reselect = false;
 
    auto applyPlacementFrameOrientation =
            [&]()
            {
                if( !fp )
                    return;
 
                EDA_ANGLE newAngle = GridFrameAngleAt( *board, fp->GetPosition(), PCB_GRID_ROLE::PLACEMENT );
                EDA_ANGLE delta = GridFrameRotationDelta( prevFrameAngle, newAngle, m_frame->GetRotationAngle() );
 
                prevFrameAngle = newAngle;
 
                if( !delta.IsZero() )
                    fp->Rotate( fp->GetPosition(), delta );
            };
 
    // Prime the pump
    if( fp )
    {
        m_placingFootprint = true;
 
        // A footprint handed over from another command may already carry the frame
        // rotation of the grid it sits in; count that as applied, like a move pick-up.
        prevFrameAngle = GridFrameAngleAt( *board, fp->GetPosition(), PCB_GRID_ROLE::PLACEMENT );
        fp->SetPosition( cursorPos );
        applyPlacementFrameOrientation();
        m_toolMgr->RunAction<EDA_ITEM*>( ACTIONS::selectItem, fp );
        m_toolMgr->PostAction( ACTIONS::refreshPreview );
    }
    else if( aEvent.HasPosition() )
    {
        m_toolMgr->PrimeTool( aEvent.Position() );
    }
    else if( common_settings->m_Input.immediate_actions && !aEvent.IsReactivate() )
    {
        m_toolMgr->PrimeTool( { 0, 0 } );
        ignorePrimePosition = true;
    }
 
    // Main loop: keep receiving events
    while( TOOL_EVENT* evt = Wait() )
    {
        setCursor();
        cursorPos = controls->GetCursorPosition( !evt->DisableGridSnapping() );
 
        if( reselect && fp )
            m_toolMgr->RunAction<EDA_ITEM*>( ACTIONS::selectItem, fp );
 
        if( evt->IsCancelInteractive() || ( fp && evt->IsAction( &ACTIONS::undo ) ) )
        {
            if( fp )
                cleanup();
            else
                break;
        }
        else if( evt->IsActivate() )
        {
            if( fp )
                cleanup();
 
            if( evt->IsMoveTool() )
            {
                // Make sure we come back after the move tool is done
                m_frame->PushTool( originalEvent );
            }
 
            break;
        }
        else if( evt->IsClick( BUT_LEFT ) )
        {
            if( !fp )
            {
                // Pick the footprint to be placed
                fp = m_frame->SelectFootprintFromLibrary();
 
                if( fp == nullptr )
                    continue;
 
                // If we started with a hotkey which has a position then warp back to that.
                // Otherwise update to the current mouse position pinned inside the autoscroll
                // boundaries.
                if( evt->IsPrime() && !ignorePrimePosition )
                {
                    cursorPos = evt->Position();
                    getViewControls()->WarpMouseCursor( cursorPos, true );
                }
                else
                {
                    getViewControls()->PinCursorInsideNonAutoscrollArea( true );
                    cursorPos = getViewControls()->GetMousePosition();
                }
 
                m_placingFootprint = true;
 
                fp->SetLink( niluuid );
 
                fp->SetFlags( IS_NEW ); // whatever
 
                // Set parent so that clearance can be loaded
                fp->SetParent( board );
                board->UpdateUserUnits( fp, m_frame->GetCanvas()->GetView() );
 
                for( PAD* pad : fp->Pads() )
                {
                    pad->SetLocalRatsnestVisible( m_frame->GetPcbNewSettings()->m_Display.m_ShowGlobalRatsnest );
 
                    // Pads in the library all have orphaned nets.  Replace with Default.
                    pad->SetNetCode( 0 );
                }
 
                // Put it on FRONT layer,
                // (Can be stored flipped if the lib is an archive built from a board)
                if( fp->IsFlipped() )
                    fp->Flip( fp->GetPosition(), m_frame->GetPcbNewSettings()->m_FlipDirection );
 
                fp->SetOrientation( ANGLE_0 );
                fp->SetPosition( cursorPos );
                prevFrameAngle = ANGLE_0;
                applyPlacementFrameOrientation();
 
                commit.Add( fp );
                m_toolMgr->RunAction<EDA_ITEM*>( ACTIONS::selectItem, fp );
 
                m_toolMgr->PostAction( ACTIONS::refreshPreview );
            }
            else
            {
                m_toolMgr->RunAction( ACTIONS::selectionClear );
                commit.Push( _( "Place Footprint" ) );
                fp = nullptr;  // to indicate that there is no footprint that we currently modify
                m_placingFootprint = false;
            }
        }
        else if( evt->IsClick( BUT_RIGHT ) )
        {
            m_menu->ShowContextMenu( selection() );
        }
        else if( fp && ( evt->IsMotion() || evt->IsAction( &ACTIONS::refreshPreview ) ) )
        {
            fp->SetPosition( cursorPos );
            applyPlacementFrameOrientation();
            selection().SetReferencePoint( cursorPos );
            getView()->Update( &selection() );
            getView()->Update( fp );
        }
        else if( fp && evt->IsAction( &PCB_ACTIONS::properties ) )
        {
            // Calling 'Properties' action clears the selection, so we need to restore it
            reselect = true;
        }
        else if( fp && (   ZONE_FILLER_TOOL::IsZoneFillAction( evt )
                        || evt->IsAction( &ACTIONS::redo ) ) )
        {
            wxBell();
        }
        else
        {
            evt->SetPassEvent();
        }
 
        // Enable autopanning and cursor capture only when there is a footprint to be placed
        controls->SetAutoPan( fp != nullptr );
        controls->CaptureCursor( fp != nullptr );
    }
 
    controls->SetAutoPan( false );
    controls->CaptureCursor( false );
    m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ToggleLockSelected( const TOOL_EVENT& aEvent )
{
    return modifyLockSelected( TOGGLE );
}
 
 
int BOARD_EDITOR_CONTROL::LockSelected( const TOOL_EVENT& aEvent )
{
    return modifyLockSelected( ON );
}
 
 
int BOARD_EDITOR_CONTROL::UnlockSelected( const TOOL_EVENT& aEvent )
{
    return modifyLockSelected( OFF );
}
 
 
int BOARD_EDITOR_CONTROL::modifyLockSelected( MODIFY_MODE aMode )
{
    PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
    // RequestSelection populates from the cursor when empty and marks it IsHover(), letting us
    // clear it afterwards without disturbing a pre-existing selection.
    const PCB_SELECTION& selection = selTool->RequestSelection( nullptr );
 
    BOARD_COMMIT commit( m_frame );
 
    if( selection.Empty() )
        return 0;
 
    const bool isHover = selection.IsHover();
 
    // Resolve TOGGLE mode
    if( aMode == TOGGLE )
    {
        aMode = ON;
 
        for( EDA_ITEM* item : selection )
        {
            if( !item->IsBOARD_ITEM() )
                continue;
 
            if( static_cast<BOARD_ITEM*>( item )->IsLocked() )
            {
                aMode = OFF;
                break;
            }
        }
    }
 
    for( EDA_ITEM* item : selection )
    {
        if( !item->IsBOARD_ITEM() )
            continue;
 
        BOARD_ITEM* const board_item = static_cast<BOARD_ITEM*>( item );
 
        // Disallow locking free pads - it's confusing and not persisted
        // through save/load anyway.
        if( board_item->Type() == PCB_PAD_T )
            continue;
 
        EDA_GROUP* parent_group = board_item->GetParentGroup();
 
        if( parent_group && parent_group->AsEdaItem()->Type() == PCB_GENERATOR_T )
        {
            PCB_GENERATOR* generator = static_cast<PCB_GENERATOR*>( parent_group );
 
            if( generator && commit.GetStatus( generator ) != CHT_MODIFY )
            {
                commit.Modify( generator );
 
                if( aMode == ON )
                    generator->SetLocked( true );
                else
                    generator->SetLocked( false );
            }
        }
 
        commit.Modify( board_item );
 
        if( aMode == ON )
            board_item->SetLocked( true );
        else
            board_item->SetLocked( false );
 
        if( aMode == OFF && board_item->Type() == PCB_FOOTPRINT_T )
        {
            board_item->RunOnChildren(
                    []( BOARD_ITEM* child )
                    {
                        child->SetLocked( false );
                    },
                    RECURSE_MODE::RECURSE );
        }
    }
 
    if( !commit.Empty() )
    {
        commit.Push( aMode == ON ? _( "Lock" ) : _( "Unlock" ), SKIP_TEARDROPS );
 
        m_toolMgr->PostEvent( EVENTS::SelectedEvent );
        m_frame->OnModify();
    }
 
    if( isHover )
        m_toolMgr->RunAction( ACTIONS::selectionClear );
 
    return 0;
}
 
 
static bool mergeZones( EDA_DRAW_FRAME* aFrame, BOARD_COMMIT& aCommit,
                        std::vector<ZONE*>& aOriginZones, std::vector<ZONE*>& aMergedZones )
{
    aCommit.Modify( aOriginZones[0] );
 
    aOriginZones[0]->Outline()->ClearArcs();
 
    for( unsigned int i = 1; i < aOriginZones.size(); i++ )
    {
        SHAPE_POLY_SET otherOutline = aOriginZones[i]->Outline()->CloneDropTriangulation();
        otherOutline.ClearArcs();
        aOriginZones[0]->Outline()->BooleanAdd( otherOutline );
    }
 
    aOriginZones[0]->Outline()->Simplify();
 
    // We should have one polygon, possibly with holes.  If we end up with two polygons (either
    // because the intersection was a single point or because the intersection was within one of
    // the zone's holes) then we can't merge.
    if( aOriginZones[0]->Outline()->IsSelfIntersecting() || aOriginZones[0]->Outline()->OutlineCount() > 1 )
    {
        DisplayErrorMessage( aFrame, _( "Zones have insufficient overlap for merging." ) );
        aCommit.Revert();
        return false;
    }
 
    // Adopt the highest priority from all merged zones so the result maintains
    // the most aggressive fill ordering.
    unsigned highestPriority = aOriginZones[0]->GetAssignedPriority();
 
    for( unsigned int i = 1; i < aOriginZones.size(); i++ )
    {
        highestPriority = std::max( highestPriority, aOriginZones[i]->GetAssignedPriority() );
        aCommit.Remove( aOriginZones[i] );
    }
 
    aOriginZones[0]->SetAssignedPriority( highestPriority );
 
    aMergedZones.push_back( aOriginZones[0] );
 
    aOriginZones[0]->SetLocalFlags( 1 );
    aOriginZones[0]->HatchBorder();
    aOriginZones[0]->CacheTriangulation();
 
    return true;
}
 
 
int BOARD_EDITOR_CONTROL::ZoneMerge( const TOOL_EVENT& aEvent )
{
    const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
    BOARD*               board = getModel<BOARD>();
    BOARD_COMMIT         commit( m_frame );
 
    if( selection.Size() < 2 )
        return 0;
 
    int netcode = -1;
 
    ZONE* firstZone = nullptr;
    std::vector<ZONE*> toMerge, merged;
 
    for( EDA_ITEM* item : selection )
    {
        ZONE* curr_area = dynamic_cast<ZONE*>( item );
 
        if( !curr_area )
            continue;
 
        if( !firstZone )
            firstZone = curr_area;
 
        netcode = curr_area->GetNetCode();
 
        if( firstZone->GetNetCode() != netcode )
        {
            wxLogMessage( _( "Some zone netcodes did not match and were not merged." ) );
            continue;
        }
 
        if( curr_area->GetIsRuleArea() != firstZone->GetIsRuleArea() )
        {
            wxLogMessage( _( "Some zones were rule areas and were not merged." ) );
            continue;
        }
 
        if( curr_area->GetLayerSet() != firstZone->GetLayerSet() )
        {
            wxLogMessage( _( "Some zone layer sets did not match and were not merged." ) );
            continue;
        }
 
        bool intersects = curr_area == firstZone;
 
        for( ZONE* candidate : toMerge )
        {
            if( intersects )
                break;
 
            if( board->TestZoneIntersection( curr_area, candidate ) )
                intersects = true;
        }
 
        if( !intersects )
        {
            wxLogMessage( _( "Some zones did not intersect and were not merged." ) );
            continue;
        }
 
        toMerge.push_back( curr_area );
    }
 
    m_toolMgr->RunAction( ACTIONS::selectionClear );
 
    if( !toMerge.empty() )
    {
        if( mergeZones( m_frame, commit, toMerge, merged ) )
        {
            commit.Push( _( "Merge Zones" ) );
 
            for( EDA_ITEM* item : merged )
                m_toolMgr->RunAction( ACTIONS::selectItem, item );
        }
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ZoneDuplicate( const TOOL_EVENT& aEvent )
{
    PCB_SELECTION_TOOL*  selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
    const PCB_SELECTION& selection = selTool->GetSelection();
 
    // because this pops up the zone editor, it would be confusing to handle multiple zones,
    // so just handle single selections containing exactly one zone
    if( selection.Size() != 1 )
        return 0;
 
    ZONE* oldZone = dynamic_cast<ZONE*>( selection[0] );
 
    if( !oldZone )
        return 0;
 
    ZONE_SETTINGS zoneSettings;
    zoneSettings << *oldZone;
    int dialogResult;
 
    if( oldZone->GetIsRuleArea() )
        dialogResult = InvokeRuleAreaEditor( m_frame, &zoneSettings, board() );
    else if( oldZone->IsOnCopperLayer() )
        dialogResult = InvokeCopperZonesEditor( m_frame, nullptr, &zoneSettings );
    else
        dialogResult = InvokeNonCopperZonesEditor( m_frame, &zoneSettings );
 
    if( dialogResult != wxID_OK )
        return 0;
 
    // duplicate the zone
    BOARD_COMMIT commit( m_frame );
 
    std::unique_ptr<ZONE> newZone = std::make_unique<ZONE>( *oldZone );
    newZone->ClearSelected();
    newZone->UnFill();
    zoneSettings.ExportSetting( *newZone );
 
    if( !newZone->GetZoneName().IsEmpty() )
        newZone->SetZoneName( board()->GetUniqueZoneName( newZone->GetZoneName() ) );
 
    // If the new zone is on the same layer(s) as the initial zone,
    // offset it a bit so it can more easily be picked.
    if( oldZone->GetLayerSet() == zoneSettings.m_Layers )
        newZone->Move( VECTOR2I( pcbIUScale.IU_PER_MM, pcbIUScale.IU_PER_MM ) );
 
    commit.Add( newZone.release() );
    commit.Push( _( "Duplicate Zone" ) );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ZonePriorityMoveToTop( const TOOL_EVENT& aEvent )
{
    const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( selection.Size() != 1 )
        return 0;
 
    ZONE* zone = dynamic_cast<ZONE*>( selection[0] );
 
    if( !zone || zone->GetIsRuleArea() || zone->IsTeardropArea() )
        return 0;
 
    std::vector<ZONE*> overlapping = getOverlappingZones( board(), zone );
 
    unsigned maxOverlapping = zone->GetAssignedPriority();
 
    for( ZONE* other : overlapping )
        maxOverlapping = std::max( maxOverlapping, other->GetAssignedPriority() );
 
    if( zone->GetAssignedPriority() >= maxOverlapping )
        return 0;
 
    // Two options to place our zone above all overlapping zones.
    // Pick whichever viable option displaces fewer other zones.
    ZonePriorityMap byPriority = buildPriorityMap( board(), zone );
 
    // Option A: take maxOverlapping, cascade displaced zones down
    bool               cascadeDownViable = false;
    std::vector<ZONE*> cascadeDown =
            findCascadeZones( byPriority, maxOverlapping, false, cascadeDownViable );
 
    // Option B: take maxOverlapping + 1, cascade displaced zones up
    bool               cascadeUpViable = false;
    std::vector<ZONE*> cascadeUp;
    bool               canCascadeUp = ( maxOverlapping < UINT_MAX );
 
    if( canCascadeUp )
        cascadeUp = findCascadeZones( byPriority, maxOverlapping + 1, true, cascadeUpViable );
 
    if( !cascadeDownViable && !cascadeUpViable )
        return 0;
 
    BOARD_COMMIT commit( m_frame );
    commit.Modify( zone );
 
    bool useDown = cascadeDownViable
                   && ( !cascadeUpViable || cascadeDown.size() <= cascadeUp.size() );
 
    if( useDown )
    {
        zone->SetAssignedPriority( maxOverlapping );
 
        for( ZONE* z : cascadeDown )
        {
            commit.Modify( z );
            z->SetAssignedPriority( z->GetAssignedPriority() - 1 );
            z->SetNeedRefill( true );
        }
    }
    else
    {
        zone->SetAssignedPriority( maxOverlapping + 1 );
 
        for( ZONE* z : cascadeUp )
        {
            commit.Modify( z );
            z->SetAssignedPriority( z->GetAssignedPriority() + 1 );
            z->SetNeedRefill( true );
        }
    }
 
    zone->SetNeedRefill( true );
    commit.Push( _( "Move Zone to Top Priority" ) );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ZonePriorityRaise( const TOOL_EVENT& aEvent )
{
    const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( selection.Size() != 1 )
        return 0;
 
    ZONE* zone = dynamic_cast<ZONE*>( selection[0] );
 
    if( !zone || zone->GetIsRuleArea() || zone->IsTeardropArea() )
        return 0;
 
    std::vector<ZONE*> overlapping = getOverlappingZones( board(), zone );
 
    // Find the overlapping zone with the lowest priority still above ours
    ZONE*    target = nullptr;
    unsigned zonePriority = zone->GetAssignedPriority();
 
    for( ZONE* other : overlapping )
    {
        if( other->GetAssignedPriority() > zonePriority )
        {
            if( !target || other->GetAssignedPriority() < target->GetAssignedPriority() )
                target = other;
        }
    }
 
    if( !target )
        return 0;
 
    BOARD_COMMIT commit( m_frame );
    commit.Modify( zone );
 
    // Place our zone just above the target without modifying any other zone
    if( target->GetAssignedPriority() < UINT_MAX )
    {
        zone->SetAssignedPriority( target->GetAssignedPriority() + 1 );
    }
    else
    {
        // Can't go above UINT_MAX; swap as last resort
        commit.Modify( target );
        zone->SetAssignedPriority( UINT_MAX );
        target->SetAssignedPriority( zonePriority );
        target->SetNeedRefill( true );
    }
 
    zone->SetNeedRefill( true );
    commit.Push( _( "Raise Zone Priority" ) );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ZonePriorityLower( const TOOL_EVENT& aEvent )
{
    const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( selection.Size() != 1 )
        return 0;
 
    ZONE* zone = dynamic_cast<ZONE*>( selection[0] );
 
    if( !zone || zone->GetIsRuleArea() || zone->IsTeardropArea() )
        return 0;
 
    std::vector<ZONE*> overlapping = getOverlappingZones( board(), zone );
 
    // Find the overlapping zone with the highest priority still below ours
    ZONE*    target = nullptr;
    unsigned zonePriority = zone->GetAssignedPriority();
 
    for( ZONE* other : overlapping )
    {
        if( other->GetAssignedPriority() < zonePriority )
        {
            if( !target || other->GetAssignedPriority() > target->GetAssignedPriority() )
                target = other;
        }
    }
 
    if( !target )
        return 0;
 
    BOARD_COMMIT commit( m_frame );
    commit.Modify( zone );
 
    // Place our zone just below the target without modifying any other zone
    if( target->GetAssignedPriority() > 0 )
    {
        zone->SetAssignedPriority( target->GetAssignedPriority() - 1 );
    }
    else
    {
        // Can't go below 0; swap as last resort
        commit.Modify( target );
        zone->SetAssignedPriority( 0 );
        target->SetAssignedPriority( zonePriority );
        target->SetNeedRefill( true );
    }
 
    zone->SetNeedRefill( true );
    commit.Push( _( "Lower Zone Priority" ) );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ZonePriorityMoveToBottom( const TOOL_EVENT& aEvent )
{
    const PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
    if( selection.Size() != 1 )
        return 0;
 
    ZONE* zone = dynamic_cast<ZONE*>( selection[0] );
 
    if( !zone || zone->GetIsRuleArea() || zone->IsTeardropArea() )
        return 0;
 
    std::vector<ZONE*> overlapping = getOverlappingZones( board(), zone );
 
    unsigned minOverlapping = zone->GetAssignedPriority();
 
    for( ZONE* other : overlapping )
        minOverlapping = std::min( minOverlapping, other->GetAssignedPriority() );
 
    if( zone->GetAssignedPriority() <= minOverlapping )
        return 0;
 
    // Two options to place our zone below all overlapping zones.
    // Pick whichever viable option displaces fewer other zones.
    ZonePriorityMap byPriority = buildPriorityMap( board(), zone );
 
    // Option A: take minOverlapping, cascade displaced zones up
    bool               cascadeUpViable = false;
    std::vector<ZONE*> cascadeUp =
            findCascadeZones( byPriority, minOverlapping, true, cascadeUpViable );
 
    // Option B: take minOverlapping - 1, cascade displaced zones down
    bool               cascadeDownViable = false;
    std::vector<ZONE*> cascadeDown;
    bool               canCascadeDown = ( minOverlapping > 0 );
 
    if( canCascadeDown )
    {
        cascadeDown =
                findCascadeZones( byPriority, minOverlapping - 1, false, cascadeDownViable );
    }
 
    if( !cascadeUpViable && !cascadeDownViable )
        return 0;
 
    BOARD_COMMIT commit( m_frame );
    commit.Modify( zone );
 
    bool useUp = cascadeUpViable
                 && ( !cascadeDownViable || cascadeUp.size() <= cascadeDown.size() );
 
    if( useUp )
    {
        zone->SetAssignedPriority( minOverlapping );
 
        for( ZONE* z : cascadeUp )
        {
            commit.Modify( z );
            z->SetAssignedPriority( z->GetAssignedPriority() + 1 );
            z->SetNeedRefill( true );
        }
    }
    else
    {
        zone->SetAssignedPriority( minOverlapping - 1 );
 
        for( ZONE* z : cascadeDown )
        {
            commit.Modify( z );
            z->SetAssignedPriority( z->GetAssignedPriority() - 1 );
            z->SetNeedRefill( true );
        }
    }
 
    zone->SetNeedRefill( true );
    commit.Push( _( "Move Zone to Bottom Priority" ) );
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::CrossProbeToSch( const TOOL_EVENT& aEvent )
{
    m_frame->GetBoard()->OnBoardSelectionChanged();
    doCrossProbePcbToSch( aEvent, false );
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::ExplicitCrossProbeToSch( const TOOL_EVENT& aEvent )
{
    doCrossProbePcbToSch( aEvent, true );
    return 0;
}
 
 
void BOARD_EDITOR_CONTROL::doCrossProbePcbToSch( const TOOL_EVENT& aEvent, bool aForce )
{
    // Don't get in an infinite loop PCB -> SCH -> PCB -> SCH -> ...
    if( m_frame->m_ProbingSchToPcb )
        return;
 
    PCB_SELECTION_TOOL*  selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
    const PCB_SELECTION& selection = selTool->GetSelection();
    EDA_ITEM*            focusItem = nullptr;
 
    if( aEvent.Matches( EVENTS::PointSelectedEvent ) )
        focusItem = selection.GetLastAddedItem();
 
    m_frame->SendSelectItemsToSch( selection.GetItems(), focusItem, aForce );
 
    // Update 3D viewer highlighting
    m_frame->Update3DView( false, frame()->GetPcbNewSettings()->m_Display.m_Live3DRefresh );
}
 
 
int BOARD_EDITOR_CONTROL::AssignNetclass( const TOOL_EVENT& aEvent )
{
    PCB_SELECTION_TOOL*  selectionTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
    const PCB_SELECTION& selection = selectionTool->RequestSelection(
            []( const VECTOR2I& aPt, GENERAL_COLLECTOR& aCollector, PCB_SELECTION_TOOL* sTool )
            {
                // Iterate from the back so we don't have to worry about removals.
                for( int i = aCollector.GetCount() - 1; i >= 0; --i )
                {
                    if( !dynamic_cast<BOARD_CONNECTED_ITEM*>( aCollector[ i ] ) )
                        aCollector.Remove( aCollector[ i ] );
                }
 
                sTool->FilterCollectorForLockedItems( aCollector );
            } );
 
    if( selectionTool->ReportFilteredLockedItems() )
        return 0;
 
    std::set<wxString> netNames;
    std::set<int>      netCodes;
 
    for( EDA_ITEM* item : selection )
    {
        const NETINFO_ITEM& net = *static_cast<BOARD_CONNECTED_ITEM*>( item )->GetNet();
 
        if( !net.HasAutoGeneratedNetname() )
        {
            netNames.insert( net.GetNetname() );
            netCodes.insert( net.GetNetCode() );
        }
    }
 
    if( netNames.empty() )
    {
        m_frame->ShowInfoBarError( _( "Selection contains no items with labeled nets." ) );
        return 0;
    }
 
    selectionTool->ClearSelection();
    for( const int& code : netCodes )
    {
        m_toolMgr->RunAction( PCB_ACTIONS::selectNet, code );
    }
    canvas()->ForceRefresh();
 
    DIALOG_ASSIGN_NETCLASS dlg( m_frame, netNames, board()->GetNetClassAssignmentCandidates(),
            [this]( const std::vector<wxString>& aNetNames )
            {
                PCB_SELECTION_TOOL*  selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
                selTool->ClearSelection();
 
                for( const wxString& curr_netName : aNetNames )
                {
                    int curr_netCode = board()->GetNetInfo().GetNetItem( curr_netName )->GetNetCode();
 
                    if( curr_netCode > 0 )
                        selTool->SelectAllItemsOnNet( curr_netCode );
                }
 
                canvas()->ForceRefresh();
                m_frame->UpdateMsgPanel();
            } );
 
    if( dlg.ShowModal() == wxID_OK )
    {
        board()->SynchronizeNetsAndNetClasses( false );
        // Refresh UI that depends on netclasses, such as the properties panel
        m_toolMgr->ProcessEvent( EVENTS::SelectedItemsModified );
    }
 
    return 0;
}
 
 
int BOARD_EDITOR_CONTROL::EditFpInFpEditor( const TOOL_EVENT& aEvent )
{
    PCB_SELECTION_TOOL*  selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
    const PCB_SELECTION& selection = selTool->RequestSelection( EDIT_TOOL::FootprintFilter );
 
    if( selection.Empty() )
    {
        // Giant hack: by default we assign Edit Table to the same hotkey, so give the table
        // tool a chance to handle it if we can't.
        if( PCB_EDIT_TABLE_TOOL* tableTool = m_toolMgr->GetTool<PCB_EDIT_TABLE_TOOL>() )
            tableTool->EditTable( aEvent );
 
        return 0;
    }
 
    FOOTPRINT* fp = selection.FirstOfKind<FOOTPRINT>();
 
    if( !fp )
        return 0;
 
    PCB_BASE_EDIT_FRAME* editFrame = getEditFrame<PCB_BASE_EDIT_FRAME>();
 
    if( KIWAY_PLAYER* frame = editFrame->Kiway().Player( FRAME_FOOTPRINT_EDITOR, true ) )
    {
        FOOTPRINT_EDIT_FRAME* fp_editor = static_cast<FOOTPRINT_EDIT_FRAME*>( frame );
 
        if( aEvent.IsAction( &PCB_ACTIONS::editFpInFpEditor ) )
            fp_editor->LoadFootprintFromBoard( fp );
        else if( aEvent.IsAction( &PCB_ACTIONS::editLibFpInFpEditor ) )
            fp_editor->LoadFootprintFromLibrary( fp->GetFPID() );
 
        fp_editor->Show( true );
        fp_editor->Raise();        // Iconize( false );
    }
 
    if( selection.IsHover() )
        m_toolMgr->RunAction( ACTIONS::selectionClear );
 
    return 0;
}
 
 
void BOARD_EDITOR_CONTROL::DoSetDrillOrigin( KIGFX::VIEW* aView, PCB_BASE_FRAME* aFrame,
                                             EDA_ITEM* originViewItem, const VECTOR2D& aPosition )
{
    aFrame->GetDesignSettings().SetAuxOrigin( VECTOR2I( aPosition ) );
    originViewItem->SetPosition( aPosition );
    aView->MarkDirty();
    aFrame->OnModify();
}
 
 
int BOARD_EDITOR_CONTROL::DrillOrigin( const TOOL_EVENT& aEvent )
{
    if( aEvent.IsAction( &PCB_ACTIONS::drillResetOrigin ) )
    {
        m_frame->SaveCopyInUndoList( m_placeOrigin.get(), UNDO_REDO::GRIDORIGIN );
        DoSetDrillOrigin( getView(), m_frame, m_placeOrigin.get(), VECTOR2D( 0, 0 ) );
        return 0;
    }
 
    if( aEvent.IsAction( &PCB_ACTIONS::drillSetOrigin ) )
    {
        VECTOR2I origin = aEvent.Parameter<VECTOR2I>();
        m_frame->SaveCopyInUndoList( m_placeOrigin.get(), UNDO_REDO::GRIDORIGIN );
        DoSetDrillOrigin( getView(), m_frame, m_placeOrigin.get(), origin );
        return 0;
    }
 
    PCB_PICKER_TOOL* picker = m_toolMgr->GetTool<PCB_PICKER_TOOL>();
 
    // Deactivate other tools; particularly important if another PICKER is currently running
    Activate();
 
    picker->SetCursor( KICURSOR::PLACE );
    picker->ClearHandlers();
 
    picker->SetClickHandler(
            [this] ( const VECTOR2D& pt ) -> bool
            {
                m_frame->SaveCopyInUndoList( m_placeOrigin.get(), UNDO_REDO::DRILLORIGIN );
                DoSetDrillOrigin( getView(), m_frame, m_placeOrigin.get(), pt );
                return false;   // drill origin is a one-shot; don't continue with tool
            } );
 
    m_toolMgr->RunAction( ACTIONS::pickerTool, &aEvent );
 
    return 0;
}
 
 
void BOARD_EDITOR_CONTROL::setTransitions()
{
    Go( &BOARD_EDITOR_CONTROL::New,                    ACTIONS::doNew.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::Open,                   ACTIONS::open.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::Save,                   ACTIONS::save.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::SaveAs,                 ACTIONS::saveAs.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::SaveCopy,               ACTIONS::saveCopy.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::Revert,                 ACTIONS::revert.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::PageSettings,           ACTIONS::pageSettings.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::Plot,                   ACTIONS::plot.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::Search,                 ACTIONS::showSearch.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::Find,                   ACTIONS::find.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::FindNext,               ACTIONS::findNext.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::FindNext,               ACTIONS::findPrevious.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::FindByProperties, PCB_ACTIONS::findByProperties.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::OpenNonKicadBoard,      PCB_ACTIONS::openNonKicadBoard.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportFootprints,       PCB_ACTIONS::exportFootprints.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::BoardSetup,             PCB_ACTIONS::boardSetup.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ImportNetlist,          PCB_ACTIONS::importNetlist.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ImportSpecctraSession,  PCB_ACTIONS::importSpecctraSession.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportSpecctraDSN,      PCB_ACTIONS::exportSpecctraDSN.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::EditFootprintFields,    PCB_ACTIONS::editFootprintFields.MakeEvent() );
 
    if( ADVANCED_CFG::GetCfg().m_ShowPcbnewExportNetlist && m_frame && m_frame->GetExportNetlistAction() )
        Go( &BOARD_EDITOR_CONTROL::ExportNetlist, m_frame->GetExportNetlistAction()->MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::GenerateDrillFiles,     PCB_ACTIONS::generateDrillFiles.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenerateGerbers,        PCB_ACTIONS::generateGerbers.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GeneratePosFile,        PCB_ACTIONS::generatePosFile.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenFootprintsReport,    PCB_ACTIONS::generateReportFile.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenD356File,            PCB_ACTIONS::generateD356File.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenerateBOM,            PCB_ACTIONS::generateBOM.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenBOMFileFromBoard,    PCB_ACTIONS::generateBOMLegacy.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenIPC2581File,         PCB_ACTIONS::generateIPC2581File.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::GenerateODBPPFiles,     PCB_ACTIONS::generateODBPPFile.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::ExportGenCAD,           PCB_ACTIONS::exportGenCAD.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportVRML,             PCB_ACTIONS::exportVRML.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportIDF,              PCB_ACTIONS::exportIDF.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportSTEP,             PCB_ACTIONS::exportSTEP.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportCmpFile,          PCB_ACTIONS::exportCmpFile.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ExportHyperlynx,        PCB_ACTIONS::exportHyperlynx.MakeEvent() );
 
    // Track & via size control
    Go( &BOARD_EDITOR_CONTROL::TrackWidthInc,          PCB_ACTIONS::trackWidthInc.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::TrackWidthDec,          PCB_ACTIONS::trackWidthDec.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ViaSizeInc,             PCB_ACTIONS::viaSizeInc.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ViaSizeDec,             PCB_ACTIONS::viaSizeDec.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::AutoTrackWidth,         PCB_ACTIONS::autoTrackWidth.MakeEvent() );
 
    // Zone actions
    Go( &BOARD_EDITOR_CONTROL::ZoneMerge,              PCB_ACTIONS::zoneMerge.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ZoneDuplicate,          PCB_ACTIONS::zoneDuplicate.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ZonePriorityMoveToTop,  PCB_ACTIONS::zonePriorityMoveToTop.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ZonePriorityRaise,      PCB_ACTIONS::zonePriorityRaise.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ZonePriorityLower,      PCB_ACTIONS::zonePriorityLower.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ZonePriorityMoveToBottom, PCB_ACTIONS::zonePriorityMoveToBottom.MakeEvent() );
 
    // Placing tools
    Go( &BOARD_EDITOR_CONTROL::PlaceFootprint,         PCB_ACTIONS::placeFootprint.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::DrillOrigin,            PCB_ACTIONS::drillOrigin.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::DrillOrigin,            PCB_ACTIONS::drillResetOrigin.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::DrillOrigin,            PCB_ACTIONS::drillSetOrigin.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::EditFpInFpEditor,       PCB_ACTIONS::editFpInFpEditor.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::EditFpInFpEditor,       PCB_ACTIONS::editLibFpInFpEditor.MakeEvent() );
 
    // Cross-select
    Go( &BOARD_EDITOR_CONTROL::CrossProbeToSch,        EVENTS::PointSelectedEvent );
    Go( &BOARD_EDITOR_CONTROL::CrossProbeToSch,        EVENTS::SelectedEvent );
    Go( &BOARD_EDITOR_CONTROL::CrossProbeToSch,        EVENTS::UnselectedEvent );
    Go( &BOARD_EDITOR_CONTROL::CrossProbeToSch,        EVENTS::ClearedEvent );
    Go( &BOARD_EDITOR_CONTROL::ExplicitCrossProbeToSch, PCB_ACTIONS::selectOnSchematic.MakeEvent() );
 
    // Other
    Go( &BOARD_EDITOR_CONTROL::ToggleLockSelected,     PCB_ACTIONS::toggleLock.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::LockSelected,           PCB_ACTIONS::lock.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::UnlockSelected,         PCB_ACTIONS::unlock.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::AssignNetclass,         PCB_ACTIONS::assignNetClass.MakeEvent() );
 
    Go( &BOARD_EDITOR_CONTROL::UpdatePCBFromSchematic, ACTIONS::updatePcbFromSchematic.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::UpdateSchematicFromPCB, ACTIONS::updateSchematicFromPcb.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ShowEeschema,           PCB_ACTIONS::showEeschema.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleLayersManager,    PCB_ACTIONS::showLayersManager.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleProperties,       ACTIONS::showProperties.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleNetInspector,     PCB_ACTIONS::showNetInspector.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleGitCommitPane, ACTIONS::showGitCommitPane.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleLibraryTree,      PCB_ACTIONS::showDesignBlockPanel.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleSearch,           PCB_ACTIONS::showSearch.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ToggleConstraintsPanel, PCB_ACTIONS::showConstraintsPanel.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::RepairBoard,            PCB_ACTIONS::repairBoard.MakeEvent() );
    // Line modes: explicit, next, and notification
    Go( &BOARD_EDITOR_CONTROL::ChangeLineMode,        PCB_ACTIONS::lineModeFree.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ChangeLineMode,        PCB_ACTIONS::lineMode90.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::ChangeLineMode,        PCB_ACTIONS::lineMode45.MakeEvent() );
    Go( &BOARD_EDITOR_CONTROL::OnAngleSnapModeChanged,PCB_ACTIONS::angleSnapModeChanged.MakeEvent() );
}