KiCad PCB EDA Suite
CLEANUP_ITEM Class Reference

#include <cleanup_item.h>

Inheritance diagram for CLEANUP_ITEM:
RC_ITEM

Public Types

typedef std::vector< KIIDKIIDS
 

Public Member Functions

 CLEANUP_ITEM (int aErrorCode)
 
wxString GetErrorText (int aErrorCode=-1, bool aTranslate=true) const
 Return the string form of a drc error code. More...
 
void SetErrorMessage (const wxString &aMessage)
 
void SetItems (const KIIDS &aIds)
 
void SetItems (const EDA_ITEM *aItem, const EDA_ITEM *bItem=nullptr, const EDA_ITEM *cItem=nullptr, const EDA_ITEM *dItem=nullptr)
 
void SetItems (const KIID &aItem, const KIID &bItem=niluuid, const KIID &cItem=niluuid, const KIID &dItem=niluuid)
 
void AddItem (EDA_ITEM *aItem)
 
KIID GetMainItemID () const
 
KIID GetAuxItemID () const
 
KIID GetAuxItem2ID () const
 
KIID GetAuxItem3ID () const
 
void SetParent (MARKER_BASE *aMarker)
 
MARKER_BASEGetParent () const
 
virtual wxString ShowReport (EDA_UNITS aUnits, SEVERITY aSeverity, const std::map< KIID, EDA_ITEM * > &aItemMap) const
 Translate this object into a text string suitable for saving to disk in a report. More...
 
int GetErrorCode () const
 
void SetErrorCode (int aCode)
 
virtual wxString GetErrorMessage () const
 Return the error message of a RC_ITEM. More...
 
wxString GetErrorText () const
 
wxString GetSettingsKey () const
 
virtual wxString GetViolatingRuleDesc () const
 

Static Public Member Functions

static wxString ShowCoord (EDA_UNITS aUnits, const wxPoint &aPos)
 Format a coordinate or position to text. More...
 

Protected Attributes

int m_errorCode
 The error code's numeric value. More...
 
wxString m_errorTitle
 The string describing the type of error. More...
 
wxString m_settingsKey
 The key used to describe this type of error in settings. More...
 
MARKER_BASEm_parent
 The marker this item belongs to, if any. More...
 
KIIDS m_ids
 

Private Attributes

wxString m_errorMessage
 

Detailed Description

Definition at line 49 of file cleanup_item.h.

Member Typedef Documentation

◆ KIIDS

typedef std::vector<KIID> RC_ITEM::KIIDS
inherited

Definition at line 77 of file rc_item.h.

Constructor & Destructor Documentation

◆ CLEANUP_ITEM()

CLEANUP_ITEM::CLEANUP_ITEM ( int  aErrorCode)

Definition at line 29 of file cleanup_item.cpp.

30 {
31  m_errorCode = aErrorCode;
32  m_errorTitle = GetErrorText( aErrorCode );
33 }
wxString GetErrorText() const
Definition: rc_item.h:145
int m_errorCode
The error code's numeric value.
Definition: rc_item.h:166
wxString m_errorTitle
The string describing the type of error.
Definition: rc_item.h:168

References RC_ITEM::GetErrorText(), RC_ITEM::m_errorCode, and RC_ITEM::m_errorTitle.

Member Function Documentation

◆ AddItem()

void RC_ITEM::AddItem ( EDA_ITEM aItem)
inherited

Definition at line 55 of file rc_item.cpp.

56 {
57  m_ids.push_back( aItem->m_Uuid );
58 }
KIIDS m_ids
Definition: rc_item.h:172
const KIID m_Uuid
Definition: eda_item.h:475

References RC_ITEM::m_ids, and EDA_ITEM::m_Uuid.

◆ GetAuxItem2ID()

KIID RC_ITEM::GetAuxItem2ID ( ) const
inlineinherited

Definition at line 122 of file rc_item.h.

122 { return m_ids.size() > 2 ? m_ids[2] : niluuid;; }
KIIDS m_ids
Definition: rc_item.h:172
KIID niluuid(0)

References RC_ITEM::m_ids, and niluuid.

◆ GetAuxItem3ID()

KIID RC_ITEM::GetAuxItem3ID ( ) const
inlineinherited

Definition at line 123 of file rc_item.h.

123 { return m_ids.size() > 3 ? m_ids[3] : niluuid;; }
KIIDS m_ids
Definition: rc_item.h:172
KIID niluuid(0)

References RC_ITEM::m_ids, and niluuid.

◆ GetAuxItemID()

KIID RC_ITEM::GetAuxItemID ( ) const
inlineinherited

Definition at line 121 of file rc_item.h.

121 { return m_ids.size() > 1 ? m_ids[1] : niluuid;; }
KIIDS m_ids
Definition: rc_item.h:172
KIID niluuid(0)

References RC_ITEM::m_ids, and niluuid.

Referenced by RC_ITEM::ShowReport().

◆ GetErrorCode()

int RC_ITEM::GetErrorCode ( ) const
inlineinherited

◆ GetErrorMessage()

wxString RC_ITEM::GetErrorMessage ( ) const
virtualinherited

Return the error message of a RC_ITEM.

Definition at line 38 of file rc_item.cpp.

39 {
40  if( m_errorMessage.IsEmpty() )
41  return GetErrorText();
42  else
43  return m_errorMessage;
44 }
wxString GetErrorText() const
Definition: rc_item.h:145
wxString m_errorMessage
A message describing the details of this specific error.
Definition: rc_item.h:167

References RC_ITEM::GetErrorText(), and RC_ITEM::m_errorMessage.

Referenced by RC_ITEM::ShowReport().

◆ GetErrorText() [1/2]

wxString CLEANUP_ITEM::GetErrorText ( int  aErrorCode = -1,
bool  aTranslate = true 
) const

Return the string form of a drc error code.

Definition at line 36 of file cleanup_item.cpp.

37 {
38  wxString msg;
39 
40  if( aCode < 0 )
41  aCode = m_errorCode;
42 
43  switch( aCode )
44  {
45  // For cleanup tracks and vias:
46  case CLEANUP_CHECKING_ZONE_FILLS: msg = _HKI( "Checking zone fills..." ); break;
47  case CLEANUP_SHORTING_TRACK: msg = _HKI( "Remove track shorting two nets" ); break;
48  case CLEANUP_SHORTING_VIA: msg = _HKI( "Remove via shorting two nets" ); break;
49  case CLEANUP_REDUNDANT_VIA: msg = _HKI( "Remove redundant via" ); break;
50  case CLEANUP_DUPLICATE_TRACK: msg = _HKI( "Remove duplicate track" ); break;
51  case CLEANUP_MERGE_TRACKS: msg = _HKI( "Merge co-linear tracks" ); break;
52  case CLEANUP_DANGLING_TRACK: msg = _HKI( "Remove track not connected at both ends" ); break;
53  case CLEANUP_DANGLING_VIA: msg = _HKI( "Remove via connected on fewer than two layers" ); break;
54  case CLEANUP_ZERO_LENGTH_TRACK: msg = _HKI( "Remove zero-length track" ); break;
55  case CLEANUP_TRACK_IN_PAD: msg = _HKI( "Remove track inside pad" ); break;
56 
57  // For cleanup graphics:
58  case CLEANUP_NULL_GRAPHIC: msg = _HKI( "Remove zero-size graphic" ); break;
59  case CLEANUP_DUPLICATE_GRAPHIC: msg = _HKI( "Remove duplicated graphic" ); break;
60  case CLEANUP_LINES_TO_RECT: msg = _HKI( "Convert lines to rectangle" ); break;
61 
62  default:
63  wxFAIL_MSG( "Missing cleanup item description" );
64  msg = _HKI( "Unknown cleanup action" );
65  break;
66  }
67 
68  if( aTranslate )
69  return wxGetTranslation( msg );
70  else
71  return msg;
72 }
int m_errorCode
The error code's numeric value.
Definition: rc_item.h:166
#define _HKI(x)

References _HKI, CLEANUP_CHECKING_ZONE_FILLS, CLEANUP_DANGLING_TRACK, CLEANUP_DANGLING_VIA, CLEANUP_DUPLICATE_GRAPHIC, CLEANUP_DUPLICATE_TRACK, CLEANUP_LINES_TO_RECT, CLEANUP_MERGE_TRACKS, CLEANUP_NULL_GRAPHIC, CLEANUP_REDUNDANT_VIA, CLEANUP_SHORTING_TRACK, CLEANUP_SHORTING_VIA, CLEANUP_TRACK_IN_PAD, CLEANUP_ZERO_LENGTH_TRACK, and RC_ITEM::m_errorCode.

◆ GetErrorText() [2/2]

wxString RC_ITEM::GetErrorText ( ) const
inlineinherited

Definition at line 145 of file rc_item.h.

146  {
147  return wxGetTranslation( m_errorTitle );
148  }
wxString m_errorTitle
The string describing the type of error.
Definition: rc_item.h:168

References RC_ITEM::m_errorTitle.

Referenced by CLEANUP_ITEM(), RC_ITEM::GetErrorMessage(), and PANEL_SETUP_SEVERITIES::PANEL_SETUP_SEVERITIES().

◆ GetMainItemID()

KIID RC_ITEM::GetMainItemID ( ) const
inlineinherited

Definition at line 120 of file rc_item.h.

120 { return m_ids.size() > 0 ? m_ids[0] : niluuid; }
KIIDS m_ids
Definition: rc_item.h:172
KIID niluuid(0)

References RC_ITEM::m_ids, and niluuid.

Referenced by RC_ITEM::ShowReport().

◆ GetParent()

MARKER_BASE* RC_ITEM::GetParent ( void  ) const
inlineinherited

Definition at line 126 of file rc_item.h.

126 { return m_parent; }
MARKER_BASE * m_parent
The marker this item belongs to, if any.
Definition: rc_item.h:170

References RC_ITEM::m_parent.

◆ GetSettingsKey()

wxString RC_ITEM::GetSettingsKey ( ) const
inlineinherited

Definition at line 150 of file rc_item.h.

151  {
152  return m_settingsKey;
153  }
wxString m_settingsKey
The key used to describe this type of error in settings.
Definition: rc_item.h:169

References RC_ITEM::m_settingsKey.

Referenced by RC_ITEM::ShowReport().

◆ GetViolatingRuleDesc()

virtual wxString RC_ITEM::GetViolatingRuleDesc ( ) const
inlinevirtualinherited

Reimplemented in DRC_ITEM.

Definition at line 155 of file rc_item.h.

156  {
157  return wxEmptyString;
158  }

Referenced by RC_ITEM::ShowReport().

◆ SetErrorCode()

void RC_ITEM::SetErrorCode ( int  aCode)
inlineinherited

Definition at line 138 of file rc_item.h.

138 { m_errorCode = aCode; }
int m_errorCode
The error code's numeric value.
Definition: rc_item.h:166

References RC_ITEM::m_errorCode.

◆ SetErrorMessage()

void RC_ITEM::SetErrorMessage ( const wxString &  aMessage)
inlineinherited

Definition at line 97 of file rc_item.h.

97 { m_errorMessage = aMessage; }
wxString m_errorMessage
A message describing the details of this specific error.
Definition: rc_item.h:167

References RC_ITEM::m_errorMessage.

◆ SetItems() [1/3]

void RC_ITEM::SetItems ( const KIIDS aIds)
inlineinherited

Definition at line 99 of file rc_item.h.

100  {
101  m_ids = aIds;
102  }
KIIDS m_ids
Definition: rc_item.h:172

References RC_ITEM::m_ids.

◆ SetItems() [2/3]

void RC_ITEM::SetItems ( const EDA_ITEM aItem,
const EDA_ITEM bItem = nullptr,
const EDA_ITEM cItem = nullptr,
const EDA_ITEM dItem = nullptr 
)
inherited

Definition at line 61 of file rc_item.cpp.

63 {
64  m_ids.clear();
65 
66  m_ids.push_back( aItem->m_Uuid );
67 
68  if( bItem )
69  m_ids.push_back( bItem->m_Uuid );
70 
71  if( cItem )
72  m_ids.push_back( cItem->m_Uuid );
73 
74  if( dItem )
75  m_ids.push_back( dItem->m_Uuid );
76 }
KIIDS m_ids
Definition: rc_item.h:172
const KIID m_Uuid
Definition: eda_item.h:475

References RC_ITEM::m_ids, and EDA_ITEM::m_Uuid.

◆ SetItems() [3/3]

void RC_ITEM::SetItems ( const KIID aItem,
const KIID bItem = niluuid,
const KIID cItem = niluuid,
const KIID dItem = niluuid 
)
inlineinherited

Definition at line 109 of file rc_item.h.

111  {
112  m_ids.clear();
113 
114  m_ids.push_back( aItem );
115  m_ids.push_back( bItem );
116  m_ids.push_back( cItem );
117  m_ids.push_back( dItem );
118  }
KIIDS m_ids
Definition: rc_item.h:172

References RC_ITEM::m_ids.

◆ SetParent()

void RC_ITEM::SetParent ( MARKER_BASE aMarker)
inlineinherited

Definition at line 125 of file rc_item.h.

125 { m_parent = aMarker; }
MARKER_BASE * m_parent
The marker this item belongs to, if any.
Definition: rc_item.h:170

References RC_ITEM::m_parent.

◆ ShowCoord()

wxString RC_ITEM::ShowCoord ( EDA_UNITS  aUnits,
const wxPoint &  aPos 
)
staticinherited

Format a coordinate or position to text.

Definition at line 47 of file rc_item.cpp.

48 {
49  return wxString::Format( "@(%s, %s)",
50  MessageTextFromValue( aUnits, aPos.x ),
51  MessageTextFromValue( aUnits, aPos.y ) );
52 }
wxString MessageTextFromValue(EDA_UNITS aUnits, int aValue, bool aAddUnitLabel, EDA_DATA_TYPE aType)
Convert a value to a string using double notation.
Definition: base_units.cpp:104
void Format(OUTPUTFORMATTER *out, int aNestLevel, int aCtl, const CPTREE &aTree)
Output a PTREE into s-expression format via an OUTPUTFORMATTER derivative.
Definition: ptree.cpp:200

References Format(), and MessageTextFromValue().

Referenced by RC_ITEM::ShowReport().

◆ ShowReport()

wxString RC_ITEM::ShowReport ( EDA_UNITS  aUnits,
SEVERITY  aSeverity,
const std::map< KIID, EDA_ITEM * > &  aItemMap 
) const
virtualinherited

Translate this object into a text string suitable for saving to disk in a report.

Returns
wxString - the simple multi-line report text.

Definition at line 79 of file rc_item.cpp.

81 {
82  wxString severity;
83 
84  switch( aSeverity )
85  {
86  case RPT_SEVERITY_ERROR: severity = wxT( "Severity: error" ); break;
87  case RPT_SEVERITY_WARNING: severity = wxT( "Severity: warning" ); break;
88  case RPT_SEVERITY_ACTION: severity = wxT( "Severity: action" ); break;
89  case RPT_SEVERITY_INFO: severity = wxT( "Severity: info" ); break;
90  default: ;
91  };
92 
93  if( m_parent && m_parent->IsExcluded() )
94  severity += wxT( " (excluded)" );
95 
96  EDA_ITEM* mainItem = nullptr;
97  EDA_ITEM* auxItem = nullptr;
98 
99  auto ii = aItemMap.find( GetMainItemID() );
100 
101  if( ii != aItemMap.end() )
102  mainItem = ii->second;
103 
104  ii = aItemMap.find( GetAuxItemID() );
105 
106  if( ii != aItemMap.end() )
107  auxItem = ii->second;
108 
109  // Note: some customers machine-process these. So:
110  // 1) don't translate
111  // 2) try not to re-order or change syntax
112  // 3) report settings key (which should be more stable) in addition to message
113 
114  if( mainItem && auxItem )
115  {
116  return wxString::Format( wxT( "[%s]: %s\n %s; %s\n %s: %s\n %s: %s\n" ),
117  GetSettingsKey(),
118  GetErrorMessage(),
120  severity,
121  ShowCoord( aUnits, mainItem->GetPosition() ),
122  mainItem->GetSelectMenuText( aUnits ),
123  ShowCoord( aUnits, auxItem->GetPosition() ),
124  auxItem->GetSelectMenuText( aUnits ) );
125  }
126  else if( mainItem )
127  {
128  return wxString::Format( wxT( "[%s]: %s\n %s; %s\n %s: %s\n" ),
129  GetSettingsKey(),
130  GetErrorMessage(),
132  severity,
133  ShowCoord( aUnits, mainItem->GetPosition() ),
134  mainItem->GetSelectMenuText( aUnits ) );
135  }
136  else
137  {
138  return wxString::Format( wxT( "[%s]: %s\n %s; %s\n" ),
139  GetSettingsKey(),
140  GetErrorMessage(),
142  severity );
143  }
144 }
virtual wxPoint GetPosition() const
Definition: eda_item.h:252
virtual wxString GetViolatingRuleDesc() const
Definition: rc_item.h:155
static wxString ShowCoord(EDA_UNITS aUnits, const wxPoint &aPos)
Format a coordinate or position to text.
Definition: rc_item.cpp:47
KIID GetAuxItemID() const
Definition: rc_item.h:121
bool IsExcluded() const
Definition: marker_base.h:94
void Format(OUTPUTFORMATTER *out, int aNestLevel, int aCtl, const CPTREE &aTree)
Output a PTREE into s-expression format via an OUTPUTFORMATTER derivative.
Definition: ptree.cpp:200
MARKER_BASE * m_parent
The marker this item belongs to, if any.
Definition: rc_item.h:170
virtual wxString GetSelectMenuText(EDA_UNITS aUnits) const
Return the text to display to be used in the selection clarification context menu when multiple items...
Definition: eda_item.cpp:109
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:100
wxString GetSettingsKey() const
Definition: rc_item.h:150
KIID GetMainItemID() const
Definition: rc_item.h:120
virtual wxString GetErrorMessage() const
Return the error message of a RC_ITEM.
Definition: rc_item.cpp:38

References Format(), RC_ITEM::GetAuxItemID(), RC_ITEM::GetErrorMessage(), RC_ITEM::GetMainItemID(), EDA_ITEM::GetPosition(), EDA_ITEM::GetSelectMenuText(), RC_ITEM::GetSettingsKey(), RC_ITEM::GetViolatingRuleDesc(), MARKER_BASE::IsExcluded(), RC_ITEM::m_parent, RPT_SEVERITY_ACTION, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, RPT_SEVERITY_WARNING, and RC_ITEM::ShowCoord().

Member Data Documentation

◆ m_errorCode

int RC_ITEM::m_errorCode
protectedinherited

◆ m_errorMessage

wxString CLEANUP_ITEM::m_errorMessage
private

Definition at line 60 of file cleanup_item.h.

◆ m_errorTitle

wxString RC_ITEM::m_errorTitle
protectedinherited

The string describing the type of error.

Definition at line 168 of file rc_item.h.

Referenced by CLEANUP_ITEM(), DRC_ITEM::DRC_ITEM(), ERC_ITEM::ERC_ITEM(), RC_ITEM::GetErrorText(), and RC_ITEM::RC_ITEM().

◆ m_ids

◆ m_parent

MARKER_BASE* RC_ITEM::m_parent
protectedinherited

The marker this item belongs to, if any.

Definition at line 170 of file rc_item.h.

Referenced by DRC_ITEM::DRC_ITEM(), RC_ITEM::GetParent(), RC_ITEM::RC_ITEM(), RC_ITEM::SetParent(), and RC_ITEM::ShowReport().

◆ m_settingsKey

wxString RC_ITEM::m_settingsKey
protectedinherited

The key used to describe this type of error in settings.

Definition at line 169 of file rc_item.h.

Referenced by DRC_ITEM::DRC_ITEM(), ERC_ITEM::ERC_ITEM(), RC_ITEM::GetSettingsKey(), and RC_ITEM::RC_ITEM().


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