KiCad PCB EDA Suite
COLLECTORS_GUIDE Class Referenceabstract

An abstract base class whose derivatives may be passed to a GENERAL_COLLECTOR, telling GENERAL_COLLECTOR what should be collected (aside from HitTest()ing and KICAD_T scanTypes[], information which are provided to the GENERAL_COLLECTOR through attributes or arguments separately). More...

#include <collectors.h>

Inheritance diagram for COLLECTORS_GUIDE:
GENERAL_COLLECTORS_GUIDE

Public Member Functions

virtual ~COLLECTORS_GUIDE ()
 
virtual bool IsLayerLocked (PCB_LAYER_ID layer) const =0
 
virtual bool IsLayerVisible (PCB_LAYER_ID layer) const =0
 
virtual bool IgnoreLockedLayers () const =0
 
virtual bool IgnoreNonVisibleLayers () const =0
 
virtual PCB_LAYER_ID GetPreferredLayer () const =0
 
virtual bool IgnorePreferredLayer () const =0
 Provide wildcard behavior regarding the preferred layer. More...
 
virtual bool IgnoreLockedItems () const =0
 
virtual bool IncludeSecondary () const =0
 Determine if the secondary criteria or 2nd choice items should be included. More...
 
virtual bool IgnoreMTextsMarkedNoShow () const =0
 
virtual bool IgnoreMTextsOnBack () const =0
 
virtual bool IgnoreMTextsOnFront () const =0
 
virtual bool IgnoreModulesOnBack () const =0
 
virtual bool IgnoreModulesOnFront () const =0
 
virtual bool IgnorePadsOnBack () const =0
 
virtual bool IgnorePadsOnFront () const =0
 
virtual bool IgnorePads () const
 
virtual bool IgnoreModulesVals () const =0
 
virtual bool IgnoreModulesRefs () const =0
 

Detailed Description

An abstract base class whose derivatives may be passed to a GENERAL_COLLECTOR, telling GENERAL_COLLECTOR what should be collected (aside from HitTest()ing and KICAD_T scanTypes[], information which are provided to the GENERAL_COLLECTOR through attributes or arguments separately).

A justification for this class is to keep the structural storage details of the program's "global preferences" or "configuration options" out of GENERAL_COLLECTOR::Inspect(). This class carries all the necessary details in with it to the Inspect() call. The constructors or other functions of this class's derivatives are then the only place where knowledge of the specific structure of the global preference storage is needed. Thus, GENERAL_COLLECTOR::Inspect() can be kept as simple as possible, and insulated from changes in global preference storage (and even then it is not simple enough).

This class introduces the notion of layer locking.

Definition at line 63 of file collectors.h.

Constructor & Destructor Documentation

virtual COLLECTORS_GUIDE::~COLLECTORS_GUIDE ( )
inlinevirtual

Definition at line 67 of file collectors.h.

67 {}

Member Function Documentation

virtual PCB_LAYER_ID COLLECTORS_GUIDE::GetPreferredLayer ( ) const
pure virtual
Returns
int - the preferred layer for HitTest()ing.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreLockedItems ( ) const
pure virtual
Returns
bool - true if should ignore locked items, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreLockedLayers ( ) const
pure virtual
Returns
bool - true if should ignore locked layers, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreModulesOnBack ( ) const
pure virtual
Returns
bool - true if should ignore MODULEs on Back Side.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreModulesOnFront ( ) const
pure virtual
Returns
bool - ture if should ignore MODULEs on Front Side.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreModulesRefs ( ) const
pure virtual
Returns
bool - true if should ignore module references.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreModulesVals ( ) const
pure virtual
Returns
bool - true if should ignore modules values.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreMTextsMarkedNoShow ( ) const
pure virtual
Returns
bool - true if MTexts marked as "no show" should be ignored.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreMTextsOnBack ( ) const
pure virtual
Returns
bool - true if should ignore MTexts on back layers

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreMTextsOnFront ( ) const
pure virtual
Returns
bool - true if should ignore MTexts on front layers.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnoreNonVisibleLayers ( ) const
pure virtual
Returns
bool - true if should ignore non-visible layers, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnorePads ( ) const
inlinevirtual
Returns
bool - true if should ignore PADSs on Front side and Back side.

Definition at line 151 of file collectors.h.

References IgnorePadsOnBack(), and IgnorePadsOnFront().

Referenced by GENERAL_COLLECTOR::Inspect().

152  {
153  return IgnorePadsOnFront() && IgnorePadsOnBack();
154  }
virtual bool IgnorePadsOnFront() const =0
virtual bool IgnorePadsOnBack() const =0
virtual bool COLLECTORS_GUIDE::IgnorePadsOnBack ( ) const
pure virtual
Returns
bool - true if should ignore Pads on Back Side.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by IgnorePads(), and GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnorePadsOnFront ( ) const
pure virtual
Returns
bool - ture if should ignore PADSs on Front Side.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by IgnorePads(), and GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IgnorePreferredLayer ( ) const
pure virtual

Provide wildcard behavior regarding the preferred layer.

Returns
bool - true if should ignore preferred layer, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IncludeSecondary ( ) const
pure virtual

Determine if the secondary criteria or 2nd choice items should be included.

Returns
bool - true if should include, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IsLayerLocked ( PCB_LAYER_ID  layer) const
pure virtual
Returns
bool - true if the given layer is locked, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().

virtual bool COLLECTORS_GUIDE::IsLayerVisible ( PCB_LAYER_ID  layer) const
pure virtual
Returns
bool - true if the given layer is visible, else false.

Implemented in GENERAL_COLLECTORS_GUIDE.

Referenced by GENERAL_COLLECTOR::Inspect().


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