KiCad PCB EDA Suite
Loading...
Searching...
No Matches
pcb_selection_tool.cpp
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2013-2017 CERN
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 * @author Tomasz Wlostowski <[email protected]>
7 * @author Maciej Suminski <[email protected]>
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * as published by the Free Software Foundation; either version 2
12 * of the License, or (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, you may find one here:
21 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
22 * or you may search the http://www.gnu.org website for the version 2 license,
23 * or you may write to the Free Software Foundation, Inc.,
24 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
25 */
26
27#include <limits>
28#include <cmath>
29#include <functional>
30#include <stack>
31using namespace std::placeholders;
32
33#include <advanced_config.h>
34#include <macros.h>
35#include <board.h>
37#include <pcb_point.h>
38#include <pcb_table.h>
39#include <pcb_tablecell.h>
40#include <pcb_marker.h>
41#include <pcb_generator.h>
42#include <pcb_base_edit_frame.h>
43#include <zone.h>
44#include <collectors.h>
46#include <view/view_controls.h>
47#include <gal/painter.h>
48#include <router/router_tool.h>
49#include <pcbnew_settings.h>
50#include <tool/tool_event.h>
51#include <tool/tool_manager.h>
55#include <tools/pcb_actions.h>
59#include <wx/event.h>
60#include <wx/timer.h>
61#include <wx/log.h>
62#include <wx/debug.h>
63#include <core/profile.h>
64#include <math/vector2wx.h>
65
66
73
74
76{
77public:
79 ACTION_MENU( true )
80 {
81 SetTitle( _( "Select" ) );
82
84
85 AppendSeparator();
86
89
90 // This could be enabled if we have better logic for picking the target net with the mouse
91 // Add( PCB_ACTIONS::deselectNet );
94
97 }
98
99private:
100 ACTION_MENU* create() const override
101 {
102 return new SELECT_MENU();
103 }
104};
105
106
115
116
118 SELECTION_TOOL( "common.InteractiveSelection" ),
119 m_frame( nullptr ),
120 m_isFootprintEditor( false ),
122 m_enteredGroup( nullptr ),
124 m_priv( std::make_unique<PRIV>() )
125{
126 m_filter.lockedItems = false;
127 m_filter.footprints = true;
128 m_filter.text = true;
129 m_filter.tracks = true;
130 m_filter.vias = true;
131 m_filter.pads = true;
132 m_filter.graphics = true;
133 m_filter.zones = true;
134 m_filter.keepouts = true;
135 m_filter.dimensions = true;
136 m_filter.points = true;
137 m_filter.otherItems = true;
138}
139
140
142{
145
146 Disconnect( wxEVT_TIMER, wxTimerEventHandler( PCB_SELECTION_TOOL::onDisambiguationExpire ), nullptr, this );
147}
148
149
151{
153
154 if( frame && frame->IsType( FRAME_FOOTPRINT_VIEWER ) )
155 {
156 frame->AddStandardSubMenus( *m_menu.get() );
157 return true;
158 }
159
160 std::shared_ptr<SELECT_MENU> selectMenu = std::make_shared<SELECT_MENU>();
161 selectMenu->SetTool( this );
162 m_menu->RegisterSubMenu( selectMenu );
163
164 static const std::vector<KICAD_T> tableCellTypes = { PCB_TABLECELL_T };
165
166 auto& menu = m_menu->GetMenu();
167
168 auto activeToolCondition =
169 [this] ( const SELECTION& aSel )
170 {
172 return pcbFrame && !pcbFrame->ToolStackIsEmpty();
173 };
174
175 auto haveHighlight =
176 [this]( const SELECTION& sel )
177 {
178 KIGFX::RENDER_SETTINGS* cfg = m_toolMgr->GetView()->GetPainter()->GetSettings();
179
180 return !cfg->GetHighlightNetCodes().empty();
181 };
182
183 auto groupEnterCondition =
185
186 auto inGroupCondition =
187 [this] ( const SELECTION& )
188 {
189 return m_enteredGroup != nullptr;
190 };
191
192 auto tableCellSelection = SELECTION_CONDITIONS::MoreThan( 0 )
194
195 if( frame && frame->IsType( FRAME_PCB_EDITOR ) )
196 {
197 menu.AddMenu( selectMenu.get(), SELECTION_CONDITIONS::NotEmpty );
198 menu.AddSeparator( 1000 );
199 }
200
201 // "Cancel" goes at the top of the context menu when a tool is active
202 menu.AddItem( ACTIONS::cancelInteractive, activeToolCondition, 1 );
203 menu.AddItem( ACTIONS::groupEnter, groupEnterCondition, 1 );
204 menu.AddItem( ACTIONS::groupLeave, inGroupCondition, 1 );
205 menu.AddItem( PCB_ACTIONS::applyDesignBlockLayout, groupEnterCondition, 1 );
206 menu.AddItem( PCB_ACTIONS::placeLinkedDesignBlock, groupEnterCondition, 1 );
207 menu.AddItem( PCB_ACTIONS::saveToLinkedDesignBlock, groupEnterCondition, 1 );
208 menu.AddItem( PCB_ACTIONS::clearHighlight, haveHighlight, 1 );
209 menu.AddSeparator( haveHighlight, 1 );
210
211 menu.AddItem( ACTIONS::selectColumns, tableCellSelection, 2 );
212 menu.AddItem( ACTIONS::selectRows, tableCellSelection, 2 );
213 menu.AddItem( ACTIONS::selectTable, tableCellSelection, 2 );
214
215 menu.AddSeparator( 1 );
216
217 if( frame )
218 frame->AddStandardSubMenus( *m_menu.get() );
219
220 m_disambiguateTimer.SetOwner( this );
221 Connect( m_disambiguateTimer.GetId(), wxEVT_TIMER,
222 wxTimerEventHandler( PCB_SELECTION_TOOL::onDisambiguationExpire ), nullptr, this );
223
224 return true;
225}
226
227
229{
232
233 if( aReason != TOOL_BASE::REDRAW )
234 {
235 if( m_enteredGroup )
236 ExitGroup();
237
238 // Deselect any item being currently in edit, to avoid unexpected behavior and remove
239 // pointers to the selected items from containers.
240 ClearSelection( true );
241 }
242
243 if( aReason == TOOL_BASE::MODEL_RELOAD )
244 getView()->GetPainter()->GetSettings()->SetHighlight( false );
245
246 // Reinsert the VIEW_GROUP, in case it was removed from the VIEW
247 view()->Remove( &m_selection );
248 view()->Add( &m_selection );
249
252}
253
254
255void PCB_SELECTION_TOOL::OnIdle( wxIdleEvent& aEvent )
256{
257 if( m_frame->ToolStackIsEmpty() && !m_multiple )
258 {
259 wxMouseState keyboardState = wxGetMouseState();
260
261 setModifiersState( keyboardState.ShiftDown(), keyboardState.ControlDown(), keyboardState.AltDown() );
262
263 if( m_additive )
264 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::ADD );
265 else if( m_subtractive )
266 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::SUBTRACT );
267 else if( m_exclusive_or )
268 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::XOR );
269 else
270 m_frame->GetCanvas()->SetCurrentCursor( m_nonModifiedCursor );
271 }
272}
273
274
276{
277 // Main loop: keep receiving events
278 while( TOOL_EVENT* evt = Wait() )
279 {
280 MOUSE_DRAG_ACTION dragAction = m_frame->GetDragAction();
282
283 if( PCBNEW_SETTINGS* cfg = m_frame->GetPcbNewSettings() )
284 trackDragAction = cfg->m_TrackDragAction;
285
286 // on left click, a selection is made, depending on modifiers ALT, SHIFT, CTRL:
287 setModifiersState( evt->Modifier( MD_SHIFT ), evt->Modifier( MD_CTRL ), evt->Modifier( MD_ALT ) );
288
290 bool brd_editor = frame && frame->IsType( FRAME_PCB_EDITOR );
291 ROUTER_TOOL* router = m_toolMgr->GetTool<ROUTER_TOOL>();
292
293 // If the router tool is active, don't override
294 if( router && router->IsToolActive() && router->RoutingInProgress() )
295 {
296 evt->SetPassEvent();
297 }
298 else if( evt->IsMouseDown( BUT_LEFT ) )
299 {
300 // Avoid triggering when running under other tools
301 PCB_POINT_EDITOR *pt_tool = m_toolMgr->GetTool<PCB_POINT_EDITOR>();
302
303 if( m_frame->ToolStackIsEmpty() && pt_tool && !pt_tool->HasPoint() )
304 {
305 m_originalCursor = m_toolMgr->GetMousePosition();
306 m_disambiguateTimer.StartOnce( ADVANCED_CFG::GetCfg().m_DisambiguationMenuDelay );
307 }
308 }
309 else if( evt->IsClick( BUT_LEFT ) )
310 {
311 // If there is no disambiguation, this routine is still running and will
312 // register a `click` event when released
313 if( m_disambiguateTimer.IsRunning() )
314 {
315 m_disambiguateTimer.Stop();
316
317 // Single click? Select single object
318 if( m_highlight_modifier && brd_editor )
319 {
321 }
322 else
323 {
324 m_frame->ClearFocus();
325 selectPoint( evt->Position() );
326 }
327 }
328
329 m_canceledMenu = false;
330 }
331 else if( evt->IsClick( BUT_RIGHT ) )
332 {
333 m_disambiguateTimer.Stop();
334
335 // Right click? if there is any object - show the context menu
336 bool selectionCancelled = false;
337
338 if( m_selection.Empty() )
339 {
340 selectPoint( evt->Position(), false, &selectionCancelled );
341 m_selection.SetIsHover( true );
342 }
343
344 // Show selection before opening menu
345 m_frame->GetCanvas()->ForceRefresh();
346
347 if( !selectionCancelled )
348 {
349 m_toolMgr->VetoContextMenuMouseWarp();
350 m_menu->ShowContextMenu( m_selection );
351 }
352 }
353 else if( evt->IsDblClick( BUT_LEFT ) )
354 {
355 m_disambiguateTimer.Stop();
356
357 // Double clicks make no sense in the footprint viewer
358 if( frame && frame->IsType( FRAME_FOOTPRINT_VIEWER ) )
359 {
360 evt->SetPassEvent();
361 continue;
362 }
363
364 // Double click? Display the properties window
365 m_frame->ClearFocus();
366
367 if( m_selection.Empty() )
368 selectPoint( evt->Position() );
369
370 if( m_selection.GetSize() == 1 && m_selection[0]->Type() == PCB_GROUP_T )
371 EnterGroup();
372 else
374 }
375 else if( evt->IsDblClick( BUT_MIDDLE ) )
376 {
377 // Middle double click? Do zoom to fit or zoom to objects
378 if( evt->Modifier( MD_CTRL ) ) // Is CTRL key down?
380 else
381 m_toolMgr->RunAction( ACTIONS::zoomFitScreen );
382 }
383 else if( evt->Action() == TA_MOUSE_WHEEL )
384 {
385 int field = -1;
386
387 if( evt->Modifier() == ( MD_SHIFT | MD_ALT ) )
388 field = 0;
389 else if( evt->Modifier() == ( MD_CTRL | MD_ALT ) )
390 field = 1;
391 // any more?
392
393 if( field >= 0 )
394 {
395 const int delta = evt->Parameter<int>();
396 ACTIONS::INCREMENT params { delta > 0 ? 1 : -1, field };
397
398 m_toolMgr->RunAction( ACTIONS::increment, params );
399 }
400 }
401 else if( evt->IsDrag( BUT_LEFT ) )
402 {
403 m_disambiguateTimer.Stop();
404
405 // Is another tool already moving a new object? Don't allow a drag start
406 if( !m_selection.Empty() && m_selection[0]->HasFlag( IS_NEW | IS_MOVING ) )
407 {
408 evt->SetPassEvent();
409 continue;
410 }
411
412 // Drag with LMB? Select multiple objects (or at least draw a selection box)
413 // or drag them
414 m_frame->ClearFocus();
416
417 GENERAL_COLLECTOR hoverCells;
418
419 if( m_isFootprintEditor && board()->GetFirstFootprint() )
420 {
421 hoverCells.Collect( board()->GetFirstFootprint(), { PCB_TABLECELL_T }, evt->DragOrigin(),
423 }
424 else
425 {
426 hoverCells.Collect( board(), { PCB_TABLECELL_T }, evt->DragOrigin(), getCollectorsGuide() );
427 }
428
429 if( hoverCells.GetCount() )
430 {
431 if( m_selection.Empty() || SELECTION_CONDITIONS::OnlyTypes( { PCB_TABLECELL_T } )( m_selection ) )
432 {
433 selectTableCells( static_cast<PCB_TABLE*>( hoverCells[0]->GetParent() ) );
434 }
435 else
436 {
437 m_toolMgr->RunAction( PCB_ACTIONS::move );
438 }
439 }
440 else if( ( hasModifier() || dragAction == MOUSE_DRAG_ACTION::SELECT )
441 || ( m_selection.Empty() && dragAction != MOUSE_DRAG_ACTION::DRAG_ANY ) )
442 {
445 {
446 SelectRectArea( aEvent );
447 }
450 {
451 SelectPolyArea( aEvent );
452 }
453 else
454 {
455 wxASSERT_MSG( false, wxT( "Unknown selection mode" ) );
456 SelectRectArea( aEvent );
457 }
458 }
459 else
460 {
461 // Don't allow starting a drag from a zone filled area that isn't already selected
462 auto zoneFilledAreaFilter =
463 []( const VECTOR2I& aWhere, GENERAL_COLLECTOR& aCollector, PCB_SELECTION_TOOL* aTool )
464 {
465 int accuracy = aCollector.GetGuide()->Accuracy();
466 std::set<EDA_ITEM*> remove;
467
468 for( EDA_ITEM* item : aCollector )
469 {
470 if( item->Type() == PCB_ZONE_T )
471 {
472 ZONE* zone = static_cast<ZONE*>( item );
473
474 if( !zone->HitTestForCorner( aWhere, accuracy * 2 )
475 && !zone->HitTestForEdge( aWhere, accuracy ) )
476 {
477 remove.insert( zone );
478 }
479 }
480 }
481
482 for( EDA_ITEM* item : remove )
483 aCollector.Remove( item );
484 };
485
486 // See if we can drag before falling back to SelectRectArea()
487 bool doDrag = false;
488
489 if( evt->HasPosition() )
490 {
491 if( m_selection.Empty()
492 && selectPoint( evt->DragOrigin(), false, nullptr, zoneFilledAreaFilter ) )
493 {
494 m_selection.SetIsHover( true );
495 doDrag = true;
496 }
497 // Check if dragging has started within any of selected items bounding box.
498 else if( evt->HasPosition() && selectionContains( evt->DragOrigin() ) )
499 {
500 doDrag = true;
501 }
502 }
503
504 if( doDrag )
505 {
506 size_t segs = m_selection.CountType( PCB_TRACE_T );
507 size_t arcs = m_selection.CountType( PCB_ARC_T );
508 size_t vias = m_selection.CountType( PCB_VIA_T );
509 // Note: multi-track dragging is currently supported, but not multi-via
510 bool routable = ( segs >= 1 || arcs >= 1 || vias == 1 )
511 && ( segs + arcs + vias == m_selection.GetSize() );
512
513 if( routable && trackDragAction == TRACK_DRAG_ACTION::DRAG )
515 else if( routable && trackDragAction == TRACK_DRAG_ACTION::DRAG_FREE_ANGLE )
517 else
518 m_toolMgr->RunAction( PCB_ACTIONS::move );
519 }
520 else
521 {
522 // Otherwise drag a selection box
525 {
526 SelectPolyArea( aEvent );
527 }
528 else
529 {
530 SelectRectArea( aEvent );
531 }
532 }
533 }
534 }
535 else if( evt->IsCancel() )
536 {
537 m_disambiguateTimer.Stop();
538 m_frame->ClearFocus();
539
540 if( !GetSelection().Empty() )
541 {
543 }
544 else if( evt->FirstResponder() == this && evt->GetCommandId() == (int) WXK_ESCAPE )
545 {
546 if( m_enteredGroup )
547 {
548 ExitGroup();
549 }
550 else
551 {
552 BOARD_INSPECTION_TOOL* controller = m_toolMgr->GetTool<BOARD_INSPECTION_TOOL>();
553
554 try
555 {
556 if( controller && m_frame->GetPcbNewSettings()->m_ESCClearsNetHighlight )
557 controller->ClearHighlight( *evt );
558 }
559 catch( const std::runtime_error& e )
560 {
561 wxCHECK_MSG( false, 0, e.what() );
562 }
563 }
564 }
565 }
566 else
567 {
568 evt->SetPassEvent();
569 }
570
571
572 if( m_frame->ToolStackIsEmpty() )
573 {
574 // move cursor prediction
575 if( !hasModifier()
576 && dragAction == MOUSE_DRAG_ACTION::DRAG_SELECTED
577 && !m_selection.Empty()
578 && evt->HasPosition()
579 && selectionContains( evt->Position() ) )
580 {
582 }
583 else
584 {
586 }
587 }
588 }
589
590 // Shutting down; clear the selection
591 m_selection.Clear();
592 m_disambiguateTimer.Stop();
593
594 return 0;
595}
596
597
599{
600 wxCHECK_RET( m_selection.GetSize() == 1 && m_selection[0]->Type() == PCB_GROUP_T,
601 wxT( "EnterGroup called when selection is not a single group" ) );
602 PCB_GROUP* aGroup = static_cast<PCB_GROUP*>( m_selection[0] );
603
604 if( m_enteredGroup != nullptr )
605 ExitGroup();
606
608 m_enteredGroup = aGroup;
609 m_enteredGroup->SetFlags( ENTERED );
610
611 for( EDA_ITEM* member : m_enteredGroup->GetItems() )
612 select( member );
613
614 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
615
616 view()->Hide( m_enteredGroup, true );
619}
620
621
622void PCB_SELECTION_TOOL::ExitGroup( bool aSelectGroup )
623{
624 // Only continue if there is a group entered
625 if( m_enteredGroup == nullptr )
626 return;
627
628 m_enteredGroup->ClearFlags( ENTERED );
629 view()->Hide( m_enteredGroup, false );
631
632 if( aSelectGroup )
633 {
635 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
636 }
637
638 m_enteredGroupOverlay.Clear();
639 m_enteredGroup = nullptr;
641}
642
643
648
649
651{
652 bool selectionEmpty = m_selection.Empty();
653 m_selection.SetIsHover( selectionEmpty );
654
655 if( selectionEmpty )
656 {
657 m_toolMgr->RunAction( ACTIONS::selectionCursor, aClientFilter );
658 m_selection.ClearReferencePoint();
659 }
660
661 if( aClientFilter )
662 {
663 enum DISPOSITION { BEFORE = 1, AFTER, BOTH };
664
665 std::map<EDA_ITEM*, DISPOSITION> itemDispositions;
667 GENERAL_COLLECTOR collector;
668
669 collector.SetGuide( &guide );
670
671 for( EDA_ITEM* item : m_selection )
672 {
673 collector.Append( item );
674 itemDispositions[ item ] = BEFORE;
675 }
676
677 aClientFilter( VECTOR2I(), collector, this );
678
679 for( EDA_ITEM* item : collector )
680 {
681 if( itemDispositions.count( item ) )
682 itemDispositions[ item ] = BOTH;
683 else
684 itemDispositions[ item ] = AFTER;
685 }
686
687 // Unhighlight the BEFORE items before highlighting the AFTER items.
688 // This is so that in the case of groups, if aClientFilter replaces a selection
689 // with the enclosing group, the unhighlight of the element doesn't undo the
690 // recursive highlighting of that element by the group.
691
692 for( std::pair<EDA_ITEM* const, DISPOSITION> itemDisposition : itemDispositions )
693 {
694 EDA_ITEM* item = itemDisposition.first;
695 DISPOSITION disposition = itemDisposition.second;
696
697 if( disposition == BEFORE )
699 }
700
701 for( std::pair<EDA_ITEM* const, DISPOSITION> itemDisposition : itemDispositions )
702 {
703 EDA_ITEM* item = itemDisposition.first;
704 DISPOSITION disposition = itemDisposition.second;
705
706 // Note that we must re-highlight even previously-highlighted items
707 // (ie: disposition BOTH) in case we removed any of their children.
708 if( disposition == AFTER || disposition == BOTH )
709 highlight( item, SELECTED, &m_selection );
710 }
711
712 m_frame->GetCanvas()->ForceRefresh();
713 }
714
715 return m_selection;
716}
717
718
720{
721 GENERAL_COLLECTORS_GUIDE guide( board()->GetVisibleLayers(), (PCB_LAYER_ID) view()->GetTopLayer(),
722 view() );
723
724 bool padsDisabled = !board()->IsElementVisible( LAYER_PADS );
725
726 // account for the globals
727 guide.SetIgnoreFPTextOnBack( !board()->IsElementVisible( LAYER_FP_TEXT ) );
728 guide.SetIgnoreFPTextOnFront( !board()->IsElementVisible( LAYER_FP_TEXT ) );
729 guide.SetIgnoreFootprintsOnBack( !board()->IsElementVisible( LAYER_FOOTPRINTS_BK ) );
730 guide.SetIgnoreFootprintsOnFront( !board()->IsElementVisible( LAYER_FOOTPRINTS_FR ) );
731 guide.SetIgnorePadsOnBack( padsDisabled );
732 guide.SetIgnorePadsOnFront( padsDisabled );
733 guide.SetIgnoreThroughHolePads( padsDisabled );
734 guide.SetIgnoreFPValues( !board()->IsElementVisible( LAYER_FP_VALUES ) );
735 guide.SetIgnoreFPReferences( !board()->IsElementVisible( LAYER_FP_REFERENCES ) );
736 guide.SetIgnoreThroughVias( ! board()->IsElementVisible( LAYER_VIAS ) );
737 guide.SetIgnoreBlindBuriedVias( ! board()->IsElementVisible( LAYER_VIAS ) );
738 guide.SetIgnoreMicroVias( ! board()->IsElementVisible( LAYER_VIAS ) );
739 guide.SetIgnoreTracks( ! board()->IsElementVisible( LAYER_TRACKS ) );
740
741 return guide;
742}
743
744
746{
747 return m_frame && m_frame->GetPcbNewSettings()->m_CtrlClickHighlight && !m_isFootprintEditor;
748}
749
750
751bool PCB_SELECTION_TOOL::selectPoint( const VECTOR2I& aWhere, bool aOnDrag, bool* aSelectionCancelledFlag,
752 CLIENT_SELECTION_FILTER aClientFilter )
753{
755 GENERAL_COLLECTOR collector;
756 const PCB_DISPLAY_OPTIONS& displayOpts = m_frame->GetDisplayOptions();
757
759
760 if( m_enteredGroup && !m_enteredGroup->GetBoundingBox().Contains( aWhere ) )
761 ExitGroup();
762
765 aWhere, guide );
766
767 // Remove unselectable items
768 for( int i = collector.GetCount() - 1; i >= 0; --i )
769 {
770 if( !Selectable( collector[ i ] ) || ( aOnDrag && collector[i]->IsLocked() ) )
771 collector.Remove( i );
772 }
773
774 m_selection.ClearReferencePoint();
775
776 size_t preFilterCount = collector.GetCount();
778 rejected.SetAll( false );
779
780 // Apply the stateful filter (remove items disabled by the Selection Filter)
781 FilterCollectedItems( collector, false, &rejected );
782
783 if( collector.GetCount() == 0 && preFilterCount > 0 )
784 {
786 editFrame->HighlightSelectionFilter( rejected );
787
788 return false;
789 }
790
791 // Allow the client to do tool- or action-specific filtering to see if we can get down
792 // to a single item
793 if( aClientFilter )
794 aClientFilter( aWhere, collector, this );
795
796 FilterCollectorForHierarchy( collector, false );
797
798 FilterCollectorForFootprints( collector, aWhere );
799
800 // For subtracting, we only want items that are selected
801 if( m_subtractive )
802 {
803 for( int i = collector.GetCount() - 1; i >= 0; --i )
804 {
805 if( !collector[i]->IsSelected() )
806 collector.Remove( i );
807 }
808 }
809
810 // Apply some ugly heuristics to avoid disambiguation menus whenever possible
811 if( collector.GetCount() > 1 && !m_skip_heuristics )
812 {
813 try
814 {
815 GuessSelectionCandidates( collector, aWhere );
816 }
817 catch( const std::exception& exc )
818 {
819 wxLogWarning( wxS( "Exception '%s' occurred attempting to guess selection candidates." ),
820 exc.what() );
821 return false;
822 }
823 }
824
825 // If still more than one item we're going to have to ask the user.
826 if( collector.GetCount() > 1 )
827 {
828 if( aOnDrag )
830
831 if( !doSelectionMenu( &collector ) )
832 {
833 if( aSelectionCancelledFlag )
834 *aSelectionCancelledFlag = true;
835
836 return false;
837 }
838 }
839
840 int addedCount = 0;
841 bool anySubtracted = false;
842
844 {
845 if( m_selection.GetSize() > 0 )
846 {
847 ClearSelection( true /*quiet mode*/ );
848 anySubtracted = true;
849 }
850 }
851
852 if( collector.GetCount() > 0 )
853 {
854 for( int i = 0; i < collector.GetCount(); ++i )
855 {
856 if( m_subtractive || ( m_exclusive_or && collector[i]->IsSelected() ) )
857 {
858 unselect( collector[i] );
859 anySubtracted = true;
860 }
861 else
862 {
863 select( collector[i] );
864 addedCount++;
865 }
866 }
867 }
868
869 if( addedCount == 1 )
870 {
871 m_toolMgr->ProcessEvent( EVENTS::PointSelectedEvent );
872 return true;
873 }
874 else if( addedCount > 1 )
875 {
876 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
877 return true;
878 }
879 else if( anySubtracted )
880 {
881 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
882 return true;
883 }
884
885 return false;
886}
887
888
889bool PCB_SELECTION_TOOL::selectCursor( bool aForceSelect, CLIENT_SELECTION_FILTER aClientFilter )
890{
891 if( aForceSelect || m_selection.Empty() )
892 {
893 ClearSelection( true /*quiet mode*/ );
894 selectPoint( getViewControls()->GetCursorPosition( false ), false, nullptr, aClientFilter );
895 }
896
897 return !m_selection.Empty();
898}
899
900
901// Some navigation actions are allowed in selectMultiple
912
913
914static void passEvent( TOOL_EVENT* const aEvent, const TOOL_ACTION* const aAllowedActions[] )
915{
916 for( int i = 0; aAllowedActions[i]; ++i )
917 {
918 if( aEvent->IsAction( aAllowedActions[i] ) )
919 {
920 aEvent->SetPassEvent();
921 break;
922 }
923 }
924}
925
926
928{
929 bool cancelled = false; // Was the tool canceled while it was running?
930 m_multiple = true; // Multiple selection mode is active
931
932 for( PCB_TABLECELL* cell : aTable->GetCells() )
933 {
934 if( cell->IsSelected() )
935 cell->SetFlags( CANDIDATE );
936 else
937 cell->ClearFlags( CANDIDATE );
938 }
939
940 auto wasSelected =
941 []( EDA_ITEM* aItem )
942 {
943 return ( aItem->GetFlags() & CANDIDATE ) > 0;
944 };
945
946 while( TOOL_EVENT* evt = Wait() )
947 {
948 if( evt->IsCancelInteractive() || evt->IsActivate() )
949 {
950 cancelled = true;
951 break;
952 }
953 else if( evt->IsDrag( BUT_LEFT ) )
954 {
955 getViewControls()->SetAutoPan( true );
956
957 BOX2I selectionRect( evt->DragOrigin(), evt->Position() - evt->DragOrigin() );
958 selectionRect.Normalize();
959
960 for( PCB_TABLECELL* cell : aTable->GetCells() )
961 {
962 bool doSelect = false;
963
964 if( cell->HitTest( selectionRect, false ) )
965 {
966 if( m_subtractive )
967 doSelect = false;
968 else if( m_exclusive_or )
969 doSelect = !wasSelected( cell );
970 else
971 doSelect = true;
972 }
973 else if( wasSelected( cell ) )
974 {
975 doSelect = m_additive || m_subtractive || m_exclusive_or;
976 }
977
978 if( doSelect && !cell->IsSelected() )
979 select( cell );
980 else if( !doSelect && cell->IsSelected() )
981 unselect( cell );
982 }
983 }
984 else if( evt->IsMouseUp( BUT_LEFT ) )
985 {
986 m_selection.SetIsHover( false );
987
988 bool anyAdded = false;
989 bool anySubtracted = false;
990
991 for( PCB_TABLECELL* cell : aTable->GetCells() )
992 {
993 if( cell->IsSelected() && !wasSelected( cell ) )
994 anyAdded = true;
995 else if( wasSelected( cell ) && !cell->IsSelected() )
996 anySubtracted = true;
997 }
998
999 // Inform other potentially interested tools
1000 if( anyAdded )
1001 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
1002
1003 if( anySubtracted )
1004 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
1005
1006 break; // Stop waiting for events
1007 }
1008 else
1009 {
1010 // Allow some actions for navigation
1011 passEvent( evt, allowedActions );
1012 }
1013 }
1014
1015 getViewControls()->SetAutoPan( false );
1016
1017 m_multiple = false; // Multiple selection mode is inactive
1018
1019 if( !cancelled )
1020 m_selection.ClearReferencePoint();
1021
1022 return cancelled;
1023}
1024
1025
1027{
1028 bool cancelled = false; // Was the tool canceled while it was running?
1029 m_multiple = true; // Multiple selection mode is active
1031
1033 view->Add( &area );
1034
1035 while( TOOL_EVENT* evt = Wait() )
1036 {
1037 /* Selection mode depends on direction of drag-selection:
1038 * Left > Right : Select objects that are fully enclosed by selection
1039 * Right > Left : Select objects that are crossed by selection
1040 */
1041 bool greedySelection = area.GetEnd().x < area.GetOrigin().x;
1042
1043 if( view->IsMirroredX() )
1044 greedySelection = !greedySelection;
1045
1046 m_frame->GetCanvas()->SetCurrentCursor( !greedySelection ? KICURSOR::SELECT_WINDOW
1048
1049 if( evt->IsCancelInteractive() || evt->IsActivate() )
1050 {
1051 cancelled = true;
1052 break;
1053 }
1054
1055 if( evt->IsDrag( BUT_LEFT ) )
1056 {
1058 {
1059 if( m_selection.GetSize() > 0 )
1060 {
1061 ClearSelection( true /*quiet mode*/ );
1062 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
1063 }
1064 }
1065
1066 // Start drawing a selection box
1067 area.SetOrigin( evt->DragOrigin() );
1068 area.SetEnd( evt->Position() );
1071 area.SetExclusiveOr( false );
1073
1074 view->SetVisible( &area, true );
1075 view->Update( &area );
1076 getViewControls()->SetAutoPan( true );
1077 }
1078
1079 if( evt->IsMouseUp( BUT_LEFT ) )
1080 {
1081 getViewControls()->SetAutoPan( false );
1082
1083 // End drawing the selection box
1084 view->SetVisible( &area, false );
1085
1087
1088 break; // Stop waiting for events
1089 }
1090
1091 // Allow some actions for navigation
1092 passEvent( evt, allowedActions );
1093 }
1094
1095 getViewControls()->SetAutoPan( false );
1096
1097 // Stop drawing the selection box
1098 view->Remove( &area );
1099 m_multiple = false; // Multiple selection mode is inactive
1100
1101 if( !cancelled )
1102 m_selection.ClearReferencePoint();
1103
1105
1106 return cancelled;
1107}
1108
1109
1111{
1113 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::SELECT_LASSO );
1114 m_toolMgr->PostAction( ACTIONS::selectionTool );
1115 return 0; // No need to wait for an event, just set the mode
1116}
1117
1118
1120{
1122 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
1123 m_toolMgr->PostAction( ACTIONS::selectionTool );
1124 return 0; // No need to wait for an event, just set the mode
1125}
1126
1127
1129{
1130 bool cancelled = false; // Was the tool canceled while it was running?
1131
1133 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::SELECT_LASSO );
1134
1135
1136 SHAPE_LINE_CHAIN points;
1137 points.SetClosed( true );
1138
1140 getView()->Add( &area );
1141 getView()->SetVisible( &area, true );
1142 getViewControls()->SetAutoPan( true );
1143
1144 while( TOOL_EVENT* evt = Wait() )
1145 {
1146 // Auto mode: clockwise = inside, counterclockwise = touching
1147 double shapeArea = area.GetPoly().Area( false );
1148 bool isClockwise = shapeArea > 0 ? true : false;
1149
1150 if( getView()->IsMirroredX() && shapeArea != 0 )
1151 isClockwise = !isClockwise;
1152
1153 selectionMode = isClockwise ? SELECTION_MODE::INSIDE_LASSO : SELECTION_MODE::TOUCHING_LASSO;
1154
1155 if( evt->IsCancelInteractive() || evt->IsActivate() )
1156 {
1157 cancelled = true;
1158 evt->SetPassEvent( false );
1159 break;
1160 }
1161 else if( evt->IsDrag( BUT_LEFT )
1162 || evt->IsClick( BUT_LEFT )
1163 || evt->IsAction( &ACTIONS::cursorClick ) )
1164 {
1165 points.Append( evt->Position() );
1166 }
1167 else if( evt->IsDblClick( BUT_LEFT )
1168 || evt->IsAction( &ACTIONS::cursorDblClick )
1169 || evt->IsAction( &ACTIONS::finishInteractive ) )
1170 {
1171 area.GetPoly().GenerateBBoxCache();
1173 evt->SetPassEvent( false );
1174 break;
1175 }
1176 else if( evt->IsAction( &PCB_ACTIONS::deleteLastPoint )
1177 || evt->IsAction( &ACTIONS::doDelete )
1178 || evt->IsAction( &ACTIONS::undo ) )
1179 {
1180 if( points.GetPointCount() > 0 )
1181 {
1183 points.Remove( points.GetPointCount() - 1 );
1184 }
1185 }
1186 else
1187 {
1188 // Allow navigation actions
1189 passEvent( evt, allowedActions );
1190 }
1191
1192 if( points.PointCount() > 0 )
1193 {
1195 {
1196 if( m_selection.GetSize() > 0 )
1197 {
1198 ClearSelection( true /*quiet mode*/ );
1199 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
1200 }
1201 }
1202 }
1203
1204 area.SetPoly( points );
1205 area.GetPoly().Append( m_toolMgr->GetMousePosition() );
1206 area.SetAdditive( m_additive );
1208 area.SetExclusiveOr( false );
1209 area.SetMode( selectionMode );
1210 getView()->Update( &area );
1211 }
1212
1213 getViewControls()->SetAutoPan( false );
1214 getView()->SetVisible( &area, false );
1215 getView()->Remove( &area );
1216 m_frame->GetCanvas()->SetCurrentCursor( KICURSOR::ARROW );
1217
1218 if( !cancelled )
1220
1222
1223 return cancelled;
1224}
1225
1226
1228 bool aExclusiveOr )
1229{
1231
1232 bool anyAdded = false;
1233 bool anySubtracted = false;
1234
1235 SELECTION_MODE selectionMode = aArea.GetMode();
1236 bool containedMode = ( selectionMode == SELECTION_MODE::INSIDE_RECTANGLE
1237 || selectionMode == SELECTION_MODE::INSIDE_LASSO ) ? true : false;
1238 bool boxMode = ( selectionMode == SELECTION_MODE::INSIDE_RECTANGLE
1239 || selectionMode == SELECTION_MODE::TOUCHING_RECTANGLE ) ? true : false;
1240
1241 std::vector<KIGFX::VIEW::LAYER_ITEM_PAIR> candidates;
1242 BOX2I selectionBox = aArea.ViewBBox();
1243 view->Query( selectionBox, candidates ); // Get the list of nearby items
1244
1245 GENERAL_COLLECTOR collector;
1246 GENERAL_COLLECTOR padsCollector;
1247 std::set<EDA_ITEM*> group_items;
1248
1249 for( PCB_GROUP* group : board()->Groups() )
1250 {
1251 // The currently entered group does not get limited
1252 if( m_enteredGroup == group )
1253 continue;
1254
1255 std::unordered_set<EDA_ITEM*>& newset = group->GetItems();
1256
1257 auto boxContained =
1258 [&]( const BOX2I& aBox )
1259 {
1260 return boxMode ? selectionBox.Contains( aBox )
1261 : KIGEOM::BoxHitTest( aArea.GetPoly(), aBox, true );
1262 };
1263
1264 // If we are not greedy and have selected the whole group, add just one item
1265 // to allow it to be promoted to the group later
1266 if( containedMode && boxContained( group->GetBoundingBox() ) && newset.size() )
1267 {
1268 for( EDA_ITEM* group_item : newset )
1269 {
1270 if( !group_item->IsBOARD_ITEM() )
1271 continue;
1272
1273 if( Selectable( static_cast<BOARD_ITEM*>( group_item ) ) )
1274 collector.Append( *newset.begin() );
1275 }
1276 }
1277
1278 for( EDA_ITEM* group_item : newset )
1279 group_items.emplace( group_item );
1280 }
1281
1282 auto hitTest =
1283 [&]( const EDA_ITEM* aItem )
1284 {
1285 return boxMode ? aItem->HitTest( selectionBox, containedMode )
1286 : aItem->HitTest( aArea.GetPoly(), containedMode );
1287 };
1288
1289 for( const auto& [item, layer] : candidates )
1290 {
1291 if( !item->IsBOARD_ITEM() )
1292 continue;
1293
1294 BOARD_ITEM* boardItem = static_cast<BOARD_ITEM*>( item );
1295
1296 if( Selectable( boardItem ) && hitTest( boardItem )
1297 && ( !containedMode || !group_items.count( boardItem ) ) )
1298 {
1299 if( boardItem->Type() == PCB_PAD_T && !m_isFootprintEditor )
1300 padsCollector.Append( boardItem );
1301 else
1302 collector.Append( boardItem );
1303 }
1304 }
1305
1306 // Apply the stateful filter
1307 FilterCollectedItems( collector, true, nullptr );
1308
1309 FilterCollectorForHierarchy( collector, true );
1310
1311 // If we selected nothing but pads, allow them to be selected
1312 if( collector.GetCount() == 0 )
1313 {
1314 collector = padsCollector;
1315 FilterCollectedItems( collector, true, nullptr );
1316 FilterCollectorForHierarchy( collector, true );
1317 }
1318
1319 // Sort the filtered selection by rows and columns to have a nice default
1320 // for tools that can use it.
1321 std::sort( collector.begin(), collector.end(),
1322 []( EDA_ITEM* a, EDA_ITEM* b )
1323 {
1324 VECTOR2I aPos = a->GetPosition();
1325 VECTOR2I bPos = b->GetPosition();
1326
1327 if( aPos.y == bPos.y )
1328 return aPos.x < bPos.x;
1329
1330 return aPos.y < bPos.y;
1331 } );
1332
1333 for( EDA_ITEM* i : collector )
1334 {
1335 if( !i->IsBOARD_ITEM() )
1336 continue;
1337
1338 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( i );
1339
1340 if( aSubtractive || ( aExclusiveOr && item->IsSelected() ) )
1341 {
1342 unselect( item );
1343 anySubtracted = true;
1344 }
1345 else
1346 {
1347 select( item );
1348 anyAdded = true;
1349 }
1350 }
1351
1352 m_selection.SetIsHover( false );
1353
1354 // Inform other potentially interested tools
1355 if( anyAdded )
1356 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
1357 else if( anySubtracted )
1358 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
1359}
1360
1361
1363{
1364 wxMouseState keyboardState = wxGetMouseState();
1365
1366 setModifiersState( keyboardState.ShiftDown(), keyboardState.ControlDown(), keyboardState.AltDown() );
1367
1368 m_skip_heuristics = true;
1370 m_skip_heuristics = false;
1371
1372 return 0;
1373}
1374
1375
1376
1378{
1380
1381 selectCursor( false, aClientFilter );
1382
1383 return 0;
1384}
1385
1386
1388{
1390
1391 return 0;
1392}
1393
1394
1396{
1397 GENERAL_COLLECTOR collection;
1398 BOX2I selectionBox;
1399
1400 selectionBox.SetMaximum();
1401
1402 getView()->Query( selectionBox,
1403 [&]( KIGFX::VIEW_ITEM* viewItem ) -> bool
1404 {
1405 if( viewItem->IsBOARD_ITEM() )
1406 {
1407 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( viewItem );
1408
1409 if( item && Selectable( item ) && itemPassesFilter( item, true, nullptr ) )
1410 collection.Append( item );
1411 }
1412
1413 return true;
1414 } );
1415
1416 FilterCollectorForHierarchy( collection, true );
1417
1418 for( EDA_ITEM* item : collection )
1419 select( item );
1420
1421 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
1422
1423 m_frame->GetCanvas()->ForceRefresh();
1424
1425 return 0;
1426}
1427
1428
1430{
1431 BOX2I selectionBox;
1432
1433 selectionBox.SetMaximum();
1434
1435 getView()->Query( selectionBox,
1436 [&]( KIGFX::VIEW_ITEM* viewItem ) -> bool
1437 {
1438 if( viewItem->IsBOARD_ITEM() )
1439 {
1440 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( viewItem );
1441
1442 if( item && Selectable( item ) )
1443 unselect( item );
1444 }
1445
1446 return true;
1447 } );
1448
1449 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
1450
1451 m_frame->GetCanvas()->ForceRefresh();
1452
1453 return 0;
1454}
1455
1456
1458{
1459 // Narrow the collection down to a single BOARD_CONNECTED_ITEM for each represented net.
1460 // All other items types are removed.
1461 std::set<int> representedNets;
1462
1463 for( int i = aCollector.GetCount() - 1; i >= 0; i-- )
1464 {
1465 BOARD_CONNECTED_ITEM* item = dynamic_cast<BOARD_CONNECTED_ITEM*>( aCollector[i] );
1466
1467 if( !item )
1468 aCollector.Remove( i );
1469 else if ( representedNets.count( item->GetNetCode() ) )
1470 aCollector.Remove( i );
1471 else
1472 representedNets.insert( item->GetNetCode() );
1473 }
1474}
1475
1476
1478{
1479 std::deque<EDA_ITEM*> selectedItems = m_selection.GetItems();
1480
1481 // Get all footprints and pads
1482 std::vector<BOARD_CONNECTED_ITEM*> toUnroute;
1483
1484 for( EDA_ITEM* item : selectedItems )
1485 {
1486 if( item->Type() == PCB_FOOTPRINT_T )
1487 {
1488 for( PAD* pad : static_cast<FOOTPRINT*>( item )->Pads() )
1489 toUnroute.push_back( pad );
1490 }
1491 else if( BOARD_CONNECTED_ITEM::ClassOf( item ) )
1492 {
1493 toUnroute.push_back( static_cast<BOARD_CONNECTED_ITEM*>( item ) );
1494 }
1495 }
1496
1497 // Clear selection so we don't delete our footprints/pads
1498 ClearSelection( true );
1499
1500 // Get the tracks on our list of pads, then delete them
1502 m_toolMgr->RunAction( ACTIONS::doDelete );
1503
1504 // Reselect our footprint/pads as they were in our original selection
1505 for( EDA_ITEM* item : selectedItems )
1506 {
1507 if( item->Type() == PCB_FOOTPRINT_T || item->Type() == PCB_PAD_T )
1508 select( item );
1509 }
1510
1511 return 0;
1512}
1513
1514
1516{
1517 std::deque<EDA_ITEM*> selectedItems = m_selection.GetItems();
1518
1519 // Get all footprints and pads
1520 std::vector<BOARD_CONNECTED_ITEM*> toUnroute;
1521
1522 for( EDA_ITEM* item : selectedItems )
1523 {
1524 if( item->Type() == PCB_TRACE_T || item->Type() == PCB_ARC_T || item->Type() == PCB_VIA_T )
1525 toUnroute.push_back( static_cast<BOARD_CONNECTED_ITEM*>( item ) );
1526 }
1527
1528 // Get the tracks connecting to our starting objects
1531 std::deque<EDA_ITEM*> toSelectAfter;
1532 // This will select the unroute items too, so filter them out
1533 for( EDA_ITEM* item : m_selection.GetItemsSortedByTypeAndXY() )
1534 {
1535 if( !item->IsBOARD_ITEM() )
1536 continue;
1537
1538 if( std::find( toUnroute.begin(), toUnroute.end(), item ) == toUnroute.end() )
1539 toSelectAfter.push_back( item );
1540 }
1541
1542 ClearSelection( true );
1543
1544 for( EDA_ITEM* item : toUnroute )
1545 select( item );
1546
1547 m_toolMgr->RunAction( ACTIONS::doDelete );
1548
1549 // Now our after tracks so the user can continue backing up as desired
1550 ClearSelection( true );
1551
1552 for( EDA_ITEM* item : toSelectAfter )
1553 select( item );
1554
1555 return 0;
1556}
1557
1558
1560{
1561 // expandConnection will get called no matter whether the user selected a connected item or a
1562 // non-connected shape (graphic on a non-copper layer). The algorithm for expanding to connected
1563 // items is different from graphics, so they need to be handled separately.
1564 unsigned initialCount = 0;
1565
1566 for( const EDA_ITEM* item : m_selection.GetItems() )
1567 {
1568 if( item->Type() == PCB_FOOTPRINT_T
1569 || item->Type() == PCB_GENERATOR_T
1570 || ( static_cast<const BOARD_ITEM*>( item )->IsConnected() ) )
1571 {
1572 initialCount++;
1573 }
1574 }
1575
1576 if( initialCount == 0 )
1577 {
1578 // First, process any graphic shapes we have
1579 std::vector<PCB_SHAPE*> startShapes;
1580
1581 for( EDA_ITEM* item : m_selection.GetItems() )
1582 {
1583 if( isExpandableGraphicShape( item ) )
1584 startShapes.push_back( static_cast<PCB_SHAPE*>( item ) );
1585 }
1586
1587 // If no non-copper shapes; fall back to looking for connected items
1588 if( !startShapes.empty() )
1589 selectAllConnectedShapes( startShapes );
1590 else
1592 }
1593
1594 m_frame->SetStatusText( _( "Select/Expand Connection..." ) );
1595
1596 for( STOP_CONDITION stopCondition : { STOP_AT_JUNCTION, STOP_AT_PAD, STOP_NEVER } )
1597 {
1598 std::deque<EDA_ITEM*> selectedItems = m_selection.GetItems();
1599
1600 for( EDA_ITEM* item : selectedItems )
1601 item->ClearTempFlags();
1602
1603 std::vector<BOARD_CONNECTED_ITEM*> startItems;
1604
1605 for( EDA_ITEM* item : selectedItems )
1606 {
1607 if( item->Type() == PCB_FOOTPRINT_T )
1608 {
1609 FOOTPRINT* footprint = static_cast<FOOTPRINT*>( item );
1610
1611 for( PAD* pad : footprint->Pads() )
1612 startItems.push_back( pad );
1613 }
1614 else if( item->Type() == PCB_GENERATOR_T )
1615 {
1616 for( BOARD_ITEM* generatedItem : static_cast<PCB_GENERATOR*>( item )->GetBoardItems() )
1617 {
1618 if( BOARD_CONNECTED_ITEM::ClassOf( generatedItem ) )
1619 startItems.push_back( static_cast<BOARD_CONNECTED_ITEM*>( generatedItem ) );
1620 }
1621 }
1622 else if( BOARD_CONNECTED_ITEM::ClassOf( item ) )
1623 {
1624 startItems.push_back( static_cast<BOARD_CONNECTED_ITEM*>( item ) );
1625 }
1626 }
1627
1628 selectAllConnectedTracks( startItems, stopCondition );
1629
1630 if( m_selection.GetItems().size() > initialCount )
1631 break;
1632 }
1633
1634 m_frame->SetStatusText( wxEmptyString );
1635
1636 // Inform other potentially interested tools
1637 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
1638
1639 return 0;
1640}
1641
1642
1643void PCB_SELECTION_TOOL::selectAllConnectedTracks( const std::vector<BOARD_CONNECTED_ITEM*>& aStartItems,
1644 STOP_CONDITION aStopCondition )
1645{
1646 PROF_TIMER refreshTimer;
1647 double refreshIntervalMs = 500; // Refresh display with this interval to indicate progress
1648 int lastSelectionSize = (int) m_selection.GetSize();
1649
1650 auto connectivity = board()->GetConnectivity();
1651
1652 std::set<PAD*> startPadSet;
1653 std::vector<BOARD_CONNECTED_ITEM*> cleanupItems;
1654
1655 for( BOARD_CONNECTED_ITEM* startItem : aStartItems )
1656 {
1657 // Register starting pads
1658 if( startItem->Type() == PCB_PAD_T )
1659 startPadSet.insert( static_cast<PAD*>( startItem ) );
1660
1661 // Select any starting track items
1662 if( startItem->IsType( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T } ) )
1663 {
1664 if( itemPassesFilter( startItem, true ) )
1665 select( startItem );
1666 }
1667 }
1668
1669 for( BOARD_CONNECTED_ITEM* startItem : aStartItems )
1670 {
1671 std::map<VECTOR2I, std::vector<PCB_TRACK*>> trackMap;
1672 std::map<VECTOR2I, PCB_VIA*> viaMap;
1673 std::map<VECTOR2I, PAD*> padMap;
1674 std::map<VECTOR2I, std::vector<PCB_SHAPE*>> shapeMap;
1675 std::vector<std::pair<VECTOR2I, LSET>> activePts;
1676
1677 if( startItem->HasFlag( SKIP_STRUCT ) ) // Skip already visited items
1678 continue;
1679
1680 auto connectedItems = connectivity->GetConnectedItems( startItem, EXCLUDE_ZONES | IGNORE_NETS );
1681
1682 // Build maps of connected items
1683 for( BOARD_CONNECTED_ITEM* item : connectedItems )
1684 {
1685 switch( item->Type() )
1686 {
1687 case PCB_ARC_T:
1688 case PCB_TRACE_T:
1689 {
1690 PCB_TRACK* track = static_cast<PCB_TRACK*>( item );
1691 trackMap[track->GetStart()].push_back( track );
1692 trackMap[track->GetEnd()].push_back( track );
1693 break;
1694 }
1695
1696 case PCB_VIA_T:
1697 {
1698 PCB_VIA* via = static_cast<PCB_VIA*>( item );
1699 viaMap[via->GetStart()] = via;
1700 break;
1701 }
1702
1703 case PCB_PAD_T:
1704 {
1705 PAD* pad = static_cast<PAD*>( item );
1706 padMap[pad->GetPosition()] = pad;
1707 break;
1708 }
1709
1710 case PCB_SHAPE_T:
1711 {
1712 PCB_SHAPE* shape = static_cast<PCB_SHAPE*>( item );
1713
1714 for( const auto& point : shape->GetConnectionPoints() )
1715 shapeMap[point].push_back( shape );
1716
1717 break;
1718 }
1719
1720 default:
1721 break;
1722 }
1723 }
1724
1725 // Set up the initial active points
1726 switch( startItem->Type() )
1727 {
1728 case PCB_ARC_T:
1729 case PCB_TRACE_T:
1730 {
1731 PCB_TRACK* track = static_cast<PCB_TRACK*>( startItem );
1732
1733 activePts.push_back( { track->GetStart(), track->GetLayerSet() } );
1734 activePts.push_back( { track->GetEnd(), track->GetLayerSet() } );
1735 break;
1736 }
1737
1738 case PCB_VIA_T:
1739 activePts.push_back( { startItem->GetPosition(), startItem->GetLayerSet() } );
1740 break;
1741
1742 case PCB_PAD_T:
1743 activePts.push_back( { startItem->GetPosition(), startItem->GetLayerSet() } );
1744 break;
1745
1746 case PCB_SHAPE_T:
1747 {
1748 PCB_SHAPE* shape = static_cast<PCB_SHAPE*>( startItem );
1749
1750 for( const auto& point : shape->GetConnectionPoints() )
1751 activePts.push_back( { point, startItem->GetLayerSet() } );
1752
1753 break;
1754 }
1755
1756 default:
1757 break;
1758 }
1759
1760 bool expand = true;
1761 int failSafe = 0;
1762
1763 // Iterative push from all active points
1764 while( expand && failSafe++ < 100000 )
1765 {
1766 expand = false;
1767
1768 for( int i = (int) activePts.size() - 1; i >= 0; --i )
1769 {
1770 VECTOR2I pt = activePts[i].first;
1771 LSET layerSetCu = activePts[i].second & LSET::AllCuMask();
1772
1773 auto viaIt = viaMap.find( pt );
1774 auto padIt = padMap.find( pt );
1775
1776 bool gotVia = viaIt != viaMap.end() && ( viaIt->second->GetLayerSet() & layerSetCu ).any();
1777 bool gotPad = padIt != padMap.end() && ( padIt->second->GetLayerSet() & layerSetCu ).any();
1778 bool gotNonStartPad = gotPad && ( startPadSet.find( padIt->second ) == startPadSet.end() );
1779
1780 if( gotPad && !itemPassesFilter( padIt->second, true ) )
1781 {
1782 activePts.erase( activePts.begin() + i );
1783 continue;
1784 }
1785
1786 if( gotVia && !itemPassesFilter( viaIt->second, true ) )
1787 {
1788 activePts.erase( activePts.begin() + i );
1789 continue;
1790 }
1791
1792 if( aStopCondition == STOP_AT_JUNCTION )
1793 {
1794 size_t pt_count = 0;
1795
1796 for( PCB_TRACK* track : trackMap[pt] )
1797 {
1798 if( track->GetStart() != track->GetEnd() && layerSetCu.Contains( track->GetLayer() ) )
1799 pt_count++;
1800 }
1801
1802 if( pt_count > 2 || gotVia || gotNonStartPad )
1803 {
1804 activePts.erase( activePts.begin() + i );
1805 continue;
1806 }
1807 }
1808 else if( aStopCondition == STOP_AT_PAD )
1809 {
1810 if( gotNonStartPad )
1811 {
1812 activePts.erase( activePts.begin() + i );
1813 continue;
1814 }
1815 }
1816
1817 if( gotPad )
1818 {
1819 PAD* pad = padIt->second;
1820
1821 if( !pad->HasFlag( SKIP_STRUCT ) )
1822 {
1823 pad->SetFlags( SKIP_STRUCT );
1824 cleanupItems.push_back( pad );
1825
1826 activePts.push_back( { pad->GetPosition(), pad->GetLayerSet() } );
1827 expand = true;
1828 }
1829 }
1830
1831 for( PCB_TRACK* track : trackMap[pt] )
1832 {
1833 if( !layerSetCu.Contains( track->GetLayer() ) )
1834 continue;
1835
1836 if( !itemPassesFilter( track, true ) )
1837 continue;
1838
1839 if( !track->IsSelected() )
1840 select( track );
1841
1842 if( !track->HasFlag( SKIP_STRUCT ) )
1843 {
1844 track->SetFlags( SKIP_STRUCT );
1845 cleanupItems.push_back( track );
1846
1847 if( track->GetStart() == pt )
1848 activePts.push_back( { track->GetEnd(), track->GetLayerSet() } );
1849 else
1850 activePts.push_back( { track->GetStart(), track->GetLayerSet() } );
1851
1852 if( aStopCondition != STOP_AT_SEGMENT )
1853 expand = true;
1854 }
1855 }
1856
1857 for( PCB_SHAPE* shape : shapeMap[pt] )
1858 {
1859 if( !layerSetCu.Contains( shape->GetLayer() ) )
1860 continue;
1861
1862 if( !itemPassesFilter( shape, true ) )
1863 continue;
1864
1865 if( !shape->IsSelected() )
1866 select( shape );
1867
1868 if( !shape->HasFlag( SKIP_STRUCT ) )
1869 {
1870 shape->SetFlags( SKIP_STRUCT );
1871 cleanupItems.push_back( shape );
1872
1873 for( const VECTOR2I& newPoint : shape->GetConnectionPoints() )
1874 {
1875 if( newPoint == pt )
1876 continue;
1877
1878 activePts.push_back( { newPoint, shape->GetLayerSet() } );
1879 }
1880
1881 if( aStopCondition != STOP_AT_SEGMENT )
1882 expand = true;
1883 }
1884 }
1885
1886 if( viaMap.count( pt ) )
1887 {
1888 PCB_VIA* via = viaMap[pt];
1889
1890 if( !itemPassesFilter( via, true ) )
1891 {
1892 activePts.erase( activePts.begin() + i );
1893 continue;
1894 }
1895
1896 if( !via->IsSelected() )
1897 select( via );
1898
1899 if( !via->HasFlag( SKIP_STRUCT ) )
1900 {
1901 via->SetFlags( SKIP_STRUCT );
1902 cleanupItems.push_back( via );
1903
1904 activePts.push_back( { via->GetPosition(), via->GetLayerSet() } );
1905
1906 if( aStopCondition != STOP_AT_SEGMENT )
1907 expand = true;
1908 }
1909 }
1910
1911 activePts.erase( activePts.begin() + i );
1912 }
1913
1914 // Refresh display for the feel of progress
1915 if( refreshTimer.msecs() >= refreshIntervalMs )
1916 {
1917 if( m_selection.Size() != lastSelectionSize )
1918 {
1919 m_frame->GetCanvas()->ForceRefresh();
1920 lastSelectionSize = m_selection.Size();
1921 }
1922
1923 refreshTimer.Start();
1924 }
1925 }
1926 }
1927
1928 std::set<EDA_ITEM*> toDeselect;
1929 std::set<EDA_ITEM*> toSelect;
1930
1931 // Promote generated members to their PCB_GENERATOR parents
1932 for( EDA_ITEM* item : m_selection )
1933 {
1934 if( !item->IsBOARD_ITEM() )
1935 continue;
1936
1937 BOARD_ITEM* boardItem = static_cast<BOARD_ITEM*>( item );
1938 EDA_GROUP* parent = boardItem->GetParentGroup();
1939
1940 if( parent && parent->AsEdaItem()->Type() == PCB_GENERATOR_T )
1941 {
1942 toDeselect.insert( item );
1943
1944 if( !parent->AsEdaItem()->IsSelected() )
1945 toSelect.insert( parent->AsEdaItem() );
1946 }
1947 }
1948
1949 for( EDA_ITEM* item : toDeselect )
1950 unselect( item );
1951
1952 for( EDA_ITEM* item : toSelect )
1953 select( item );
1954
1955 for( BOARD_CONNECTED_ITEM* item : cleanupItems )
1956 item->ClearFlags( SKIP_STRUCT );
1957}
1958
1959
1961{
1962 if( aItem->Type() == PCB_SHAPE_T )
1963 {
1964 const PCB_SHAPE* shape = static_cast<const PCB_SHAPE*>( aItem );
1965
1966 switch( shape->GetShape() )
1967 {
1968 case SHAPE_T::SEGMENT:
1969 case SHAPE_T::ARC:
1970 case SHAPE_T::BEZIER:
1971 return !shape->IsOnCopperLayer();
1972
1973 case SHAPE_T::POLY:
1974 return !shape->IsOnCopperLayer() && !shape->IsClosed();
1975
1976 default:
1977 return false;
1978 }
1979 }
1980
1981 return false;
1982}
1983
1984
1985void PCB_SELECTION_TOOL::selectAllConnectedShapes( const std::vector<PCB_SHAPE*>& aStartItems )
1986{
1987 std::stack<PCB_SHAPE*> toSearch;
1988 std::set<PCB_SHAPE*> toCleanup;
1989
1990 for( PCB_SHAPE* startItem : aStartItems )
1991 toSearch.push( startItem );
1992
1993 GENERAL_COLLECTOR collector;
1995
1996 auto searchPoint =
1997 [&]( const VECTOR2I& aWhere )
1998 {
1999 collector.Collect( board(), { PCB_SHAPE_T }, aWhere, guide );
2000
2001 for( EDA_ITEM* item : collector )
2002 {
2003 if( isExpandableGraphicShape( item ) )
2004 toSearch.push( static_cast<PCB_SHAPE*>( item ) );
2005 }
2006 };
2007
2008 while( !toSearch.empty() )
2009 {
2010 PCB_SHAPE* shape = toSearch.top();
2011 toSearch.pop();
2012
2013 if( shape->HasFlag( SKIP_STRUCT ) )
2014 continue;
2015
2016 select( shape );
2017 shape->SetFlags( SKIP_STRUCT );
2018 toCleanup.insert( shape );
2019
2020 guide.SetLayerVisibleBits( shape->GetLayerSet() );
2021
2022 searchPoint( shape->GetStart() );
2023 searchPoint( shape->GetEnd() );
2024 }
2025
2026 for( PCB_SHAPE* shape : toCleanup )
2027 shape->ClearFlags( SKIP_STRUCT );
2028}
2029
2030
2032{
2033 // Get all pads
2034 std::vector<PAD*> pads;
2035
2036 for( EDA_ITEM* item : m_selection.GetItems() )
2037 {
2038 if( item->Type() == PCB_FOOTPRINT_T )
2039 {
2040 for( PAD* pad : static_cast<FOOTPRINT*>( item )->Pads() )
2041 pads.push_back( pad );
2042 }
2043 else if( item->Type() == PCB_PAD_T )
2044 {
2045 pads.push_back( static_cast<PAD*>( item ) );
2046 }
2047 }
2048
2049 // Select every footprint on the end of the ratsnest for each pad in our selection
2050 std::shared_ptr<CONNECTIVITY_DATA> conn = board()->GetConnectivity();
2051
2052 for( PAD* pad : pads )
2053 {
2054 for( const CN_EDGE& edge : conn->GetRatsnestForPad( pad ) )
2055 {
2056 wxCHECK2( edge.GetSourceNode() && !edge.GetSourceNode()->Dirty(), continue );
2057 wxCHECK2( edge.GetTargetNode() && !edge.GetTargetNode()->Dirty(), continue );
2058
2059 BOARD_CONNECTED_ITEM* sourceParent = edge.GetSourceNode()->Parent();
2060 BOARD_CONNECTED_ITEM* targetParent = edge.GetTargetNode()->Parent();
2061
2062 if( sourceParent == pad )
2063 {
2064 if( targetParent->Type() == PCB_PAD_T )
2065 select( static_cast<PAD*>( targetParent )->GetParent() );
2066 }
2067 else if( targetParent == pad )
2068 {
2069 if( sourceParent->Type() == PCB_PAD_T )
2070 select( static_cast<PAD*>( sourceParent )->GetParent() );
2071 }
2072 }
2073 }
2074
2075 return 0;
2076}
2077
2078
2080{
2081 PCB_SELECTION originalSelection = m_selection;
2082
2083 // Get all pads
2084 std::vector<PAD*> pads;
2085
2086 for( EDA_ITEM* item : m_selection.GetItems() )
2087 {
2088 if( item->Type() == PCB_FOOTPRINT_T )
2089 {
2090 for( PAD* pad : static_cast<FOOTPRINT*>( item )->Pads() )
2091 pads.push_back( pad );
2092 }
2093 else if( item->Type() == PCB_PAD_T )
2094 {
2095 pads.push_back( static_cast<PAD*>( item ) );
2096 }
2097 }
2098
2100
2101 // Select every footprint on the end of the ratsnest for each pad in our selection
2102 std::shared_ptr<CONNECTIVITY_DATA> conn = board()->GetConnectivity();
2103
2104 for( PAD* pad : pads )
2105 {
2106 const std::vector<CN_EDGE> edges = conn->GetRatsnestForPad( pad );
2107
2108 // Need to have something unconnected to grab
2109 if( edges.size() == 0 )
2110 continue;
2111
2112 double currentDistance = DBL_MAX;
2113 FOOTPRINT* nearest = nullptr;
2114
2115 // Check every ratsnest line for the nearest one
2116 for( const CN_EDGE& edge : edges )
2117 {
2118 if( edge.GetSourceNode()->Parent()->GetParentFootprint()
2119 == edge.GetTargetNode()->Parent()->GetParentFootprint() )
2120 {
2121 continue; // This edge is a loop on the same footprint
2122 }
2123
2124 // Figure out if we are the source or the target node on the ratnest
2125 const CN_ANCHOR* other = edge.GetSourceNode()->Parent() == pad ? edge.GetTargetNode().get()
2126 : edge.GetSourceNode().get();
2127
2128 wxCHECK2( other && !other->Dirty(), continue );
2129
2130 // We only want to grab footprints, so the ratnest has to point to a pad
2131 if( other->Parent()->Type() != PCB_PAD_T )
2132 continue;
2133
2134 if( edge.GetLength() < currentDistance )
2135 {
2136 currentDistance = edge.GetLength();
2137 nearest = other->Parent()->GetParentFootprint();
2138 }
2139 }
2140
2141 if( nearest != nullptr )
2142 select( nearest );
2143 }
2144
2146
2147 return 0;
2148}
2149
2150
2151void PCB_SELECTION_TOOL::SelectAllItemsOnNet( int aNetCode, bool aSelect )
2152{
2153 std::shared_ptr<CONNECTIVITY_DATA> conn = board()->GetConnectivity();
2154
2155 for( BOARD_ITEM* item : conn->GetNetItems( aNetCode, { PCB_TRACE_T,
2156 PCB_ARC_T,
2157 PCB_VIA_T,
2158 PCB_SHAPE_T } ) )
2159 {
2160 if( itemPassesFilter( item, true, nullptr ) )
2161 aSelect ? select( item ) : unselect( item );
2162 }
2163}
2164
2165
2167{
2168 bool select = aEvent.IsAction( &PCB_ACTIONS::selectNet );
2169
2170 // If we've been passed an argument, just select that netcode1
2171 int netcode = aEvent.Parameter<int>();
2172
2173 if( netcode > 0 )
2174 {
2175 SelectAllItemsOnNet( netcode, select );
2176
2177 // Inform other potentially interested tools
2178 if( m_selection.Size() > 0 )
2179 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2180 else
2181 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
2182
2183 return 0;
2184 }
2185
2186 if( !selectCursor() )
2187 return 0;
2188
2189 // copy the selection, since we're going to iterate and modify
2190 auto selection = m_selection.GetItems();
2191
2192 for( EDA_ITEM* i : selection )
2193 {
2194 BOARD_CONNECTED_ITEM* connItem = dynamic_cast<BOARD_CONNECTED_ITEM*>( i );
2195
2196 if( connItem )
2197 SelectAllItemsOnNet( connItem->GetNetCode(), select );
2198 }
2199
2200 // Inform other potentially interested tools
2201 if( m_selection.Size() > 0 )
2202 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2203 else
2204 m_toolMgr->ProcessEvent( EVENTS::UnselectedEvent );
2205
2206 return 0;
2207}
2208
2209
2211{
2212 std::vector<BOARD_ITEM*> footprints;
2213
2214 // store all footprints that are on that sheet path
2215 for( FOOTPRINT* footprint : board()->Footprints() )
2216 {
2217 if( footprint == nullptr )
2218 continue;
2219
2220 wxString footprint_path = footprint->GetPath().AsString().BeforeLast( '/' );
2221
2222 if( footprint_path.IsEmpty() )
2223 footprint_path += '/';
2224
2225 if( footprint_path == aSheetPath )
2226 footprints.push_back( footprint );
2227 }
2228
2229 for( BOARD_ITEM* i : footprints )
2230 {
2231 if( i != nullptr )
2232 select( i );
2233 }
2234
2235 selectConnections( footprints );
2236}
2237
2238
2239void PCB_SELECTION_TOOL::selectConnections( const std::vector<BOARD_ITEM*>& aItems )
2240{
2241 // Generate a list of all pads, and of all nets they belong to.
2242 std::list<int> netcodeList;
2243 std::vector<BOARD_CONNECTED_ITEM*> padList;
2244
2245 for( BOARD_ITEM* item : aItems )
2246 {
2247 switch( item->Type() )
2248 {
2249 case PCB_FOOTPRINT_T:
2250 {
2251 for( PAD* pad : static_cast<FOOTPRINT*>( item )->Pads() )
2252 {
2253 if( pad->IsConnected() )
2254 {
2255 netcodeList.push_back( pad->GetNetCode() );
2256 padList.push_back( pad );
2257 }
2258 }
2259
2260 break;
2261 }
2262
2263 case PCB_PAD_T:
2264 {
2265 PAD* pad = static_cast<PAD*>( item );
2266
2267 if( pad->IsConnected() )
2268 {
2269 netcodeList.push_back( pad->GetNetCode() );
2270 padList.push_back( pad );
2271 }
2272
2273 break;
2274 }
2275
2276 default:
2277 break;
2278 }
2279 }
2280
2281 // Sort for binary search
2282 std::sort( padList.begin(), padList.end() );
2283
2284 // remove all duplicates
2285 netcodeList.sort();
2286 netcodeList.unique();
2287
2289
2290 // now we need to find all footprints that are connected to each of these nets then we need
2291 // to determine if these footprints are in the list of footprints
2292 std::vector<int> removeCodeList;
2293 std::shared_ptr<CONNECTIVITY_DATA> conn = board()->GetConnectivity();
2294
2295 for( int netCode : netcodeList )
2296 {
2297 for( BOARD_CONNECTED_ITEM* pad : conn->GetNetItems( netCode, { PCB_PAD_T } ) )
2298 {
2299 if( !std::binary_search( padList.begin(), padList.end(), pad ) )
2300 {
2301 // if we cannot find the pad in the padList then we can assume that that pad
2302 // should not be used, therefore invalidate this netcode.
2303 removeCodeList.push_back( netCode );
2304 break;
2305 }
2306 }
2307 }
2308
2309 for( int removeCode : removeCodeList )
2310 netcodeList.remove( removeCode );
2311
2312 std::unordered_set<BOARD_ITEM*> localConnectionList;
2313
2314 for( int netCode : netcodeList )
2315 {
2316 for( BOARD_ITEM* item : conn->GetNetItems( netCode, { PCB_TRACE_T,
2317 PCB_ARC_T,
2318 PCB_VIA_T,
2319 PCB_SHAPE_T } ) )
2320 {
2321 localConnectionList.insert( item );
2322 }
2323 }
2324
2325 for( BOARD_ITEM* item : localConnectionList )
2326 select( item );
2327}
2328
2329
2331{
2332 std::vector<BOARD_ITEM*>* items = aEvent.Parameter<std::vector<BOARD_ITEM*>*>();
2333
2334 if( items )
2335 doSyncSelection( *items, false );
2336
2337 return 0;
2338}
2339
2340
2342{
2343 std::vector<BOARD_ITEM*>* items = aEvent.Parameter<std::vector<BOARD_ITEM*>*>();
2344
2345 if( items )
2346 doSyncSelection( *items, true );
2347
2348 return 0;
2349}
2350
2351
2352void PCB_SELECTION_TOOL::doSyncSelection( const std::vector<BOARD_ITEM*>& aItems, bool aWithNets )
2353{
2354 if( m_selection.Front() && m_selection.Front()->IsMoving() )
2355 return;
2356
2357 ClearSelection( true /*quiet mode*/ );
2358
2359 // Perform individual selection of each item before processing the event.
2360 for( BOARD_ITEM* item : aItems )
2361 select( item );
2362
2363 if( aWithNets )
2364 selectConnections( aItems );
2365
2366 BOX2I bbox = m_selection.GetBoundingBox();
2367
2368 if( bbox.GetWidth() != 0 && bbox.GetHeight() != 0 )
2369 {
2370 if( m_frame->GetPcbNewSettings()->m_CrossProbing.center_on_items )
2371 {
2372 if( m_frame->GetPcbNewSettings()->m_CrossProbing.zoom_to_fit )
2373 ZoomFitCrossProbeBBox( bbox );
2374
2375 m_frame->FocusOnLocation( bbox.Centre() );
2376 }
2377 }
2378
2380
2381 m_frame->GetCanvas()->ForceRefresh();
2382
2383 if( m_selection.Size() > 0 )
2384 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2385}
2386
2387
2389{
2390 ClearSelection( true /*quiet mode*/ );
2391 wxString sheetPath = *aEvent.Parameter<wxString*>();
2392
2393 selectAllItemsOnSheet( sheetPath );
2394
2396
2397 if( m_selection.Size() > 0 )
2398 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2399
2400 return 0;
2401}
2402
2403
2405{
2406 // this function currently only supports footprints since they are only on one sheet.
2407 EDA_ITEM* item = m_selection.Front();
2408
2409 if( !item )
2410 return 0;
2411
2412 if( item->Type() != PCB_FOOTPRINT_T )
2413 return 0;
2414
2415 FOOTPRINT* footprint = dynamic_cast<FOOTPRINT*>( item );
2416
2417 if( !footprint || footprint->GetPath().empty() )
2418 return 0;
2419
2420 ClearSelection( true /*quiet mode*/ );
2421
2422 // get the sheet path only.
2423 wxString sheetPath = footprint->GetPath().AsString().BeforeLast( '/' );
2424
2425 if( sheetPath.IsEmpty() )
2426 sheetPath += '/';
2427
2428 selectAllItemsOnSheet( sheetPath );
2429
2430 // Inform other potentially interested tools
2431 if( m_selection.Size() > 0 )
2432 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2433
2434 return 0;
2435}
2436
2437
2439{
2440 // Should recalculate the view to zoom in on the selection.
2441 BOX2I selectionBox = m_selection.GetBoundingBox();
2443
2444 VECTOR2D screenSize = view->ToWorld( ToVECTOR2D( m_frame->GetCanvas()->GetClientSize() ),
2445 false );
2446 screenSize.x = std::max( 10.0, screenSize.x );
2447 screenSize.y = std::max( 10.0, screenSize.y );
2448
2449 if( selectionBox.GetWidth() != 0 || selectionBox.GetHeight() != 0 )
2450 {
2451 VECTOR2D vsize = selectionBox.GetSize();
2452 double scale = view->GetScale() / std::max( fabs( vsize.x / screenSize.x ),
2453 fabs( vsize.y / screenSize.y ) );
2454 view->SetScale( scale );
2455 view->SetCenter( selectionBox.Centre() );
2456 view->Add( &m_selection );
2457 }
2458
2459 m_frame->GetCanvas()->ForceRefresh();
2460}
2461
2462
2464{
2465 // Should recalculate the view to zoom in on the bbox.
2467
2468 if( aBBox.GetWidth() == 0 )
2469 return;
2470
2471 BOX2I bbox = aBBox;
2472 bbox.Normalize();
2473
2474 //#define DEFAULT_PCBNEW_CODE // Un-comment for normal full zoom KiCad algorithm
2475#ifdef DEFAULT_PCBNEW_CODE
2476 auto bbSize = bbox.Inflate( bbox.GetWidth() * 0.2f ).GetSize();
2477 auto screenSize = view->ToWorld( GetCanvas()->GetClientSize(), false );
2478
2479 // The "fabs" on x ensures the right answer when the view is flipped
2480 screenSize.x = std::max( 10.0, fabs( screenSize.x ) );
2481 screenSize.y = std::max( 10.0, screenSize.y );
2482 double ratio = std::max( fabs( bbSize.x / screenSize.x ), fabs( bbSize.y / screenSize.y ) );
2483
2484 // Try not to zoom on every cross-probe; it gets very noisy
2485 if( crossProbingSettings.zoom_to_fit && ( ratio < 0.5 || ratio > 1.0 ) )
2486 view->SetScale( view->GetScale() / ratio );
2487#endif // DEFAULT_PCBNEW_CODE
2488
2489#ifndef DEFAULT_PCBNEW_CODE // Do the scaled zoom
2490 auto bbSize = bbox.Inflate( KiROUND( bbox.GetWidth() * 0.2 ) ).GetSize();
2491 VECTOR2D screenSize = view->ToWorld( ToVECTOR2D( m_frame->GetCanvas()->GetClientSize() ), false );
2492
2493 // This code tries to come up with a zoom factor that doesn't simply zoom in
2494 // to the cross probed component, but instead shows a reasonable amount of the
2495 // circuit around it to provide context. This reduces or eliminates the need
2496 // to manually change the zoom because it's too close.
2497
2498 // Using the default text height as a constant to compare against, use the
2499 // height of the bounding box of visible items for a footprint to figure out
2500 // if this is a big footprint (like a processor) or a small footprint (like a resistor).
2501 // This ratio is not useful by itself as a scaling factor. It must be "bent" to
2502 // provide good scaling at varying component sizes. Bigger components need less
2503 // scaling than small ones.
2504 double currTextHeight = pcbIUScale.mmToIU( DEFAULT_TEXT_SIZE );
2505
2506 double compRatio = bbSize.y / currTextHeight; // Ratio of component to text height
2507
2508 // This will end up as the scaling factor we apply to "ratio".
2509 double compRatioBent = 1.0;
2510
2511 // This is similar to the original KiCad code that scaled the zoom to make sure
2512 // components were visible on screen. It's simply a ratio of screen size to
2513 // component size, and its job is to zoom in to make the component fullscreen.
2514 // Earlier in the code the component BBox is given a 20% margin to add some
2515 // breathing room. We compare the height of this enlarged component bbox to the
2516 // default text height. If a component will end up with the sides clipped, we
2517 // adjust later to make sure it fits on screen.
2518 //
2519 // The "fabs" on x ensures the right answer when the view is flipped
2520 screenSize.x = std::max( 10.0, fabs( screenSize.x ) );
2521 screenSize.y = std::max( 10.0, screenSize.y );
2522 double ratio = std::max( -1.0, fabs( bbSize.y / screenSize.y ) );
2523
2524 // Original KiCad code for how much to scale the zoom
2525 double kicadRatio = std::max( fabs( bbSize.x / screenSize.x ),
2526 fabs( bbSize.y / screenSize.y ) );
2527
2528 // LUT to scale zoom ratio to provide reasonable schematic context. Must work
2529 // with footprints of varying sizes (e.g. 0402 package and 200 pin BGA).
2530 // "first" is used as the input and "second" as the output
2531 //
2532 // "first" = compRatio (footprint height / default text height)
2533 // "second" = Amount to scale ratio by
2534 std::vector<std::pair<double, double>> lut {
2535 { 1, 8 },
2536 { 1.5, 5 },
2537 { 3, 3 },
2538 { 4.5, 2.5 },
2539 { 8, 2.0 },
2540 { 12, 1.7 },
2541 { 16, 1.5 },
2542 { 24, 1.3 },
2543 { 32, 1.0 },
2544 };
2545
2546
2547 std::vector<std::pair<double, double>>::iterator it;
2548
2549 compRatioBent = lut.back().second; // Large component default
2550
2551 if( compRatio >= lut.front().first )
2552 {
2553 // Use LUT to do linear interpolation of "compRatio" within "first", then
2554 // use that result to linearly interpolate "second" which gives the scaling
2555 // factor needed.
2556
2557 for( it = lut.begin(); it < lut.end() - 1; it++ )
2558 {
2559 if( it->first <= compRatio && next( it )->first >= compRatio )
2560 {
2561 double diffx = compRatio - it->first;
2562 double diffn = next( it )->first - it->first;
2563
2564 compRatioBent = it->second + ( next( it )->second - it->second ) * diffx / diffn;
2565 break; // We have our interpolated value
2566 }
2567 }
2568 }
2569 else
2570 {
2571 compRatioBent = lut.front().second; // Small component default
2572 }
2573
2574 // If the width of the part we're probing is bigger than what the screen width will be
2575 // after the zoom, then punt and use the KiCad zoom algorithm since it guarantees the
2576 // part's width will be encompassed within the screen. This will apply to parts that
2577 // are much wider than they are tall.
2578
2579 if( bbSize.x > screenSize.x * ratio * compRatioBent )
2580 {
2581 // Use standard KiCad zoom algorithm for parts too wide to fit screen/
2582 ratio = kicadRatio;
2583 compRatioBent = 1.0; // Reset so we don't modify the "KiCad" ratio
2584 wxLogTrace( "CROSS_PROBE_SCALE", "Part TOO WIDE for screen. Using normal KiCad zoom ratio: %1.5f", ratio );
2585 }
2586
2587 // Now that "compRatioBent" holds our final scaling factor we apply it to the original
2588 // fullscreen zoom ratio to arrive at the final ratio itself.
2589 ratio *= compRatioBent;
2590
2591 bool alwaysZoom = false; // DEBUG - allows us to minimize zooming or not
2592
2593 // Try not to zoom on every cross-probe; it gets very noisy
2594 if( ( ratio < 0.5 || ratio > 1.0 ) || alwaysZoom )
2595 view->SetScale( view->GetScale() / ratio );
2596#endif // ifndef DEFAULT_PCBNEW_CODE
2597}
2598
2599
2601{
2602 bool cleared = false;
2603
2604 if( m_selection.GetSize() > 0 )
2605 {
2606 // Don't fire an event now; most of the time it will be redundant as we're about to
2607 // fire a SelectedEvent.
2608 cleared = true;
2609 ClearSelection( true /*quiet mode*/ );
2610 }
2611
2612 if( aItem )
2613 {
2614 switch( aItem->Type() )
2615 {
2616 case PCB_NETINFO_T:
2617 {
2618 int netCode = static_cast<NETINFO_ITEM*>( aItem )->GetNetCode();
2619
2620 if( netCode > 0 )
2621 {
2622 SelectAllItemsOnNet( netCode, true );
2623 m_frame->FocusOnLocation( aItem->GetCenter() );
2624 }
2625 break;
2626 }
2627
2628 default:
2629 select( aItem );
2630 m_frame->FocusOnLocation( aItem->GetPosition() );
2631 }
2632
2633 // If the item has a bounding box, then zoom out if needed
2634 if( aItem->GetBoundingBox().GetHeight() > 0 && aItem->GetBoundingBox().GetWidth() > 0 )
2635 {
2636 // This adds some margin
2637 double marginFactor = 2;
2638
2639 KIGFX::PCB_VIEW* pcbView = canvas()->GetView();
2640 BOX2D screenBox = pcbView->GetViewport();
2641 VECTOR2D screenSize = screenBox.GetSize();
2642 BOX2I screenRect = BOX2ISafe( screenBox.GetOrigin(), screenSize / marginFactor );
2643
2644 if( !screenRect.Contains( aItem->GetBoundingBox() ) )
2645 {
2646 double scaleX = screenSize.x / static_cast<double>( aItem->GetBoundingBox().GetWidth() );
2647 double scaleY = screenSize.y / static_cast<double>( aItem->GetBoundingBox().GetHeight() );
2648
2649 scaleX /= marginFactor;
2650 scaleY /= marginFactor;
2651
2652 double scale = scaleX > scaleY ? scaleY : scaleX;
2653
2654 if( scale < 1 ) // Don't zoom in, only zoom out
2655 {
2656 pcbView->SetScale( pcbView->GetScale() * ( scale ) );
2657
2658 //Let's refocus because there is an algorithm to avoid dialogs in there.
2659 m_frame->FocusOnLocation( aItem->GetCenter() );
2660 }
2661 }
2662 }
2663 // Inform other potentially interested tools
2664 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2665 }
2666 else if( cleared )
2667 {
2668 m_toolMgr->ProcessEvent( EVENTS::ClearedEvent );
2669 }
2670
2671 m_frame->GetCanvas()->ForceRefresh();
2672}
2673
2674
2680static bool itemIsIncludedByFilter( const BOARD_ITEM& aItem, const BOARD& aBoard,
2681 const DIALOG_FILTER_SELECTION::OPTIONS& aFilterOptions )
2682{
2683 switch( aItem.Type() )
2684 {
2685 case PCB_FOOTPRINT_T:
2686 {
2687 const FOOTPRINT& footprint = static_cast<const FOOTPRINT&>( aItem );
2688
2689 return aFilterOptions.includeFootprints && ( aFilterOptions.includeLockedFootprints
2690 || !footprint.IsLocked() );
2691 }
2692
2693 case PCB_TRACE_T:
2694 case PCB_ARC_T:
2695 return aFilterOptions.includeTracks;
2696
2697 case PCB_VIA_T:
2698 return aFilterOptions.includeVias;
2699
2700 case PCB_ZONE_T:
2701 return aFilterOptions.includeZones;
2702
2703 case PCB_SHAPE_T:
2704 case PCB_TARGET_T:
2705 case PCB_DIM_ALIGNED_T:
2706 case PCB_DIM_CENTER_T:
2707 case PCB_DIM_RADIAL_T:
2709 case PCB_DIM_LEADER_T:
2710 if( aItem.GetLayer() == Edge_Cuts )
2711 return aFilterOptions.includeBoardOutlineLayer;
2712 else
2713 return aFilterOptions.includeItemsOnTechLayers;
2714
2715 case PCB_FIELD_T:
2716 case PCB_TEXT_T:
2717 case PCB_TEXTBOX_T:
2718 case PCB_TABLE_T:
2719 case PCB_TABLECELL_T:
2720 return aFilterOptions.includePcbTexts;
2721
2722 default:
2723 // Filter dialog is inclusive, not exclusive. If it's not included, then it doesn't
2724 // get selected.
2725 return false;
2726 }
2727}
2728
2729
2731{
2732 const BOARD& board = *getModel<BOARD>();
2733 DIALOG_FILTER_SELECTION::OPTIONS& opts = m_priv->m_filterOpts;
2734 DIALOG_FILTER_SELECTION dlg( m_frame, opts );
2735
2736 const int cmd = dlg.ShowModal();
2737
2738 if( cmd != wxID_OK )
2739 return 0;
2740
2741 // copy current selection
2742 std::deque<EDA_ITEM*> selection = m_selection.GetItems();
2743
2744 ClearSelection( true /*quiet mode*/ );
2745
2746 // re-select items from the saved selection according to the dialog options
2747 for( EDA_ITEM* i : selection )
2748 {
2749 if( !i->IsBOARD_ITEM() )
2750 continue;
2751
2752 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( i );
2753 bool include = itemIsIncludedByFilter( *item, board, opts );
2754
2755 if( include )
2756 select( item );
2757 }
2758
2759 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
2760
2761 return 0;
2762}
2763
2764
2766 PCB_SELECTION_FILTER_OPTIONS* aRejected )
2767{
2768 if( aCollector.GetCount() == 0 )
2769 return;
2770
2771 std::set<BOARD_ITEM*> rejected;
2772
2773 for( EDA_ITEM* i : aCollector )
2774 {
2775 if( !i->IsBOARD_ITEM() )
2776 continue;
2777
2778 BOARD_ITEM* item = static_cast<BOARD_ITEM*>( i );
2779
2780 if( !itemPassesFilter( item, aMultiSelect, aRejected ) )
2781 rejected.insert( item );
2782 }
2783
2784 for( BOARD_ITEM* item : rejected )
2785 aCollector.Remove( item );
2786}
2787
2788
2789bool PCB_SELECTION_TOOL::itemPassesFilter( BOARD_ITEM* aItem, bool aMultiSelect,
2790 PCB_SELECTION_FILTER_OPTIONS* aRejected )
2791{
2792 if( !m_filter.lockedItems )
2793 {
2794 if( aItem->IsLocked() || ( aItem->GetParent() && aItem->GetParent()->IsLocked() ) )
2795 {
2796 if( aItem->Type() == PCB_PAD_T && !aMultiSelect )
2797 {
2798 // allow a single pad to be selected -- there are a lot of operations that
2799 // require this so we allow this one inconsistency
2800 }
2801 else
2802 {
2803 if( aRejected )
2804 aRejected->lockedItems = true;
2805 return false;
2806 }
2807 }
2808 }
2809
2810 if( !aItem )
2811 return false;
2812
2813 KICAD_T itemType = aItem->Type();
2814
2815 if( itemType == PCB_GENERATOR_T )
2816 {
2817 if( static_cast<PCB_GENERATOR*>( aItem )->GetItems().empty() )
2818 {
2819 if( !m_filter.otherItems )
2820 {
2821 if( aRejected )
2822 aRejected->otherItems = true;
2823
2824 return false;
2825 }
2826 }
2827 else
2828 {
2829 itemType = ( *static_cast<PCB_GENERATOR*>( aItem )->GetItems().begin() )->Type();
2830 }
2831 }
2832
2833 switch( itemType )
2834 {
2835 case PCB_FOOTPRINT_T:
2836 if( !m_filter.footprints )
2837 {
2838 if( aRejected )
2839 aRejected->footprints = true;
2840
2841 return false;
2842 }
2843
2844 break;
2845
2846 case PCB_PAD_T:
2847 if( !m_filter.pads )
2848 {
2849 if( aRejected )
2850 aRejected->pads = true;
2851
2852 return false;
2853 }
2854
2855 break;
2856
2857 case PCB_TRACE_T:
2858 case PCB_ARC_T:
2859 if( !m_filter.tracks )
2860 {
2861 if( aRejected )
2862 aRejected->tracks = true;
2863
2864 return false;
2865 }
2866
2867 break;
2868
2869 case PCB_VIA_T:
2870 if( !m_filter.vias )
2871 {
2872 if( aRejected )
2873 aRejected->vias = true;
2874
2875 return false;
2876 }
2877
2878 break;
2879
2880 case PCB_ZONE_T:
2881 {
2882 ZONE* zone = static_cast<ZONE*>( aItem );
2883
2884 if( ( !m_filter.zones && !zone->GetIsRuleArea() )
2885 || ( !m_filter.keepouts && zone->GetIsRuleArea() ) )
2886 {
2887 if( aRejected )
2888 {
2889 if( zone->GetIsRuleArea() )
2890 aRejected->keepouts = true;
2891 else
2892 aRejected->zones = true;
2893 }
2894
2895 return false;
2896 }
2897
2898 // m_SolderMaskBridges zone is a special zone, only used to showsolder mask briges
2899 // after running DRC. it is not really a board item.
2900 // Never select it or delete by a Commit.
2901 if( zone == m_frame->GetBoard()->m_SolderMaskBridges )
2902 return false;
2903
2904 break;
2905 }
2906
2907 case PCB_SHAPE_T:
2908 case PCB_TARGET_T:
2909 if( !m_filter.graphics )
2910 {
2911 if( aRejected )
2912 aRejected->graphics = true;
2913
2914 return false;
2915 }
2916
2917 break;
2918
2920 if( !m_filter.graphics )
2921 {
2922 if( aRejected )
2923 aRejected->graphics = true;
2924
2925 return false;
2926 }
2927
2928 // a reference image living in a footprint must not be selected inside the board editor
2929 if( !m_isFootprintEditor && aItem->GetParentFootprint() )
2930 {
2931 if( aRejected )
2932 aRejected->text = true;
2933
2934 return false;
2935 }
2936
2937 break;
2938
2939 case PCB_FIELD_T:
2940 case PCB_TEXT_T:
2941 case PCB_TEXTBOX_T:
2942 case PCB_TABLE_T:
2943 case PCB_TABLECELL_T:
2944 if( !m_filter.text )
2945 return false;
2946
2947 break;
2948
2949 case PCB_DIM_ALIGNED_T:
2950 case PCB_DIM_CENTER_T:
2951 case PCB_DIM_RADIAL_T:
2953 case PCB_DIM_LEADER_T:
2954 if( !m_filter.dimensions )
2955 {
2956 if( aRejected )
2957 aRejected->dimensions = true;
2958
2959 return false;
2960 }
2961
2962 break;
2963
2964 case PCB_POINT_T:
2965 if( !m_filter.points )
2966 {
2967 if( aRejected )
2968 aRejected->points = true;
2969
2970 return false;
2971 }
2972
2973 break;
2974
2975 case PCB_BARCODE_T:
2976 default:
2977 if( !m_filter.otherItems )
2978 {
2979 if( aRejected )
2980 aRejected->otherItems = true;
2981
2982 return false;
2983 }
2984 }
2985
2986 return true;
2987}
2988
2989
2991{
2992 if( m_selection.Empty() )
2993 return;
2994
2995 while( m_selection.GetSize() )
2997
2998 view()->Update( &m_selection );
2999
3000 m_selection.SetIsHover( false );
3001 m_selection.ClearReferencePoint();
3002
3003 // Inform other potentially interested tools
3004 if( !aQuietMode )
3005 {
3006 m_toolMgr->ProcessEvent( EVENTS::ClearedEvent );
3008 }
3009}
3010
3011
3013{
3014 m_selection.Clear();
3015
3016 bool enteredGroupFound = false;
3017
3018 INSPECTOR_FUNC inspector =
3019 [&]( EDA_ITEM* item, void* testData )
3020 {
3021 if( item->IsSelected() )
3022 {
3023 EDA_ITEM* parent = item->GetParent();
3024
3025 // Let selected parents handle their children.
3026 if( parent && parent->IsSelected() )
3028
3029 highlight( item, SELECTED, &m_selection );
3030 }
3031
3032 if( item->Type() == PCB_GROUP_T )
3033 {
3034 if( item == m_enteredGroup )
3035 {
3036 item->SetFlags( ENTERED );
3037 enteredGroupFound = true;
3038 }
3039 else
3040 {
3041 item->ClearFlags( ENTERED );
3042 }
3043 }
3044
3046 };
3047
3050
3051 if( !enteredGroupFound )
3052 {
3053 m_enteredGroupOverlay.Clear();
3054 m_enteredGroup = nullptr;
3055 }
3056}
3057
3058
3059bool PCB_SELECTION_TOOL::Selectable( const BOARD_ITEM* aItem, bool checkVisibilityOnly ) const
3060{
3061 const RENDER_SETTINGS* settings = getView()->GetPainter()->GetSettings();
3062 const PCB_DISPLAY_OPTIONS& options = frame()->GetDisplayOptions();
3063
3064 auto visibleLayers =
3065 [&]() -> LSET
3066 {
3068 {
3069 LSET set;
3070
3071 for( PCB_LAYER_ID layer : LSET::AllLayersMask() )
3072 set.set( layer, view()->IsLayerVisible( layer ) );
3073
3074 return set;
3075 }
3076 else
3077 {
3078 return board()->GetVisibleLayers();
3079 }
3080 };
3081
3082 auto layerVisible =
3083 [&]( PCB_LAYER_ID aLayer )
3084 {
3086 return view()->IsLayerVisible( aLayer );
3087 else
3088 return board()->IsLayerVisible( aLayer );
3089 };
3090
3091 if( settings->GetHighContrast() )
3092 {
3093 const std::set<int> activeLayers = settings->GetHighContrastLayers();
3094 bool onActiveLayer = false;
3095
3096 for( int layer : activeLayers )
3097 {
3098 // NOTE: Only checking the regular layers (not GAL meta-layers)
3099 if( layer < PCB_LAYER_ID_COUNT && aItem->IsOnLayer( ToLAYER_ID( layer ) ) )
3100 {
3101 onActiveLayer = true;
3102 break;
3103 }
3104 }
3105
3106 if( !onActiveLayer && aItem->Type() != PCB_MARKER_T )
3107 {
3108 // We do not want to select items that are in the background
3109 return false;
3110 }
3111 }
3112
3113 if( aItem->Type() == PCB_FOOTPRINT_T )
3114 {
3115 const FOOTPRINT* footprint = static_cast<const FOOTPRINT*>( aItem );
3116
3117 // In footprint editor, we do not want to select the footprint itself.
3119 return false;
3120
3121 // Allow selection of footprints if some part of the footprint is visible.
3122 if( footprint->GetSide() != UNDEFINED_LAYER && !m_skip_heuristics )
3123 {
3124 LSET boardSide = footprint->IsFlipped() ? LSET::BackMask() : LSET::FrontMask();
3125
3126 if( !( visibleLayers() & boardSide ).any() )
3127 return false;
3128 }
3129
3130 // If the footprint has no items except the reference and value fields, include the
3131 // footprint in the selections.
3132 if( footprint->GraphicalItems().empty()
3133 && footprint->Pads().empty()
3134 && footprint->Zones().empty() )
3135 {
3136 return true;
3137 }
3138
3139 for( const BOARD_ITEM* item : footprint->GraphicalItems() )
3140 {
3141 if( Selectable( item, true ) )
3142 return true;
3143 }
3144
3145 for( const PAD* pad : footprint->Pads() )
3146 {
3147 if( Selectable( pad, true ) )
3148 return true;
3149 }
3150
3151 for( const ZONE* zone : footprint->Zones() )
3152 {
3153 if( Selectable( zone, true ) )
3154 return true;
3155 }
3156
3157 for( const PCB_POINT* point: footprint->Points() )
3158 {
3159 if( Selectable( point, true ) )
3160 return true;
3161 }
3162
3163 return false;
3164 }
3165 else if( aItem->Type() == PCB_GROUP_T )
3166 {
3167 PCB_GROUP* group = const_cast<PCB_GROUP*>( static_cast<const PCB_GROUP*>( aItem ) );
3168
3169 // Similar to logic for footprint, a group is selectable if any of its members are.
3170 // (This recurses.)
3171 for( BOARD_ITEM* item : group->GetBoardItems() )
3172 {
3173 if( Selectable( item, true ) )
3174 return true;
3175 }
3176
3177 return false;
3178 }
3179
3180 if( aItem->GetParentGroup() && aItem->GetParentGroup()->AsEdaItem()->Type() == PCB_GENERATOR_T )
3181 return false;
3182
3183 const ZONE* zone = nullptr;
3184 const PCB_VIA* via = nullptr;
3185 const PAD* pad = nullptr;
3186 const PCB_TEXT* text = nullptr;
3187 const PCB_FIELD* field = nullptr;
3188 const PCB_MARKER* marker = nullptr;
3189 const PCB_TABLECELL* cell = nullptr;
3190
3191 // Most footprint children can only be selected in the footprint editor.
3192 if( aItem->GetParentFootprint() && !m_isFootprintEditor && !checkVisibilityOnly )
3193 {
3194 if( aItem->Type() != PCB_FIELD_T && aItem->Type() != PCB_PAD_T && aItem->Type() != PCB_TEXT_T )
3195 return false;
3196 }
3197
3198 switch( aItem->Type() )
3199 {
3200 case PCB_ZONE_T:
3201 if( !board()->IsElementVisible( LAYER_ZONES ) || ( options.m_ZoneOpacity == 0.00 ) )
3202 return false;
3203
3204 zone = static_cast<const ZONE*>( aItem );
3205
3206 // A teardrop is modelled as a property of a via, pad or the board (for track-to-track
3207 // teardrops). The underlying zone is only an implementation detail.
3208 if( zone->IsTeardropArea() && !board()->LegacyTeardrops() )
3209 return false;
3210
3211 // zones can exist on multiple layers!
3212 if( !( zone->GetLayerSet() & visibleLayers() ).any() )
3213 return false;
3214
3215 break;
3216
3217 case PCB_TRACE_T:
3218 case PCB_ARC_T:
3219 if( !board()->IsElementVisible( LAYER_TRACKS ) || ( options.m_TrackOpacity == 0.00 ) )
3220 return false;
3221
3222 if( !layerVisible( aItem->GetLayer() ) )
3223 return false;
3224
3225 break;
3226
3227 case PCB_VIA_T:
3228 if( !board()->IsElementVisible( LAYER_VIAS ) || ( options.m_ViaOpacity == 0.00 ) )
3229 return false;
3230
3231 via = static_cast<const PCB_VIA*>( aItem );
3232
3233 // For vias it is enough if only one of its layers is visible
3234 if( !( visibleLayers() & via->GetLayerSet() ).any() )
3235 return false;
3236
3237 break;
3238
3239 case PCB_FIELD_T:
3240 field = static_cast<const PCB_FIELD*>( aItem );
3241
3242 if( !field->IsVisible() )
3243 return false;
3244
3245 if( field->IsReference() && !view()->IsLayerVisible( LAYER_FP_REFERENCES ) )
3246 return false;
3247
3248 if( field->IsValue() && !view()->IsLayerVisible( LAYER_FP_VALUES ) )
3249 return false;
3250
3251 // Handle all other fields with normal text visibility controls
3253 case PCB_TEXT_T:
3254 text = static_cast<const PCB_TEXT*>( aItem );
3255
3256 if( !layerVisible( text->GetLayer() ) )
3257 return false;
3258
3259 // Apply the LOD visibility test as well
3260 if( !view()->IsVisible( text ) )
3261 return false;
3262
3263 if( aItem->GetParentFootprint() )
3264 {
3265 int controlLayer = LAYER_FP_TEXT;
3266
3267 if( text->GetText() == wxT( "${REFERENCE}" ) )
3268 controlLayer = LAYER_FP_REFERENCES;
3269 else if( text->GetText() == wxT( "${VALUE}" ) )
3270 controlLayer = LAYER_FP_VALUES;
3271
3272 if( !view()->IsLayerVisible( controlLayer ) )
3273 return false;
3274 }
3275
3276 break;
3277
3279 if( options.m_ImageOpacity == 0.00 )
3280 return false;
3281
3282 // Bitmap images on board are hidden if LAYER_DRAW_BITMAPS is not visible
3283 if( !view()->IsLayerVisible( LAYER_DRAW_BITMAPS ) )
3284 return false;
3285
3286 if( !layerVisible( aItem->GetLayer() ) )
3287 return false;
3288
3289 break;
3290
3291 case PCB_SHAPE_T:
3292 if( options.m_FilledShapeOpacity == 0.0 && static_cast<const PCB_SHAPE*>( aItem )->IsAnyFill() )
3293 return false;
3294
3295 if( !layerVisible( aItem->GetLayer() ) )
3296 return false;
3297
3298 break;
3299
3300 case PCB_BARCODE_T:
3301 if( !layerVisible( aItem->GetLayer() ) )
3302 return false;
3303
3304 break;
3305
3306 case PCB_TEXTBOX_T:
3307 case PCB_TABLE_T:
3308 if( !layerVisible( aItem->GetLayer() ) )
3309 return false;
3310
3311 break;
3312
3313 case PCB_TABLECELL_T:
3314 cell = static_cast<const PCB_TABLECELL*>( aItem );
3315
3316 if( !layerVisible( aItem->GetLayer() ) )
3317 return false;
3318
3319 if( cell->GetRowSpan() == 0 || cell->GetColSpan() == 0 )
3320 return false;
3321
3322 break;
3323
3324 case PCB_DIM_ALIGNED_T:
3325 case PCB_DIM_LEADER_T:
3326 case PCB_DIM_CENTER_T:
3327 case PCB_DIM_RADIAL_T:
3329 if( !layerVisible( aItem->GetLayer() ) )
3330 return false;
3331
3332 break;
3333
3334 case PCB_PAD_T:
3335 if( options.m_PadOpacity == 0.00 )
3336 return false;
3337
3338 pad = static_cast<const PAD*>( aItem );
3339
3340 if( pad->GetAttribute() == PAD_ATTRIB::PTH || pad->GetAttribute() == PAD_ATTRIB::NPTH )
3341 {
3342 // A pad's hole is visible on every layer the pad is visible on plus many layers the
3343 // pad is not visible on -- so we only need to check for any visible hole layers.
3344 if( !( visibleLayers() & LSET::PhysicalLayersMask() ).any() )
3345 return false;
3346 }
3347 else
3348 {
3349 if( !( pad->GetLayerSet() & visibleLayers() ).any() )
3350 return false;
3351 }
3352
3353 break;
3354
3355 case PCB_MARKER_T:
3356 marker = static_cast<const PCB_MARKER*>( aItem );
3357
3358 if( marker && marker->IsExcluded() && !board()->IsElementVisible( LAYER_DRC_EXCLUSION ) )
3359 return false;
3360
3361 break;
3362
3363 case PCB_POINT_T:
3364 if( !layerVisible( aItem->GetLayer() ) )
3365 return false;
3366
3367 if( !board()->IsElementVisible( LAYER_POINTS ) )
3368 return false;
3369
3370 break;
3371
3372 // These are not selectable
3373 case PCB_NETINFO_T:
3374 case NOT_USED:
3375 case TYPE_NOT_INIT:
3376 return false;
3377
3378 default: // Suppress warnings
3379 break;
3380 }
3381
3382 return true;
3383}
3384
3385
3387{
3388 if( !aItem || aItem->IsSelected() || !aItem->IsBOARD_ITEM() )
3389 return;
3390
3391 if( aItem->Type() == PCB_PAD_T )
3392 {
3393 FOOTPRINT* footprint = static_cast<FOOTPRINT*>( aItem->GetParent() );
3394
3395 if( m_selection.Contains( footprint ) )
3396 return;
3397 }
3398
3399 if( m_enteredGroup && !PCB_GROUP::WithinScope( static_cast<BOARD_ITEM*>( aItem ), m_enteredGroup,
3401 {
3402 ExitGroup();
3403 }
3404
3405 highlight( aItem, SELECTED, &m_selection );
3406}
3407
3408
3410{
3411 unhighlight( aItem, SELECTED, &m_selection );
3412}
3413
3414
3415void PCB_SELECTION_TOOL::highlight( EDA_ITEM* aItem, int aMode, SELECTION* aGroup )
3416{
3417 if( aGroup )
3418 aGroup->Add( aItem );
3419
3420 highlightInternal( aItem, aMode, aGroup != nullptr );
3421 view()->Update( aItem, KIGFX::REPAINT );
3422
3423 // Many selections are very temporal and updating the display each time just
3424 // creates noise.
3425 if( aMode == BRIGHTENED )
3427}
3428
3429
3430void PCB_SELECTION_TOOL::highlightInternal( EDA_ITEM* aItem, int aMode, bool aUsingOverlay )
3431{
3432 if( aMode == SELECTED )
3433 aItem->SetSelected();
3434 else if( aMode == BRIGHTENED )
3435 aItem->SetBrightened();
3436
3437 if( aUsingOverlay && aMode != BRIGHTENED )
3438 view()->Hide( aItem, true ); // Hide the original item, so it is shown only on overlay
3439
3440 if( aItem->IsBOARD_ITEM() )
3441 {
3442 BOARD_ITEM* boardItem = static_cast<BOARD_ITEM*>( aItem );
3443 boardItem->RunOnChildren( std::bind( &PCB_SELECTION_TOOL::highlightInternal, this, _1, aMode, aUsingOverlay ),
3445 }
3446}
3447
3448
3449void PCB_SELECTION_TOOL::unhighlight( EDA_ITEM* aItem, int aMode, SELECTION* aGroup )
3450{
3451 if( aGroup )
3452 aGroup->Remove( aItem );
3453
3454 unhighlightInternal( aItem, aMode, aGroup != nullptr );
3455 view()->Update( aItem, KIGFX::REPAINT );
3456
3457 // Many selections are very temporal and updating the display each time just creates noise.
3458 if( aMode == BRIGHTENED )
3460}
3461
3462
3463void PCB_SELECTION_TOOL::unhighlightInternal( EDA_ITEM* aItem, int aMode, bool aUsingOverlay )
3464{
3465 if( aMode == SELECTED )
3466 aItem->ClearSelected();
3467 else if( aMode == BRIGHTENED )
3468 aItem->ClearBrightened();
3469
3470 if( aUsingOverlay && aMode != BRIGHTENED )
3471 {
3472 view()->Hide( aItem, false ); // Restore original item visibility...
3473 view()->Update( aItem ); // ... and make sure it's redrawn un-selected
3474 }
3475
3476 if( aItem->IsBOARD_ITEM() )
3477 {
3478 BOARD_ITEM* boardItem = static_cast<BOARD_ITEM*>( aItem );
3479 boardItem->RunOnChildren( std::bind( &PCB_SELECTION_TOOL::unhighlightInternal, this, _1, aMode, aUsingOverlay ),
3481 }
3482}
3483
3484
3486{
3487 const unsigned GRIP_MARGIN = 20;
3488 int margin = KiROUND( getView()->ToWorld( GRIP_MARGIN ) );
3489
3490 // Check if the point is located close to any of the currently selected items
3491 for( EDA_ITEM* item : m_selection )
3492 {
3493 if( !item->IsBOARD_ITEM() )
3494 continue;
3495
3496 BOX2I itemBox = item->ViewBBox();
3497 itemBox.Inflate( margin ); // Give some margin for gripping an item
3498
3499 if( itemBox.Contains( aPoint ) )
3500 {
3501 if( item->HitTest( aPoint, margin ) )
3502 return true;
3503
3504 bool found = false;
3505
3506 if( PCB_GROUP* group = dynamic_cast<PCB_GROUP*>( item ) )
3507 {
3508 group->RunOnChildren(
3509 [&]( BOARD_ITEM* aItem )
3510 {
3511 if( aItem->HitTest( aPoint, margin ) )
3512 found = true;
3513 },
3515 }
3516
3517 if( found )
3518 return true;
3519 }
3520 }
3521
3522 return false;
3523}
3524
3525
3526int PCB_SELECTION_TOOL::hitTestDistance( const VECTOR2I& aWhere, BOARD_ITEM* aItem, int aMaxDistance ) const
3527{
3528 BOX2D viewportD = getView()->GetViewport();
3529 BOX2I viewport = BOX2ISafe( viewportD );
3530 int distance = INT_MAX;
3531 SEG loc( aWhere, aWhere );
3532
3533 switch( aItem->Type() )
3534 {
3535 case PCB_FIELD_T:
3536 case PCB_TEXT_T:
3537 {
3538 PCB_TEXT* text = static_cast<PCB_TEXT*>( aItem );
3539
3540 // Add a bit of slop to text-shapes
3541 if( text->GetEffectiveTextShape()->Collide( loc, aMaxDistance, &distance ) )
3542 distance = std::clamp( distance - ( aMaxDistance / 2 ), 0, distance );
3543
3544 break;
3545 }
3546
3547 case PCB_TEXTBOX_T:
3548 {
3549 PCB_TEXTBOX* textbox = static_cast<PCB_TEXTBOX*>( aItem );
3550
3551 // Add a bit of slop to text-shapes
3552 if( textbox->GetEffectiveTextShape()->Collide( loc, aMaxDistance, &distance ) )
3553 distance = std::clamp( distance - ( aMaxDistance / 2 ), 0, distance );
3554
3555 break;
3556 }
3557
3558 case PCB_TABLECELL_T:
3559 {
3560 PCB_TABLECELL* tablecell = static_cast<PCB_TABLECELL*>( aItem );
3561 auto shape = std::make_shared<SHAPE_COMPOUND>( tablecell->MakeEffectiveShapesForHitTesting() );
3562
3563 shape->Collide( loc, aMaxDistance, &distance );
3564
3565 break;
3566 }
3567
3568 case PCB_TABLE_T:
3569 {
3570 PCB_TABLE* table = static_cast<PCB_TABLE*>( aItem );
3571 distance = aMaxDistance;
3572
3573 for( PCB_TABLECELL* cell : table->GetCells() )
3574 distance = std::min( distance, hitTestDistance( aWhere, cell, aMaxDistance ) );
3575
3576 // Tables should defer to their table cells. Never consider them exact.
3577 distance = std::clamp( distance + ( aMaxDistance / 4 ), 0, aMaxDistance );
3578 break;
3579 }
3580
3581 case PCB_ZONE_T:
3582 {
3583 ZONE* zone = static_cast<ZONE*>( aItem );
3584
3585 // Zone borders are very specific
3586 if( zone->HitTestForEdge( aWhere, aMaxDistance / 2 ) )
3587 distance = 0;
3588 else if( zone->HitTestForEdge( aWhere, aMaxDistance ) )
3589 distance = aMaxDistance / 2;
3590 else
3591 aItem->GetEffectiveShape()->Collide( loc, aMaxDistance, &distance );
3592
3593 break;
3594 }
3595
3596 case PCB_FOOTPRINT_T:
3597 {
3598 FOOTPRINT* footprint = static_cast<FOOTPRINT*>( aItem );
3599 BOX2I bbox = footprint->GetBoundingBox( false );
3600
3601 try
3602 {
3603 footprint->GetBoundingHull().Collide( loc, aMaxDistance, &distance );
3604 }
3605 catch( const std::exception& e )
3606 {
3607 wxFAIL_MSG( wxString::Format( wxT( "Clipper exception occurred: %s" ), e.what() ) );
3608 }
3609
3610 // Consider footprints larger than the viewport only as a last resort
3611 if( bbox.GetHeight() > viewport.GetHeight() || bbox.GetWidth() > viewport.GetWidth() )
3612 distance = INT_MAX / 2;
3613
3614 break;
3615 }
3616
3617 case PCB_MARKER_T:
3618 {
3619 PCB_MARKER* marker = static_cast<PCB_MARKER*>( aItem );
3620 SHAPE_LINE_CHAIN polygon;
3621
3622 marker->ShapeToPolygon( polygon );
3623 polygon.Move( marker->GetPos() );
3624 polygon.Collide( loc, aMaxDistance, &distance );
3625 break;
3626 }
3627
3628 case PCB_GROUP_T:
3629 case PCB_GENERATOR_T:
3630 {
3631 PCB_GROUP* group = static_cast<PCB_GROUP*>( aItem );
3632
3633 for( BOARD_ITEM* member : group->GetBoardItems() )
3634 distance = std::min( distance, hitTestDistance( aWhere, member, aMaxDistance ) );
3635
3636 break;
3637 }
3638
3639 case PCB_PAD_T:
3640 {
3641 static_cast<PAD*>( aItem )->Padstack().ForEachUniqueLayer(
3642 [&]( PCB_LAYER_ID aLayer )
3643 {
3644 int layerDistance = INT_MAX;
3645 aItem->GetEffectiveShape( aLayer )->Collide( loc, aMaxDistance, &layerDistance );
3646 distance = std::min( distance, layerDistance );
3647 } );
3648
3649 break;
3650 }
3651
3652 default:
3653 aItem->GetEffectiveShape()->Collide( loc, aMaxDistance, &distance );
3654 break;
3655 }
3656
3657 return distance;
3658}
3659
3660
3662{
3663 wxCHECK( m_frame, /* void */ );
3664
3665 if( aCollector.GetCount() < 2 )
3666 return;
3667
3668 const RENDER_SETTINGS* settings = getView()->GetPainter()->GetSettings();
3669
3670 wxCHECK( settings, /* void */ );
3671
3672 PCB_LAYER_ID activeLayer = m_frame->GetActiveLayer();
3673 LSET visibleLayers = m_frame->GetBoard()->GetVisibleLayers();
3674 LSET enabledLayers = m_frame->GetBoard()->GetEnabledLayers();
3675 LSEQ enabledLayerStack = enabledLayers.SeqStackupTop2Bottom( activeLayer );
3676
3677 wxCHECK( !enabledLayerStack.empty(), /* void */ );
3678
3679 auto isZoneFillKeepout =
3680 []( const BOARD_ITEM* aItem ) -> bool
3681 {
3682 if( aItem->Type() == PCB_ZONE_T )
3683 {
3684 const ZONE* zone = static_cast<const ZONE*>( aItem );
3685
3686 if( zone->GetIsRuleArea() && zone->GetDoNotAllowZoneFills() )
3687 return true;
3688 }
3689
3690 return false;
3691 };
3692
3693 std::vector<LAYER_OPACITY_ITEM> opacityStackup;
3694
3695 for( int i = 0; i < aCollector.GetCount(); i++ )
3696 {
3697 const BOARD_ITEM* item = aCollector[i];
3698
3699 LSET itemLayers = item->GetLayerSet() & enabledLayers & visibleLayers;
3700 LSEQ itemLayerSeq = itemLayers.Seq( enabledLayerStack );
3701
3702 for( PCB_LAYER_ID layer : itemLayerSeq )
3703 {
3704 COLOR4D color = settings->GetColor( item, layer );
3705
3706 if( color.a == 0 )
3707 continue;
3708
3709 LAYER_OPACITY_ITEM opacityItem;
3710
3711 opacityItem.m_Layer = layer;
3712 opacityItem.m_Opacity = color.a;
3713 opacityItem.m_Item = item;
3714
3715 if( isZoneFillKeepout( item ) )
3716 opacityItem.m_Opacity = 0.0;
3717
3718 opacityStackup.emplace_back( opacityItem );
3719 }
3720 }
3721
3722 std::sort( opacityStackup.begin(), opacityStackup.end(),
3723 [&]( const LAYER_OPACITY_ITEM& aLhs, const LAYER_OPACITY_ITEM& aRhs ) -> bool
3724 {
3725 int retv = enabledLayerStack.TestLayers( aLhs.m_Layer, aRhs.m_Layer );
3726
3727 if( retv )
3728 return retv > 0;
3729
3730 return aLhs.m_Opacity > aRhs.m_Opacity;
3731 } );
3732
3733 std::set<const BOARD_ITEM*> visibleItems;
3734 std::set<const BOARD_ITEM*> itemsToRemove;
3735 double minAlphaLimit = ADVANCED_CFG::GetCfg().m_PcbSelectionVisibilityRatio;
3736 double currentStackupOpacity = 0.0;
3738
3739 for( const LAYER_OPACITY_ITEM& opacityItem : opacityStackup )
3740 {
3741 if( lastVisibleLayer == PCB_LAYER_ID::UNDEFINED_LAYER )
3742 {
3743 currentStackupOpacity = opacityItem.m_Opacity;
3744 lastVisibleLayer = opacityItem.m_Layer;
3745 visibleItems.emplace( opacityItem.m_Item );
3746 continue;
3747 }
3748
3749 // Objects to ignore and fallback to the old selection behavior.
3750 auto ignoreItem =
3751 [&]()
3752 {
3753 const BOARD_ITEM* item = opacityItem.m_Item;
3754
3755 wxCHECK( item, false );
3756
3757 // Check items that span multiple layers for visibility.
3758 if( visibleItems.count( item ) )
3759 return true;
3760
3761 // Don't prune child items of a footprint that is already visible.
3762 if( item->GetParent()
3763 && ( item->GetParent()->Type() == PCB_FOOTPRINT_T )
3764 && visibleItems.count( item->GetParent() ) )
3765 {
3766 return true;
3767 }
3768
3769 // Keepout zones are transparent but for some reason, PCB_PAINTER::GetColor()
3770 // returns the color of the zone it prevents from filling.
3771 if( isZoneFillKeepout( item ) )
3772 return true;
3773
3774 return false;
3775 };
3776
3777 // Everything on the currently selected layer is visible;
3778 if( opacityItem.m_Layer == enabledLayerStack[0] )
3779 {
3780 visibleItems.emplace( opacityItem.m_Item );
3781 }
3782 else
3783 {
3784 double itemVisibility = opacityItem.m_Opacity * ( 1.0 - currentStackupOpacity );
3785
3786 if( ( itemVisibility <= minAlphaLimit ) && !ignoreItem() )
3787 itemsToRemove.emplace( opacityItem.m_Item );
3788 else
3789 visibleItems.emplace( opacityItem.m_Item );
3790 }
3791
3792 if( opacityItem.m_Layer != lastVisibleLayer )
3793 {
3794 currentStackupOpacity += opacityItem.m_Opacity * ( 1.0 - currentStackupOpacity );
3795 currentStackupOpacity = std::min( currentStackupOpacity, 1.0 );
3796 lastVisibleLayer = opacityItem.m_Layer;
3797 }
3798 }
3799
3800 for( const BOARD_ITEM* itemToRemove : itemsToRemove )
3801 {
3802 wxCHECK( aCollector.GetCount() > 1, /* void */ );
3803 aCollector.Remove( itemToRemove );
3804 }
3805}
3806
3807
3808// The general idea here is that if the user clicks directly on a small item inside a larger
3809// one, then they want the small item. The quintessential case of this is clicking on a pad
3810// within a footprint, but we also apply it for text within a footprint, footprints within
3811// larger footprints, and vias within either larger pads or longer tracks.
3812//
3813// These "guesses" presume there is area within the larger item to click in to select it. If
3814// an item is mostly covered by smaller items within it, then the guesses are inappropriate as
3815// there might not be any area left to click to select the larger item. In this case we must
3816// leave the items in the collector and bring up a Selection Clarification menu.
3817//
3818// We currently check for pads and text mostly covering a footprint, but we don't check for
3819// smaller footprints mostly covering a larger footprint.
3820//
3822 const VECTOR2I& aWhere ) const
3823{
3824 static const LSET silkLayers( { B_SilkS, F_SilkS } );
3825 static const LSET courtyardLayers( { B_CrtYd, F_CrtYd } );
3826 static std::vector<KICAD_T> singleLayerSilkTypes = { PCB_FIELD_T,
3830 PCB_BARCODE_T };
3831
3832 if( ADVANCED_CFG::GetCfg().m_PcbSelectionVisibilityRatio != 1.0 )
3834
3835 if( aCollector.GetCount() == 1 )
3836 return;
3837
3838 std::set<BOARD_ITEM*> preferred;
3839 std::set<BOARD_ITEM*> rejected;
3840 VECTOR2I where( aWhere.x, aWhere.y );
3841 const RENDER_SETTINGS* settings = getView()->GetPainter()->GetSettings();
3842 PCB_LAYER_ID activeLayer = m_frame->GetActiveLayer();
3843
3844 // If a silk layer is in front, we assume the user is working with silk and give preferential
3845 // treatment to single-layer items on *either* silk layer.
3846 if( silkLayers[activeLayer] )
3847 {
3848 for( int i = 0; i < aCollector.GetCount(); ++i )
3849 {
3850 BOARD_ITEM* item = aCollector[i];
3851
3852 if( item->IsType( singleLayerSilkTypes ) && silkLayers[ item->GetLayer() ] )
3853 preferred.insert( item );
3854 }
3855 }
3856 // Similarly, if a courtyard layer is in front, we assume the user is positioning footprints
3857 // and give preferential treatment to footprints on *both* top and bottom.
3858 else if( courtyardLayers[activeLayer] && settings->GetHighContrast() )
3859 {
3860 for( int i = 0; i < aCollector.GetCount(); ++i )
3861 {
3862 BOARD_ITEM* item = aCollector[i];
3863
3864 if( item->Type() == PCB_FOOTPRINT_T )
3865 preferred.insert( item );
3866 }
3867 }
3868
3869 if( preferred.size() > 0 )
3870 {
3871 aCollector.Empty();
3872
3873 for( BOARD_ITEM* item : preferred )
3874 aCollector.Append( item );
3875
3876 if( preferred.size() == 1 )
3877 return;
3878 }
3879
3880 // Prefer exact hits to sloppy ones
3881 constexpr int MAX_SLOP = 5;
3882
3883 int singlePixel = KiROUND( aCollector.GetGuide()->OnePixelInIU() );
3884 int maxSlop = KiROUND( MAX_SLOP * aCollector.GetGuide()->OnePixelInIU() );
3885 int minSlop = INT_MAX;
3886
3887 std::map<BOARD_ITEM*, int> itemsBySloppiness;
3888
3889 for( int i = 0; i < aCollector.GetCount(); ++i )
3890 {
3891 BOARD_ITEM* item = aCollector[i];
3892 int itemSlop = hitTestDistance( where, item, maxSlop );
3893
3894 itemsBySloppiness[ item ] = itemSlop;
3895
3896 if( itemSlop < minSlop )
3897 minSlop = itemSlop;
3898 }
3899
3900 // Prune sloppier items
3901 if( minSlop < INT_MAX )
3902 {
3903 for( std::pair<BOARD_ITEM*, int> pair : itemsBySloppiness )
3904 {
3905 if( pair.second > minSlop + singlePixel )
3906 aCollector.Transfer( pair.first );
3907 }
3908 }
3909
3910 // If the user clicked on a small item within a much larger one then it's pretty clear
3911 // they're trying to select the smaller one.
3912 constexpr double sizeRatio = 1.5;
3913
3914 std::vector<std::pair<BOARD_ITEM*, double>> itemsByArea;
3915
3916 for( int i = 0; i < aCollector.GetCount(); ++i )
3917 {
3918 BOARD_ITEM* item = aCollector[i];
3919 double area = 0.0;
3920
3921 if( item->Type() == PCB_ZONE_T
3922 && static_cast<ZONE*>( item )->HitTestForEdge( where, maxSlop / 2 ) )
3923 {
3924 // Zone borders are very specific, so make them "small"
3925 area = (double) SEG::Square( singlePixel ) * MAX_SLOP;
3926 }
3927 else if( item->Type() == PCB_VIA_T )
3928 {
3929 // Vias rarely hide other things, and we don't want them deferring to short track
3930 // segments underneath them -- so artificially reduce their size from πr² to r².
3931 area = (double) SEG::Square( static_cast<PCB_VIA*>( item )->GetDrill() / 2 );
3932 }
3933 else if( item->Type() == PCB_REFERENCE_IMAGE_T )
3934 {
3935 BOX2I box = item->GetBoundingBox();
3936 area = (double) box.GetWidth() * box.GetHeight();
3937 }
3938 else
3939 {
3940 try
3941 {
3942 area = FOOTPRINT::GetCoverageArea( item, aCollector );
3943 }
3944 catch( const std::exception& e )
3945 {
3946 wxFAIL_MSG( wxString::Format( wxT( "Clipper exception occurred: %s" ), e.what() ) );
3947 }
3948 }
3949
3950 itemsByArea.emplace_back( item, area );
3951 }
3952
3953 std::sort( itemsByArea.begin(), itemsByArea.end(),
3954 []( const std::pair<BOARD_ITEM*, double>& lhs,
3955 const std::pair<BOARD_ITEM*, double>& rhs ) -> bool
3956 {
3957 return lhs.second < rhs.second;
3958 } );
3959
3960 bool rejecting = false;
3961
3962 for( int i = 1; i < (int) itemsByArea.size(); ++i )
3963 {
3964 if( itemsByArea[i].second > itemsByArea[i-1].second * sizeRatio )
3965 rejecting = true;
3966
3967 if( rejecting )
3968 rejected.insert( itemsByArea[i].first );
3969 }
3970
3971 // Special case: if a footprint is completely covered with other features then there's no
3972 // way to select it -- so we need to leave it in the list for user disambiguation.
3973 constexpr double maxCoverRatio = 0.70;
3974
3975 for( int i = 0; i < aCollector.GetCount(); ++i )
3976 {
3977 if( FOOTPRINT* footprint = dynamic_cast<FOOTPRINT*>( aCollector[i] ) )
3978 {
3979 if( footprint->CoverageRatio( aCollector ) > maxCoverRatio )
3980 rejected.erase( footprint );
3981 }
3982 }
3983
3984 // Hopefully we've now got what the user wanted.
3985 if( (unsigned) aCollector.GetCount() > rejected.size() ) // do not remove everything
3986 {
3987 for( BOARD_ITEM* item : rejected )
3988 aCollector.Transfer( item );
3989 }
3990
3991 // Finally, what we are left with is a set of items of similar coverage area. We now reject
3992 // any that are not on the active layer, to reduce the number of disambiguation menus shown.
3993 // If the user wants to force-disambiguate, they can either switch layers or use the modifier
3994 // key to force the menu.
3995 if( aCollector.GetCount() > 1 )
3996 {
3997 bool haveItemOnActive = false;
3998 rejected.clear();
3999
4000 for( int i = 0; i < aCollector.GetCount(); ++i )
4001 {
4002 if( !aCollector[i]->IsOnLayer( activeLayer ) )
4003 rejected.insert( aCollector[i] );
4004 else
4005 haveItemOnActive = true;
4006 }
4007
4008 if( haveItemOnActive )
4009 {
4010 for( BOARD_ITEM* item : rejected )
4011 aCollector.Transfer( item );
4012 }
4013 }
4014}
4015
4016
4018{
4019 if( m_frame && m_frame->IsType( FRAME_PCB_EDITOR ) && !m_frame->GetOverrideLocks() )
4020 {
4021 // Iterate from the back so we don't have to worry about removals.
4022 for( int i = (int) aCollector.GetCount() - 1; i >= 0; --i )
4023 {
4024 BOARD_ITEM* item = aCollector[i];
4025 bool lockedDescendant = false;
4026
4027 item->RunOnChildren(
4028 [&]( BOARD_ITEM* curr_item )
4029 {
4030 if( curr_item->IsLocked() )
4031 lockedDescendant = true;
4032 },
4034
4035 if( item->IsLocked() || lockedDescendant )
4036 aCollector.Remove( item );
4037 }
4038 }
4039}
4040
4041
4042void PCB_SELECTION_TOOL::FilterCollectorForHierarchy( GENERAL_COLLECTOR& aCollector, bool aMultiselect ) const
4043{
4044 std::unordered_set<EDA_ITEM*> toAdd;
4045
4046 // Set CANDIDATE on all parents which are included in the GENERAL_COLLECTOR. This
4047 // algorithm is O(3n), whereas checking for the parent inclusion could potentially be O(n^2).
4048 for( int j = 0; j < aCollector.GetCount(); j++ )
4049 {
4050 if( aCollector[j]->GetParent() )
4051 aCollector[j]->GetParent()->ClearFlags( CANDIDATE );
4052
4053 if( aCollector[j]->GetParentFootprint() )
4054 aCollector[j]->GetParentFootprint()->ClearFlags( CANDIDATE );
4055 }
4056
4057 if( aMultiselect )
4058 {
4059 for( int j = 0; j < aCollector.GetCount(); j++ )
4060 aCollector[j]->SetFlags( CANDIDATE );
4061 }
4062
4063 for( int j = 0; j < aCollector.GetCount(); )
4064 {
4065 BOARD_ITEM* item = aCollector[j];
4066 FOOTPRINT* fp = item->GetParentFootprint();
4067 BOARD_ITEM* start = item;
4068
4069 if( !m_isFootprintEditor && fp )
4070 start = fp;
4071
4072 // If a group is entered, disallow selections of objects outside the group.
4074 {
4075 aCollector.Remove( item );
4076 continue;
4077 }
4078
4079 // If any element is a member of a group, replace those elements with the top containing
4080 // group.
4082 {
4083 if( top->AsEdaItem() != item )
4084 {
4085 toAdd.insert( top->AsEdaItem() );
4086 top->AsEdaItem()->SetFlags( CANDIDATE );
4087
4088 aCollector.Remove( item );
4089 continue;
4090 }
4091 }
4092
4093 // Footprints are a bit easier as they can't be nested.
4094 if( fp && ( fp->GetFlags() & CANDIDATE ) )
4095 {
4096 // Remove children of selected items
4097 aCollector.Remove( item );
4098 continue;
4099 }
4100
4101 ++j;
4102 }
4103
4104 for( EDA_ITEM* item : toAdd )
4105 {
4106 if( !aCollector.HasItem( item ) )
4107 aCollector.Append( item );
4108 }
4109}
4110
4111
4113{
4114 std::set<BOARD_ITEM*> to_add;
4115
4116 // Iterate from the back so we don't have to worry about removals.
4117 for( int i = (int) aCollector.GetCount() - 1; i >= 0; --i )
4118 {
4119 BOARD_ITEM* item = aCollector[i];
4120
4121 if( item->Type() == PCB_TABLECELL_T )
4122 {
4123 if( !aCollector.HasItem( item->GetParent() ) )
4124 to_add.insert( item->GetParent() );
4125
4126 aCollector.Remove( item );
4127 }
4128 }
4129
4130 for( BOARD_ITEM* item : to_add )
4131 aCollector.Append( item );
4132}
4133
4134
4136 bool aForcePromotion ) const
4137{
4138 std::set<BOARD_ITEM*> to_add;
4139
4140 // Iterate from the back so we don't have to worry about removals.
4141 for( int i = aCollector.GetCount() - 1; i >= 0; --i )
4142 {
4143 BOARD_ITEM* item = aCollector[i];
4144
4145 if( !m_isFootprintEditor && item->Type() == PCB_PAD_T
4146 && ( !frame()->GetPcbNewSettings()->m_AllowFreePads || aForcePromotion ) )
4147 {
4148 if( !aCollector.HasItem( item->GetParent() ) )
4149 to_add.insert( item->GetParent() );
4150
4151 aCollector.Remove( item );
4152 }
4153 }
4154
4155 for( BOARD_ITEM* item : to_add )
4156 aCollector.Append( item );
4157}
4158
4159
4161{
4162 // Iterate from the back so we don't have to worry about removals.
4163 for( int i = aCollector.GetCount() - 1; i >= 0; --i )
4164 {
4165 BOARD_ITEM* item = aCollector[i];
4166
4167 if( item->Type() == PCB_MARKER_T )
4168 aCollector.Remove( item );
4169 }
4170}
4171
4172
4174 const VECTOR2I& aWhere ) const
4175{
4176 const RENDER_SETTINGS* settings = getView()->GetPainter()->GetSettings();
4177 BOX2D viewport = getView()->GetViewport();
4178 BOX2I extents = BOX2ISafe( viewport );
4179
4180 bool need_direct_hit = false;
4181 FOOTPRINT* single_fp = nullptr;
4182
4183 // If the designer is not modifying the existing selection AND we already have
4184 // a selection, then we only want to select items that are directly under the cursor.
4185 // This prevents us from being unable to clear the selection when zoomed into a footprint
4186 if( !m_additive && !m_subtractive && !m_exclusive_or && m_selection.GetSize() > 0 )
4187 {
4188 need_direct_hit = true;
4189
4190 for( EDA_ITEM* item : m_selection )
4191 {
4192 FOOTPRINT* fp = nullptr;
4193
4194 if( item->Type() == PCB_FOOTPRINT_T )
4195 fp = static_cast<FOOTPRINT*>( item );
4196 else if( item->IsBOARD_ITEM() )
4197 fp = static_cast<BOARD_ITEM*>( item )->GetParentFootprint();
4198
4199 // If the selection contains items that are not footprints, then don't restrict
4200 // whether we deselect the item or not.
4201 if( !fp )
4202 {
4203 single_fp = nullptr;
4204 break;
4205 }
4206 else if( !single_fp )
4207 {
4208 single_fp = fp;
4209 }
4210 // If the selection contains items from multiple footprints, then don't restrict
4211 // whether we deselect the item or not.
4212 else if( single_fp != fp )
4213 {
4214 single_fp = nullptr;
4215 break;
4216 }
4217 }
4218 }
4219
4220 auto visibleLayers =
4221 [&]() -> LSET
4222 {
4224 {
4225 LSET set;
4226
4227 for( PCB_LAYER_ID layer : LSET::AllLayersMask() )
4228 set.set( layer, view()->IsLayerVisible( layer ) );
4229
4230 return set;
4231 }
4232 else
4233 {
4234 return board()->GetVisibleLayers();
4235 }
4236 };
4237
4238 LSET layers = visibleLayers();
4239
4240 if( settings->GetHighContrast() )
4241 {
4242 layers.reset();
4243
4244 const std::set<int> activeLayers = settings->GetHighContrastLayers();
4245
4246 for( int layer : activeLayers )
4247 {
4248 if( layer >= 0 && layer < PCB_LAYER_ID_COUNT )
4249 layers.set( layer );
4250 }
4251 }
4252
4253 // Iterate from the back so we don't have to worry about removals.
4254 for( int i = aCollector.GetCount() - 1; i >= 0; --i )
4255 {
4256 BOARD_ITEM* item = aCollector[i];
4257 FOOTPRINT* fp = dyn_cast<FOOTPRINT*>( item );
4258
4259 if( !fp )
4260 continue;
4261
4262 // Make footprints not difficult to select in high-contrast modes.
4263 if( layers[fp->GetLayer()] )
4264 continue;
4265
4266 BOX2I bbox = fp->GetLayerBoundingBox( layers );
4267
4268 // If the point clicked is not inside the visible bounding box, we can also remove it.
4269 if( !bbox.Contains( aWhere) )
4270 aCollector.Remove( item );
4271
4272 bool has_hit = false;
4273
4274 for( PCB_LAYER_ID layer : layers )
4275 {
4276 if( fp->HitTestOnLayer( extents, false, layer ) )
4277 {
4278 has_hit = true;
4279 break;
4280 }
4281 }
4282
4283 // If the point is outside of the visible bounding box, we can remove it.
4284 if( !has_hit )
4285 {
4286 aCollector.Remove( item );
4287 }
4288 // Do not require a direct hit on this fp if the existing selection only contains
4289 // this fp's items. This allows you to have a selection of pads from a single
4290 // footprint and still click in the center of the footprint to select it.
4291 else if( single_fp )
4292 {
4293 if( fp == single_fp )
4294 continue;
4295 }
4296 else if( need_direct_hit )
4297 {
4298 has_hit = false;
4299
4300 for( PCB_LAYER_ID layer : layers )
4301 {
4302 if( fp->HitTestOnLayer( aWhere, layer ) )
4303 {
4304 has_hit = true;
4305 break;
4306 }
4307 }
4308
4309 if( !has_hit )
4310 aCollector.Remove( item );
4311 }
4312 }
4313}
4314
4315
4317{
4318 getView()->Update( &m_selection );
4320
4321 return 0;
4322}
4323
4324
4326{
4327 std::set<std::pair<PCB_TABLE*, int>> columns;
4328 bool added = false;
4329
4330 for( EDA_ITEM* item : m_selection )
4331 {
4332 if( PCB_TABLECELL* cell = dynamic_cast<PCB_TABLECELL*>( item ) )
4333 {
4334 PCB_TABLE* table = static_cast<PCB_TABLE*>( cell->GetParent() );
4335 columns.insert( std::make_pair( table, cell->GetColumn() ) );
4336 }
4337 }
4338
4339 for( auto& [ table, col ] : columns )
4340 {
4341 for( int row = 0; row < table->GetRowCount(); ++row )
4342 {
4343 PCB_TABLECELL* cell = table->GetCell( row, col );
4344
4345 if( !cell->IsSelected() )
4346 {
4347 select( table->GetCell( row, col ) );
4348 added = true;
4349 }
4350 }
4351 }
4352
4353 if( added )
4354 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
4355
4356 return 0;
4357}
4358
4359
4361{
4362 std::set<std::pair<PCB_TABLE*, int>> rows;
4363 bool added = false;
4364
4365 for( EDA_ITEM* item : m_selection )
4366 {
4367 if( PCB_TABLECELL* cell = dynamic_cast<PCB_TABLECELL*>( item ) )
4368 {
4369 PCB_TABLE* table = static_cast<PCB_TABLE*>( cell->GetParent() );
4370 rows.insert( std::make_pair( table, cell->GetRow() ) );
4371 }
4372 }
4373
4374 for( auto& [ table, row ] : rows )
4375 {
4376 for( int col = 0; col < table->GetColCount(); ++col )
4377 {
4378 PCB_TABLECELL* cell = table->GetCell( row, col );
4379
4380 if( !cell->IsSelected() )
4381 {
4382 select( table->GetCell( row, col ) );
4383 added = true;
4384 }
4385 }
4386 }
4387
4388 if( added )
4389 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
4390
4391 return 0;
4392}
4393
4394
4396{
4397 std::set<PCB_TABLE*> tables;
4398 bool added = false;
4399
4400 for( EDA_ITEM* item : m_selection )
4401 {
4402 if( PCB_TABLECELL* cell = dynamic_cast<PCB_TABLECELL*>( item ) )
4403 tables.insert( static_cast<PCB_TABLE*>( cell->GetParent() ) );
4404 }
4405
4407
4408 for( PCB_TABLE* table : tables )
4409 {
4410 if( !table->IsSelected() )
4411 {
4412 select( table );
4413 added = true;
4414 }
4415 }
4416
4417 if( added )
4418 m_toolMgr->ProcessEvent( EVENTS::SelectedEvent );
4419
4420 return 0;
4421}
4422
4423
4425{
4427
4431
4438
4456
4461
4463}
int color
std::function< void(const VECTOR2I &, GENERAL_COLLECTOR &, PCB_SELECTION_TOOL *)> CLIENT_SELECTION_FILTER
Definition actions.h:37
constexpr EDA_IU_SCALE pcbIUScale
Definition base_units.h:112
constexpr BOX2I BOX2ISafe(const BOX2D &aInput)
Definition box2.h:929
BOX2< VECTOR2I > BOX2I
Definition box2.h:922
constexpr BOX2I KiROUND(const BOX2D &aBoxD)
Definition box2.h:990
BOX2< VECTOR2D > BOX2D
Definition box2.h:923
static TOOL_ACTION cancelInteractive
Definition actions.h:72
static TOOL_ACTION unselectAll
Definition actions.h:83
static TOOL_ACTION selectItem
Select an item (specified as the event parameter).
Definition actions.h:226
static TOOL_ACTION cursorLeft
Definition actions.h:171
static TOOL_ACTION zoomOutCenter
Definition actions.h:135
static TOOL_ACTION unselectItem
Definition actions.h:227
static TOOL_ACTION zoomIn
Definition actions.h:132
static TOOL_ACTION cursorLeftFast
Definition actions.h:176
static TOOL_ACTION selectionCursor
Select a single item under the cursor position.
Definition actions.h:216
static TOOL_ACTION selectSetLasso
Definition actions.h:220
static TOOL_ACTION selectSetRect
Set lasso selection mode.
Definition actions.h:219
static TOOL_ACTION groupEnter
Definition actions.h:242
static TOOL_ACTION selectColumns
Definition actions.h:102
static TOOL_ACTION cursorDown
Definition actions.h:170
static TOOL_ACTION zoomOut
Definition actions.h:133
static TOOL_ACTION cursorRightFast
Definition actions.h:177
static TOOL_ACTION zoomCenter
Definition actions.h:140
static TOOL_ACTION panDown
Definition actions.h:184
static TOOL_ACTION cursorDblClick
Definition actions.h:180
static TOOL_ACTION undo
Definition actions.h:75
static TOOL_ACTION selectionActivate
Activation of the selection tool.
Definition actions.h:213
static TOOL_ACTION cursorDownFast
Definition actions.h:175
static TOOL_ACTION selectionMenu
Run a selection menu to select from a list of items.
Definition actions.h:235
static TOOL_ACTION reselectItem
Definition actions.h:228
static TOOL_ACTION selectRows
Definition actions.h:101
static TOOL_ACTION cursorUpFast
Definition actions.h:174
static TOOL_ACTION panLeft
Definition actions.h:185
static TOOL_ACTION updateMenu
Definition actions.h:271
static TOOL_ACTION doDelete
Definition actions.h:85
static TOOL_ACTION selectionTool
Definition actions.h:250
static TOOL_ACTION cursorClick
Definition actions.h:179
static TOOL_ACTION zoomFitScreen
Definition actions.h:141
static TOOL_ACTION increment
Definition actions.h:94
static TOOL_ACTION selectionClear
Clear the current selection.
Definition actions.h:223
static TOOL_ACTION panUp
Definition actions.h:183
static TOOL_ACTION zoomFitObjects
Definition actions.h:142
static TOOL_ACTION zoomInCenter
Definition actions.h:134
static TOOL_ACTION panRight
Definition actions.h:186
static TOOL_ACTION selectTable
Definition actions.h:103
static TOOL_ACTION cursorUp
Cursor control with keyboard.
Definition actions.h:169
static TOOL_ACTION groupLeave
Definition actions.h:243
static TOOL_ACTION finishInteractive
Definition actions.h:73
static TOOL_ACTION cursorRight
Definition actions.h:172
static TOOL_ACTION selectAll
Definition actions.h:82
static TOOL_ACTION unselectItems
Definition actions.h:232
static TOOL_ACTION selectItems
Select a list of items (specified as the event parameter)
Definition actions.h:231
ACTION_MENU(bool isContextMenu, TOOL_INTERACTIVE *aTool=nullptr)
Default constructor.
void SetTitle(const wxString &aTitle) override
Set title for the menu.
wxMenuItem * Add(const wxString &aLabel, int aId, BITMAPS aIcon)
Add a wxWidgets-style entry to the menu.
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
BASE_SET & reset(size_t pos)
Definition base_set.h:143
BASE_SET & set(size_t pos)
Definition base_set.h:116
A base class derived from BOARD_ITEM for items that can be connected and have a net,...
static bool ClassOf(const EDA_ITEM *aItem)
Returns information if the object is derived from BOARD_CONNECTED_ITEM.
Tool for pcb inspection.
int ClearHighlight(const TOOL_EVENT &aEvent)
Perform the appropriate action in response to an Eeschema cross-probe.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition board_item.h:79
virtual PCB_LAYER_ID GetLayer() const
Return the primary layer this item is on.
Definition board_item.h:232
virtual bool IsConnected() const
Returns information if the object is derived from BOARD_CONNECTED_ITEM.
Definition board_item.h:134
bool IsLocked() const override
virtual VECTOR2I GetCenter() const
This defaults to the center of the bounding box if not overridden.
Definition board_item.h:112
virtual std::shared_ptr< SHAPE > GetEffectiveShape(PCB_LAYER_ID aLayer=UNDEFINED_LAYER, FLASHING aFlash=FLASHING::DEFAULT) const
Some pad shapes can be complex (rounded/chamfered rectangle), even without considering custom shapes.
FOOTPRINT * GetParentFootprint() const
virtual LSET GetLayerSet() const
Return a std::bitset of all layers on which the item physically resides.
Definition board_item.h:252
virtual void RunOnChildren(const std::function< void(BOARD_ITEM *)> &aFunction, RECURSE_MODE aMode) const
Invoke a function on all children.
Definition board_item.h:208
BOARD_ITEM_CONTAINER * GetParent() const
Definition board_item.h:210
virtual bool IsOnCopperLayer() const
Definition board_item.h:151
Information pertinent to a Pcbnew printed circuit board.
Definition board.h:322
INSPECT_RESULT Visit(INSPECTOR inspector, void *testData, const std::vector< KICAD_T > &scanTypes) override
May be re-implemented for each derived class in order to handle all the types given by its member dat...
Definition board.cpp:2123
bool IsElementVisible(GAL_LAYER_ID aLayer) const
Test whether a given element category is visible.
Definition board.cpp:990
const LSET & GetVisibleLayers() const
A proxy function that calls the correspondent function in m_BoardSettings.
Definition board.cpp:938
bool IsLayerVisible(PCB_LAYER_ID aLayer) const
A proxy function that calls the correspondent function in m_BoardSettings tests whether a given layer...
Definition board.cpp:930
std::shared_ptr< CONNECTIVITY_DATA > GetConnectivity() const
Return a list of missing connections between components/tracks.
Definition board.h:538
constexpr void SetMaximum()
Definition box2.h:80
constexpr BOX2< Vec > & Inflate(coord_type dx, coord_type dy)
Inflates the rectangle horizontally by dx and vertically by dy.
Definition box2.h:558
constexpr BOX2< Vec > & Normalize()
Ensure that the height and width are positive.
Definition box2.h:146
constexpr size_type GetWidth() const
Definition box2.h:214
constexpr Vec Centre() const
Definition box2.h:97
constexpr size_type GetHeight() const
Definition box2.h:215
constexpr bool Contains(const Vec &aPoint) const
Definition box2.h:168
constexpr const Vec & GetOrigin() const
Definition box2.h:210
constexpr const SizeVec & GetSize() const
Definition box2.h:206
CN_ANCHOR represents a physical location that can be connected: a pad or a track/arc/via endpoint.
bool Dirty() const
BOARD_CONNECTED_ITEM * Parent() const
CN_EDGE represents a point-to-point connection, whether realized or unrealized (ie: tracks etc.
virtual double OnePixelInIU() const =0
void Transfer(int aIndex)
Move the item at aIndex (first position is 0) to the backup list.
Definition collector.h:153
void Empty()
Clear the list.
Definition collector.h:91
ITER begin()
Definition collector.h:75
int GetCount() const
Return the number of objects in the list.
Definition collector.h:83
bool HasItem(const EDA_ITEM *aItem) const
Tests if aItem has already been collected.
Definition collector.h:197
void Remove(int aIndex)
Remove the item at aIndex (first position is 0).
Definition collector.h:111
ITER end()
Definition collector.h:76
void Append(EDA_ITEM *item)
Add an item to the end of the list.
Definition collector.h:101
int ShowModal() override
A set of EDA_ITEMs (i.e., without duplicates).
Definition eda_group.h:46
std::unordered_set< EDA_ITEM * > & GetItems()
Definition eda_group.h:54
virtual EDA_ITEM * AsEdaItem()=0
A base class for most all the KiCad significant classes used in schematics and boards.
Definition eda_item.h:98
virtual VECTOR2I GetPosition() const
Definition eda_item.h:272
virtual const BOX2I GetBoundingBox() const
Return the orthogonal bounding box of this object for display purposes.
Definition eda_item.cpp:110
void SetFlags(EDA_ITEM_FLAGS aMask)
Definition eda_item.h:142
virtual EDA_GROUP * GetParentGroup() const
Definition eda_item.h:116
KICAD_T Type() const
Returns the type of object.
Definition eda_item.h:110
void ClearSelected()
Definition eda_item.h:137
void ClearFlags(EDA_ITEM_FLAGS aMask=EDA_ITEM_ALL_FLAGS)
Definition eda_item.h:144
bool IsSelected() const
Definition eda_item.h:127
void SetSelected()
Definition eda_item.h:134
virtual bool IsType(const std::vector< KICAD_T > &aScanTypes) const
Check whether the item is one of the listed types.
Definition eda_item.h:192
void ClearBrightened()
Definition eda_item.h:138
void SetBrightened()
Definition eda_item.h:135
virtual bool HitTest(const VECTOR2I &aPosition, int aAccuracy=0) const
Test if aPosition is inside or on the boundary of this item.
Definition eda_item.h:233
EDA_ITEM * GetParent() const
Definition eda_item.h:112
bool HasFlag(EDA_ITEM_FLAGS aFlag) const
Definition eda_item.h:146
EDA_ITEM_FLAGS GetFlags() const
Definition eda_item.h:145
SHAPE_T GetShape() const
Definition eda_shape.h:168
const VECTOR2I & GetEnd() const
Return the ending point of the graphic.
Definition eda_shape.h:215
bool IsClosed() const
const VECTOR2I & GetStart() const
Return the starting point of the graphic.
Definition eda_shape.h:173
bool IsAnyFill() const
Definition eda_shape.h:112
virtual std::vector< SHAPE * > MakeEffectiveShapesForHitTesting() const
Definition eda_shape.h:384
virtual bool IsVisible() const
Definition eda_text.h:187
std::shared_ptr< SHAPE_COMPOUND > GetEffectiveTextShape(bool aTriangulate=true, const BOX2I &aBBox=BOX2I(), const EDA_ANGLE &aAngle=ANGLE_0) const
build a list of segments (SHAPE_SEGMENT) to describe a text shape.
static const TOOL_EVENT DisambiguatePoint
Used for hotkey feedback.
Definition actions.h:363
static const TOOL_EVENT ClearedEvent
Definition actions.h:348
static const TOOL_EVENT InhibitSelectionEditing
Definition actions.h:359
static const TOOL_EVENT SelectedEvent
Definition actions.h:346
static const TOOL_EVENT SelectedItemsModified
Selected items were moved, this can be very high frequency on the canvas, use with care.
Definition actions.h:353
static const TOOL_EVENT UninhibitSelectionEditing
Used to inform tool that it should display the disambiguation menu.
Definition actions.h:360
static const TOOL_EVENT PointSelectedEvent
Definition actions.h:345
static const TOOL_EVENT SelectedItemsMoved
Used to inform tools that the selection should temporarily be non-editable.
Definition actions.h:356
static const TOOL_EVENT UnselectedEvent
Definition actions.h:347
ZONES & Zones()
Definition footprint.h:230
PCB_POINTS & Points()
Definition footprint.h:236
static double GetCoverageArea(const BOARD_ITEM *aItem, const GENERAL_COLLECTOR &aCollector)
PCB_LAYER_ID GetSide() const
Use instead of IsFlipped() when you also need to account for unsided footprints (those purely on user...
const BOX2I GetLayerBoundingBox(const LSET &aLayers) const
Return the bounding box of the footprint on a given set of layers.
std::deque< PAD * > & Pads()
Definition footprint.h:224
PCB_LAYER_ID GetLayer() const override
Return the primary layer this item is on.
Definition footprint.h:257
bool IsFlipped() const
Definition footprint.h:434
SHAPE_POLY_SET GetBoundingHull() const
Return a bounding polygon for the shapes and pads in the footprint.
bool IsLocked() const override
Definition footprint.h:454
bool HitTestOnLayer(const VECTOR2I &aPosition, PCB_LAYER_ID aLayer, int aAccuracy=0) const
Test if the point hits one or more of the footprint elements on a given layer.
const KIID_PATH & GetPath() const
Definition footprint.h:284
DRAWINGS & GraphicalItems()
Definition footprint.h:227
const BOX2I GetBoundingBox() const override
Return the orthogonal bounding box of this object for display purposes.
A general implementation of a COLLECTORS_GUIDE.
Definition collectors.h:324
void SetIgnoreBlindBuriedVias(bool ignore)
Definition collectors.h:464
void SetIgnoreTracks(bool ignore)
Definition collectors.h:470
void SetIgnoreFootprintsOnFront(bool ignore)
Definition collectors.h:428
void SetIgnoreFPTextOnFront(bool ignore)
Definition collectors.h:416
void SetIgnoreMicroVias(bool ignore)
Definition collectors.h:467
void SetIgnoreZoneFills(bool ignore)
Definition collectors.h:473
void SetIgnorePadsOnBack(bool ignore)
Definition collectors.h:434
void SetIgnoreFPTextOnBack(bool ignore)
Definition collectors.h:410
void SetLayerVisibleBits(const LSET &aLayerBits)
Definition collectors.h:384
void SetIgnoreThroughVias(bool ignore)
Definition collectors.h:461
void SetIgnoreThroughHolePads(bool ignore)
Definition collectors.h:446
void SetIgnoreFPReferences(bool ignore)
Definition collectors.h:458
void SetIgnoreFPValues(bool ignore)
Definition collectors.h:452
void SetIgnorePadsOnFront(bool ignore)
Definition collectors.h:440
void SetIgnoreFootprintsOnBack(bool ignore)
Definition collectors.h:422
Used when the right click button is pressed, or when the select tool is in effect.
Definition collectors.h:207
void SetGuide(const COLLECTORS_GUIDE *aGuide)
Record which COLLECTORS_GUIDE to use.
Definition collectors.h:291
const COLLECTORS_GUIDE * GetGuide() const
Definition collectors.h:293
static const std::vector< KICAD_T > AllBoardItems
A scan list for all editable board items.
Definition collectors.h:41
void Collect(BOARD_ITEM *aItem, const std::vector< KICAD_T > &aScanList, const VECTOR2I &aRefPos, const COLLECTORS_GUIDE &aGuide)
Scan a BOARD_ITEM using this class's Inspector method, which does the collection.
static const std::vector< KICAD_T > FootprintItems
A scan list for primary footprint items.
Definition collectors.h:107
A color representation with 4 components: red, green, blue, alpha.
Definition color4d.h:104
virtual RENDER_SETTINGS * GetSettings()=0
Return a pointer to current settings that are going to be used when drawing items.
virtual void Update(const VIEW_ITEM *aItem, int aUpdateFlags) const override
For dynamic VIEWs, inform the associated VIEW that the graphical representation of this item has chan...
Definition pcb_view.cpp:91
virtual void Add(VIEW_ITEM *aItem, int aDrawPriority=-1) override
Add a VIEW_ITEM to the view.
Definition pcb_view.cpp:57
virtual void Remove(VIEW_ITEM *aItem) override
Remove a VIEW_ITEM from the view.
Definition pcb_view.cpp:74
Represent a selection area (currently a rectangle) in a VIEW, drawn corner-to-corner between two poin...
void SetMode(SELECTION_MODE aMode)
void SetSubtractive(bool aSubtractive)
SELECTION_MODE GetMode() const
void SetAdditive(bool aAdditive)
void SetPoly(SHAPE_LINE_CHAIN &aPoly)
void SetOrigin(const VECTOR2I &aOrigin)
const BOX2I ViewBBox() const override
Set the origin of the rectangle (the fixed corner)
SHAPE_LINE_CHAIN & GetPoly()
void SetExclusiveOr(bool aExclusiveOr)
void SetEnd(const VECTOR2I &aEnd)
Set the current end of the rectangle (the corner that moves with the cursor.
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
const std::set< int > & GetHighlightNetCodes() const
Return the netcode of currently highlighted net.
const std::set< int > GetHighContrastLayers() const
Returns the set of currently high-contrast layers.
virtual COLOR4D GetColor(const VIEW_ITEM *aItem, int aLayer) const =0
Returns the color that should be used to draw the specific VIEW_ITEM on the specific layer using curr...
void SetHighlight(bool aEnabled, int aNetcode=-1, bool aMulti=false)
Turns on/off highlighting.
virtual void SetCursorPosition(const VECTOR2D &aPosition, bool aWarpView=true, bool aTriggeredByArrows=false, long aArrowCommand=0)=0
Move cursor to the requested position expressed in world coordinates.
virtual void SetAutoPan(bool aEnabled)
Turn on/off auto panning (this feature is used when there is a tool active (eg.
An abstract base class for deriving all objects that can be added to a VIEW.
Definition view_item.h:86
bool IsBOARD_ITEM() const
Definition view_item.h:102
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition view.h:66
double GetScale() const
Definition view.h:276
BOX2D GetViewport() const
Return the current viewport visible area rectangle.
Definition view.cpp:530
virtual void SetScale(double aScale, VECTOR2D aAnchor={ 0, 0 })
Set the scaling factor, zooming around a given anchor point.
Definition view.cpp:570
virtual void Add(VIEW_ITEM *aItem, int aDrawPriority=-1)
Add a VIEW_ITEM to the view.
Definition view.cpp:298
virtual void Remove(VIEW_ITEM *aItem)
Remove a VIEW_ITEM from the view.
Definition view.cpp:341
void UpdateAllLayersColor()
Apply the new coloring scheme to all layers.
Definition view.cpp:775
int Query(const BOX2I &aRect, std::vector< LAYER_ITEM_PAIR > &aResult) const
Find all visible items that touch or are within the rectangle aRect.
Definition view.cpp:420
virtual void Update(const VIEW_ITEM *aItem, int aUpdateFlags) const
For dynamic VIEWs, inform the associated VIEW that the graphical representation of this item has chan...
Definition view.cpp:1685
void Hide(VIEW_ITEM *aItem, bool aHide=true, bool aHideOverlay=false)
Temporarily hide the item in the view (e.g.
Definition view.cpp:1633
bool IsLayerVisible(int aLayer) const
Return information about visibility of a particular layer.
Definition view.h:422
PAINTER * GetPainter() const
Return the painter object used by the view for drawing #VIEW_ITEMS.
Definition view.h:220
void MarkTargetDirty(int aTarget)
Set or clear target 'dirty' flag.
Definition view.h:639
void SetVisible(VIEW_ITEM *aItem, bool aIsVisible=true)
Set the item visibility.
Definition view.cpp:1612
wxString AsString() const
Definition kiid.cpp:356
LSEQ is a sequence (and therefore also a set) of PCB_LAYER_IDs.
Definition lseq.h:47
LSET is a set of PCB_LAYER_IDs.
Definition lset.h:37
static const LSET & FrontMask()
Return a mask holding all technical layers and the external CU layer on front side.
Definition lset.cpp:705
static const LSET & BackMask()
Return a mask holding all technical layers and the external CU layer on back side.
Definition lset.cpp:712
LSEQ Seq(const LSEQ &aSequence) const
Return an LSEQ from the union of this LSET and a desired sequence.
Definition lset.cpp:296
LSEQ SeqStackupTop2Bottom(PCB_LAYER_ID aSelectedLayer=UNDEFINED_LAYER) const
Generate a sequence of layers that represent a top to bottom stack of this set of layers.
Definition lset.cpp:326
static const LSET & AllLayersMask()
Definition lset.cpp:624
static LSET AllCuMask()
return AllCuMask( MAX_CU_LAYERS );
Definition lset.cpp:591
static const LSET & PhysicalLayersMask()
Return a mask holding all layers which are physically realized.
Definition lset.cpp:680
bool Contains(PCB_LAYER_ID aLayer) const
See if the layer set contains a PCB layer.
Definition lset.h:63
bool IsExcluded() const
Definition marker_base.h:93
const VECTOR2I & GetPos() const
Definition marker_base.h:83
void ShapeToPolygon(SHAPE_LINE_CHAIN &aPolygon, int aScale=-1) const
Return the shape polygon in internal units in a SHAPE_LINE_CHAIN the coordinates are relatives to the...
Handle the data for a net.
Definition netinfo.h:54
Definition pad.h:54
static TOOL_ACTION deleteLastPoint
static TOOL_ACTION drag45Degree
static TOOL_ACTION unrouteSelected
Removes all tracks from the selected items to the first pad.
Definition pcb_actions.h:76
static TOOL_ACTION saveToLinkedDesignBlock
static TOOL_ACTION grabUnconnected
Select and move nearest unconnected footprint from ratsnest of selection.
Definition pcb_actions.h:91
static TOOL_ACTION filterSelection
Filter the items in the current selection (invokes dialog)
static TOOL_ACTION highlightNet
static TOOL_ACTION hideLocalRatsnest
static TOOL_ACTION properties
Activation of the edit tool.
static TOOL_ACTION selectOnSheetFromEeschema
Select all components on sheet from Eeschema crossprobing.
Definition pcb_actions.h:94
static TOOL_ACTION selectConnection
Select tracks between junctions or expands an existing selection to pads or the entire connection.
Definition pcb_actions.h:73
static TOOL_ACTION applyDesignBlockLayout
static TOOL_ACTION dragFreeAngle
static TOOL_ACTION clearHighlight
static TOOL_ACTION selectUnconnected
Select unconnected footprints from ratsnest of selection.
Definition pcb_actions.h:88
static TOOL_ACTION unrouteSegment
Removes track segment from the selected item to the next segment.
Definition pcb_actions.h:79
static TOOL_ACTION moveIndividually
move items one-by-one
static TOOL_ACTION syncSelection
Sets selection to specified items, zooms to fit, if enabled.
Definition pcb_actions.h:63
static TOOL_ACTION selectSameSheet
Select all components on the same sheet as the selected footprint.
Definition pcb_actions.h:97
static TOOL_ACTION selectNet
Select all connections belonging to a single net.
Definition pcb_actions.h:82
static TOOL_ACTION move
move or drag an item
static TOOL_ACTION syncSelectionWithNets
Sets selection to specified items with connected nets, zooms to fit, if enabled.
Definition pcb_actions.h:66
static TOOL_ACTION deselectNet
Remove all connections belonging to a single net from the active selection.
Definition pcb_actions.h:85
static TOOL_ACTION placeLinkedDesignBlock
static TOOL_ACTION selectOnSchematic
Select symbols/pins on schematic corresponding to selected footprints/pads.
Common, abstract interface for edit frames.
Base PCB main window class for Pcbnew, Gerbview, and CvPcb footprint viewer.
const PCB_DISPLAY_OPTIONS & GetDisplayOptions() const
Display options control the way tracks, vias, outlines and other things are shown (for instance solid...
double m_TrackOpacity
Opacity override for all tracks.
double m_FilledShapeOpacity
Opacity override for graphic shapes.
double m_ZoneOpacity
Opacity override for filled zone areas.
double m_ImageOpacity
Opacity override for user images.
double m_PadOpacity
Opacity override for SMD pads and PTHs.
double m_ViaOpacity
Opacity override for all types of via.
ZONE_DISPLAY_MODE m_ZoneDisplayMode
virtual KIGFX::PCB_VIEW * GetView() const override
Return a pointer to the #VIEW instance used in the panel.
bool IsReference() const
Definition pcb_field.h:68
bool IsValue() const
Definition pcb_field.h:69
A set of BOARD_ITEMs (i.e., without duplicates).
Definition pcb_group.h:53
static bool WithinScope(BOARD_ITEM *aItem, PCB_GROUP *aScope, bool isFootprintEditor)
static EDA_GROUP * TopLevelGroup(BOARD_ITEM *aItem, EDA_GROUP *aScope, bool isFootprintEditor)
Tool that displays edit points allowing to modify items by dragging the points.
bool HasPoint()
Indicate the cursor is over an edit point.
A PCB_POINT is a 0-dimensional point that is used to mark a position on a PCB, or more usually a foot...
Definition pcb_point.h:43
Private implementation of firewalled private data.
DIALOG_FILTER_SELECTION::OPTIONS m_filterOpts
The selection tool: currently supports:
void highlight(EDA_ITEM *aItem, int aHighlightMode, SELECTION *aGroup=nullptr) override
Highlight the item visually.
int syncSelectionWithNets(const TOOL_EVENT &aEvent)
int SelectTable(const TOOL_EVENT &aEvent)
Clear current selection event handler.
PCB_BASE_FRAME * frame() const
int syncSelection(const TOOL_EVENT &aEvent)
int selectNet(const TOOL_EVENT &aEvent)
Select all copper connections belonging to the same net(s) as the items in the selection.
int filterSelection(const TOOL_EVENT &aEvent)
Return true if the given item passes the current SELECTION_FILTER_OPTIONS.
void Reset(RESET_REASON aReason) override
Bring the tool to a known, initial state.
void ZoomFitCrossProbeBBox(const BOX2I &bbox)
void EnterGroup() override
Enter the group at the head of the current selection.
void doSyncSelection(const std::vector< BOARD_ITEM * > &aItems, bool aWithNets)
Invoke filter dialog and modify current selection.
SELECTION_MODE m_selectionMode
void GuessSelectionCandidates(GENERAL_COLLECTOR &aCollector, const VECTOR2I &aWhere) const
Try to guess best selection candidates in case multiple items are clicked, by doing some brain-dead h...
void ExitGroup(bool aSelectGroup=false) override
Leave the currently-entered group.
bool isExpandableGraphicShape(const EDA_ITEM *aItem) const
int disambiguateCursor(const TOOL_EVENT &aEvent)
Handle disambiguation actions including displaying the menu.
int SelectPolyArea(const TOOL_EVENT &aEvent)
Handles drawing a lasso selection area that allows multiple items to be selected simultaneously.
void FilterCollectorForMarkers(GENERAL_COLLECTOR &aCollector) const
Drop any PCB_MARKERs from the collector.
int UnselectAll(const TOOL_EVENT &aEvent)
Change the selection mode.
void unhighlightInternal(EDA_ITEM *aItem, int aHighlightMode, bool aUsingOverlay)
bool selectionContains(const VECTOR2I &aPoint) const
void select(EDA_ITEM *aItem) override
Take necessary action mark an item as selected.
bool selectCursor(bool aForceSelect=false, CLIENT_SELECTION_FILTER aClientFilter=nullptr)
Select an item under the cursor unless there is something already selected.
int SetSelectPoly(const TOOL_EVENT &aEvent)
int SetSelectRect(const TOOL_EVENT &aEvent)
int SelectColumns(const TOOL_EVENT &aEvent)
std::unique_ptr< PRIV > m_priv
int unrouteSelected(const TOOL_EVENT &aEvent)
Unroute the selected board connected items.
int unrouteSegment(const TOOL_EVENT &aEvent)
Unroute the selected track connected item.
SELECTION & selection() override
Return a reference to the selection.
int grabUnconnected(const TOOL_EVENT &aEvent)
Select and move other nearest footprint unconnected on same net as selected items.
PCB_SELECTION & RequestSelection(CLIENT_SELECTION_FILTER aClientFilter)
Return the current selection, filtered according to aClientFilter.
void FilterCollectorForFreePads(GENERAL_COLLECTOR &aCollector, bool aForcePromotion=false) const
Check the "allow free pads" setting and if disabled, replace any pads in the collector with their par...
bool itemPassesFilter(BOARD_ITEM *aItem, bool aMultiSelect, PCB_SELECTION_FILTER_OPTIONS *aRejected=nullptr)
const GENERAL_COLLECTORS_GUIDE getCollectorsGuide() const
bool Selectable(const BOARD_ITEM *aItem, bool checkVisibilityOnly=false) const
bool selectPoint(const VECTOR2I &aWhere, bool aOnDrag=false, bool *aSelectionCancelledFlag=nullptr, CLIENT_SELECTION_FILTER aClientFilter=nullptr)
Select an item pointed by the parameter aWhere.
KIGFX::PCB_VIEW * view() const
void selectAllItemsOnSheet(wxString &aSheetPath)
Select all items with the given sheet timestamp/UUID name (the sheet path).
void FilterCollectorForHierarchy(GENERAL_COLLECTOR &aCollector, bool aMultiselect) const
In general we don't want to select both a parent and any of it's children.
void SelectMultiple(KIGFX::PREVIEW::SELECTION_AREA &aArea, bool aSubtractive=false, bool aExclusiveOr=false)
Selects multiple PCB items within a specified area.
void setTransitions() override
Zoom the screen to center and fit the current selection.
PCB_BASE_EDIT_FRAME * editFrame() const
int expandConnection(const TOOL_EVENT &aEvent)
Expand the current connected-item selection to the next boundary (junctions, pads,...
int selectUnconnected(const TOOL_EVENT &aEvent)
Select nearest unconnected footprints on same net as selected items.
virtual bool ctrlClickHighlights() override
Determine if ctrl-click is highlight net or XOR selection.
int selectSheetContents(const TOOL_EVENT &aEvent)
Select all footprints belonging to same hierarchical sheet as the selected footprint (same sheet path...
int SelectRows(const TOOL_EVENT &aEvent)
int selectSameSheet(const TOOL_EVENT &aEvent)
Set selection to items passed by parameter and connected nets (optionally).
void zoomFitSelection()
Zoom the screen to fit the bounding box for cross probing/selection sync.
void selectAllConnectedTracks(const std::vector< BOARD_CONNECTED_ITEM * > &aStartItems, STOP_CONDITION aStopCondition)
Select connected tracks and vias.
int CursorSelection(const TOOL_EVENT &aEvent)
int ClearSelection(const TOOL_EVENT &aEvent)
void highlightInternal(EDA_ITEM *aItem, int aHighlightMode, bool aUsingOverlay)
PCB_BASE_FRAME * m_frame
PCB_SELECTION_FILTER_OPTIONS m_filter
PCB_SELECTION & GetSelection()
@ STOP_AT_SEGMENT
Stop when reaching a segment (next track/arc/via).
@ STOP_AT_PAD
Stop when reaching a pad.
@ STOP_NEVER
Select the entire net.
@ STOP_AT_JUNCTION
Stop at any place where more than two traces meet.
int Main(const TOOL_EVENT &aEvent)
The main loop.
void RebuildSelection()
Rebuild the selection from the EDA_ITEMs' selection flags.
void pruneObscuredSelectionCandidates(GENERAL_COLLECTOR &aCollector) const
void OnIdle(wxIdleEvent &aEvent)
PCB_DRAW_PANEL_GAL * canvas() const
void FilterCollectorForFootprints(GENERAL_COLLECTOR &aCollector, const VECTOR2I &aWhere) const
Drop footprints that are not directly selected.
void FindItem(BOARD_ITEM *aItem)
Take necessary actions to mark an item as found.
void FilterCollectorForLockedItems(GENERAL_COLLECTOR &aCollector)
In the PCB editor strip out any locked items unless the OverrideLocks checkbox is set.
int SelectRectArea(const TOOL_EVENT &aEvent)
Handles drawing a selection box that allows multiple items to be selected simultaneously.
int updateSelection(const TOOL_EVENT &aEvent)
Event handler to update the selection VIEW_ITEM.
bool Init() override
Init() is called once upon a registration of the tool.
KIGFX::VIEW_GROUP m_enteredGroupOverlay
void selectConnections(const std::vector< BOARD_ITEM * > &aItems)
int hitTestDistance(const VECTOR2I &aWhere, BOARD_ITEM *aItem, int aMaxDistance) const
void selectAllConnectedShapes(const std::vector< PCB_SHAPE * > &aStartItems)
Select all non-closed shapes that are graphically connected to the given start items.
void SelectAllItemsOnNet(int aNetCode, bool aSelect=true)
Select all items with the given net code.
void FilterCollectorForTableCells(GENERAL_COLLECTOR &aCollector) const
Promote any table cell selections to the whole table.
void unselect(EDA_ITEM *aItem) override
Take necessary action mark an item as unselected.
int SelectAll(const TOOL_EVENT &aEvent)
Unselect all items on the board.
void FilterCollectedItems(GENERAL_COLLECTOR &aCollector, bool aMultiSelect, PCB_SELECTION_FILTER_OPTIONS *aRejected=nullptr)
Apply the SELECTION_FITLER_OPTIONS to the collector.
bool selectTableCells(PCB_TABLE *aTable)
void unhighlight(EDA_ITEM *aItem, int aHighlightMode, SELECTION *aGroup=nullptr) override
Unhighlight the item visually.
virtual LSET GetLayerSet() const override
Return a std::bitset of all layers on which the item physically resides.
std::vector< VECTOR2I > GetConnectionPoints() const
int GetRowSpan() const
int GetColSpan() const
std::vector< PCB_TABLECELL * > GetCells() const
Definition pcb_table.h:159
virtual LSET GetLayerSet() const override
Return a std::bitset of all layers on which the item physically resides.
const VECTOR2I & GetStart() const
Definition pcb_track.h:154
const VECTOR2I & GetEnd() const
Definition pcb_track.h:151
A small class to help profiling.
Definition profile.h:49
void Start()
Start or restart the counter.
Definition profile.h:77
double msecs(bool aSinceLast=false)
Definition profile.h:149
bool RoutingInProgress()
Returns whether routing is currently active.
Definition seg.h:42
static SEG::ecoord Square(int a)
Definition seg.h:123
static SELECTION_CONDITION HasType(KICAD_T aType)
Create a functor that tests if among the selected items there is at least one of a given type.
static bool NotEmpty(const SELECTION &aSelection)
Test if there are any items selected.
static SELECTION_CONDITION MoreThan(int aNumber)
Create a functor that tests if the number of selected items is greater than the value given as parame...
static SELECTION_CONDITION Count(int aNumber)
Create a functor that tests if the number of selected items is equal to the value given as parameter.
static SELECTION_CONDITION OnlyTypes(std::vector< KICAD_T > aTypes)
Create a functor that tests if the selected items are only of given types.
bool m_multiple
Multiple selection mode is active.
int RemoveItemFromSel(const TOOL_EVENT &aEvent)
bool doSelectionMenu(COLLECTOR *aCollector)
wxTimer m_disambiguateTimer
Timer to show the disambiguate menu.
bool m_drag_additive
Add multiple items to selection.
bool m_exclusive_or
Items' selection state should be toggled.
int AddItemsToSel(const TOOL_EVENT &aEvent)
int AddItemToSel(const TOOL_EVENT &aEvent)
int UpdateMenu(const TOOL_EVENT &aEvent)
Update a menu's state based on the current selection.
void setModifiersState(bool aShiftState, bool aCtrlState, bool aAltState)
Set the configuration of m_additive, m_subtractive, m_exclusive_or, m_skip_heuristics from the state ...
VECTOR2I m_originalCursor
Location of original cursor when starting click.
int SelectionMenu(const TOOL_EVENT &aEvent)
Show a popup menu to trim the COLLECTOR passed as aEvent's parameter down to a single item.
int RemoveItemsFromSel(const TOOL_EVENT &aEvent)
bool m_subtractive
Items should be removed from selection.
SELECTION_TOOL(const std::string &aName)
bool m_highlight_modifier
Select highlight net on left click.
bool m_skip_heuristics
Show disambiguation menu for all items under the cursor rather than trying to narrow them down first ...
int ReselectItem(const TOOL_EVENT &aEvent)
bool m_drag_subtractive
Remove multiple from selection.
bool m_additive
Items should be added to sel (instead of replacing).
bool hasModifier()
True if a selection modifier is enabled, false otherwise.
bool m_canceledMenu
Sets to true if the disambiguation menu was canceled.
void onDisambiguationExpire(wxTimerEvent &aEvent)
Start the process to show our disambiguation menu once the user has kept the mouse down for the minim...
virtual void Add(EDA_ITEM *aItem)
Definition selection.cpp:42
virtual void Remove(EDA_ITEM *aItem)
Definition selection.cpp:60
void ClearReferencePoint()
ACTION_MENU * create() const override
Return an instance of this class. It has to be overridden in inheriting classes.
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
void Move(const VECTOR2I &aVector) override
void GenerateBBoxCache() const
void SetClosed(bool aClosed)
Mark the line chain as closed (i.e.
int PointCount() const
Return the number of points (vertices) in this line chain.
virtual bool Collide(const VECTOR2I &aP, int aClearance=0, int *aActual=nullptr, VECTOR2I *aLocation=nullptr) const override
Check if point aP lies closer to us than aClearance.
double Area(bool aAbsolute=true) const
Return the area of this chain.
virtual size_t GetPointCount() const override
void Append(int aX, int aY, bool aAllowDuplication=false)
Append a new point at the end of the line chain.
const VECTOR2I & CLastPoint() const
Return the last point in the line chain.
void Remove(int aStartIndex, int aEndIndex)
Remove the range of points [start_index, end_index] from the line chain.
bool Collide(const SHAPE *aShape, int aClearance=0, int *aActual=nullptr, VECTOR2I *aLocation=nullptr) const override
Check if the boundary of shape (this) lies closer to the shape aShape than aClearance,...
virtual bool Collide(const VECTOR2I &aP, int aClearance=0, int *aActual=nullptr, VECTOR2I *aLocation=nullptr) const
Check if the boundary of shape (this) lies closer to the point aP than aClearance,...
Definition shape.h:181
bool ToolStackIsEmpty()
Represent a single user action.
T * getEditFrame() const
Return the application window object, casted to requested user type.
Definition tool_base.h:186
T * getModel() const
Return the model object if it matches the requested type.
Definition tool_base.h:198
KIGFX::VIEW_CONTROLS * getViewControls() const
Return the instance of VIEW_CONTROLS object used in the application.
Definition tool_base.cpp:44
TOOL_MANAGER * m_toolMgr
Definition tool_base.h:220
KIGFX::VIEW * getView() const
Returns the instance of #VIEW object used in the application.
Definition tool_base.cpp:38
bool IsToolActive() const
Definition tool_base.cpp:32
RESET_REASON
Determine the reason of reset for a tool.
Definition tool_base.h:78
@ REDRAW
Full drawing refresh.
Definition tool_base.h:83
@ MODEL_RELOAD
Model changes (the sheet for a schematic)
Definition tool_base.h:80
Generic, UI-independent tool event.
Definition tool_event.h:171
bool IsAction(const TOOL_ACTION *aAction) const
Test if the event contains an action issued upon activation of the given TOOL_ACTION.
T Parameter() const
Return a parameter assigned to the event.
Definition tool_event.h:473
void SetPassEvent(bool aPass=true)
Definition tool_event.h:256
void Go(int(T::*aStateFunc)(const TOOL_EVENT &), const TOOL_EVENT_LIST &aConditions=TOOL_EVENT(TC_ANY, TA_ANY))
Define which state (aStateFunc) to go when a certain event arrives (aConditions).
std::unique_ptr< TOOL_MENU > m_menu
The functions below are not yet implemented - their interface may change.
TOOL_EVENT * Wait(const TOOL_EVENT_LIST &aEventList=TOOL_EVENT(TC_ANY, TA_ANY))
Suspend execution of the tool until an event specified in aEventList arrives.
Handle a list of polygons defining a copper zone.
Definition zone.h:74
bool GetIsRuleArea() const
Accessors to parameters used in Rule Area zones:
Definition zone.h:704
bool HitTestForCorner(const VECTOR2I &refPos, int aAccuracy, SHAPE_POLY_SET::VERTEX_INDEX *aCornerHit=nullptr) const
Test if the given VECTOR2I is near a corner.
Definition zone.cpp:713
bool HitTestForEdge(const VECTOR2I &refPos, int aAccuracy, SHAPE_POLY_SET::VERTEX_INDEX *aCornerHit=nullptr) const
Test if the given VECTOR2I is near a segment defined by 2 corners.
Definition zone.cpp:720
bool IsTeardropArea() const
Definition zone.h:679
virtual LSET GetLayerSet() const override
Return a std::bitset of all layers on which the item physically resides.
Definition zone.h:136
bool GetDoNotAllowZoneFills() const
Definition zone.h:719
A type-safe container of any type.
Definition ki_any.h:93
MOUSE_DRAG_ACTION
#define EXCLUDE_ZONES
#define IGNORE_NETS
Function GetConnectedItems() Returns a list of items connected to a source item aItem.
KICURSOR
Definition cursors.h:44
@ SUBTRACT
Definition cursors.h:72
@ SELECT_WINDOW
Definition cursors.h:86
@ SELECT_LASSO
Definition cursors.h:88
@ MOVING
Definition cursors.h:48
@ ARROW
Definition cursors.h:46
#define DEFAULT_TEXT_SIZE
Ratio of the font height to the baseline of the text above the wire.
static bool empty(const wxTextEntryBase *aCtrl)
#define _(s)
@ RECURSE
Definition eda_item.h:51
std::function< INSPECT_RESULT(EDA_ITEM *aItem, void *aTestData) > INSPECTOR_FUNC
Used to inspect and possibly collect the (search) results of iterating over a list or tree of KICAD_T...
Definition eda_item.h:88
#define BRIGHTENED
item is drawn with a bright contour
#define IS_NEW
New item, just created.
#define SELECTED
Item was manually selected by the user.
#define ENTERED
indicates a group has been entered
#define SKIP_STRUCT
flag indicating that the structure should be ignored
#define CANDIDATE
flag indicating that the structure is connected
#define IS_MOVING
Item being moved.
@ SEGMENT
Definition eda_shape.h:45
@ FRAME_PCB_EDITOR
Definition frame_type.h:42
@ FRAME_FOOTPRINT_VIEWER
Definition frame_type.h:45
@ FRAME_FOOTPRINT_EDITOR
Definition frame_type.h:43
a few functions useful in geometry calculations.
double m_PcbSelectionVisibilityRatio
Board object selection visibility limit.
@ LAYER_POINTS
PCB reference/manual snap points visibility.
Definition layer_ids.h:321
@ LAYER_FOOTPRINTS_FR
Show footprints on front.
Definition layer_ids.h:259
@ LAYER_DRAW_BITMAPS
Draw images.
Definition layer_ids.h:284
@ LAYER_FP_REFERENCES
Show footprints references (when texts are visible).
Definition layer_ids.h:266
@ LAYER_DRC_EXCLUSION
Layer for DRC markers which have been individually excluded.
Definition layer_ids.h:304
@ LAYER_ZONES
Control for copper zone opacity/visibility (color ignored).
Definition layer_ids.h:295
@ LAYER_PADS
Meta control for all pads opacity/visibility (color ignored).
Definition layer_ids.h:292
@ LAYER_TRACKS
Definition layer_ids.h:267
@ LAYER_FP_TEXT
Definition layer_ids.h:240
@ LAYER_FOOTPRINTS_BK
Show footprints on back.
Definition layer_ids.h:260
@ LAYER_FP_VALUES
Show footprints values (when texts are visible).
Definition layer_ids.h:263
@ LAYER_VIAS
Meta control for all vias opacity/visibility.
Definition layer_ids.h:232
PCB_LAYER_ID
A quick note on layer IDs:
Definition layer_ids.h:60
@ F_CrtYd
Definition layer_ids.h:116
@ Edge_Cuts
Definition layer_ids.h:112
@ F_SilkS
Definition layer_ids.h:100
@ B_CrtYd
Definition layer_ids.h:115
@ UNDEFINED_LAYER
Definition layer_ids.h:61
@ B_SilkS
Definition layer_ids.h:101
@ PCB_LAYER_ID_COUNT
Definition layer_ids.h:171
PCB_LAYER_ID ToLAYER_ID(int aLayer)
Definition lset.cpp:737
This file contains miscellaneous commonly used macros and functions.
#define KI_FALLTHROUGH
The KI_FALLTHROUGH macro is to be used when switch statement cases should purposely fallthrough from ...
Definition macros.h:83
bool BoxHitTest(const VECTOR2I &aHitPoint, const BOX2I &aHittee, int aAccuracy)
Perform a point-to-box hit test.
@ REPAINT
Item needs to be redrawn.
Definition view_item.h:58
@ TARGET_OVERLAY
Items that may change while the view stays the same (noncached)
Definition definitions.h:39
STL namespace.
@ NPTH
like PAD_PTH, but not plated mechanical use only, no connection allowed
Definition padstack.h:87
@ PTH
Plated through hole pad.
Definition padstack.h:82
void connectedItemFilter(const VECTOR2I &, GENERAL_COLLECTOR &aCollector, PCB_SELECTION_TOOL *sTool)
static void passEvent(TOOL_EVENT *const aEvent, const TOOL_ACTION *const aAllowedActions[])
static bool itemIsIncludedByFilter(const BOARD_ITEM &aItem, const BOARD &aBoard, const DIALOG_FILTER_SELECTION::OPTIONS &aFilterOptions)
Determine if an item is included by the filter specified.
TRACK_DRAG_ACTION
CITER next(CITER it)
Definition ptree.cpp:124
Class that computes missing connections on a PCB.
static float distance(const SFVEC2UI &a, const SFVEC2UI &b)
static std::vector< KICAD_T > tableCellTypes
const TOOL_ACTION * allowedActions[]
static void passEvent(TOOL_EVENT *const aEvent, const TOOL_ACTION *const aAllowedActions[])
SELECTION_MODE
const int scale
Struct that will be set with the result of the user choices in the dialog.
const BOARD_ITEM * m_Item
This file contains data structures that are saved in the project file or project local settings file ...
bool otherItems
Anything not fitting one of the above categories.
bool graphics
Graphic lines, shapes, polygons.
bool footprints
Allow selecting entire footprints.
bool text
Text (free or attached to a footprint)
bool lockedItems
Allow selecting locked items.
const int accuracy
int delta
@ TA_MOUSE_UP
Definition tool_event.h:69
@ TA_MOUSE_WHEEL
Definition tool_event.h:73
@ TC_ANY
Definition tool_event.h:60
@ MD_ALT
Definition tool_event.h:145
@ MD_CTRL
Definition tool_event.h:144
@ MD_SHIFT
Definition tool_event.h:143
@ BUT_MIDDLE
Definition tool_event.h:134
@ BUT_LEFT
Definition tool_event.h:132
@ BUT_RIGHT
Definition tool_event.h:133
KICAD_T
The set of class identification values stored in EDA_ITEM::m_structType.
Definition typeinfo.h:78
@ PCB_SHAPE_T
class PCB_SHAPE, a segment not on copper layers
Definition typeinfo.h:88
@ PCB_DIM_ORTHOGONAL_T
class PCB_DIM_ORTHOGONAL, a linear dimension constrained to x/y
Definition typeinfo.h:106
@ PCB_DIM_LEADER_T
class PCB_DIM_LEADER, a leader dimension (graphic item)
Definition typeinfo.h:103
@ PCB_GENERATOR_T
class PCB_GENERATOR, generator on a layer
Definition typeinfo.h:91
@ PCB_VIA_T
class PCB_VIA, a via (like a track segment on a copper layer)
Definition typeinfo.h:97
@ TYPE_NOT_INIT
Definition typeinfo.h:81
@ PCB_DIM_CENTER_T
class PCB_DIM_CENTER, a center point marking (graphic item)
Definition typeinfo.h:104
@ PCB_GROUP_T
class PCB_GROUP, a set of BOARD_ITEMs
Definition typeinfo.h:111
@ PCB_TEXTBOX_T
class PCB_TEXTBOX, wrapped text on a layer
Definition typeinfo.h:93
@ PCB_ZONE_T
class ZONE, a copper pour area
Definition typeinfo.h:108
@ PCB_TEXT_T
class PCB_TEXT, text on a layer
Definition typeinfo.h:92
@ PCB_REFERENCE_IMAGE_T
class PCB_REFERENCE_IMAGE, bitmap on a layer
Definition typeinfo.h:89
@ PCB_FIELD_T
class PCB_FIELD, text associated with a footprint property
Definition typeinfo.h:90
@ NOT_USED
the 3d code uses this value
Definition typeinfo.h:79
@ PCB_MARKER_T
class PCB_MARKER, a marker used to show something
Definition typeinfo.h:99
@ PCB_BARCODE_T
class PCB_BARCODE, a barcode (graphic item)
Definition typeinfo.h:101
@ PCB_TARGET_T
class PCB_TARGET, a target (graphic item)
Definition typeinfo.h:107
@ PCB_TABLECELL_T
class PCB_TABLECELL, PCB_TEXTBOX for use in tables
Definition typeinfo.h:95
@ PCB_FOOTPRINT_T
class FOOTPRINT, a footprint
Definition typeinfo.h:86
@ PCB_DIM_ALIGNED_T
class PCB_DIM_ALIGNED, a linear dimension (graphic item)
Definition typeinfo.h:102
@ PCB_PAD_T
class PAD, a pad in a footprint
Definition typeinfo.h:87
@ PCB_ARC_T
class PCB_ARC, an arc track segment on a copper layer
Definition typeinfo.h:98
@ PCB_TABLE_T
class PCB_TABLE, table of PCB_TABLECELLs
Definition typeinfo.h:94
@ PCB_NETINFO_T
class NETINFO_ITEM, a description of a net
Definition typeinfo.h:110
@ PCB_POINT_T
class PCB_POINT, a 0-dimensional point
Definition typeinfo.h:113
@ PCB_TRACE_T
class PCB_TRACK, a track segment (segment on a copper layer)
Definition typeinfo.h:96
@ PCB_DIM_RADIAL_T
class PCB_DIM_RADIAL, a radius or diameter dimension
Definition typeinfo.h:105
Casted dyn_cast(From aObject)
A lightweight dynamic downcast.
Definition typeinfo.h:61
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:695
VECTOR2< double > VECTOR2D
Definition vector2d.h:694
VECTOR2D ToVECTOR2D(const wxPoint &aPoint)
Definition vector2wx.h:40