kicad/pcbnew/collectors.cpp

623 lines
18 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.
2007-08-23 04:28:46 +00:00
*
* Copyright (C) 2007-2008 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
* Copyright (C) 2004-2018 KiCad Developers, see AUTHORS.txt for contributors.
*
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.
*
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.
*
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:
* 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
*/
#include <collectors.h>
2020-11-14 18:11:28 +00:00
#include <board_item.h> // class BOARD_ITEM
#include <footprint.h>
#include <fp_shape.h>
#include <pad.h>
#include <track.h>
2020-11-14 18:11:28 +00:00
#include <pcb_marker.h>
#include <dimension.h>
#include <zone.h>
#include <pcb_shape.h>
#include <pcb_group.h>
#include <macros.h>
#include <math/util.h> // for KiROUND
2007-08-23 04:28:46 +00:00
2020-11-13 02:57:11 +00:00
/*
* This module contains out of line member functions for classes given in
* collectors.h. Those classes augment the functionality of class PCB_EDIT_FRAME.
*/
2007-08-23 04:28:46 +00:00
2007-08-30 22:20:52 +00:00
const KICAD_T GENERAL_COLLECTOR::AllBoardItems[] = {
2007-10-03 19:45:32 +00:00
// there are some restrictions on the order of items in the general case.
// all items in m_Drawings for instance should be contiguous.
// *** all items in a same list (shown here) must be contiguous ****
PCB_MARKER_T, // in m_markers
PCB_TEXT_T, // in m_drawings
PCB_SHAPE_T, // in m_drawings
PCB_DIM_ALIGNED_T, // in m_drawings
PCB_DIM_CENTER_T, // in m_drawings
PCB_DIM_ORTHOGONAL_T, // in m_drawings
PCB_DIM_LEADER_T, // in m_drawings
PCB_TARGET_T, // in m_drawings
PCB_VIA_T, // in m_tracks
PCB_TRACE_T, // in m_tracks
PCB_ARC_T, // in m_tracks
PCB_PAD_T, // in footprints
PCB_FP_TEXT_T, // in footprints
2020-11-13 12:21:02 +00:00
PCB_FOOTPRINT_T, // in m_footprints
PCB_GROUP_T, // in m_groups
PCB_ZONE_T, // in m_zones
2007-08-23 04:28:46 +00:00
EOT
};
2007-08-23 04:28:46 +00:00
const KICAD_T GENERAL_COLLECTOR::BoardLevelItems[] = {
PCB_MARKER_T,
PCB_TEXT_T,
PCB_SHAPE_T,
PCB_DIM_ALIGNED_T,
2020-09-22 02:32:40 +00:00
PCB_DIM_ORTHOGONAL_T,
PCB_DIM_CENTER_T,
PCB_DIM_LEADER_T,
PCB_TARGET_T,
PCB_VIA_T,
PCB_ARC_T,
PCB_TRACE_T,
2020-11-13 12:21:02 +00:00
PCB_FOOTPRINT_T,
PCB_GROUP_T,
PCB_ZONE_T,
EOT
};
2007-09-06 04:34:03 +00:00
2020-11-14 19:16:42 +00:00
const KICAD_T GENERAL_COLLECTOR::Footprints[] = {
2020-11-13 12:21:02 +00:00
PCB_FOOTPRINT_T,
EOT
};
const KICAD_T GENERAL_COLLECTOR::PadsOrTracks[] = {
PCB_PAD_T,
PCB_VIA_T,
PCB_TRACE_T,
PCB_ARC_T,
EOT
};
2020-11-14 19:16:42 +00:00
const KICAD_T GENERAL_COLLECTOR::FootprintItems[] = {
PCB_FP_TEXT_T,
PCB_FP_SHAPE_T,
PCB_PAD_T,
PCB_FP_ZONE_T,
PCB_GROUP_T,
EOT
};
const KICAD_T GENERAL_COLLECTOR::Tracks[] = {
PCB_TRACE_T,
PCB_ARC_T,
PCB_VIA_T,
EOT
};
const KICAD_T GENERAL_COLLECTOR::LockableItems[] = {
2020-11-13 12:21:02 +00:00
PCB_FOOTPRINT_T,
PCB_GROUP_T, // Can a group be locked?
PCB_TRACE_T,
PCB_ARC_T,
PCB_VIA_T,
EOT
};
const KICAD_T GENERAL_COLLECTOR::Zones[] = {
PCB_ZONE_T,
PCB_FP_ZONE_T,
EOT
};
const KICAD_T GENERAL_COLLECTOR::Dimensions[] = {
PCB_DIM_ALIGNED_T,
PCB_DIM_LEADER_T,
2020-09-22 02:32:40 +00:00
PCB_DIM_ORTHOGONAL_T,
PCB_DIM_CENTER_T,
EOT
};
SEARCH_RESULT GENERAL_COLLECTOR::Inspect( EDA_ITEM* testItem, void* testData )
2007-08-23 04:28:46 +00:00
{
BOARD_ITEM* item = (BOARD_ITEM*) testItem;
2020-11-13 15:15:52 +00:00
FOOTPRINT* footprint = nullptr;
PCB_GROUP* group = nullptr;
2020-11-12 22:30:02 +00:00
PAD* pad = nullptr;
bool pad_through = false;
VIA* via = nullptr;
2020-11-14 18:11:28 +00:00
PCB_MARKER* marker = nullptr;
ZONE* zone = nullptr;
PCB_SHAPE* shape = nullptr;
DIMENSION_BASE* dimension = nullptr;
#if 0 // debugging
static int breakhere = 0;
2007-09-01 12:00:30 +00:00
switch( item->Type() )
{
case PCB_PAD_T:
{
2020-11-13 15:15:52 +00:00
FOOTPRINT* footprint = (FOOTPRINT*) item->GetParent();
2020-11-13 02:57:11 +00:00
if( footprint->GetReference() == wxT( "Y2" ) )
breakhere++;
}
2007-09-05 04:48:47 +00:00
break;
case PCB_VIA_T:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
case PCB_TRACE_T:
case PCB_ARC_T:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
case PCB_TEXT_T:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
case PCB_SHAPE_T:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
case PCB_DIM_ALIGNED_T:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
case PCB_FP_TEXT_T:
{
2020-11-13 02:57:11 +00:00
FP_TEXT* fpText = (FP_TEXT*) item;
2020-11-13 02:57:11 +00:00
if( fpText->GetText() == wxT( "10uH" ) )
breakhere++;
}
2007-09-05 04:48:47 +00:00
break;
2020-11-13 12:21:02 +00:00
case PCB_FOOTPRINT_T:
2007-09-05 04:48:47 +00:00
{
2020-11-13 15:15:52 +00:00
FOOTPRINT* footprint = (FOOTPRINT*) item;
2020-11-13 02:57:11 +00:00
if( footprint->GetReference() == wxT( "C98" ) )
breakhere++;
2007-09-05 04:48:47 +00:00
}
break;
case PCB_MARKER_T:
breakhere++;
break;
default:
2007-09-05 04:48:47 +00:00
breakhere++;
break;
}
#endif
2007-08-30 22:20:52 +00:00
2007-09-05 04:48:47 +00:00
switch( item->Type() )
{
case PCB_PAD_T:
// there are pad specific visibility controls.
// Criterias to select a pad is:
2020-11-13 02:57:11 +00:00
// for smd pads: the footprint parent must be visible, and pads on the corresponding
// board side must be visible
// if pad is a thru hole, then it can be visible when its parent footprint is not.
// for through pads: pads on Front or Back board sides must be visible
2020-11-12 22:30:02 +00:00
pad = static_cast<PAD*>( item );
if( (pad->GetAttribute() != PAD_ATTRIB_SMD) &&
2020-11-13 02:57:11 +00:00
(pad->GetAttribute() != PAD_ATTRIB_CONN) ) // a hole is present, so multiple layers
2007-09-22 04:33:44 +00:00
{
2020-11-13 02:57:11 +00:00
// proceed to the common tests below, but without the parent footprint test,
// by leaving footprint==NULL, but having pad != null
pad_through = true;
2007-09-22 04:33:44 +00:00
}
2020-11-13 02:57:11 +00:00
else // smd, so use pads test after footprint test
{
2020-11-13 15:15:52 +00:00
footprint = static_cast<FOOTPRINT*>( item->GetParent() );
}
2007-09-05 04:48:47 +00:00
break;
case PCB_VIA_T: // vias are on many layers, so layer test is specific
via = static_cast<VIA*>( item );
2007-09-05 04:48:47 +00:00
break;
case PCB_TRACE_T:
case PCB_ARC_T:
if( m_Guide->IgnoreTracks() )
goto exit;
2007-09-05 04:48:47 +00:00
break;
case PCB_FP_ZONE_T:
2020-11-13 15:15:52 +00:00
footprint = static_cast<FOOTPRINT*>( item->GetParent() );
// Fallthrough to get the zone as well
KI_FALLTHROUGH;
case PCB_ZONE_T:
zone = static_cast<ZONE*>( item );
break;
case PCB_TEXT_T:
2007-09-05 04:48:47 +00:00
break;
case PCB_SHAPE_T:
shape = static_cast<PCB_SHAPE*>( item );
2007-09-05 04:48:47 +00:00
break;
case PCB_DIM_ALIGNED_T:
2020-09-17 00:54:58 +00:00
case PCB_DIM_CENTER_T:
case PCB_DIM_ORTHOGONAL_T:
case PCB_DIM_LEADER_T:
dimension = static_cast<DIMENSION_BASE*>( item );
2007-09-05 04:48:47 +00:00
break;
case PCB_TARGET_T:
break;
case PCB_FP_TEXT_T:
2007-09-05 04:48:47 +00:00
{
FP_TEXT *text = static_cast<FP_TEXT*>( item );
2020-11-12 23:06:47 +00:00
if( m_Guide->IgnoreHiddenFPText() && !text->IsVisible() )
2007-09-05 04:48:47 +00:00
goto exit;
2020-11-12 23:06:47 +00:00
if( m_Guide->IgnoreFPTextOnBack() && IsBackLayer( text->GetLayer() ) )
2007-09-25 15:10:01 +00:00
goto exit;
2011-12-14 22:35:03 +00:00
2020-11-12 23:06:47 +00:00
if( m_Guide->IgnoreFPTextOnFront() && IsFrontLayer( text->GetLayer() ) )
2011-12-14 22:35:03 +00:00
goto exit;
/* The three text types have different criteria: reference
* and value have their own ignore flags; user text instead
* follows their layer visibility. Checking this here is
* simpler than later (when layer visibility is checked for
* other entities) */
switch( text->GetType() )
{
case FP_TEXT::TEXT_is_REFERENCE:
2020-11-12 23:06:47 +00:00
if( m_Guide->IgnoreFPReferences() )
goto exit;
break;
case FP_TEXT::TEXT_is_VALUE:
2020-11-12 23:06:47 +00:00
if( m_Guide->IgnoreFPValues() )
goto exit;
break;
case FP_TEXT::TEXT_is_DIVERS:
if( !m_Guide->IsLayerVisible( text->GetLayer() )
&& m_Guide->IgnoreNonVisibleLayers() )
goto exit;
break;
}
2020-11-13 02:57:11 +00:00
// Extract the footprint since it could be hidden
2020-11-13 15:15:52 +00:00
footprint = static_cast<FOOTPRINT*>( item->GetParent() );
2007-09-05 04:48:47 +00:00
}
break;
case PCB_FP_SHAPE_T:
shape = static_cast<FP_SHAPE*>( item );
break;
2020-11-13 12:21:02 +00:00
case PCB_FOOTPRINT_T:
2020-11-13 15:15:52 +00:00
footprint = static_cast<FOOTPRINT*>( item );
2007-09-05 04:48:47 +00:00
break;
case PCB_GROUP_T:
group = static_cast<PCB_GROUP*>( item );
break;
case PCB_MARKER_T:
2020-11-14 18:11:28 +00:00
marker = static_cast<PCB_MARKER*>( item );
break;
2007-09-05 04:48:47 +00:00
default:
break;
}
2007-09-05 04:48:47 +00:00
// common tests:
2020-11-13 15:15:52 +00:00
if( footprint ) // true from case PCB_PAD_T, PCB_FP_TEXT_T, or PCB_FOOTPRINT_T
{
2020-11-13 02:57:11 +00:00
if( m_Guide->IgnoreFootprintsOnBack() && ( footprint->GetLayer() == B_Cu) )
goto exit;
2020-11-13 02:57:11 +00:00
if( m_Guide->IgnoreFootprintsOnFront() && ( footprint->GetLayer() == F_Cu) )
goto exit;
}
2007-09-15 04:25:54 +00:00
// Pads are not sensitive to the layer visibility controls.
// They all have their own separate visibility controls
// skip them if not visible
if( pad )
{
if( m_Guide->IgnorePads() )
goto exit;
if( ! pad_through )
{
if( m_Guide->IgnorePadsOnFront() && pad->IsOnLayer(F_Cu ) )
goto exit;
if( m_Guide->IgnorePadsOnBack() && pad->IsOnLayer(B_Cu ) )
goto exit;
}
}
if( marker )
{
// Markers are not sensitive to the layer
2020-10-02 20:25:14 +00:00
if( marker->HitTest( m_refPos ) )
Append( item );
goto exit;
}
if( group )
{
// Groups are not sensitive to the layer ... ?
2020-10-02 20:25:14 +00:00
if( group->HitTest( m_refPos ) )
Append( item );
goto exit;
}
if( via )
{
auto type = via->GetViaType();
2019-12-28 00:55:11 +00:00
if( ( m_Guide->IgnoreThroughVias() && type == VIATYPE::THROUGH )
|| ( m_Guide->IgnoreBlindBuriedVias() && type == VIATYPE::BLIND_BURIED )
|| ( m_Guide->IgnoreMicroVias() && type == VIATYPE::MICROVIA ) )
{
goto exit;
}
}
if( item->IsOnLayer( m_Guide->GetPreferredLayer() ) || m_Guide->IgnorePreferredLayer() )
2007-08-23 04:28:46 +00:00
{
PCB_LAYER_ID layer = item->GetLayer();
2007-09-15 04:25:54 +00:00
// footprints and their subcomponents: reference, value and pads are not sensitive
// to the layer visibility controls. They all have their own separate visibility
// controls for vias, GetLayer() has no meaning, but IsOnLayer() works fine. User
2020-11-13 02:57:11 +00:00
// text in a footprint *is* sensitive to layer visibility but that was already handled.
2020-11-13 02:57:11 +00:00
if( via || footprint || pad || m_Guide->IsLayerVisible( layer )
|| !m_Guide->IgnoreNonVisibleLayers() )
2007-08-23 04:28:46 +00:00
{
if( !m_Guide->IsLayerLocked( layer ) || !m_Guide->IgnoreLockedLayers() )
{
2007-08-30 22:20:52 +00:00
if( !item->IsLocked() || !m_Guide->IgnoreLockedItems() )
{
int accuracy = KiROUND( 5 * m_Guide->OnePixelInIU() );
if( zone )
2007-08-30 22:20:52 +00:00
{
bool testFill = !m_Guide->IgnoreZoneFills();
2020-10-02 20:25:14 +00:00
if( zone->HitTestForCorner( m_refPos, accuracy * 2 )
|| zone->HitTestForEdge( m_refPos, accuracy )
|| ( testFill && zone->HitTestFilledArea( layer, m_refPos ) ) )
{
Append( item );
goto exit;
}
}
2020-11-13 12:21:02 +00:00
else if( item->Type() == PCB_FOOTPRINT_T )
{
2020-11-13 02:57:11 +00:00
if( footprint->HitTest( m_refPos, accuracy )
&& footprint->HitTestAccurate( m_refPos, accuracy ) )
{
Append( item );
goto exit;
}
}
else if( shape )
{
if( shape->HitTest( m_refPos, accuracy ) )
{
Append( shape );
goto exit;
}
}
else if( dimension )
{
// Dimensions feels particularly hard to select, probably due to their
// noisy shape making it feel like they should have a larger bounary.
if( dimension->HitTest( m_refPos, KiROUND( accuracy * 1.5 ) ) )
{
Append( dimension );
goto exit;
}
}
else
{
2020-10-02 20:25:14 +00:00
if( item->HitTest( m_refPos, 0 ) )
{
Append( item );
goto exit;
}
}
2007-08-30 22:20:52 +00:00
}
}
2007-08-23 04:28:46 +00:00
}
2007-08-30 22:20:52 +00:00
}
if( m_Guide->IncludeSecondary() )
{
// for now, "secondary" means "tolerate any layer". It has
// no effect on other criteria, since there is a separate "ignore" control for
2007-08-30 22:20:52 +00:00
// those in the COLLECTORS_GUIDE
PCB_LAYER_ID layer = item->GetLayer();
// footprints and their subcomponents: reference, value and pads are not sensitive
// to the layer visibility controls. They all have their own separate visibility
// controls for vias, GetLayer() has no meaning, but IsOnLayer() works fine. User
2020-11-13 02:57:11 +00:00
// text in a footprint *is* sensitive to layer visibility but that was already handled.
2020-11-13 02:57:11 +00:00
if( via || footprint || pad || zone || m_Guide->IsLayerVisible( layer )
|| !m_Guide->IgnoreNonVisibleLayers() )
2007-08-23 04:28:46 +00:00
{
if( !m_Guide->IsLayerLocked( layer ) || !m_Guide->IgnoreLockedLayers() )
2007-08-30 22:20:52 +00:00
{
if( !item->IsLocked() || !m_Guide->IgnoreLockedItems() )
{
int accuracy = KiROUND( 5 * m_Guide->OnePixelInIU() );
if( zone )
2007-08-30 22:20:52 +00:00
{
bool testFill = !m_Guide->IgnoreZoneFills();
2020-10-02 20:25:14 +00:00
if( zone->HitTestForCorner( m_refPos, accuracy * 2 )
|| zone->HitTestForEdge( m_refPos, accuracy )
|| ( testFill && zone->HitTestFilledArea( layer, m_refPos ) ) )
{
Append2nd( item );
goto exit;
}
2007-08-30 22:20:52 +00:00
}
2020-11-13 12:21:02 +00:00
else if( item->Type() == PCB_FOOTPRINT_T )
{
2020-11-13 02:57:11 +00:00
if( footprint->HitTest( m_refPos, accuracy )
&& footprint->HitTestAccurate( m_refPos, accuracy ) )
{
Append( item );
goto exit;
}
}
else if( shape )
{
if( shape->HitTest( m_refPos, accuracy ) )
{
Append( shape );
goto exit;
}
}
else if( dimension )
{
// Dimensions feels particularly hard to select, probably due to their
// noisy shape making it feel like they should have a larger bounary.
if( dimension->HitTest( m_refPos, KiROUND( accuracy * 1.5 ) ) )
{
Append( dimension );
goto exit;
}
}
else
{
2020-10-02 20:25:14 +00:00
if( item->HitTest( m_refPos, 0 ) )
{
Append( item );
goto exit;
}
}
2007-08-30 22:20:52 +00:00
}
}
2007-08-23 04:28:46 +00:00
}
}
2007-08-30 22:20:52 +00:00
exit:
2019-12-28 00:55:11 +00:00
return SEARCH_RESULT::CONTINUE; // always when collecting
2007-08-23 04:28:46 +00:00
}
2007-09-11 04:16:31 +00:00
void GENERAL_COLLECTOR::Collect( BOARD_ITEM* aItem, const KICAD_T aScanList[],
const wxPoint& aRefPos, const COLLECTORS_GUIDE& aGuide )
2007-08-30 03:53:26 +00:00
{
Empty(); // empty the collection, primary criteria list
Empty2nd(); // empty the collection, secondary criteria list
2007-08-30 22:20:52 +00:00
// remember guide, pass it to Inspect()
2007-09-11 04:16:31 +00:00
SetGuide( &aGuide );
SetScanTypes( aScanList );
2007-08-30 22:20:52 +00:00
// remember where the snapshot was taken from and pass refPos to
// the Inspect() function.
2007-09-06 04:34:03 +00:00
SetRefPos( aRefPos );
2007-08-30 03:53:26 +00:00
2020-10-02 20:25:14 +00:00
aItem->Visit( m_inspector, NULL, m_scanTypes );
// record the length of the primary list before concatenating on to it.
2020-10-02 20:25:14 +00:00
m_PrimaryLength = m_list.size();
// append 2nd list onto end of the first list
for( unsigned i = 0; i<m_List2nd.size(); ++i )
2007-08-30 22:20:52 +00:00
Append( m_List2nd[i] );
2007-08-30 03:53:26 +00:00
Empty2nd();
}
SEARCH_RESULT PCB_TYPE_COLLECTOR::Inspect( EDA_ITEM* testItem, void* testData )
{
// The Visit() function only visits the testItem if its type was in the
// the scanList, so therefore we can collect anything given to us here.
Append( testItem );
2008-02-19 16:54:57 +00:00
2019-12-28 00:55:11 +00:00
return SEARCH_RESULT::CONTINUE; // always when collecting
}
void PCB_TYPE_COLLECTOR::Collect( BOARD_ITEM* aBoard, const KICAD_T aScanList[] )
{
Empty(); // empty any existing collection
2008-02-19 16:54:57 +00:00
aBoard->Visit( m_inspector, NULL, aScanList );
}
SEARCH_RESULT PCB_LAYER_COLLECTOR::Inspect( EDA_ITEM* testItem, void* testData )
{
BOARD_ITEM* item = (BOARD_ITEM*) testItem;
if( item->IsOnLayer( m_layer_id ) )
Append( testItem );
2019-12-28 00:55:11 +00:00
return SEARCH_RESULT::CONTINUE;
}
void PCB_LAYER_COLLECTOR::Collect( BOARD_ITEM* aBoard, const KICAD_T aScanList[] )
{
Empty();
aBoard->Visit( m_inspector, NULL, aScanList );
}