Loads DRC rules from .kicad_dru files and converts them to panel entries. More...

#include <drc_re_rule_loader.h>

Public Member Functions
	DRC_RULE_LOADER ()

std::vector< DRC_RE_LOADED_PANEL_ENTRY >	LoadRule (const DRC_RULE &aRule, const wxString &aOriginalText)
	Load a single DRC_RULE and convert it to panel entries.

std::vector< DRC_RE_LOADED_PANEL_ENTRY >	LoadFile (const wxString &aPath)
	Load all rules from a .kicad_dru file.

std::vector< DRC_RE_LOADED_PANEL_ENTRY >	LoadFromString (const wxString &aRulesText)
	Load rules from a text string.

Private Member Functions
std::shared_ptr< DRC_RE_BASE_CONSTRAINT_DATA >	createConstraintData (DRC_RULE_EDITOR_CONSTRAINT_NAME aPanel, const DRC_RULE &aRule, const std::set< DRC_CONSTRAINT_T > &aClaimedConstraints)
	Create the appropriate constraint data object for a panel type.

const DRC_CONSTRAINT *	findConstraint (const DRC_RULE &aRule, DRC_CONSTRAINT_T aType)
	Find a constraint of a specific type in a rule.

double	toMM (int aValue)
	Convert internal units (nanometers) to millimeters.

wxString	extractRuleText (const wxString &aContent, const wxString &aRuleName)
	Extract the complete original text of a rule from file content.

Private Attributes
DRC_PANEL_MATCHER	m_matcher

Detailed Description

Loads DRC rules from .kicad_dru files and converts them to panel entries.

This class handles the conversion of text-based DRC rules into the appropriate graphical panel representations. Rules with multiple constraints may be split across multiple panel entries, with the condition and severity duplicated to each.

Definition at line 47 of file drc_re_rule_loader.h.

Constructor & Destructor Documentation

◆ DRC_RULE_LOADER()

DRC_RULE_LOADER::DRC_RULE_LOADER ( )

Definition at line 46 of file drc_re_rule_loader.cpp.

Member Function Documentation

◆ createConstraintData()

std::shared_ptr< DRC_RE_BASE_CONSTRAINT_DATA > DRC_RULE_LOADER::createConstraintData	(	DRC_RULE_EDITOR_CONSTRAINT_NAME	aPanel,
		const DRC_RULE &	aRule,
		const std::set< DRC_CONSTRAINT_T > &	aClaimedConstraints )

private

Create the appropriate constraint data object for a panel type.

Parameters

aPanel	The target panel type.
aRule	The source rule.
aClaimedConstraints	The constraints this panel should handle.

Returns: Shared pointer to the populated constraint data.

Definition at line 70 of file drc_re_rule_loader.cpp.

References ABSOLUTE_LENGTH, ALLOWED_ORIENTATION, ASSERTION_CONSTRAINT, DRC_RULE_EDITOR_UTILS::CreateNumericConstraintData(), CUSTOM_RULE, DIFF_PAIR_GAP_CONSTRAINT, DISALLOW_CONSTRAINT, DRC_DISALLOW_BLIND_VIAS, DRC_DISALLOW_BURIED_VIAS, DRC_DISALLOW_MICRO_VIAS, DRC_DISALLOW_THROUGH_VIAS, findConstraint(), DRC_RULE_EDITOR_UTILS::GetConstraintCode(), DRC_RULE_CONDITION::GetExpression(), DRC_CONSTRAINT::GetValue(), HOLE_SIZE_CONSTRAINT, DRC_RULE_EDITOR_UTILS::IsNumericInputType(), LENGTH_CONSTRAINT, DRC_CONSTRAINT::m_DisallowFlags, DRC_RULE::m_Name, DRC_CONSTRAINT::m_Test, MATCHED_LENGTH_DIFF_PAIR, MINOPTMAX< T >::Max(), MAX_UNCOUPLED_CONSTRAINT, MINOPTMAX< T >::Min(), MIN_RESOLVED_SPOKES_CONSTRAINT, MINIMUM_TEXT_HEIGHT_AND_THICKNESS, MINOPTMAX< T >::Opt(), PERMITTED_LAYERS, ROUTING_DIFF_PAIR, ROUTING_WIDTH, SKEW_CONSTRAINT, TEXT_HEIGHT_CONSTRAINT, TEXT_THICKNESS_CONSTRAINT, toMM(), TRACK_WIDTH_CONSTRAINT, VIA_COUNT_CONSTRAINT, VIA_DIAMETER_CONSTRAINT, VIA_STYLE, and VIAS_UNDER_SMD.

Referenced by LoadRule().

◆ extractRuleText()

wxString DRC_RULE_LOADER::extractRuleText	(	const wxString &	aContent,
		const wxString &	aRuleName )

private

Extract the complete original text of a rule from file content.

Parameters

aContent	The full file content.
aRuleName	The name of the rule to extract.

Returns: The complete rule text including (rule ...) wrapper, or empty if not found.

Definition at line 436 of file drc_re_rule_loader.cpp.

Referenced by LoadFromString().

◆ findConstraint()

const DRC_CONSTRAINT * DRC_RULE_LOADER::findConstraint	(	const DRC_RULE &	aRule,
		DRC_CONSTRAINT_T	aType )

private

Find a constraint of a specific type in a rule.

Parameters

aRule	The rule to search.
aType	The constraint type to find.

Returns: Pointer to the constraint, or nullptr if not found.

Definition at line 57 of file drc_re_rule_loader.cpp.

References DRC_RULE::m_Constraints, and DRC_CONSTRAINT::m_Type.

Referenced by createConstraintData(), and LoadRule().

◆ LoadFile()

std::vector< DRC_RE_LOADED_PANEL_ENTRY > DRC_RULE_LOADER::LoadFile ( const wxString & aPath )

Load all rules from a .kicad_dru file.

Parameters

aPath Path to the rules file.

Returns: Vector of panel entries for all rules in the file.

Definition at line 527 of file drc_re_rule_loader.cpp.

References LoadFromString().

Referenced by DIALOG_DRC_RULE_EDITOR::LoadExistingRules().

◆ LoadFromString()

std::vector< DRC_RE_LOADED_PANEL_ENTRY > DRC_RULE_LOADER::LoadFromString ( const wxString & aRulesText )

Load rules from a text string.

Parameters

aRulesText The text content of the rules.

Returns: Vector of panel entries for all rules in the text.

Definition at line 401 of file drc_re_rule_loader.cpp.

References extractRuleText(), LoadRule(), and DRC_RULES_PARSER::Parse().

◆ LoadRule()

std::vector< DRC_RE_LOADED_PANEL_ENTRY > DRC_RULE_LOADER::LoadRule	(	const DRC_RULE &	aRule,
		const wxString &	aOriginalText )

Load a single DRC_RULE and convert it to panel entries.

If the rule contains more constraints than a single panel can handle, it will be split into multiple entries, preserving order.

Parameters

aRule	The parsed DRC rule to convert.
aOriginalText	The original text of the rule for round-trip fidelity.

Returns: Vector of panel entries representing the rule.

Definition at line 333 of file drc_re_rule_loader.cpp.

References ALLOWED_ORIENTATION, ASSERTION_CONSTRAINT, createConstraintData(), CUSTOM_RULE, findConstraint(), DRC_RULE_CONDITION::GetExpression(), DRC_RE_LOADED_PANEL_ENTRY::layerSource, DRC_RULE::m_Condition, DRC_RULE::m_LayerCondition, DRC_RULE::m_LayerSource, m_matcher, DRC_RULE::m_Name, DRC_RULE::m_Severity, DRC_CONSTRAINT::m_Test, DRC_RE_LOADED_PANEL_ENTRY::originalRuleText, and PERMITTED_LAYERS.

Referenced by LoadFromString().

◆ toMM()

double DRC_RULE_LOADER::toMM ( int aValue )

private

Convert internal units (nanometers) to millimeters.

Definition at line 51 of file drc_re_rule_loader.cpp.

Referenced by createConstraintData().

Member Data Documentation

◆ m_matcher

DRC_PANEL_MATCHER DRC_RULE_LOADER::m_matcher

private

Definition at line 118 of file drc_re_rule_loader.h.

Referenced by LoadRule().

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ DRC_RULE_LOADER()

Member Function Documentation

◆ createConstraintData()

◆ extractRuleText()

◆ findConstraint()

◆ LoadFile()

◆ LoadFromString()

◆ LoadRule()

◆ toMM()

Member Data Documentation

◆ m_matcher