KiCad PCB EDA Suite
Loading...
Searching...
No Matches
drc_rule.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 The 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#ifndef DRC_RULE_H
25#define DRC_RULE_H
26
27#include <bitset>
28#include <kiid.h>
29#include <core/typeinfo.h>
30#include <optional>
31#include <core/minoptmax.h>
32#include <layer_ids.h>
33#include <lset.h>
34#include <netclass.h>
35#include <zones.h>
37#include <wx/intl.h>
39
40class BOARD_ITEM;
41class PCBEXPR_UCODE;
42class DRC_CONSTRAINT;
44
45
47{
82};
83
84
86{
97};
98
99
101{
102public:
103 DRC_RULE();
104 DRC_RULE( const wxString& aName );
105
106 virtual ~DRC_RULE();
107
108 virtual bool AppliesTo( const BOARD_ITEM* a, const BOARD_ITEM* b = nullptr ) const
109 {
110 return true;
111 };
112
113 void AddConstraint( DRC_CONSTRAINT& aConstraint );
114 std::optional<DRC_CONSTRAINT> FindConstraint( DRC_CONSTRAINT_T aType );
115
116public:
120 wxString m_Name;
124 std::vector<DRC_CONSTRAINT> m_Constraints;
126};
127
128
130{
131public:
133 const wxString& aName = wxEmptyString ) :
134 m_Type( aType ),
135 m_Value(),
136 m_DisallowFlags( 0 ),
138 m_Test( nullptr ),
139 m_ImplicitMin( false ),
140 m_name( aName ),
141 m_parentRule( nullptr )
142 {
143 }
144
145 enum class OPTIONS : std::size_t
146 {
150
151 // Keep this last value - used to statically size the options bitset
153 };
154
155 bool IsNull() const
156 {
157 return m_Type == NULL_CONSTRAINT;
158 }
159
160 const MINOPTMAX<int>& GetValue() const { return m_Value; }
162
163 void SetParentRule( DRC_RULE *aParentRule ) { m_parentRule = aParentRule; }
165
166 void SetName( const wxString& aName ) { m_name = aName; }
167
168 wxString GetName() const
169 {
170 if( m_parentRule )
171 {
173 return m_parentRule->m_Name;
174 else
175 return wxString::Format( _( "rule '%s'" ), m_parentRule->m_Name );
176 }
177
178 return m_name;
179 }
180
182 {
183 if( m_parentRule )
184 return m_parentRule->m_Severity;
185 else
187 }
188
189 void SetOption( OPTIONS option ) { m_options.set( static_cast<std::size_t>( option ), true ); }
190
191 void ClearOption( OPTIONS option ) { m_options.set( static_cast<std::size_t>( option ), false ); }
192
193 bool GetOption( OPTIONS option ) const
194 {
195 return m_options.test( static_cast<std::size_t>( option ) );
196 }
197
198 void SetOptionsFromOther( const DRC_CONSTRAINT& aOther ) { m_options = aOther.m_options; }
199
200public:
207
208private:
209 wxString m_name; // For just-in-time constraints
210 DRC_RULE* m_parentRule; // For constraints found in rules
211 std::bitset<static_cast<int>( OPTIONS::NUM_OPTIONS )> m_options; // Constraint-specific option bits
212 // (indexed from DRC_CONSTRAINT::OPTIONS)
213};
214
215
216const DRC_CONSTRAINT* GetConstraint( const BOARD_ITEM* aItem, const BOARD_ITEM* bItem,
217 int aConstraint, PCB_LAYER_ID aLayer,
218 wxString* aRuleName = nullptr );
219
220
221#endif // DRC_RULE_H
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:79
DRC_RULE_CONDITION * m_Test
Definition: drc_rule.h:205
wxString GetName() const
Definition: drc_rule.h:168
int m_DisallowFlags
Definition: drc_rule.h:203
SEVERITY GetSeverity() const
Definition: drc_rule.h:181
void SetOption(OPTIONS option)
Definition: drc_rule.h:189
DRC_RULE * m_parentRule
Definition: drc_rule.h:210
void SetParentRule(DRC_RULE *aParentRule)
Definition: drc_rule.h:163
MINOPTMAX< int > & Value()
Definition: drc_rule.h:161
const MINOPTMAX< int > & GetValue() const
Definition: drc_rule.h:160
ZONE_CONNECTION m_ZoneConnection
Definition: drc_rule.h:204
void SetName(const wxString &aName)
Definition: drc_rule.h:166
MINOPTMAX< int > m_Value
Definition: drc_rule.h:202
DRC_CONSTRAINT_T m_Type
Definition: drc_rule.h:201
void SetOptionsFromOther(const DRC_CONSTRAINT &aOther)
Definition: drc_rule.h:198
wxString m_name
Definition: drc_rule.h:209
bool GetOption(OPTIONS option) const
Definition: drc_rule.h:193
DRC_RULE * GetParentRule() const
Definition: drc_rule.h:164
void ClearOption(OPTIONS option)
Definition: drc_rule.h:191
DRC_CONSTRAINT(DRC_CONSTRAINT_T aType=NULL_CONSTRAINT, const wxString &aName=wxEmptyString)
Definition: drc_rule.h:132
bool m_ImplicitMin
Definition: drc_rule.h:206
std::bitset< static_cast< int >(OPTIONS::NUM_OPTIONS)> m_options
Definition: drc_rule.h:211
bool IsNull() const
Definition: drc_rule.h:155
SEVERITY m_Severity
Definition: drc_rule.h:125
bool m_Unary
Definition: drc_rule.h:117
DRC_RULE_CONDITION * m_Condition
Definition: drc_rule.h:123
LSET m_LayerCondition
Definition: drc_rule.h:122
virtual bool AppliesTo(const BOARD_ITEM *a, const BOARD_ITEM *b=nullptr) const
Definition: drc_rule.h:108
KIID m_ImplicitItemId
Definition: drc_rule.h:119
DRC_RULE()
Definition: drc_rule.cpp:31
std::vector< DRC_CONSTRAINT > m_Constraints
Definition: drc_rule.h:124
bool m_Implicit
Definition: drc_rule.h:118
wxString m_Name
Definition: drc_rule.h:120
void AddConstraint(DRC_CONSTRAINT &aConstraint)
Definition: drc_rule.cpp:60
wxString m_LayerSource
Definition: drc_rule.h:121
virtual ~DRC_RULE()
Definition: drc_rule.cpp:54
std::optional< DRC_CONSTRAINT > FindConstraint(DRC_CONSTRAINT_T aType)
Definition: drc_rule.cpp:67
Definition: kiid.h:49
LSET is a set of PCB_LAYER_IDs.
Definition: lset.h:37
const DRC_CONSTRAINT * GetConstraint(const BOARD_ITEM *aItem, const BOARD_ITEM *bItem, int aConstraint, PCB_LAYER_ID aLayer, wxString *aRuleName=nullptr)
DRC_DISALLOW_T
Definition: drc_rule.h:86
@ DRC_DISALLOW_PADS
Definition: drc_rule.h:91
@ DRC_DISALLOW_VIAS
Definition: drc_rule.h:87
@ DRC_DISALLOW_TEXTS
Definition: drc_rule.h:93
@ DRC_DISALLOW_ZONES
Definition: drc_rule.h:92
@ DRC_DISALLOW_HOLES
Definition: drc_rule.h:95
@ DRC_DISALLOW_GRAPHICS
Definition: drc_rule.h:94
@ DRC_DISALLOW_FOOTPRINTS
Definition: drc_rule.h:96
@ DRC_DISALLOW_TRACKS
Definition: drc_rule.h:90
@ DRC_DISALLOW_MICRO_VIAS
Definition: drc_rule.h:88
@ DRC_DISALLOW_BB_VIAS
Definition: drc_rule.h:89
DRC_CONSTRAINT_T
Definition: drc_rule.h:47
@ ANNULAR_WIDTH_CONSTRAINT
Definition: drc_rule.h:61
@ COURTYARD_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:55
@ VIA_DIAMETER_CONSTRAINT
Definition: drc_rule.h:70
@ ZONE_CONNECTION_CONSTRAINT
Definition: drc_rule.h:62
@ DIFF_PAIR_GAP_CONSTRAINT
Definition: drc_rule.h:73
@ DISALLOW_CONSTRAINT
Definition: drc_rule.h:69
@ TRACK_WIDTH_CONSTRAINT
Definition: drc_rule.h:59
@ SILK_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:56
@ EDGE_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:53
@ MIN_RESOLVED_SPOKES_CONSTRAINT
Definition: drc_rule.h:65
@ TRACK_SEGMENT_LENGTH_CONSTRAINT
Definition: drc_rule.h:60
@ TEXT_THICKNESS_CONSTRAINT
Definition: drc_rule.h:58
@ LENGTH_CONSTRAINT
Definition: drc_rule.h:71
@ VIA_COUNT_CONSTRAINT
Definition: drc_rule.h:76
@ PHYSICAL_HOLE_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:78
@ CLEARANCE_CONSTRAINT
Definition: drc_rule.h:49
@ NULL_CONSTRAINT
Definition: drc_rule.h:48
@ THERMAL_SPOKE_WIDTH_CONSTRAINT
Definition: drc_rule.h:64
@ CONNECTION_WIDTH_CONSTRAINT
Definition: drc_rule.h:80
@ THERMAL_RELIEF_GAP_CONSTRAINT
Definition: drc_rule.h:63
@ MAX_UNCOUPLED_CONSTRAINT
Definition: drc_rule.h:74
@ ASSERTION_CONSTRAINT
Definition: drc_rule.h:79
@ SKEW_CONSTRAINT
Definition: drc_rule.h:72
@ HOLE_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:51
@ SOLDER_PASTE_ABS_MARGIN_CONSTRAINT
Definition: drc_rule.h:67
@ SOLDER_MASK_EXPANSION_CONSTRAINT
Definition: drc_rule.h:66
@ TRACK_ANGLE_CONSTRAINT
Definition: drc_rule.h:81
@ HOLE_SIZE_CONSTRAINT
Definition: drc_rule.h:54
@ TEXT_HEIGHT_CONSTRAINT
Definition: drc_rule.h:57
@ CREEPAGE_CONSTRAINT
Definition: drc_rule.h:50
@ DIFF_PAIR_INTRA_SKEW_CONSTRAINT
Definition: drc_rule.h:75
@ PHYSICAL_CLEARANCE_CONSTRAINT
Definition: drc_rule.h:77
@ SOLDER_PASTE_REL_MARGIN_CONSTRAINT
Definition: drc_rule.h:68
@ HOLE_TO_HOLE_CONSTRAINT
Definition: drc_rule.h:52
#define _(s)
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
SEVERITY
@ RPT_SEVERITY_UNDEFINED
ZONE_CONNECTION
How pads are covered by copper in zone.
Definition: zones.h:47