kicad/pcbnew/collectors.h

555 lines
17 KiB
C
Raw Normal View History

2007-08-23 04:28:46 +00:00
/*
* This program source code file is part of KICAD, a free EDA CAD application.
*
* Copyright (C) 2007-2008 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
2007-08-23 04:28:46 +00:00
* Copyright (C) 2004-2007 Kicad Developers, see change_log.txt for contributors.
2008-02-19 16:54:57 +00:00
*
2007-08-23 04:28:46 +00:00
* 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.
2008-02-19 16:54:57 +00:00
*
2007-08-23 04:28:46 +00:00
* 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.
2008-02-19 16:54:57 +00:00
*
2007-08-23 04:28:46 +00:00
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
2008-02-19 16:54:57 +00:00
* 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.,
2007-08-23 04:28:46 +00:00
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
#ifndef COLLECTORS_H
#define COLLECTORS_H
/* This module contains a number of COLLECTOR implementations which are used
to augment the functionality of class WinEDA_PcbFrame.
*/
#include "class_collector.h"
2007-08-30 22:20:52 +00:00
#include "pcbstruct.h" // LAYER_COUNT, layer defs
2007-08-23 04:28:46 +00:00
2007-08-30 03:53:26 +00:00
/**
* Class COLLECTORS_GUIDE
2008-02-19 16:54:57 +00:00
* is 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).
2007-08-30 22:20:52 +00:00
* <p>
* A justification for this class is to keep the structural storage details of
2008-02-19 16:54:57 +00:00
* the program's "global preferences" or "configuration options" out of
2007-08-30 22:20:52 +00:00
* 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
2008-02-19 16:54:57 +00:00
* 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
2007-08-30 22:20:52 +00:00
* not simple enough).
2007-08-30 03:53:26 +00:00
* <p>
* This class introduces the notion of layer locking.
*/
2008-02-19 16:54:57 +00:00
class COLLECTORS_GUIDE
2007-08-30 03:53:26 +00:00
{
2008-02-19 16:54:57 +00:00
2007-08-30 03:53:26 +00:00
public:
virtual ~COLLECTORS_GUIDE() {}
/**
* Function IsLayerLocked
* @return bool - true if the given layer is locked, else false.
*/
virtual bool IsLayerLocked( int layer ) const = 0;
2008-02-19 16:54:57 +00:00
2007-08-30 03:53:26 +00:00
/**
* Function IsLayerVisible
* @return bool - true if the given layer is visible, else false.
*/
virtual bool IsLayerVisible( int layer ) const = 0;
2008-02-19 16:54:57 +00:00
2007-08-30 03:53:26 +00:00
/**
* Function IgnoreLockedLayers
2007-08-30 22:20:52 +00:00
* @return bool - true if should ignore locked layers, else false.
2007-08-30 03:53:26 +00:00
*/
virtual bool IgnoreLockedLayers() const = 0;
2008-02-19 16:54:57 +00:00
2007-08-30 03:53:26 +00:00
/**
* Function IgnoredNonVisibleLayers
* @return bool - true if should ignore non-visible layers, else false.
*/
virtual bool IgnoreNonVisibleLayers() const = 0;
2008-02-19 16:54:57 +00:00
2007-08-30 03:53:26 +00:00
/**
* Function GetPreferredLayer
* @return int - the preferred layer for HitTest()ing.
*/
virtual int GetPreferredLayer() const = 0;
2007-08-30 22:20:52 +00:00
/**
* Function IgnorePreferredLayer
* provides wildcard behavior regarding the preferred layer.
* @return bool - true if should ignore preferred layer, else false.
*/
virtual bool IgnorePreferredLayer() const = 0;
/**
* Function IgnoreLockedItems
* @return bool - true if should ignore locked items, else false.
*/
virtual bool IgnoreLockedItems() const = 0;
/**
* Function IncludeSecondary
* determines if the secondary criteria, or 2nd choice items should be
* included.
* @return bool - true if should include, else false.
*/
virtual bool IncludeSecondary() const = 0;
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreMTextsMarkedNoShow
2007-10-31 20:02:34 +00:00
* @return bool - true if MTexts marked as "no show" should be ignored.
2007-09-01 12:00:30 +00:00
*/
virtual bool IgnoreMTextsMarkedNoShow() const = 0;
2008-02-19 16:54:57 +00:00
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreZones
* @return bool - true if should ignore zones.
virtual bool IgnoreZones() const = 0;
can simply omit from scanTypes[] TYPE_ZONE */
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreMTextsOnCu
* @return bool - true if should ignore MTexts on copper layer.
*/
virtual bool IgnoreMTextsOnCopper() const = 0;
/**
* Function IgnoreMTextsOnCmp
* @return bool - true if should ignore MTexts on component layer.
*/
virtual bool IgnoreMTextsOnCmp() const = 0;
2008-02-19 16:54:57 +00:00
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreModulesOnCu
* @return bool - true if should ignore MODULEs on copper layer.
*/
virtual bool IgnoreModulesOnCu() const = 0;
/**
* Function IgnoreModulesOnCmp
* @return bool - ture if should ignore MODULEs on component layer.
*/
virtual bool IgnoreModulesOnCmp() const = 0;
2007-09-25 15:10:01 +00:00
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function UseHitTesting
* @return bool - true if Inspect() should use BOARD_ITEM::HitTest()
* or false if Inspect() should use BOARD_ITEM::BoundsTest().
virtual bool UseHitTesting() const = 0;
*/
2007-08-30 03:53:26 +00:00
};
2007-08-23 04:28:46 +00:00
/**
2007-08-30 22:20:52 +00:00
* Class GENERAL_COLLECTOR
2008-02-19 16:54:57 +00:00
* is intended for use when the right click button is pressed, or when the
2007-08-23 04:28:46 +00:00
* plain "arrow" tool is in effect. This class can be used by window classes
* such as WinEDA_PcbFrame.
*
* Philosophy: this class knows nothing of the context in which a BOARD is used
2008-02-19 16:54:57 +00:00
* and that means it knows nothing about which layers are visible or current,
2007-08-23 04:28:46 +00:00
* but can handle those concerns by the SetPreferredLayer() function and the
* SetLayerMask() fuction.
*/
2007-08-30 22:20:52 +00:00
class GENERAL_COLLECTOR : public COLLECTOR
2007-08-23 04:28:46 +00:00
{
2008-02-19 16:54:57 +00:00
protected:
2007-08-23 04:28:46 +00:00
/**
2008-02-19 16:54:57 +00:00
* A place to hold collected objects which don't match precisely the search
* criteria, but would be acceptable if nothing else is found.
* "2nd" choice, which will be appended to the end of COLLECTOR's prime
2007-08-23 04:28:46 +00:00
* "list" at the end of the search.
*/
2007-08-30 22:20:52 +00:00
std::vector<BOARD_ITEM*> m_List2nd;
2008-02-19 16:54:57 +00:00
2007-08-23 04:28:46 +00:00
/**
2007-08-30 22:20:52 +00:00
* Determines which items are to be collected by Inspect()
2007-08-23 04:28:46 +00:00
*/
2007-09-11 04:15:39 +00:00
const COLLECTORS_GUIDE* m_Guide;
2008-02-19 16:54:57 +00:00
/**
2008-02-19 16:54:57 +00:00
* The number of items that were originally in the primary list before the
* m_List2nd was concatonated onto the end of it.
*/
int m_PrimaryLength;
2007-08-30 22:20:52 +00:00
2008-02-19 16:54:57 +00:00
2007-08-23 04:28:46 +00:00
public:
2007-09-11 04:15:39 +00:00
/**
* A scan list for all editable board items, like PcbGeneralLocateAndDisplay()
*/
2007-08-23 04:28:46 +00:00
static const KICAD_T AllBoardItems[];
2007-09-25 15:10:01 +00:00
/**
* A scan list for all editable board items, except zones
*/
static const KICAD_T AllButZones[];
2008-02-19 16:54:57 +00:00
/**
2007-09-11 04:15:39 +00:00
* A scan list for all primary board items, omitting items which are subordinate to
2007-09-06 04:34:03 +00:00
* a MODULE, such as D_PAD and TEXTEMODULE.
static const KICAD_T PrimaryItems[];
2007-10-10 14:08:26 +00:00
*/
/**
* A scan list for only MODULEs
*/
static const KICAD_T ModuleItems[];
/**
* A scan list for PADs or MODULEs
*/
static const KICAD_T PadsOrModules[];
/**
* A scan list for PADs, TRACKs, VIAs, or ZONEs
*/
2008-02-19 16:54:57 +00:00
static const KICAD_T PadsTracksOrZones[];
/**
* A scan list for MODULEs and their items (for Modedit)
*/
static const KICAD_T ModulesAndTheirItems[];
/**
* A scan list for only TRACKS
*/
static const KICAD_T Tracks[];
2008-02-19 16:54:57 +00:00
2007-08-23 04:28:46 +00:00
/**
* Constructor GENERALCOLLECTOR
2008-02-19 16:54:57 +00:00
*/
2007-08-30 22:20:52 +00:00
GENERAL_COLLECTOR()
2007-08-23 04:28:46 +00:00
{
SetScanTypes( AllBoardItems );
}
void Empty2nd()
{
2007-08-30 22:20:52 +00:00
m_List2nd.clear();
2007-08-23 04:28:46 +00:00
}
void Append2nd( BOARD_ITEM* item )
2007-08-23 04:28:46 +00:00
{
2007-08-30 22:20:52 +00:00
m_List2nd.push_back( item );
2007-08-23 04:28:46 +00:00
}
2007-08-30 22:20:52 +00:00
/**
* Function SetGuide
2007-09-11 04:15:39 +00:00
* records which COLLECTORS_GUIDE to use.
2007-08-30 22:20:52 +00:00
* @param aGuide Which guide to use in the collection.
*/
void SetGuide( const COLLECTORS_GUIDE* aGuide ) { m_Guide = aGuide; }
2008-02-19 16:54:57 +00:00
/**
* Function operator[int]
* overloads COLLECTOR::operator[](int) to return a BOARD_ITEM* instead of
* an EDA_BaseStruct* type.
* @param ndx The index into the list.
* @return BOARD_ITEM* - or something derived from it, or NULL.
*/
BOARD_ITEM* operator[]( int ndx ) const
{
if( (unsigned)ndx < (unsigned)GetCount() )
2007-08-30 22:20:52 +00:00
return (BOARD_ITEM*) m_List[ ndx ];
return NULL;
}
2008-02-19 16:54:57 +00:00
/**
* Function GetPrimaryCount
* @return int - The number if items which met the primary search criteria
*/
int GetPrimaryCount() { return m_PrimaryLength; }
2008-02-19 16:54:57 +00:00
2007-08-23 04:28:46 +00:00
/**
* Function Inspect
2008-02-19 16:54:57 +00:00
* is the examining function within the INSPECTOR which is passed to the
2007-08-23 04:28:46 +00:00
* Iterate function.
*
* @param testItem An EDA_BaseStruct to examine.
* @param testData is not used in this class.
* @return SEARCH_RESULT - SEARCH_QUIT if the Iterator is to stop the scan,
* else SCAN_CONTINUE;
2008-02-19 16:54:57 +00:00
*/
2007-08-23 04:28:46 +00:00
SEARCH_RESULT Inspect( EDA_BaseStruct* testItem, const void* testData );
2008-02-19 16:54:57 +00:00
2007-08-23 04:28:46 +00:00
/**
2007-08-30 22:20:52 +00:00
* Function Collect
2007-10-31 20:02:34 +00:00
* scans a BOARD_ITEM using this class's Inspector method, which does the collection.
2007-09-11 04:15:39 +00:00
* @param aItem A BOARD_ITEM to scan, may be a BOARD or MODULE, or whatever.
2008-02-19 16:54:57 +00:00
* @param aScanList A list of KICAD_Ts with a terminating EOT, that specs
* what is to be collected and the priority order of the resultant
2007-09-11 04:15:39 +00:00
* collection in "m_List".
2007-08-30 22:20:52 +00:00
* @param aRefPos A wxPoint to use in hit-testing.
* @param aGuide The COLLECTORS_GUIDE to use in collecting items.
2007-08-30 03:53:26 +00:00
*/
2008-02-19 16:54:57 +00:00
void Collect( BOARD_ITEM* aItem, const KICAD_T aScanList[],
const wxPoint& aRefPos, const COLLECTORS_GUIDE& aGuide );
2007-08-23 04:28:46 +00:00
};
2007-08-30 22:20:52 +00:00
/**
* Class GENERAL_COLLECTORS_GUIDE
* is a general implementation of a COLLECTORS_GUIDE. One of its constructors is
* entitled to grab information from the program's global preferences.
2008-02-19 16:54:57 +00:00
*/
2007-08-30 22:20:52 +00:00
class GENERAL_COLLECTORS_GUIDE : public COLLECTORS_GUIDE
{
private:
2008-02-19 16:54:57 +00:00
// the storage architecture here is not important, since this is only
2007-08-30 22:20:52 +00:00
// a carrier object and its functions are what is used, and data only indirectly.
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
int m_PreferredLayer;
bool m_IgnorePreferredLayer;
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
int m_LayerLocked; ///< bit-mapped layer locked bits
bool m_IgnoreLockedLayers;
2008-02-19 16:54:57 +00:00
int m_LayerVisible; ///< bit-mapped layer visible bits
2007-08-30 22:20:52 +00:00
bool m_IgnoreNonVisibleLayers;
2008-02-19 16:54:57 +00:00
bool m_IgnoreLockedItems;
2007-08-30 22:20:52 +00:00
bool m_IncludeSecondary;
2008-02-19 16:54:57 +00:00
2007-09-01 12:00:30 +00:00
bool m_IgnoreMTextsMarkedNoShow;
bool m_IgnoreMTextsOnCopper;
bool m_IgnoreMTextsOnCmp;
bool m_IgnoreModulesOnCu;
bool m_IgnoreModulesOnCmp;
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
public:
/**
* Constructor GENERAL_COLLECTORS_GUIDE
* grabs stuff from global preferences and uses reasonable defaults.
* Add more constructors as needed.
* @param settings The EDA_BoardDesignSettings to reference.
*/
2007-09-05 04:48:47 +00:00
GENERAL_COLLECTORS_GUIDE( int aVisibleLayerMask, int aPreferredLayer )
2007-08-30 22:20:52 +00:00
{
m_PreferredLayer = LAYER_CMP_N;
m_IgnorePreferredLayer = false;
m_LayerLocked = 0;
2008-02-19 16:54:57 +00:00
m_LayerVisible = aVisibleLayerMask;
2007-08-30 22:20:52 +00:00
m_IgnoreLockedLayers = true;
m_IgnoreNonVisibleLayers = true;
2007-09-05 04:48:47 +00:00
m_IgnoreLockedItems = false;
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
#if defined(USE_MATCH_LAYER)
m_IncludeSecondary = false;
2008-02-19 16:54:57 +00:00
#else
2007-08-30 22:20:52 +00:00
m_IncludeSecondary = true;
2008-02-19 16:54:57 +00:00
#endif
2007-09-01 12:00:30 +00:00
2007-09-05 04:48:47 +00:00
m_PreferredLayer = aPreferredLayer;
2007-09-01 12:00:30 +00:00
2007-09-05 04:48:47 +00:00
m_IgnoreMTextsMarkedNoShow = true; // g_ModuleTextNOVColor;
m_IgnoreMTextsOnCopper = true;
m_IgnoreMTextsOnCmp = false;
m_IgnoreModulesOnCu = true; // !Show_Modules_Cmp;
m_IgnoreModulesOnCmp = false;
}
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IsLayerLocked
* @return bool - true if the given layer is locked, else false.
*/
bool IsLayerLocked( int aLayer ) const { return (1<<aLayer) & m_LayerLocked; }
2008-02-19 16:54:57 +00:00
void SetLayerLocked( int aLayer, bool isLocked )
2007-08-30 22:20:52 +00:00
{
if( isLocked )
m_LayerLocked |= 1 << aLayer;
else
m_LayerLocked &= ~(1 << aLayer);
}
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IsLayerVisible
* @return bool - true if the given layer is visible, else false.
*/
bool IsLayerVisible( int aLayer ) const { return (1<<aLayer) & m_LayerVisible; }
void SetLayerVisible( int aLayer, bool isVisible )
{
if( isVisible )
m_LayerVisible |= 1 << aLayer;
else
m_LayerVisible &= ~(1 << aLayer);
}
void SetLayerVisibleBits( int aLayerBits ) { m_LayerVisible = aLayerBits; }
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IgnoreLockedLayers
* @return bool - true if should ignore locked layers, else false.
*/
bool IgnoreLockedLayers() const { return m_IgnoreLockedLayers; }
void SetIgnoreLockedLayers( bool ignore ) { m_IgnoreLockedLayers = ignore; }
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IgnoredNonVisibleLayers
* @return bool - true if should ignore non-visible layers, else false.
*/
bool IgnoreNonVisibleLayers() const { return m_IgnoreNonVisibleLayers; }
void SetIgnoreNonVisibleLayers( bool ignore ) { m_IgnoreLockedLayers = ignore; }
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function GetPreferredLayer
* @return int - the preferred layer for HitTest()ing.
*/
int GetPreferredLayer() const { return m_PreferredLayer; }
void SetPreferredLayer( int aLayer ) { m_PreferredLayer = aLayer; }
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IgnorePreferredLayer
* provides wildcard behavior regarding the preferred layer.
* @return bool - true if should ignore preferred layer, else false.
*/
bool IgnorePreferredLayer() const { return m_IgnorePreferredLayer; }
void SetIgnorePreferredLayer( bool ignore ) { m_IgnorePreferredLayer = ignore; }
2008-02-19 16:54:57 +00:00
2007-08-30 22:20:52 +00:00
/**
* Function IgnoreLockedItems
* @return bool - true if should ignore locked items, else false.
*/
bool IgnoreLockedItems() const { return m_IgnoreLockedItems; }
void SetIgnoreLockedItems( bool ignore ) { m_IgnoreLockedItems = ignore; }
/**
* Function IncludeSecondary
* determines if the secondary criteria, or 2nd choice items should be
* included.
* @return bool - true if should include, else false.
*/
bool IncludeSecondary() const { return m_IncludeSecondary; }
2007-09-01 12:00:30 +00:00
void SetIncludeSecondary( bool include ) { m_IncludeSecondary = include; }
2008-02-19 16:54:57 +00:00
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreMTextsMarkedNoShow
2007-10-31 20:02:34 +00:00
* @return bool - true if MTexts marked as "no show" should be ignored.
2007-09-01 12:00:30 +00:00
*/
bool IgnoreMTextsMarkedNoShow() const { return m_IgnoreMTextsMarkedNoShow; }
void SetIgnoreMTextsMarkedNoShow( bool ignore ) { m_IgnoreMTextsMarkedNoShow = ignore; }
2008-02-19 16:54:57 +00:00
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreMTextsOnCu
* @return bool - true if should ignore MTexts on copper layer.
*/
bool IgnoreMTextsOnCopper() const { return m_IgnoreMTextsOnCopper; }
void SetIgnoreMTextsOnCopper( bool ignore ) { m_IgnoreMTextsOnCopper = ignore; }
/**
* Function IgnoreMTextsOnCmp
* @return bool - true if should ignore MTexts on component layer.
*/
bool IgnoreMTextsOnCmp() const { return m_IgnoreMTextsOnCmp; }
2008-02-19 16:54:57 +00:00
void SetIgnoreMTextsOnCmp( bool ignore ) { m_IgnoreMTextsOnCmp = ignore; }
2007-09-01 12:00:30 +00:00
/**
* Function IgnoreModulesOnCu
* @return bool - true if should ignore MODULEs on copper layer.
*/
bool IgnoreModulesOnCu() const { return m_IgnoreModulesOnCu; }
void SetIgnoreModulesOnCu( bool ignore ) { m_IgnoreModulesOnCu = ignore; }
/**
* Function IgnoreModulesOnCmp
* @return bool - ture if should ignore MODULEs on component layer.
*/
bool IgnoreModulesOnCmp() const { return m_IgnoreModulesOnCmp; }
void SetIgnoreModulesOnCmp( bool ignore ) { m_IgnoreModulesOnCmp = ignore; }
2007-08-30 22:20:52 +00:00
};
/**
* Class TYPE_COLLECTOR
* merely gathers up all BOARD_ITEMs of a given set of KICAD_T type(s).
* @see class COLLECTOR
*/
class TYPE_COLLECTOR : public COLLECTOR
{
2008-02-19 16:54:57 +00:00
public:
/**
* Function operator[int]
* overloads COLLECTOR::operator[](int) to return a BOARD_ITEM* instead of
* an EDA_BaseStruct* type.
* @param ndx The index into the list.
* @return BOARD_ITEM* - or something derived from it, or NULL.
*/
BOARD_ITEM* operator[]( int ndx ) const
{
if( (unsigned)ndx < (unsigned)GetCount() )
return (BOARD_ITEM*) m_List[ ndx ];
return NULL;
}
2008-02-19 16:54:57 +00:00
/**
* Function Inspect
2008-02-19 16:54:57 +00:00
* is the examining function within the INSPECTOR which is passed to the
* Iterate function.
*
* @param testItem An EDA_BaseStruct to examine.
* @param testData is not used in this class.
* @return SEARCH_RESULT - SEARCH_QUIT if the Iterator is to stop the scan,
* else SCAN_CONTINUE;
2008-02-19 16:54:57 +00:00
*/
SEARCH_RESULT Inspect( EDA_BaseStruct* testItem, const void* testData );
2008-02-19 16:54:57 +00:00
/**
* Function Collect
2008-02-19 16:54:57 +00:00
* scans a BOARD_ITEM using this class's Inspector method, which does
* the collection.
* @param aBoard The BOARD_ITEM to scan.
* @param aScanList The KICAD_Ts to gather up.
*/
void Collect( BOARD_ITEM* aBoard, const KICAD_T aScanList[] );
};
2007-08-23 04:28:46 +00:00
#endif // COLLECTORS_H