/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2017 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 #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "pcbnew_id.h" // Pad tools TOOL_ACTION PCB_ACTIONS::copyPadSettings( "pcbnew.PadTool.CopyPadSettings", AS_GLOBAL, 0, "", _( "Copy Pad Properties" ), _( "Copy current pad's properties" ), copy_pad_settings_xpm ); TOOL_ACTION PCB_ACTIONS::applyPadSettings( "pcbnew.PadTool.ApplyPadSettings", AS_GLOBAL, 0, "", _( "Paste Pad Properties" ), _( "Replace the current pad's properties with those copied earlier" ), apply_pad_settings_xpm ); TOOL_ACTION PCB_ACTIONS::pushPadSettings( "pcbnew.PadTool.PushPadSettings", AS_GLOBAL, 0, "", _( "Push Pad Properties..." ), _( "Copy the current pad's properties to other pads" ), push_pad_settings_xpm ); TOOL_ACTION PCB_ACTIONS::enumeratePads( "pcbnew.PadTool.enumeratePads", AS_GLOBAL, 0, "", _( "Renumber Pads..." ), _( "Renumber pads by clicking on them in the desired order" ), pad_enumerate_xpm, AF_ACTIVATE ); class PAD_CONTEXT_MENU : public ACTION_MENU { public: using SHOW_FUNCTOR = std::function; PAD_CONTEXT_MENU( bool aEditingFootprint, SHOW_FUNCTOR aHaveGlobalPadSetting ) : ACTION_MENU( true ), m_editingFootprint( aEditingFootprint ), m_haveGlobalPadSettings( std::move( aHaveGlobalPadSetting ) ) { SetIcon( pad_xpm ); SetTitle( _( "Pads" ) ); Add( PCB_ACTIONS::copyPadSettings ); Add( PCB_ACTIONS::applyPadSettings ); Add( PCB_ACTIONS::pushPadSettings ); // show modedit-specific items if( m_editingFootprint ) { AppendSeparator(); Add( PCB_ACTIONS::enumeratePads ); } } protected: ACTION_MENU* create() const override { return new PAD_CONTEXT_MENU( m_editingFootprint, m_haveGlobalPadSettings ); } private: struct ENABLEMENTS { bool canImport; bool canExport; bool canPush; }; ENABLEMENTS getEnablements( const SELECTION& aSelection ) { using S_C = SELECTION_CONDITIONS; ENABLEMENTS enablements; auto anyPadSel = S_C::HasType( PCB_PAD_T ); auto singlePadSel = S_C::Count( 1 ) && S_C::OnlyType( PCB_PAD_T ); // Apply pads enabled when any pads selected (it applies to each one // individually), plus need a valid global pad setting enablements.canImport = m_haveGlobalPadSettings() && ( anyPadSel )( aSelection ); // Copy pads item enabled only when there is a single pad selected // (otherwise how would we know which one to copy?) enablements.canExport = ( singlePadSel )( aSelection ); // Push pads available when there is a single pad to push from enablements.canPush = ( singlePadSel )( aSelection ); return enablements; } void update() override { auto selTool = getToolManager()->GetTool(); const PCBNEW_SELECTION& selection = selTool->GetSelection(); auto enablements = getEnablements( selection ); Enable( getMenuId( PCB_ACTIONS::applyPadSettings ), enablements.canImport ); Enable( getMenuId( PCB_ACTIONS::copyPadSettings ), enablements.canExport ); Enable( getMenuId( PCB_ACTIONS::pushPadSettings ), enablements.canPush ); } bool m_editingFootprint; SHOW_FUNCTOR m_haveGlobalPadSettings; }; PAD_TOOL::PAD_TOOL() : PCB_TOOL_BASE( "pcbnew.PadTool" ), m_padCopied( false ) {} PAD_TOOL::~PAD_TOOL() {} void PAD_TOOL::Reset( RESET_REASON aReason ) { m_padCopied = false; } bool PAD_TOOL::haveFootprints() { auto& board = *getModel(); return board.Modules().size() > 0; } bool PAD_TOOL::Init() { auto contextMenu = std::make_shared( EditingModules(), [this]() { return m_padCopied; } ); contextMenu->SetTool( this ); SELECTION_TOOL* selTool = m_toolMgr->GetTool(); if( selTool ) { auto& toolMenu = selTool->GetToolMenu(); auto& menu = toolMenu.GetMenu(); toolMenu.AddSubMenu( contextMenu ); auto canShowMenuCond = [this, contextMenu] ( const SELECTION& aSel ) { contextMenu->UpdateAll(); return frame()->GetToolId() == ID_NO_TOOL_SELECTED && haveFootprints() && contextMenu->HasEnabledItems(); }; // show menu when there is a footprint, and the menu has any items auto showCond = canShowMenuCond && ( SELECTION_CONDITIONS::HasType( PCB_PAD_T ) || SELECTION_CONDITIONS::Count( 0 ) ); menu.AddMenu( contextMenu.get(), showCond, 1000 ); // we need a separator only when the selection is empty auto separatorCond = canShowMenuCond && SELECTION_CONDITIONS::Count( 0 ); menu.AddSeparator( 1000 ); } return true; } int PAD_TOOL::pastePadProperties( const TOOL_EVENT& aEvent ) { auto& selTool = *m_toolMgr->GetTool(); const auto& selection = selTool.GetSelection(); const D_PAD& masterPad = frame()->GetDesignSettings().m_Pad_Master; BOARD_COMMIT commit( frame() ); // for every selected pad, paste global settings for( auto item : selection ) { if( item->Type() == PCB_PAD_T ) { commit.Modify( item ); static_cast( *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 ) { auto& selTool = *m_toolMgr->GetTool(); const auto& selection = selTool.GetSelection(); D_PAD& masterPad = frame()->GetDesignSettings().m_Pad_Master; // can only copy from a single pad if( selection.Size() == 1 ) { auto item = selection[0]; if( item->Type() == PCB_PAD_T ) { const auto& selPad = static_cast( *item ); masterPad.ImportSettingsFrom( selPad ); m_padCopied = true; } } return 0; } static void doPushPadProperties( BOARD& board, const D_PAD& aSrcPad, BOARD_COMMIT& commit, bool aSameFootprints, bool aPadShapeFilter, bool aPadOrientFilter, bool aPadLayerFilter ) { const MODULE* moduleRef = aSrcPad.GetParent(); double pad_orient = aSrcPad.GetOrientation() - moduleRef->GetOrientation(); for( auto module : board.Modules() ) { if( !aSameFootprints && ( module != moduleRef ) ) continue; if( module->GetFPID() != moduleRef->GetFPID() ) continue; for( auto pad : module->Pads() ) { if( aPadShapeFilter && ( pad->GetShape() != aSrcPad.GetShape() ) ) continue; double currpad_orient = pad->GetOrientation() - module->GetOrientation(); if( aPadOrientFilter && ( currpad_orient != pad_orient ) ) continue; if( aPadLayerFilter && ( pad->GetLayerSet() != aSrcPad.GetLayerSet() ) ) continue; if( aPadLayerFilter && ( pad->GetLayerSet() != aSrcPad.GetLayerSet() ) ) continue; commit.Modify( pad ); // Apply source pad settings to this pad pad->ImportSettingsFrom( aSrcPad ); } } } int PAD_TOOL::pushPadSettings( const TOOL_EVENT& aEvent ) { auto& selTool = *m_toolMgr->GetTool(); const auto& selection = selTool.GetSelection(); D_PAD* srcPad; if( selection.Size() == 1 && selection[0]->Type() == PCB_PAD_T ) srcPad = static_cast( selection[0] ); else return 0; MODULE* module = srcPad->GetParent(); if( !module ) return 0; frame()->SetMsgPanel( module ); 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(), *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 ); commit.Push( _( "Push Pad Settings" ) ); m_toolMgr->ProcessEvent( EVENTS::SelectedItemsModified ); frame()->Refresh(); return 0; } int PAD_TOOL::EnumeratePads( const TOOL_EVENT& aEvent ) { if( !board()->GetFirstModule() || !board()->GetFirstModule()->Pads().empty() ) return 0; DIALOG_ENUM_PADS settingsDlg( frame() ); if( settingsDlg.ShowModal() != wxID_OK ) return 0; Activate(); GENERAL_COLLECTOR collector; const KICAD_T types[] = { PCB_PAD_T, EOT }; GENERAL_COLLECTORS_GUIDE guide = frame()->GetCollectorsGuide(); guide.SetIgnoreMTextsMarkedNoShow( true ); guide.SetIgnoreMTextsOnBack( true ); guide.SetIgnoreMTextsOnFront( true ); guide.SetIgnoreModulesVals( true ); guide.SetIgnoreModulesRefs( true ); int seqPadNum = settingsDlg.GetStartNumber(); wxString padPrefix = settingsDlg.GetPrefix(); std::deque storedPadNumbers; frame()->SetToolID( ID_MODEDIT_PAD_TOOL, wxCURSOR_HAND, _( "Click on successive pads to renumber them" ) ); m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); getViewControls()->ShowCursor( true ); KIGFX::VIEW* view = m_toolMgr->GetView(); VECTOR2I oldCursorPos; // store the previous mouse cursor position, during mouse drag std::list selectedPads; BOARD_COMMIT commit( frame() ); std::map> oldNames; bool isFirstPoint = true; // used to be sure oldCursorPos will be initialized at least once. STATUS_TEXT_POPUP statusPopup( frame() ); statusPopup.SetText( wxString::Format( _( "Click on pad %s%d\nPress Escape to cancel or double-click to commit" ), padPrefix.c_str(), seqPadNum ) ); statusPopup.Popup(); statusPopup.Move( wxGetMousePosition() + wxPoint( 20, 20 ) ); while( OPT_TOOL_EVENT evt = Wait() ) { if( evt->IsDrag( BUT_LEFT ) || evt->IsClick( BUT_LEFT ) ) { selectedPads.clear(); VECTOR2I cursorPos = getViewControls()->GetCursorPosition(); // 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*IU_PER_MM ) + 1; const wxPoint line_step( ( cursorPos - oldCursorPos ) / segments ); collector.Empty(); for( int j = 0; j < segments; ++j ) { wxPoint testpoint( cursorPos.x - j * line_step.x, cursorPos.y - j * line_step.y ); collector.Collect( board(), types, testpoint, guide ); for( int i = 0; i < collector.GetCount(); ++i ) { selectedPads.push_back( static_cast( collector[i] ) ); } } selectedPads.unique(); for( D_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++; wxString newName = wxString::Format( wxT( "%s%d" ), padPrefix.c_str(), newval ); oldNames[newName] = { newval, pad->GetName() }; pad->SetName( newName ); pad->SetSelected(); getView()->Update( pad ); // Ensure the popup text shows the correct next value if( storedPadNumbers.size() > 0 ) newval = storedPadNumbers.front(); else newval = seqPadNum; statusPopup.SetText( wxString::Format( _( "Click on pad %s%d\nPress Escape to cancel or double-click to commit" ), padPrefix.c_str(), newval ) ); } // ..or restore the old name if it was enumerated and clicked again else if( pad->IsSelected() && evt->IsClick( BUT_LEFT ) ) { auto it = oldNames.find( pad->GetName() ); wxASSERT( it != oldNames.end() ); if( it != oldNames.end() ) { storedPadNumbers.push_back( it->second.first ); pad->SetName( it->second.second ); oldNames.erase( it ); statusPopup.SetText( wxString::Format( _( "Click on pad %s%d\nPress Escape to cancel or double-click to commit" ), padPrefix.c_str(), storedPadNumbers.front() ) ); } pad->ClearSelected(); getView()->Update( pad ); } } } else if( ( evt->IsKeyPressed() && evt->KeyCode() == WXK_RETURN ) || evt->IsDblClick( BUT_LEFT ) ) { commit.Push( _( "Renumber pads" ) ); break; } // This is a cancel-current-action (ie: ). // Note that this must go before IsCancelInteractive() as it also checks IsCancel(). else if( evt->IsCancel() ) { // Clear current selection list to avoid selection of deleted items m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); commit.Revert(); break; } // Now that cancel-current-action has been handled, check for cancel-tool. else if( TOOL_EVT_UTILS::IsCancelInteractive( *evt ) ) { commit.Push( _( "Renumber pads" ) ); break; } else if( evt->IsClick( BUT_RIGHT ) ) { m_menu.ShowContextMenu( selection() ); } // Prepare the next loop by updating the old cursor mouse position // to this last mouse cursor position oldCursorPos = getViewControls()->GetCursorPosition(); statusPopup.Move( wxGetMousePosition() + wxPoint( 20, 20 ) ); } for( auto p : board()->GetFirstModule()->Pads() ) { p->ClearSelected(); view->Update( p ); } statusPopup.Hide(); frame()->SetNoToolSelected(); frame()->GetCanvas()->SetCursor( wxCURSOR_ARROW ); return 0; } 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::EnumeratePads, PCB_ACTIONS::enumeratePads.MakeEvent() ); }