KiCad PCB EDA Suite
drc_test_provider.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) 2018-2021 KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24
25#ifndef DRC_TEST_PROVIDER__H
26#define DRC_TEST_PROVIDER__H
27
28#include <board.h>
29#include <pcb_marker.h>
30
31#include <functional>
32#include <set>
33
34class DRC_ENGINE;
36
38{
39public:
41
43
45 {
47 return self;
48 }
49
50 void RegisterTestProvider( DRC_TEST_PROVIDER* provider ) { m_providers.push_back( provider ); }
51 std::vector<DRC_TEST_PROVIDER*> GetTestProviders() const { return m_providers; }
52
53private:
54 std::vector<DRC_TEST_PROVIDER*> m_providers;
55};
56
57template<class T> class DRC_REGISTER_TEST_PROVIDER
58{
59public:
61 {
62 T* provider = new T;
64 }
65};
66
67
73{
74public:
76 virtual ~DRC_TEST_PROVIDER() = default;
77
78 static void Init();
79
80 void SetDRCEngine( DRC_ENGINE *engine )
81 {
82 m_drcEngine = engine;
83 m_stats.clear();
84 }
85
86 bool RunTests( EDA_UNITS aUnits )
87 {
88 SetUserUnits( aUnits );
89 return Run();
90 }
91
95 virtual bool Run() = 0;
96
97 virtual const wxString GetName() const;
98 virtual const wxString GetDescription() const;
99
100protected:
101 int forEachGeometryItem( const std::vector<KICAD_T>& aTypes, LSET aLayers,
102 const std::function<bool(BOARD_ITEM*)>& aFunc );
103
104 virtual void reportAux( wxString fmt, ... );
105 virtual void reportViolation( std::shared_ptr<DRC_ITEM>& item, const VECTOR2I& aMarkerPos,
106 int aMarkerLayer );
107 virtual bool reportProgress( int aCount, int aSize, int aDelta );
108 virtual bool reportPhase( const wxString& aStageName );
109
110 virtual void reportRuleStatistics();
111 virtual void accountCheck( const DRC_RULE* ruleToTest );
112 virtual void accountCheck( const DRC_CONSTRAINT& constraintToTest );
113
114 bool isInvisibleText( const BOARD_ITEM* aItem ) const;
115
116 // List of basic (ie: non-compound) geometry items
117 static std::vector<KICAD_T> s_allBasicItems;
118 static std::vector<KICAD_T> s_allBasicItemsButZones;
119
121
122protected:
124 std::unordered_map<const DRC_RULE*, int> m_stats;
125 bool m_isRuleDriven = true;
126};
127
128#endif // DRC_TEST_PROVIDER__H
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:50
Design Rule Checker object that performs all the DRC tests.
Definition: drc_engine.h:83
std::vector< DRC_TEST_PROVIDER * > GetTestProviders() const
static DRC_TEST_PROVIDER_REGISTRY & Instance()
void RegisterTestProvider(DRC_TEST_PROVIDER *provider)
std::vector< DRC_TEST_PROVIDER * > m_providers
Represent a DRC "provider" which runs some DRC functions over a BOARD and spits out #DRC_ITEMs and po...
static std::vector< KICAD_T > s_allBasicItemsButZones
virtual bool reportPhase(const wxString &aStageName)
int forEachGeometryItem(const std::vector< KICAD_T > &aTypes, LSET aLayers, const std::function< bool(BOARD_ITEM *)> &aFunc)
virtual bool reportProgress(int aCount, int aSize, int aDelta)
virtual void reportViolation(std::shared_ptr< DRC_ITEM > &item, const VECTOR2I &aMarkerPos, int aMarkerLayer)
bool RunTests(EDA_UNITS aUnits)
virtual void reportAux(wxString fmt,...)
static std::vector< KICAD_T > s_allBasicItems
virtual const wxString GetDescription() const
EDA_UNITS userUnits() const
DRC_ENGINE * m_drcEngine
bool isInvisibleText(const BOARD_ITEM *aItem) const
std::unordered_map< const DRC_RULE *, int > m_stats
virtual ~DRC_TEST_PROVIDER()=default
virtual void accountCheck(const DRC_RULE *ruleToTest)
virtual bool Run()=0
Run this provider against the given PCB with configured options (if any).
void SetDRCEngine(DRC_ENGINE *engine)
virtual const wxString GetName() const
virtual void reportRuleStatistics()
LSET is a set of PCB_LAYER_IDs.
Definition: layer_ids.h:530
void SetUserUnits(EDA_UNITS aUnits)
EDA_UNITS
Definition: eda_units.h:43