pad_tool.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2017-2023 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 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, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */
 
 
#include "pad_tool.h"
#include "pcb_painter.h"
#include <kiplatform/ui.h>
#include <macros.h>
#include <class_draw_panel_gal.h>
#include <view/view_controls.h>
#include <tool/tool_manager.h>
#include <board_design_settings.h>
#include <board_item.h>
#include <footprint.h>
#include <pcb_shape.h>
#include <pad.h>
#include <pcbnew_settings.h>
#include <board_commit.h>
#include <dialogs/dialog_push_pad_properties.h>
#include <tools/pcb_actions.h>
#include <tools/pcb_grid_helper.h>
#include <tools/pcb_selection_tool.h>
#include <tools/pcb_selection_conditions.h>
#include <tools/edit_tool.h>
#include <dialogs/dialog_enum_pads.h>
#include <widgets/wx_infobar.h>
 
 
using KIGFX::PCB_RENDER_SETTINGS;
 
 
PAD_TOOL::PAD_TOOL() :
 PCB_TOOL_BASE( "pcbnew.PadTool" ),
 m_wasHighContrast( false ),
 m_editPad( niluuid )
{}
 
 
PAD_TOOL::~PAD_TOOL()
{}
 
 
void PAD_TOOL::Reset( RESET_REASON aReason )
{
 if( aReason == MODEL_RELOAD )
 m_lastPadNumber = wxT( "1" );
 
 if( board() && board()->GetItem( m_editPad ) == DELETED_BOARD_ITEM::GetInstance() )
 {
 PCB_DISPLAY_OPTIONS opts = frame()->GetDisplayOptions();
 bool highContrast = ( opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL );
 
 if( m_wasHighContrast != highContrast )
 m_toolMgr->RunAction( ACTIONS::highContrastMode );
 
 frame()->GetInfoBar()->Dismiss();
 
 m_editPad = niluuid;
 }
}
 
 
bool PAD_TOOL::Init()
{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 
 if( selTool )
 {
 // Add context menu entries that are displayed when selection tool is active
 CONDITIONAL_MENU& menu = selTool->GetToolMenu().GetMenu();
 
 SELECTION_CONDITION padSel = SELECTION_CONDITIONS::HasType( PCB_PAD_T );
 SELECTION_CONDITION singlePadSel = SELECTION_CONDITIONS::Count( 1 ) &&
 SELECTION_CONDITIONS::OnlyTypes( { PCB_PAD_T } );
 
 auto explodeCondition =
 [&]( const SELECTION& aSel )
 {
 return m_editPad == niluuid && aSel.Size() == 1 && aSel[0]->Type() == PCB_PAD_T;
 };
 
 auto recombineCondition =
 [&]( const SELECTION& aSel )
 {
 return m_editPad != niluuid;
 };
 
 menu.AddSeparator( 400 );
 
 if( m_isFootprintEditor )
 {
 menu.AddItem( PCB_ACTIONS::enumeratePads, SELECTION_CONDITIONS::ShowAlways, 400 );
 menu.AddItem( PCB_ACTIONS::recombinePad, recombineCondition, 400 );
 menu.AddItem( PCB_ACTIONS::explodePad, explodeCondition, 400 );
 }
 
 menu.AddItem( PCB_ACTIONS::copyPadSettings, singlePadSel, 400 );
 menu.AddItem( PCB_ACTIONS::applyPadSettings, padSel, 400 );
 menu.AddItem( PCB_ACTIONS::pushPadSettings, singlePadSel, 400 );
 }
 
 auto& ctxMenu = m_menu.GetMenu();
 
 // cancel current tool goes in main context menu at the top if present
 ctxMenu.AddItem( ACTIONS::cancelInteractive, SELECTION_CONDITIONS::ShowAlways, 1 );
 ctxMenu.AddSeparator( 1 );
 
 ctxMenu.AddItem( PCB_ACTIONS::rotateCcw, SELECTION_CONDITIONS::ShowAlways );
 ctxMenu.AddItem( PCB_ACTIONS::rotateCw, SELECTION_CONDITIONS::ShowAlways );
 ctxMenu.AddItem( PCB_ACTIONS::flip, SELECTION_CONDITIONS::ShowAlways );
 ctxMenu.AddItem( PCB_ACTIONS::mirrorH, SELECTION_CONDITIONS::ShowAlways );
 ctxMenu.AddItem( PCB_ACTIONS::mirrorV, SELECTION_CONDITIONS::ShowAlways );
 ctxMenu.AddItem( PCB_ACTIONS::properties, SELECTION_CONDITIONS::ShowAlways );
 
 // Finally, add the standard zoom/grid items
 getEditFrame<PCB_BASE_FRAME>()->AddStandardSubMenus( m_menu );
 
 return true;
}
 
 
int PAD_TOOL::pastePadProperties( const TOOL_EVENT& aEvent )
{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 const PCB_SELECTION& selection = selTool->GetSelection();
 const PAD* masterPad = frame()->GetDesignSettings().m_Pad_Master.get();
 
 BOARD_COMMIT commit( frame() );
 
 // for every selected pad, paste global settings
 for( EDA_ITEM* item : selection )
 {
 if( item->Type() == PCB_PAD_T )
 {
 commit.Modify( item );
 static_cast<PAD&>( *item ).ImportSettingsFrom( *masterPad );
 }
 }
 
 commit.Push( _( "Paste Pad Properties" ) );
 
 m_toolMgr->ProcessEvent( EVENTS::SelectedItemsModified );
 frame()->Refresh();
 
 return 0;
}
 
 
int PAD_TOOL::copyPadSettings( const TOOL_EVENT& aEvent )
{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 const PCB_SELECTION& selection = selTool->GetSelection();
 
 // can only copy from a single pad
 if( selection.Size() == 1 )
 {
 EDA_ITEM* item = selection[0];
 
 if( item->Type() == PCB_PAD_T )
 {
 const PAD& selPad = static_cast<const PAD&>( *item );
 frame()->GetDesignSettings().m_Pad_Master->ImportSettingsFrom( selPad );
 }
 }
 
 return 0;
}
 
 
static void doPushPadProperties( BOARD& board, const PAD& aSrcPad, BOARD_COMMIT& commit,
 bool aSameFootprints, bool aPadShapeFilter, bool aPadOrientFilter,
 bool aPadLayerFilter, bool aPadTypeFilter )
{
 const FOOTPRINT* refFootprint = aSrcPad.GetParentFootprint();
 
 EDA_ANGLE srcPadAngle = aSrcPad.GetOrientation() - refFootprint->GetOrientation();
 
 for( FOOTPRINT* footprint : board.Footprints() )
 {
 if( !aSameFootprints && ( footprint != refFootprint ) )
 continue;
 
 if( footprint->GetFPID() != refFootprint->GetFPID() )
 continue;
 
 for( PAD* pad : footprint->Pads() )
 {
 if( aPadShapeFilter && ( pad->GetShape() != aSrcPad.GetShape() ) )
 continue;
 
 EDA_ANGLE padAngle = pad->GetOrientation() - footprint->GetOrientation();
 
 if( aPadOrientFilter && ( padAngle != srcPadAngle ) )
 continue;
 
 if( aPadLayerFilter && ( pad->GetLayerSet() != aSrcPad.GetLayerSet() ) )
 continue;
 
 if( aPadTypeFilter && ( pad->GetAttribute() != aSrcPad.GetAttribute() ) )
 continue;
 
 // Special-case for aperture pads
 if( aPadTypeFilter && pad->GetAttribute() == PAD_ATTRIB::CONN )
 {
 if( pad->IsAperturePad() != aSrcPad.IsAperturePad() )
 continue;
 }
 
 commit.Modify( pad );
 
 // Apply source pad settings to this pad
 pad->ImportSettingsFrom( aSrcPad );
 }
 }
}
 
 
int PAD_TOOL::pushPadSettings( const TOOL_EVENT& aEvent )
{
 PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool<PCB_SELECTION_TOOL>();
 const PCB_SELECTION& selection = selTool->GetSelection();
 
 if( selection.Size() == 1 && selection[0]->Type() == PCB_PAD_T )
 {
 PAD* srcPad = static_cast<PAD*>( selection[0] );
 
 if( FOOTPRINT* footprint = srcPad->GetParentFootprint() )
 {
 frame()->SetMsgPanel( footprint );
 
 DIALOG_PUSH_PAD_PROPERTIES dlg( frame() );
 int dialogRet = dlg.ShowModal();
 
 if( dialogRet == wxID_CANCEL )
 return 0;
 
 const bool edit_Same_Modules = (dialogRet == 1);
 
 BOARD_COMMIT commit( frame() );
 
 doPushPadProperties( *getModel<BOARD>(), *srcPad, commit, edit_Same_Modules,
 DIALOG_PUSH_PAD_PROPERTIES::m_Pad_Shape_Filter,
 DIALOG_PUSH_PAD_PROPERTIES::m_Pad_Orient_Filter,
 DIALOG_PUSH_PAD_PROPERTIES::m_Pad_Layer_Filter,
 DIALOG_PUSH_PAD_PROPERTIES::m_Pad_Type_Filter );
 
 commit.Push( _( "Push Pad Settings" ) );
 
 m_toolMgr->ProcessEvent( EVENTS::SelectedItemsModified );
 frame()->Refresh();
 }
 }
 
 return 0;
}
 
 
static std::optional<SEQUENTIAL_PAD_ENUMERATION_PARAMS>
GetSequentialPadNumberingParams( wxWindow* aFrame )
{
 // Persistent settings for the pad enumeration dialog.
 static SEQUENTIAL_PAD_ENUMERATION_PARAMS s_lastUsedParams;
 
 DIALOG_ENUM_PADS settingsDlg( aFrame, s_lastUsedParams );
 
 if( settingsDlg.ShowModal() != wxID_OK )
 return std::nullopt;
 
 return s_lastUsedParams;
}
 
 
int PAD_TOOL::EnumeratePads( const TOOL_EVENT& aEvent )
{
 if( !m_isFootprintEditor )
 return 0;
 
 if( !board()->GetFirstFootprint() || board()->GetFirstFootprint()->Pads().empty() )
 return 0;
 
 GENERAL_COLLECTOR collector;
 GENERAL_COLLECTORS_GUIDE guide = frame()->GetCollectorsGuide();
 guide.SetIgnoreMTextsMarkedNoShow( true );
 guide.SetIgnoreMTextsOnBack( true );
 guide.SetIgnoreMTextsOnFront( true );
 guide.SetIgnoreModulesVals( true );
 guide.SetIgnoreModulesRefs( true );
 
 const std::optional<SEQUENTIAL_PAD_ENUMERATION_PARAMS> params =
 GetSequentialPadNumberingParams( frame() );
 
 // Cancelled or otherwise failed to get any useful parameters
 if( !params )
 return 0;
 
 int seqPadNum = params->m_start_number;
 
 std::deque<int> storedPadNumbers;
 std::map<wxString, std::pair<int, wxString>> oldNumbers;
 
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear );
 
 frame()->PushTool( aEvent );
 
 VECTOR2I oldCursorPos; // store the previous mouse cursor position, during mouse drag
 std::list<PAD*> selectedPads;
 BOARD_COMMIT commit( frame() );
 bool isFirstPoint = true; // make sure oldCursorPos is initialized at least once
 PADS pads = board()->GetFirstFootprint()->Pads();
 
 MAGNETIC_SETTINGS mag_settings;
 mag_settings.graphics = false;
 mag_settings.tracks = MAGNETIC_OPTIONS::NO_EFFECT;
 mag_settings.pads = MAGNETIC_OPTIONS::CAPTURE_ALWAYS;
 PCB_GRID_HELPER grid( m_toolMgr, &mag_settings );
 
 grid.SetSnap( true );
 grid.SetUseGrid( false );
 
 auto setCursor =
 [&]()
 {
 canvas()->SetCurrentCursor( KICURSOR::BULLSEYE );
 };
 
 Activate();
 // Must be done after Activate() so that it gets set into the correct context
 getViewControls()->ShowCursor( true );
 getViewControls()->ForceCursorPosition( false );
 // Set initial cursor
 setCursor();
 
 STATUS_TEXT_POPUP statusPopup( frame() );
 
 // Callable lambda to construct the pad number string for the given value
 const auto constructPadNumber = [&]( int aValue )
 {
 return wxString::Format( wxT( "%s%d" ), params->m_prefix.value_or( "" ), aValue );
 };
 
 // Callable lambda to set the popup text for the given pad value
 const auto setPopupTextForValue = [&]( int aValue )
 {
 const wxString msg =
 _( "Click on pad %s\nPress <esc> to cancel all; double-click to finish" );
 statusPopup.SetText( wxString::Format( msg, constructPadNumber( aValue ) ) );
 };
 
 setPopupTextForValue( seqPadNum );
 statusPopup.Popup();
 statusPopup.Move( KIPLATFORM::UI::GetMousePosition() + wxPoint( 20, 20 ) );
 canvas()->SetStatusPopup( statusPopup.GetPanel() );
 
 while( TOOL_EVENT* evt = Wait() )
 {
 setCursor();
 
 VECTOR2I cursorPos = grid.AlignToNearestPad( getViewControls()->GetMousePosition(), pads );
 getViewControls()->ForceCursorPosition( true, cursorPos );
 
 if( evt->IsCancelInteractive() )
 {
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear );
 commit.Revert();
 
 frame()->PopTool( aEvent );
 break;
 }
 else if( evt->IsActivate() )
 {
 commit.Push( _( "Renumber pads" ) );
 
 frame()->PopTool( aEvent );
 break;
 }
 else if( evt->IsDrag( BUT_LEFT ) || evt->IsClick( BUT_LEFT ) )
 {
 selectedPads.clear();
 
 // Be sure the old cursor mouse position was initialized:
 if( isFirstPoint )
 {
 oldCursorPos = cursorPos;
 isFirstPoint = false;
 }
 
 // wxWidgets deliver mouse move events not frequently enough, resulting in skipping
 // pads if the user moves cursor too fast. To solve it, create a line that approximates
 // the mouse move and search pads that are on the line.
 int distance = ( cursorPos - oldCursorPos ).EuclideanNorm();
 // Search will be made every 0.1 mm:
 int segments = distance / int( 0.1 * pcbIUScale.IU_PER_MM ) + 1;
 const VECTOR2I line_step( ( cursorPos - oldCursorPos ) / segments );
 
 collector.Empty();
 
 for( int j = 0; j < segments; ++j )
 {
 VECTOR2I testpoint( cursorPos.x - j * line_step.x, cursorPos.y - j * line_step.y );
 collector.Collect( board(), { PCB_PAD_T }, testpoint, guide );
 
 for( int i = 0; i < collector.GetCount(); ++i )
 selectedPads.push_back( static_cast<PAD*>( collector[i] ) );
 }
 
 selectedPads.unique();
 
 for( PAD* pad : selectedPads )
 {
 // If pad was not selected, then enumerate it
 if( !pad->IsSelected() )
 {
 commit.Modify( pad );
 
 // Rename pad and store the old name
 int newval;
 
 if( storedPadNumbers.size() > 0 )
 {
 newval = storedPadNumbers.front();
 storedPadNumbers.pop_front();
 }
 else
 {
 newval = seqPadNum;
 seqPadNum += params->m_step;
 }
 
 const wxString newNumber = constructPadNumber( newval );
 oldNumbers[newNumber] = { newval, pad->GetNumber() };
 pad->SetNumber( newNumber );
 SetLastPadNumber( newNumber );
 pad->SetSelected();
 getView()->Update( pad );
 
 // Ensure the popup text shows the correct next value
 if( storedPadNumbers.size() > 0 )
 newval = storedPadNumbers.front();
 else
 newval = seqPadNum;
 
 setPopupTextForValue( newval );
 }
 
 // ... or restore the old name if it was enumerated and clicked again
 else if( pad->IsSelected() && evt->IsClick( BUT_LEFT ) )
 {
 auto it = oldNumbers.find( pad->GetNumber() );
 wxASSERT( it != oldNumbers.end() );
 
 if( it != oldNumbers.end() )
 {
 storedPadNumbers.push_back( it->second.first );
 pad->SetNumber( it->second.second );
 SetLastPadNumber( it->second.second );
 oldNumbers.erase( it );
 
 const int newval = storedPadNumbers.front();
 setPopupTextForValue( newval );
 }
 
 pad->ClearSelected();
 getView()->Update( pad );
 }
 }
 }
 else if( evt->IsDblClick( BUT_LEFT ) )
 {
 commit.Push( _( "Renumber pads" ) );
 frame()->PopTool( aEvent );
 break;
 }
 else if( evt->IsClick( BUT_RIGHT ) )
 {
 m_menu.ShowContextMenu( selection() );
 }
 else
 {
 evt->SetPassEvent();
 }
 
 // Prepare the next loop by updating the old cursor mouse position
 // to this last mouse cursor position
 oldCursorPos = getViewControls()->GetCursorPosition();
 statusPopup.Move( KIPLATFORM::UI::GetMousePosition() + wxPoint( 20, 20 ) );
 }
 
 for( PAD* p : board()->GetFirstFootprint()->Pads() )
 {
 p->ClearSelected();
 getView()->Update( p );
 }
 
 canvas()->SetStatusPopup( nullptr );
 statusPopup.Hide();
 
 canvas()->SetCurrentCursor( KICURSOR::ARROW );
 getViewControls()->ForceCursorPosition( false );
 return 0;
}
 
 
int PAD_TOOL::PlacePad( const TOOL_EVENT& aEvent )
{
 if( !m_isFootprintEditor )
 return 0;
 
 if( !board()->GetFirstFootprint() )
 return 0;
 
 struct PAD_PLACER : public INTERACTIVE_PLACER_BASE
 {
 PAD_PLACER( PAD_TOOL* aPadTool )
 {
 m_padTool = aPadTool;
 }
 
 virtual ~PAD_PLACER()
 {
 }
 
 std::unique_ptr<BOARD_ITEM> CreateItem() override
 {
 PAD* pad = new PAD( m_board->GetFirstFootprint() );
 PAD* master = m_frame->GetDesignSettings().m_Pad_Master.get();
 
 pad->ImportSettingsFrom( *master );
 
 // If the footprint type and master pad type directly conflict then make some
 // adjustments. Otherwise assume the user set what they wanted.
 if( ( m_board->GetFirstFootprint()->GetAttributes() & FP_SMD )
 && master->GetAttribute() == PAD_ATTRIB::PTH )
 {
 pad->SetAttribute( PAD_ATTRIB::SMD );
 pad->SetShape( PAD_SHAPE::ROUNDRECT );
 pad->SetSizeX( 1.5 * pad->GetSizeY() );
 pad->SetLayerSet( PAD::SMDMask() );
 }
 else if( ( m_board->GetFirstFootprint()->GetAttributes() & FP_THROUGH_HOLE )
 && master->GetAttribute() == PAD_ATTRIB::SMD )
 {
 pad->SetAttribute( PAD_ATTRIB::PTH );
 pad->SetShape( PAD_SHAPE::CIRCLE );
 pad->SetSize( VECTOR2I( pad->GetSizeX(), pad->GetSizeX() ) );
 pad->SetLayerSet( PAD::PTHMask() );
 }
 
 if( pad->CanHaveNumber() )
 {
 wxString padNumber = m_padTool->GetLastPadNumber();
 padNumber = m_board->GetFirstFootprint()->GetNextPadNumber( padNumber );
 pad->SetNumber( padNumber );
 m_padTool->SetLastPadNumber( padNumber );
 }
 
 return std::unique_ptr<BOARD_ITEM>( pad );
 }
 
 bool PlaceItem( BOARD_ITEM *aItem, BOARD_COMMIT& aCommit ) override
 {
 PAD* pad = dynamic_cast<PAD*>( aItem );
 
 if( pad )
 {
 m_frame->GetDesignSettings().m_Pad_Master->ImportSettingsFrom( *pad );
 aCommit.Add( aItem );
 return true;
 }
 
 return false;
 }
 
 PAD_TOOL* m_padTool;
 };
 
 PAD_PLACER placer( this );
 
 doInteractiveItemPlacement( aEvent, &placer, _( "Place pad" ),
 IPO_REPEAT | IPO_SINGLE_CLICK | IPO_ROTATE | IPO_FLIP );
 
 return 0;
}
 
 
int PAD_TOOL::EditPad( const TOOL_EVENT& aEvent )
{
 if( !m_isFootprintEditor )
 return 0;
 
 Activate();
 
 PCB_DISPLAY_OPTIONS opts = frame()->GetDisplayOptions();
 KIGFX::PCB_PAINTER* painter = static_cast<KIGFX::PCB_PAINTER*>( view()->GetPainter() );
 PCB_RENDER_SETTINGS* settings = painter->GetSettings();
 PCB_SELECTION& selection = m_toolMgr->GetTool<PCB_SELECTION_TOOL>()->GetSelection();
 
 if( m_editPad != niluuid )
 {
 PAD* pad = dynamic_cast<PAD*>( frame()->GetItem( m_editPad ) );
 
 if( pad )
 {
 BOARD_COMMIT commit( frame() );
 RecombinePad( pad, false, commit );
 commit.Push( _( "Recombine pad" ) );
 }
 
 m_editPad = niluuid;
 }
 else if( selection.Size() == 1 && selection[0]->Type() == PCB_PAD_T )
 {
 PAD* pad = static_cast<PAD*>( selection[0] );
 PCB_LAYER_ID layer = explodePad( pad );
 
 m_editPad = pad->m_Uuid;
 
 m_wasHighContrast = ( opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL );
 frame()->SetActiveLayer( layer );
 
 settings->m_PadEditModePad = pad;
 enterPadEditMode();
 }
 
 if( m_editPad == niluuid )
 {
 settings->m_PadEditModePad = nullptr;
 exitPadEditMode();
 }
 
 return 0;
}
 
 
int PAD_TOOL::OnUndoRedo( const TOOL_EVENT& aEvent )
{
 PAD* flaggedPad = nullptr;
 KIID flaggedPadId = niluuid;
 
 for( FOOTPRINT* fp : board()->Footprints() )
 {
 for( PAD* pad : fp->Pads() )
 {
 if( pad->IsEntered() )
 {
 flaggedPad = pad;
 flaggedPadId = pad->m_Uuid;
 break;
 }
 }
 }
 
 if( flaggedPadId != m_editPad )
 {
 KIGFX::PCB_PAINTER* painter = static_cast<KIGFX::PCB_PAINTER*>( view()->GetPainter() );
 PCB_RENDER_SETTINGS* settings = painter->GetSettings();
 
 m_editPad = flaggedPadId;
 settings->m_PadEditModePad = flaggedPad;
 
 if( flaggedPad )
 enterPadEditMode();
 else
 exitPadEditMode();
 }
 
 return 0;
}
 
 
void PAD_TOOL::enterPadEditMode()
{
 PCB_DISPLAY_OPTIONS opts = frame()->GetDisplayOptions();
 bool highContrast = opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL;
 WX_INFOBAR* infoBar = frame()->GetInfoBar();
 wxString msg;
 
 canvas()->GetView()->UpdateAllItemsConditionally( KIGFX::REPAINT,
 [&]( KIGFX::VIEW_ITEM* aItem ) -> bool
 {
 return dynamic_cast<PAD*>( aItem ) != nullptr;
 } );
 
 if( !highContrast )
 m_toolMgr->RunAction( ACTIONS::highContrastMode );
 
 if( PCB_ACTIONS::explodePad.GetHotKey() == PCB_ACTIONS::recombinePad.GetHotKey() )
 {
 msg.Printf( _( "Pad Edit Mode. Press %s again to exit." ),
 KeyNameFromKeyCode( PCB_ACTIONS::recombinePad.GetHotKey() ) );
 }
 else
 {
 msg.Printf( _( "Pad Edit Mode. Press %s to exit." ),
 KeyNameFromKeyCode( PCB_ACTIONS::recombinePad.GetHotKey() ) );
 }
 
 infoBar->RemoveAllButtons();
 infoBar->ShowMessage( msg, wxICON_INFORMATION );
}
 
 
void PAD_TOOL::exitPadEditMode()
{
 PCB_DISPLAY_OPTIONS opts = frame()->GetDisplayOptions();
 bool highContrast = opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL;
 
 if( m_wasHighContrast != highContrast )
 m_toolMgr->RunAction( ACTIONS::highContrastMode );
 
 // Note: KIGFX::REPAINT isn't enough for things that go from invisible to visible as
 // they won't be found in the view layer's itemset for re-painting.
 canvas()->GetView()->UpdateAllItemsConditionally( KIGFX::ALL,
 [&]( KIGFX::VIEW_ITEM* aItem ) -> bool
 {
 return dynamic_cast<PAD*>( aItem ) != nullptr;
 } );
 
 // Refresh now (otherwise there's an uncomfortably long pause while the infoBar
 // closes before refresh).
 canvas()->ForceRefresh();
 
 frame()->GetInfoBar()->Dismiss();
}
 
 
PCB_LAYER_ID PAD_TOOL::explodePad( PAD* aPad )
{
 PCB_LAYER_ID layer;
 BOARD_COMMIT commit( frame() );
 
 if( aPad->IsOnLayer( F_Cu ) )
 layer = F_Cu;
 else if( aPad->IsOnLayer( B_Cu ) )
 layer = B_Cu;
 else
 layer = *aPad->GetLayerSet().UIOrder();
 
 if( aPad->GetShape() == PAD_SHAPE::CUSTOM )
 {
 commit.Modify( aPad );
 
 for( const std::shared_ptr<PCB_SHAPE>& primitive : aPad->GetPrimitives() )
 {
 PCB_SHAPE* shape = static_cast<PCB_SHAPE*>( primitive->Duplicate() );
 
 shape->SetParent( board()->GetFirstFootprint() );
 shape->Rotate( VECTOR2I( 0, 0 ), aPad->GetOrientation() );
 shape->Move( aPad->ShapePos() );
 shape->SetLayer( layer );
 
 if( shape->IsProxyItem() && shape->GetShape() == SHAPE_T::SEGMENT )
 {
 if( aPad->GetThermalSpokeWidth() )
 shape->SetWidth( aPad->GetThermalSpokeWidth() );
 else
 shape->SetWidth( pcbIUScale.mmToIU( ZONE_THERMAL_RELIEF_COPPER_WIDTH_MM ) );
 }
 
 commit.Add( shape );
 }
 
 aPad->SetShape( aPad->GetAnchorPadShape() );
 aPad->DeletePrimitivesList();
 }
 
 aPad->SetFlags( ENTERED );
 m_editPad = aPad->m_Uuid;
 
 commit.Push( _("Edit pad shapes") );
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear );
 return layer;
}
 
 
std::vector<PCB_SHAPE*> PAD_TOOL::RecombinePad( PAD* aPad, bool aIsDryRun, BOARD_COMMIT& aCommit )
{
 int maxError = board()->GetDesignSettings().m_MaxError;
 FOOTPRINT* footprint = aPad->GetParentFootprint();
 
 // Don't leave an object in the point editor that might no longer exist after recombining.
 m_toolMgr->RunAction( PCB_ACTIONS::selectionClear );
 
 for( BOARD_ITEM* item : footprint->GraphicalItems() )
 item->ClearFlags( SKIP_STRUCT );
 
 auto findNext =
 [&]( PCB_LAYER_ID aLayer ) -> PCB_SHAPE*
 {
 SHAPE_POLY_SET padPoly;
 aPad->TransformShapeToPolygon( padPoly, aLayer, 0, maxError, ERROR_INSIDE );
 
 for( BOARD_ITEM* item : footprint->GraphicalItems() )
 {
 PCB_SHAPE* shape = dynamic_cast<PCB_SHAPE*>( item );
 
 if( !shape || ( shape->GetFlags() & SKIP_STRUCT ) )
 continue;
 
 if( shape->GetLayer() != aLayer )
 continue;
 
 if( shape->IsProxyItem() ) // Pad number (and net name) box
 return shape;
 
 SHAPE_POLY_SET drawPoly;
 shape->TransformShapeToPolygon( drawPoly, aLayer, 0, maxError, ERROR_INSIDE );
 drawPoly.BooleanIntersection( padPoly, SHAPE_POLY_SET::PM_FAST );
 
 if( !drawPoly.IsEmpty() )
 return shape;
 }
 
 return nullptr;
 };
 
 auto findMatching =
 [&]( PCB_SHAPE* aShape ) -> std::vector<PCB_SHAPE*>
 {
 std::vector<PCB_SHAPE*> matching;
 
 for( BOARD_ITEM* item : footprint->GraphicalItems() )
 {
 PCB_SHAPE* other = dynamic_cast<PCB_SHAPE*>( item );
 
 if( !other || ( other->GetFlags() & SKIP_STRUCT ) )
 continue;
 
 if( aPad->GetLayerSet().test( other->GetLayer() )
 && aShape->Compare( other ) == 0 )
 {
 matching.push_back( other );
 }
 }
 
 return matching;
 };
 
 PCB_LAYER_ID layer;
 std::vector<PCB_SHAPE*> mergedShapes;
 
 if( aPad->IsOnLayer( F_Cu ) )
 layer = F_Cu;
 else if( aPad->IsOnLayer( B_Cu ) )
 layer = B_Cu;
 else
 layer = *aPad->GetLayerSet().UIOrder();
 
 // If there are intersecting items to combine, we need to first make sure the pad is a
 // custom-shape pad.
 if( !aIsDryRun && findNext( layer ) && aPad->GetShape() != PAD_SHAPE::CUSTOM )
 {
 aCommit.Modify( aPad );
 
 if( aPad->GetShape() == PAD_SHAPE::CIRCLE || aPad->GetShape() == PAD_SHAPE::RECTANGLE )
 {
 // Use the existing pad as an anchor
 aPad->SetAnchorPadShape( aPad->GetShape() );
 aPad->SetShape( PAD_SHAPE::CUSTOM );
 }
 else
 {
 // Create a new circular anchor and convert existing pad to a polygon primitive
 SHAPE_POLY_SET existingOutline;
 aPad->TransformShapeToPolygon( existingOutline, layer, 0, maxError, ERROR_INSIDE );
 
 int minExtent = std::min( aPad->GetSize().x, aPad->GetSize().y );
 aPad->SetAnchorPadShape( PAD_SHAPE::CIRCLE );
 aPad->SetSize( VECTOR2I( minExtent, minExtent ) );
 aPad->SetShape( PAD_SHAPE::CUSTOM );
 
 PCB_SHAPE* shape = new PCB_SHAPE( nullptr, SHAPE_T::POLY );
 shape->SetFilled( true );
 shape->SetStroke( STROKE_PARAMS( 0, PLOT_DASH_TYPE::SOLID ) );
 shape->SetPolyShape( existingOutline );
 shape->Rotate( VECTOR2I( 0, 0 ), - aPad->GetOrientation() );
 shape->Move( - aPad->ShapePos() );
 aPad->AddPrimitive( shape );
 }
 }
 
 while( PCB_SHAPE* fpShape = findNext( layer ) )
 {
 fpShape->SetFlags( SKIP_STRUCT );
 
 mergedShapes.push_back( fpShape );
 
 if( !aIsDryRun )
 {
 PCB_SHAPE* primitive = static_cast<PCB_SHAPE*>( fpShape->Duplicate() );
 
 primitive->SetParent( nullptr );
 primitive->Move( - aPad->ShapePos() );
 primitive->Rotate( VECTOR2I( 0, 0 ), - aPad->GetOrientation() );
 
 aPad->AddPrimitive( primitive );
 
 aCommit.Remove( fpShape );
 }
 
 // See if there are other shapes that match and mark them for delete. (KiCad won't
 // produce these, but old footprints from other vendors have them.)
 for( PCB_SHAPE* other : findMatching( fpShape ) )
 {
 other->SetFlags( SKIP_STRUCT );
 mergedShapes.push_back( other );
 
 if( !aIsDryRun )
 aCommit.Remove( other );
 }
 }
 
 for( BOARD_ITEM* item : footprint->GraphicalItems() )
 item->ClearFlags( SKIP_STRUCT );
 
 if( !aIsDryRun )
 aPad->ClearFlags( ENTERED );
 
 return mergedShapes;
}
 
 
void PAD_TOOL::setTransitions()
{
 Go( &PAD_TOOL::pastePadProperties, PCB_ACTIONS::applyPadSettings.MakeEvent() );
 Go( &PAD_TOOL::copyPadSettings, PCB_ACTIONS::copyPadSettings.MakeEvent() );
 Go( &PAD_TOOL::pushPadSettings, PCB_ACTIONS::pushPadSettings.MakeEvent() );
 
 Go( &PAD_TOOL::PlacePad, PCB_ACTIONS::placePad.MakeEvent() );
 Go( &PAD_TOOL::EnumeratePads, PCB_ACTIONS::enumeratePads.MakeEvent() );
 
 Go( &PAD_TOOL::EditPad, PCB_ACTIONS::explodePad.MakeEvent() );
 Go( &PAD_TOOL::EditPad, PCB_ACTIONS::recombinePad.MakeEvent() );
 
 Go( &PAD_TOOL::OnUndoRedo, EVENTS::UndoRedoPostEvent );
}