KiCad PCB EDA Suite
Loading...
Searching...
No Matches
collectors.h
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) 2007-2008 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
5 * Copyright (C) 2004-2023 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, you may find one here:
19 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20 * or you may search the http://www.gnu.org website for the version 2 license,
21 * or you may write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 */
24
25#ifndef COLLECTORS_H
26#define COLLECTORS_H
27
28/*
29 * This module contains a number of COLLECTOR implementations which are used
30 * to augment the functionality of class PCB_EDIT_FRAME.
31 */
32
33#include <collector.h>
34#include <layer_ids.h> // LAYER_COUNT, layer defs
35#include <view/view.h>
36#include <board_item.h>
37
53{
54public:
55 virtual ~COLLECTORS_GUIDE() {}
56
60 virtual bool IsLayerVisible( PCB_LAYER_ID layer ) const = 0;
61
65 virtual PCB_LAYER_ID GetPreferredLayer() const = 0;
66
70 virtual bool IgnoreLockedItems() const = 0;
71
77 virtual bool IncludeSecondary() const = 0;
78
82 virtual bool IgnoreHiddenFPText() const = 0;
83
87 virtual bool IgnoreFPTextOnBack() const = 0;
88
92 virtual bool IgnoreFPTextOnFront() const = 0;
93
97 virtual bool IgnoreFootprintsOnBack() const = 0;
98
102 virtual bool IgnoreFootprintsOnFront() const = 0;
103
107 virtual bool IgnorePadsOnBack() const = 0;
108
112 virtual bool IgnorePadsOnFront() const = 0;
113
117 virtual bool IgnoreThroughHolePads() const = 0;
118
122 virtual bool IgnorePads() const
123 {
125 }
126
130 virtual bool IgnoreFPValues() const = 0;
131
135 virtual bool IgnoreFPReferences() const = 0;
136
140 virtual bool IgnoreThroughVias() const = 0;
141
145 virtual bool IgnoreBlindBuriedVias() const = 0;
146
150 virtual bool IgnoreMicroVias() const = 0;
151
155 virtual bool IgnoreTracks() const = 0;
156
160 virtual bool IgnoreZoneFills() const = 0;
161
162 virtual int Accuracy() const = 0;
163
164 virtual double OnePixelInIU() const = 0;
165};
166
167
168
179{
180public:
187 BOARD_ITEM* operator[]( int ndx ) const override
188 {
189 if( (unsigned)ndx < (unsigned)GetCount() )
190 return (BOARD_ITEM*) m_list[ ndx ];
191
192 return nullptr;
193 }
194};
195
196
206{
207protected:
214 std::vector<EDA_ITEM*> m_List2nd;
215
220
221public:
222
226 static const std::vector<KICAD_T> AllBoardItems;
227
231 static const std::vector<KICAD_T> Zones;
232
237 static const std::vector<KICAD_T> BoardLevelItems;
238
242 static const std::vector<KICAD_T> Footprints;
243
247 static const std::vector<KICAD_T> PadsOrTracks;
248
252 static const std::vector<KICAD_T> FootprintItems;
253
257 static const std::vector<KICAD_T> Tracks;
258
262 static const std::vector<KICAD_T> Dimensions;
263
267 static const std::vector<KICAD_T> DraggableItems;
268
270 m_Guide( nullptr )
271 {
273 }
274
275 void Empty2nd()
276 {
277 m_List2nd.clear();
278 }
279
280 void Append2nd( EDA_ITEM* item )
281 {
282 m_List2nd.push_back( item );
283 }
284
290 void SetGuide( const COLLECTORS_GUIDE* aGuide ) { m_Guide = aGuide; }
291
292 const COLLECTORS_GUIDE* GetGuide() const { return m_Guide; }
293
302 INSPECT_RESULT Inspect( EDA_ITEM* aTestItem, void* aTestData ) override;
303
313 void Collect( BOARD_ITEM* aItem, const std::vector<KICAD_T>& aScanList,
314 const VECTOR2I& aRefPos, const COLLECTORS_GUIDE& aGuide );
315};
316
317
323{
324public:
325
334 GENERAL_COLLECTORS_GUIDE( LSET aVisibleLayerMask, PCB_LAYER_ID aPreferredLayer,
335 KIGFX::VIEW* aView )
336 {
337 static const VECTOR2I one( 1, 1 );
338
339 m_preferredLayer = aPreferredLayer;
340 m_visibleLayers = aVisibleLayerMask;
341 m_ignoreLockedItems = false;
342
343#if defined(USE_MATCH_LAYER)
344 m_includeSecondary = false;
345#else
346 m_includeSecondary = true;
347#endif
348
349 m_ignoreHiddenFPText = true; // g_ModuleTextNOVColor;
351 m_ignoreFPTextOnFront = false;
352 m_ignoreFootprintsOnBack = true; // !Show_footprints_Cmp;
354
355 m_ignorePadsOnFront = false;
356 m_ignorePadsOnBack = false;
358
359 m_ignoreFPValues = false;
360 m_ignoreFPReferences = false;
361
362 m_ignoreThroughVias = false;
364 m_ignoreMicroVias = false;
365 m_ignoreTracks = false;
366 m_ignoreZoneFills = true;
367
368 m_onePixelInIU = abs( aView->ToWorld( one, false ).x );
370 }
371
375 bool IsLayerVisible( PCB_LAYER_ID aLayerId ) const override
376 {
377 return m_visibleLayers[aLayerId];
378 }
379 void SetLayerVisible( PCB_LAYER_ID aLayerId, bool isVisible )
380 {
381 m_visibleLayers.set( aLayerId, isVisible );
382 }
383 void SetLayerVisibleBits( LSET aLayerBits ) { m_visibleLayers = aLayerBits; }
384
390
394 bool IgnoreLockedItems() const override { return m_ignoreLockedItems; }
395 void SetIgnoreLockedItems( bool ignore ) { m_ignoreLockedItems = ignore; }
396
402 bool IncludeSecondary() const override { return m_includeSecondary; }
403 void SetIncludeSecondary( bool include ) { m_includeSecondary = include; }
404
408 bool IgnoreHiddenFPText() const override { return m_ignoreHiddenFPText; }
409 void SetIgnoreMTextsMarkedNoShow( bool ignore ) { m_ignoreHiddenFPText = ignore; }
410
414 bool IgnoreFPTextOnBack() const override { return m_ignoreFPTextOnBack; }
415 void SetIgnoreMTextsOnBack( bool ignore ) { m_ignoreFPTextOnBack = ignore; }
416
420 bool IgnoreFPTextOnFront() const override { return m_ignoreFPTextOnFront; }
421 void SetIgnoreMTextsOnFront( bool ignore ) { m_ignoreFPTextOnFront = ignore; }
422
426 bool IgnoreFootprintsOnBack() const override { return m_ignoreFootprintsOnBack; }
427 void SetIgnoreModulesOnBack( bool ignore ) { m_ignoreFootprintsOnBack = ignore; }
428
432 bool IgnoreFootprintsOnFront() const override { return m_ignoreFootprintsOnFront; }
433 void SetIgnoreModulesOnFront( bool ignore ) { m_ignoreFootprintsOnFront = ignore; }
434
438 bool IgnorePadsOnBack() const override { return m_ignorePadsOnBack; }
439 void SetIgnorePadsOnBack(bool ignore) { m_ignorePadsOnBack = ignore; }
440
444 bool IgnorePadsOnFront() const override { return m_ignorePadsOnFront; }
445 void SetIgnorePadsOnFront(bool ignore) { m_ignorePadsOnFront = ignore; }
446
450 bool IgnoreThroughHolePads() const override { return m_ignoreThroughHolePads; }
451 void SetIgnoreThroughHolePads(bool ignore) { m_ignoreThroughHolePads = ignore; }
452
456 bool IgnoreFPValues() const override { return m_ignoreFPValues; }
457 void SetIgnoreModulesVals(bool ignore) { m_ignoreFPValues = ignore; }
458
462 bool IgnoreFPReferences() const override { return m_ignoreFPReferences; }
463 void SetIgnoreModulesRefs(bool ignore) { m_ignoreFPReferences = ignore; }
464
465 bool IgnoreThroughVias() const override { return m_ignoreThroughVias; }
466 void SetIgnoreThroughVias( bool ignore ) { m_ignoreThroughVias = ignore; }
467
468 bool IgnoreBlindBuriedVias() const override { return m_ignoreBlindBuriedVias; }
469 void SetIgnoreBlindBuriedVias( bool ignore ) { m_ignoreBlindBuriedVias = ignore; }
470
471 bool IgnoreMicroVias() const override { return m_ignoreMicroVias; }
472 void SetIgnoreMicroVias( bool ignore ) { m_ignoreMicroVias = ignore; }
473
474 bool IgnoreTracks() const override { return m_ignoreTracks; }
475 void SetIgnoreTracks( bool ignore ) { m_ignoreTracks = ignore; }
476
477 bool IgnoreZoneFills() const override { return m_ignoreZoneFills; }
478 void SetIgnoreZoneFills( bool ignore ) { m_ignoreZoneFills = ignore; }
479
480 int Accuracy() const override { return m_accuracy; }
481 void SetAccuracy( int aValue ) { m_accuracy = aValue; }
482
483 double OnePixelInIU() const override { return m_onePixelInIU; }
484
485private:
486 // the storage architecture here is not important, since this is only
487 // a carrier object and its functions are what is used, and data only indirectly.
488
490
492
495
511
514};
515
516
523{
524public:
525
533 INSPECT_RESULT Inspect( EDA_ITEM* testItem, void* testData ) override;
534
541 void Collect( BOARD_ITEM* aBoard, const std::vector<KICAD_T>& aTypes );
542};
543
544
551{
552public:
554 m_layer_id( aLayerId )
555 { }
556
557 void SetLayerId( PCB_LAYER_ID aLayerId ) { m_layer_id = aLayerId; }
558
566 INSPECT_RESULT Inspect( EDA_ITEM* testItem, void* testData ) override;
567
574 void Collect( BOARD_ITEM* aBoard, const std::vector<KICAD_T>& aTypes );
575
576private:
578};
579
580#endif // COLLECTORS_H
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:77
An abstract base class whose derivatives may be passed to a GENERAL_COLLECTOR telling it what should ...
Definition: collectors.h:53
virtual bool IgnoreThroughVias() const =0
virtual bool IgnoreHiddenFPText() const =0
virtual bool IsLayerVisible(PCB_LAYER_ID layer) const =0
virtual bool IgnoreFPTextOnFront() const =0
virtual double OnePixelInIU() const =0
virtual bool IgnoreFPTextOnBack() const =0
virtual bool IgnoreLockedItems() const =0
virtual bool IgnoreZoneFills() const =0
virtual bool IgnoreMicroVias() const =0
virtual bool IgnoreFootprintsOnBack() const =0
virtual bool IgnoreBlindBuriedVias() const =0
virtual int Accuracy() const =0
virtual bool IgnoreThroughHolePads() const =0
virtual bool IgnorePadsOnBack() const =0
virtual bool IgnoreFPReferences() const =0
virtual bool IgnorePadsOnFront() const =0
virtual bool IgnoreFootprintsOnFront() const =0
virtual bool IgnorePads() const
Definition: collectors.h:122
virtual bool IgnoreTracks() const =0
virtual bool IncludeSecondary() const =0
Determine if the secondary criteria or 2nd choice items should be included.
virtual bool IgnoreFPValues() const =0
virtual ~COLLECTORS_GUIDE()
Definition: collectors.h:55
virtual PCB_LAYER_ID GetPreferredLayer() const =0
An abstract class that will find and hold all the objects according to an inspection done by the Insp...
Definition: collector.h:48
int GetCount() const
Return the number of objects in the list.
Definition: collector.h:81
void SetScanTypes(const std::vector< KICAD_T > &aTypes)
Record the list of KICAD_T types to consider for collection by the Inspect() function.
Definition: collector.h:211
std::vector< EDA_ITEM * > m_list
Definition: collector.h:240
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:85
A general implementation of a COLLECTORS_GUIDE.
Definition: collectors.h:323
void SetIgnoreBlindBuriedVias(bool ignore)
Definition: collectors.h:469
void SetIgnoreTracks(bool ignore)
Definition: collectors.h:475
void SetIgnoreMTextsMarkedNoShow(bool ignore)
Definition: collectors.h:409
bool IgnoreFootprintsOnBack() const override
Definition: collectors.h:426
void SetIgnoreModulesOnFront(bool ignore)
Definition: collectors.h:433
void SetIgnoreModulesRefs(bool ignore)
Definition: collectors.h:463
bool IgnorePadsOnFront() const override
Definition: collectors.h:444
bool IgnoreLockedItems() const override
Definition: collectors.h:394
void SetIgnoreMicroVias(bool ignore)
Definition: collectors.h:472
LSET m_visibleLayers
bit-mapped layer visible bits
Definition: collectors.h:491
void SetIgnoreZoneFills(bool ignore)
Definition: collectors.h:478
int Accuracy() const override
Definition: collectors.h:480
bool IgnoreTracks() const override
Definition: collectors.h:474
GENERAL_COLLECTORS_GUIDE(LSET aVisibleLayerMask, PCB_LAYER_ID aPreferredLayer, KIGFX::VIEW *aView)
Grab stuff from global preferences and uses reasonable defaults.
Definition: collectors.h:334
double OnePixelInIU() const override
Definition: collectors.h:483
bool IncludeSecondary() const override
Determine if the secondary criteria, or 2nd choice items should be included.
Definition: collectors.h:402
bool IgnoreFPTextOnBack() const override
Definition: collectors.h:414
void SetIgnorePadsOnBack(bool ignore)
Definition: collectors.h:439
void SetLayerVisible(PCB_LAYER_ID aLayerId, bool isVisible)
Definition: collectors.h:379
void SetIgnoreLockedItems(bool ignore)
Definition: collectors.h:395
bool IgnoreBlindBuriedVias() const override
Definition: collectors.h:468
bool IgnoreFPValues() const override
Definition: collectors.h:456
void SetIgnoreModulesOnBack(bool ignore)
Definition: collectors.h:427
void SetIgnoreModulesVals(bool ignore)
Definition: collectors.h:457
bool IgnoreFootprintsOnFront() const override
Definition: collectors.h:432
void SetPreferredLayer(PCB_LAYER_ID aLayer)
Definition: collectors.h:389
bool IgnoreThroughVias() const override
Definition: collectors.h:465
void SetIgnoreThroughVias(bool ignore)
Definition: collectors.h:466
void SetIgnoreThroughHolePads(bool ignore)
Definition: collectors.h:451
void SetIgnoreMTextsOnFront(bool ignore)
Definition: collectors.h:421
void SetIncludeSecondary(bool include)
Definition: collectors.h:403
void SetLayerVisibleBits(LSET aLayerBits)
Definition: collectors.h:383
bool IsLayerVisible(PCB_LAYER_ID aLayerId) const override
Definition: collectors.h:375
void SetIgnoreMTextsOnBack(bool ignore)
Definition: collectors.h:415
bool IgnoreThroughHolePads() const override
Definition: collectors.h:450
bool IgnoreMicroVias() const override
Definition: collectors.h:471
bool IgnoreZoneFills() const override
Definition: collectors.h:477
void SetIgnorePadsOnFront(bool ignore)
Definition: collectors.h:445
bool IgnoreFPTextOnFront() const override
Definition: collectors.h:420
bool IgnorePadsOnBack() const override
Definition: collectors.h:438
bool IgnoreHiddenFPText() const override
Definition: collectors.h:408
void SetAccuracy(int aValue)
Definition: collectors.h:481
PCB_LAYER_ID m_preferredLayer
Definition: collectors.h:489
PCB_LAYER_ID GetPreferredLayer() const override
Definition: collectors.h:388
bool IgnoreFPReferences() const override
Definition: collectors.h:462
Used when the right click button is pressed, or when the select tool is in effect.
Definition: collectors.h:206
static const std::vector< KICAD_T > BoardLevelItems
A scan list for all primary board items, omitting items which are subordinate to a FOOTPRINT,...
Definition: collectors.h:237
void SetGuide(const COLLECTORS_GUIDE *aGuide)
Record which COLLECTORS_GUIDE to use.
Definition: collectors.h:290
static const std::vector< KICAD_T > PadsOrTracks
A scan list for PADs, TRACKs, or VIAs.
Definition: collectors.h:247
void Append2nd(EDA_ITEM *item)
Definition: collectors.h:280
INSPECT_RESULT Inspect(EDA_ITEM *aTestItem, void *aTestData) override
The examining function within the INSPECTOR which is passed to the Iterate function.
Definition: collectors.cpp:146
const COLLECTORS_GUIDE * GetGuide() const
Definition: collectors.h:292
static const std::vector< KICAD_T > Zones
A scan list for zones outlines only.
Definition: collectors.h:231
std::vector< EDA_ITEM * > m_List2nd
A place to hold collected objects which don't match precisely the search criteria,...
Definition: collectors.h:214
static const std::vector< KICAD_T > Footprints
A scan list for only FOOTPRINTs.
Definition: collectors.h:242
static const std::vector< KICAD_T > AllBoardItems
A scan list for all editable board items.
Definition: collectors.h:226
static const std::vector< KICAD_T > Tracks
A scan list for only TRACKs and ARCs.
Definition: collectors.h:257
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.
Definition: collectors.cpp:481
static const std::vector< KICAD_T > Dimensions
A scan list for dimensions.
Definition: collectors.h:262
static const std::vector< KICAD_T > FootprintItems
A scan list for primary footprint items.
Definition: collectors.h:252
const COLLECTORS_GUIDE * m_Guide
Determine which items are to be collected by Inspect().
Definition: collectors.h:219
static const std::vector< KICAD_T > DraggableItems
A scan list for items that can be dragged.
Definition: collectors.h:267
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition: view.h:68
VECTOR2D ToWorld(const VECTOR2D &aCoord, bool aAbsolute=true) const
Converts a screen space point/vector to a point/vector in world space coordinates.
Definition: view.cpp:449
LSET is a set of PCB_LAYER_IDs.
Definition: layer_ids.h:573
Collect BOARD_ITEM objects.
Definition: collectors.h:179
BOARD_ITEM * operator[](int ndx) const override
Overload the COLLECTOR::operator[](int) to return a BOARD_ITEM instead of an EDA_ITEM.
Definition: collectors.h:187
Collect all BOARD_ITEM objects on a given layer.
Definition: collectors.h:551
void Collect(BOARD_ITEM *aBoard, const std::vector< KICAD_T > &aTypes)
Test a BOARD_ITEM using this class's Inspector method, which does the collection.
Definition: collectors.cpp:534
INSPECT_RESULT Inspect(EDA_ITEM *testItem, void *testData) override
The examining function within the INSPECTOR which is passed to the iterate function.
Definition: collectors.cpp:523
PCB_LAYER_COLLECTOR(PCB_LAYER_ID aLayerId=UNDEFINED_LAYER)
Definition: collectors.h:553
void SetLayerId(PCB_LAYER_ID aLayerId)
Definition: collectors.h:557
PCB_LAYER_ID m_layer_id
Definition: collectors.h:577
Collect all BOARD_ITEM objects of a given set of KICAD_T type(s).
Definition: collectors.h:523
void Collect(BOARD_ITEM *aBoard, const std::vector< KICAD_T > &aTypes)
Collect BOARD_ITEM objects using this class's Inspector method, which does the collection.
Definition: collectors.cpp:516
INSPECT_RESULT Inspect(EDA_ITEM *testItem, void *testData) override
The examining function within the INSPECTOR which is passed to the Iterate function.
Definition: collectors.cpp:506
INSPECT_RESULT
Definition: eda_item.h:42
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
@ UNDEFINED_LAYER
Definition: layer_ids.h:61
constexpr ret_type KiROUND(fp_type v)
Round a floating point number to an integer using "round halfway cases away from zero".
Definition: util.h:85