/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2014-2019 CERN * @author Maciej Suminski * * 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 "footprint_editor_tools.h" #include "kicad_clipboard.h" #include "selection_tool.h" #include "pcb_actions.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace std::placeholders; #include // Module editor tools TOOL_ACTION PCB_ACTIONS::placePad( "pcbnew.ModuleEditor.placePad", AS_GLOBAL, 0, _( "Add Pad" ), _( "Add a pad" ), NULL, AF_ACTIVATE ); TOOL_ACTION PCB_ACTIONS::createPadFromShapes( "pcbnew.ModuleEditor.createPadFromShapes", AS_CONTEXT, 0, _( "Create Pad from Selected Shapes" ), _( "Creates a custom-shaped pads from a set of selected shapes" ), primitives_to_custom_pad_xpm ); TOOL_ACTION PCB_ACTIONS::explodePadToShapes( "pcbnew.ModuleEditor.explodePadToShapes", AS_CONTEXT, 0, _( "Explode Pad to Graphic Shapes" ), _( "Converts a custom-shaped pads to a set of graphical shapes" ), custom_pad_to_primitives_xpm ); TOOL_ACTION PCB_ACTIONS::enumeratePads( "pcbnew.ModuleEditor.enumeratePads", AS_GLOBAL, 0, _( "Renumber Pads..." ), _( "Renumber pads by clicking on them in the desired order" ), pad_enumerate_xpm, AF_ACTIVATE ); MODULE_EDITOR_TOOLS::MODULE_EDITOR_TOOLS() : PCB_TOOL( "pcbnew.ModuleEditor" ) { } MODULE_EDITOR_TOOLS::~MODULE_EDITOR_TOOLS() { } void MODULE_EDITOR_TOOLS::Reset( RESET_REASON aReason ) { } int MODULE_EDITOR_TOOLS::PlacePad( const TOOL_EVENT& aEvent ) { struct PAD_PLACER : public INTERACTIVE_PLACER_BASE { std::unique_ptr CreateItem() override { D_PAD* pad = new D_PAD ( m_board->m_Modules ); m_frame->Import_Pad_Settings( pad, false ); // use the global settings for pad pad->IncrementPadName( true, true ); return std::unique_ptr( pad ); } bool PlaceItem( BOARD_ITEM *aItem, BOARD_COMMIT& aCommit ) override { D_PAD* pad = dynamic_cast( aItem ); if( pad ) { m_frame->Export_Pad_Settings( pad ); pad->SetLocalCoord(); aCommit.Add( aItem ); return true; } return false; } }; PAD_PLACER placer; frame()->SetToolID( ID_MODEDIT_PAD_TOOL, wxCURSOR_PENCIL, _( "Add pads" ) ); wxASSERT( board()->m_Modules ); doInteractiveItemPlacement( &placer, _( "Place pad" ), IPO_REPEAT | IPO_SINGLE_CLICK | IPO_ROTATE | IPO_FLIP ); frame()->SetNoToolSelected(); return 0; } int MODULE_EDITOR_TOOLS::EnumeratePads( const TOOL_EVENT& aEvent ) { if( !board()->m_Modules || !board()->m_Modules->PadsList() ) 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(); } // 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()->m_Modules->Pads() ) { p->ClearSelected(); view->Update( p ); } statusPopup.Hide(); frame()->SetNoToolSelected(); frame()->GetGalCanvas()->SetCursor( wxCURSOR_ARROW ); return 0; } int MODULE_EDITOR_TOOLS::ExplodePadToShapes( const TOOL_EVENT& aEvent ) { SELECTION& selection = m_toolMgr->GetTool()->GetSelection(); BOARD_COMMIT commit( frame() ); if( selection.Size() != 1 ) return 0; if( selection[0]->Type() != PCB_PAD_T ) return 0; auto pad = static_cast( selection[0] ); if( pad->GetShape() != PAD_SHAPE_CUSTOM ) return 0; commit.Modify( pad ); wxPoint anchor = pad->GetPosition(); for( auto prim : pad->GetPrimitives() ) { auto ds = new EDGE_MODULE( board()->m_Modules ); prim.ExportTo( ds ); // ExportTo exports to a DRAWSEGMENT // Fix an arbitray draw layer for this EDGE_MODULE ds->SetLayer( Dwgs_User ); //pad->GetLayer() ); ds->Move( anchor ); commit.Add( ds ); } pad->SetShape( pad->GetAnchorPadShape() ); // Cleanup the pad primitives data, because the initial pad was a custom // shaped pad, and it contains primitives, that does not exist in non custom pads, // and can create issues later: if( pad->GetShape() != PAD_SHAPE_CUSTOM ) // should be always the case { pad->DeletePrimitivesList(); } commit.Push( _("Explode pad to shapes") ); m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); return 0; } int MODULE_EDITOR_TOOLS::CreatePadFromShapes( const TOOL_EVENT& aEvent ) { SELECTION& selection = m_toolMgr->GetTool()->GetSelection(); std::unique_ptr pad ( new D_PAD ( board()->m_Modules ) ); D_PAD *refPad = nullptr; bool multipleRefPadsFound = false; bool illegalItemsFound = false; std::vector shapes; BOARD_COMMIT commit( frame() ); for( auto item : selection ) { switch( item->Type() ) { case PCB_PAD_T: { if( refPad ) multipleRefPadsFound = true; refPad = static_cast( item ); break; } case PCB_MODULE_EDGE_T: { auto em = static_cast ( item ); // Currently, S_CURVE shape is not supported. so warn the user if( em->GetShape() == S_CURVE ) { illegalItemsFound = true; break; } PAD_CS_PRIMITIVE shape( em->GetShape() ); shape.m_Start = em->GetStart(); shape.m_End = em->GetEnd(); shape.m_Radius = em->GetRadius(); shape.m_Thickness = em->GetWidth(); shape.m_ArcAngle = em->GetAngle(); shape.m_Poly = em->BuildPolyPointsList(); shapes.push_back(shape); break; } default: { illegalItemsFound = true; break; } } } if( refPad && selection.Size() == 1 ) { // don't convert a pad into itself... return 0; } if( multipleRefPadsFound ) { DisplayErrorMessage( frame(), _( "Cannot convert items to a custom-shaped pad:\n" "selection contains more than one reference pad." ) ); return 0; } if( illegalItemsFound ) { DisplayErrorMessage( frame(), _( "Cannot convert items to a custom-shaped pad:\n" "selection contains unsupported items.\n" "Only graphical lines, circles, arcs and polygons are allowed." ) ); return 0; } if( refPad ) { pad.reset( static_cast( refPad->Clone() ) ); if( refPad->GetShape() == PAD_SHAPE_RECT ) pad->SetAnchorPadShape( PAD_SHAPE_RECT ); // ignore the pad orientation and offset for the moment. Makes more trouble than it's worth. pad->SetOrientation( 0 ); pad->SetOffset( wxPoint( 0, 0 ) ); } else { // Create a default pad anchor: pad->SetAnchorPadShape( PAD_SHAPE_CIRCLE ); pad->SetAttribute( PAD_ATTRIB_SMD ); pad->SetLayerSet( D_PAD::SMDMask() ); int radius = Millimeter2iu( 0.2 ); pad->SetSize ( wxSize( radius, radius ) ); pad->IncrementPadName( true, true ); pad->SetOrientation( 0 ); } pad->SetShape ( PAD_SHAPE_CUSTOM ); OPT anchor; VECTOR2I tmp; if( refPad ) { anchor = VECTOR2I( pad->GetPosition() ); } else if( pad->GetBestAnchorPosition( tmp ) ) { anchor = tmp; } if( !anchor ) { DisplayErrorMessage( frame(), _( "Cannot convert items to a custom-shaped pad:\n" "unable to determine the anchor point position.\n" "Consider adding a small anchor pad to the selection and try again.") ); return 0; } // relocate the shapes, they are relative to the anchor pad position for( auto& shape : shapes ) { shape.Move( wxPoint( -anchor->x, -anchor->y ) ); } pad->SetPosition( wxPoint( anchor->x, anchor->y ) ); pad->AddPrimitives( shapes ); pad->ClearFlags(); bool result = pad->MergePrimitivesAsPolygon(); if( !result ) { DisplayErrorMessage( frame(), _( "Cannot convert items to a custom-shaped pad:\n" "selected items do not form a single solid shape.") ); return 0; } auto padPtr = pad.release(); commit.Add( padPtr ); for ( auto item : selection ) { commit.Remove( item ); } m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); commit.Push(_("Create Pad from Selected Shapes") ); m_toolMgr->RunAction( PCB_ACTIONS::selectItem, true, padPtr ); return 0; } void MODULE_EDITOR_TOOLS::setTransitions() { Go( &MODULE_EDITOR_TOOLS::PlacePad, PCB_ACTIONS::placePad.MakeEvent() ); Go( &MODULE_EDITOR_TOOLS::CreatePadFromShapes, PCB_ACTIONS::createPadFromShapes.MakeEvent() ); Go( &MODULE_EDITOR_TOOLS::ExplodePadToShapes, PCB_ACTIONS::explodePadToShapes.MakeEvent() ); Go( &MODULE_EDITOR_TOOLS::EnumeratePads, PCB_ACTIONS::enumeratePads.MakeEvent() ); }