/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2020 KiCad Developers, see change_log.txt for contributors. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #ifndef DRC_RULE_PROTO_H #define DRC_RULE_PROTO_H #include #include #include #include class BOARD_ITEM; class PCB_EXPR_UCODE; class DRC_RULE; class DRC_RULE_CONDITION; enum DRC_CONSTRAINT_TYPE_T { DRC_CONSTRAINT_TYPE_UNKNOWN = -1, DRC_CONSTRAINT_TYPE_CLEARANCE = 0, DRC_CONSTRAINT_TYPE_HOLE_CLEARANCE, DRC_CONSTRAINT_TYPE_EDGE_CLEARANCE, DRC_CONSTRAINT_TYPE_HOLE_SIZE, DRC_CONSTRAINT_TYPE_COURTYARD_CLEARANCE, DRC_CONSTRAINT_TYPE_SILK_TO_PAD, DRC_CONSTRAINT_TYPE_SILK_TO_SILK, DRC_CONSTRAINT_TYPE_TRACK_WIDTH, DRC_CONSTRAINT_TYPE_ANNULUS_WIDTH, DRC_CONSTRAINT_TYPE_DISALLOW, DRC_CONSTRAINT_TYPE_VIA_DIAMETER }; enum DRC_DISALLOW_T { DRC_DISALLOW_VIAS = (1 << 0), DRC_DISALLOW_MICRO_VIAS = (1 << 1), DRC_DISALLOW_BB_VIAS = (1 << 2), DRC_DISALLOW_TRACKS = (1 << 3), DRC_DISALLOW_PADS = (1 << 4), DRC_DISALLOW_ZONES = (1 << 5), DRC_DISALLOW_TEXTS = (1 << 6), DRC_DISALLOW_GRAPHICS = (1 << 7), DRC_DISALLOW_HOLES = (1 << 8), DRC_DISALLOW_FOOTPRINTS = (1 << 9) }; template class MINOPTMAX { public: T Min() const { assert( m_hasMin ); return m_min; }; T Max() const { assert( m_hasMax ); return m_max; }; T Opt() const { assert( m_hasOpt ); return m_opt; }; bool HasMin() const { return m_hasMin; } bool HasMax() const { return m_hasMax; } bool HasOpt() const { return m_hasOpt; } void SetMin( T v ) { m_min = v; m_hasMin = true; } void SetMax( T v ) { m_max = v; m_hasMax = true; } void SetOpt( T v ) { m_opt = v; m_hasOpt = true; } private: T m_min; T m_opt; T m_max; bool m_hasMin = false; bool m_hasOpt = false; bool m_hasMax = false; }; class DRC_CONSTRAINT { public: DRC_CONSTRAINT( DRC_CONSTRAINT_TYPE_T aType = DRC_CONSTRAINT_TYPE_UNKNOWN, const wxString& aName = wxEmptyString ) : m_Type( aType ), m_DisallowFlags( 0 ), m_name( aName ), m_parentRule( nullptr ) { } const MINOPTMAX& GetValue() const { return m_Value; } MINOPTMAX& Value() { return m_Value; } void SetParentRule( DRC_RULE *aParentRule ) { m_parentRule = aParentRule; } DRC_RULE* GetParentRule() const { return m_parentRule; } wxString GetName() const; public: DRC_CONSTRAINT_TYPE_T m_Type; MINOPTMAX m_Value; int m_DisallowFlags; private: wxString m_name; // For just-in-time constraints DRC_RULE* m_parentRule; // For constraints found in rules }; class DRC_RULE_CONDITION { public: DRC_RULE_CONDITION( const wxString& aExpression = "" ); ~DRC_RULE_CONDITION(); bool EvaluateFor( const BOARD_ITEM* aItemA, const BOARD_ITEM* aItemB, PCB_LAYER_ID aLayer, REPORTER* aReporter = nullptr ); bool Compile( REPORTER* aReporter, int aSourceLine = 0, int aSourceOffset = 0 ); void SetExpression( const wxString& aExpression ) { m_expression = aExpression; } wxString GetExpression() const { return m_expression; } private: wxString m_expression; std::unique_ptr m_ucode; }; class DRC_RULE { public: DRC_RULE(); virtual ~DRC_RULE(); virtual bool IsImplicit() const { return false; }; virtual bool AppliesTo( const BOARD_ITEM* a, const BOARD_ITEM* b = nullptr ) const { return true; }; virtual bool HasSpecificItemSet() const { return false; }; virtual void FillSpecificItemSet( std::set specificItems ) { }; void SetPriority( int aPriority ) { m_Priority = aPriority; } int GetPriority() const { return m_Priority; } void AddConstraint( DRC_CONSTRAINT& aConstraint ); public: bool m_Unary; wxString m_Name; wxString m_LayerSource; LSET m_LayerCondition; DRC_RULE_CONDITION* m_Condition; std::vector m_Constraints; int m_Priority; // 0 indicates automatic priority generation fixme: use enum SEVERITY m_Severity; }; const DRC_CONSTRAINT* GetConstraint( const BOARD_ITEM* aItem, const BOARD_ITEM* bItem, int aConstraint, PCB_LAYER_ID aLayer, wxString* aRuleName = nullptr, REPORTER* aReporter = nullptr ); #endif // DRC_RULE_H