64 wxLogWarning( wxT(
"Attempting to call fromTo() with non-existent from-to cache." ) );
78#define MISSING_LAYER_ARG( f ) wxString::Format( _( "Missing layer name argument to %s." ), f )
93 if( !arg || arg->
AsString().IsEmpty() )
102 [item, arg, aCtx]() ->
double
104 const wxString& layerName = arg->
AsString();
113 bool anyMatch =
false;
115 for(
unsigned ii = 0; ii < layerMap.GetCount(); ++ii )
117 wxPGChoiceEntry& entry = layerMap[ ii ];
119 if( entry.GetText().Matches( layerName ))
130 aCtx->
ReportError( wxString::Format(
_(
"Unrecognized layer '%s'" ),
145 std::shared_lock<std::shared_mutex> readLock( board->
m_CachesMutex );
150 return ( item->
GetLayerSet() & i->second ).any() ? 1.0 : 0.0;
155 for(
unsigned ii = 0; ii < layerMap.GetCount(); ++ii )
157 wxPGChoiceEntry& entry = layerMap[ ii ];
159 if( entry.GetText().Matches( layerName ) )
164 std::unique_lock<std::shared_mutex> writeLock( board->
m_CachesMutex );
168 return ( item->
GetLayerSet() & mask ).any() ? 1.0 : 0.0;
205 if(
ZONE* zone =
dynamic_cast<ZONE*
>( aItem ) )
206 aItemShape.reset( zone->Outline()->Clone() );
211 return footprintCourtyard.
Collide( aItemShape.get() );
225 if( aSelector.Upper().StartsWith( wxT(
"${CLASS:" ) ) && aSelector.EndsWith(
'}' ) )
227 wxString
name = aSelector.Mid( 8, aSelector.Length() - 9 );
238 else if( aSelector.Contains(
':' ) && aFp->
GetFPIDAsString().Matches( aSelector ) )
248 const std::function<
bool(
FOOTPRINT* )>& aFunc )
250 if( aArg == wxT(
"A" ) )
254 if( fp && aFunc( fp ) )
257 else if( aArg == wxT(
"B" ) )
261 if( fp && aFunc( fp ) )
274#define MISSING_FP_ARG( f ) \
275 wxString::Format( _( "Missing footprint argument (A, B, or reference designator) to %s." ), f )
286 if( !arg || arg->
AsString().IsEmpty() )
301 [item, arg, context]() ->
double
304 std::shared_ptr<SHAPE> itemShape;
309 PTR_PTR_CACHE_KEY key = { fp, item };
313 std::shared_lock<std::shared_mutex> readLock( board->m_CachesMutex );
315 auto i = board->m_IntersectsCourtyardCache.find( key );
317 if( i != board->m_IntersectsCourtyardCache.end() )
326 std::unique_lock<std::shared_mutex> cacheLock( board->m_CachesMutex );
327 board->m_IntersectsCourtyardCache[ key ] = res;
350 if( !arg || arg->
AsString().IsEmpty() )
365 [item, arg, context]() ->
double
368 std::shared_ptr<SHAPE> itemShape;
373 PTR_PTR_CACHE_KEY key = { fp, item };
377 std::shared_lock<std::shared_mutex> readLock( board->m_CachesMutex );
379 auto i = board->m_IntersectsFCourtyardCache.find( key );
381 if( i != board->m_IntersectsFCourtyardCache.end() )
391 std::unique_lock<std::shared_mutex> writeLock( board->m_CachesMutex );
392 board->m_IntersectsFCourtyardCache[ key ] = res;
415 if( !arg || arg->
AsString().IsEmpty() )
430 [item, arg, context]() ->
double
433 std::shared_ptr<SHAPE> itemShape;
438 PTR_PTR_CACHE_KEY key = { fp, item };
442 std::shared_lock<std::shared_mutex> readLock( board->m_CachesMutex );
444 auto i = board->m_IntersectsBCourtyardCache.find( key );
446 if( i != board->m_IntersectsBCourtyardCache.end() )
456 std::unique_lock<std::shared_mutex> writeLock( board->m_CachesMutex );
457 board->m_IntersectsBCourtyardCache[ key ] = res;
475 std::shared_lock<std::shared_mutex> readLock( aBoard->
m_CachesMutex );
490 std::unique_lock<std::shared_mutex> writeLock( aBoard->
m_CachesMutex );
536 aCtx->
ReportError(
_(
"Footprint's courtyard is not a single, closed shape." ) );
548 aCtx->
ReportError(
_(
"Footprint has no front courtyard." ) );
563 aCtx->
ReportError(
_(
"Footprint has no back courtyard." ) );
576 ZONE* zone =
static_cast<ZONE*
>( aItem );
602 const std::function<
bool(
ZONE* )>& aFunc )
604 if( aArg == wxT(
"A" ) )
606 return aFunc(
dynamic_cast<ZONE*
>( aCtx->
GetItem( 0 ) ) );
608 else if( aArg == wxT(
"B" ) )
610 return aFunc(
dynamic_cast<ZONE*
>( aCtx->
GetItem( 1 ) ) );
619 auto it = cache.find( target );
621 if( it != cache.end() && it->second->Type() ==
PCB_ZONE_T )
622 return aFunc(
static_cast<ZONE*
>( it->second ) );
630 std::vector<ZONE*> matchingZones;
631 bool cacheHit =
false;
634 std::shared_lock<std::shared_mutex> readLock( aBoard->
m_CachesMutex );
639 matchingZones = it->second;
648 if( area->GetZoneName().Matches( aArg ) )
649 matchingZones.push_back( area );
654 for(
ZONE* area : footprint->Zones() )
656 if( area->GetZoneName().Matches( aArg ) )
657 matchingZones.push_back( area );
663 std::unique_lock<std::shared_mutex> writeLock( aBoard->
m_CachesMutex );
668 for(
ZONE* area : matchingZones )
695 m_item->SetLayerSet(
m_item->GetLayerSet().set( aLayer ) );
704#define MISSING_AREA_ARG( f ) \
705 wxString::Format( _( "Missing rule-area argument (A, B, or rule-area name) to %s." ), f )
716 if( !arg || arg->
AsString().IsEmpty() )
731 [item, arg, context]() ->
double
740 if( !aArea || aArea == item || aArea->GetParent() == item )
743 SCOPED_LAYERSET scopedLayerSet( aArea );
745 if( context->GetConstraint() == SILK_CLEARANCE_CONSTRAINT )
748 if( ( aArea->IsOnLayer( F_SilkS ) && IsFrontLayer( aLayer ) )
749 || ( aArea->IsOnLayer( B_SilkS ) && IsBackLayer( aLayer ) ) )
751 scopedLayerSet.Add( aLayer );
757 if( !commonLayers.any() )
766 testLayers.
set( aLayer );
768 testLayers = commonLayers;
771 std::vector<PCB_LAYER_ID> layersToCompute;
775 std::shared_lock<std::shared_mutex> readLock( board->m_CachesMutex );
777 for( PCB_LAYER_ID layer : testLayers.UIOrder() )
779 PTR_PTR_LAYER_CACHE_KEY key = { aArea, item, layer };
780 auto i = board->m_IntersectsAreaCache.find( key );
782 if( i != board->m_IntersectsAreaCache.end() )
789 layersToCompute.push_back( layer );
796 layersToCompute.push_back( layer );
799 std::vector<std::pair<PTR_PTR_LAYER_CACHE_KEY, bool>> results;
800 bool anyCollision =
false;
807 results.push_back( { { aArea, item, layer }, collides } );
813 if( !isTransient && !results.empty() )
815 std::unique_lock<std::shared_mutex> writeLock( board->m_CachesMutex );
817 for( const auto& [key, collides] : results )
818 board->m_IntersectsAreaCache[key] = collides;
841 if( !arg || arg->
AsString().IsEmpty() )
856 [item, arg, context]() ->
double
866 if( !aArea || aArea == item || aArea->GetParent() == item )
869 if( item->Type() != PCB_FOOTPRINT_T )
871 if( !( aArea->GetLayerSet() & item->GetLayerSet() ).any() )
882 std::shared_lock<std::shared_mutex> readLock( board->m_CachesMutex );
884 auto i = board->m_EnclosedByAreaCache.find( key );
886 if( i != board->m_EnclosedByAreaCache.end() )
895 itemShape = *static_cast<ZONE*>( item )->Outline();
899 FOOTPRINT* fp = static_cast<FOOTPRINT*>( item );
901 for( PCB_LAYER_ID testLayer : aArea->GetLayerSet() )
903 fp->TransformPadsToPolySet( itemShape, testLayer, 0,
904 maxError, ERROR_OUTSIDE );
905 fp->TransformFPShapesToPolySet( itemShape, testLayer, 0,
906 maxError, ERROR_OUTSIDE );
915 if( itemShape.IsEmpty() )
918 enclosedByArea = false;
922 itemShape.BooleanSubtract( *aArea->Outline() );
924 enclosedByArea = itemShape.IsEmpty();
929 std::unique_lock<std::shared_mutex> writeLock( board->m_CachesMutex );
930 board->m_EnclosedByAreaCache[ key ] = enclosedByArea;
933 return enclosedByArea;
944#define MISSING_GROUP_ARG( f ) \
945 wxString::Format( _( "Missing group name argument to %s." ), f )
955 if( !arg || arg->
AsString().IsEmpty() )
970 [item, arg]() ->
double
990#define MISSING_SHEET_ARG( f ) \
991 wxString::Format( _( "Missing sheet name argument to %s." ), f )
1001 if( !arg || arg->
AsString().IsEmpty() )
1016 [item, arg]() ->
double
1027 wxString refName = arg->
AsString();
1029 if( sheetName.EndsWith( wxT(
"/" ) ) )
1030 sheetName.RemoveLast();
1031 if( refName.EndsWith( wxT(
"/" ) ) )
1032 refName.RemoveLast();
1034 if( sheetName.Matches( refName ) )
1037 if( ( refName.Matches( wxT(
"/" ) ) || refName.IsEmpty() )
1038 && sheetName.IsEmpty() )
1056 if( !arg || arg->
AsString().IsEmpty() )
1071 [item, arg]() ->
double
1082 wxString refName = arg->
AsString();
1084 if( sheetName.EndsWith( wxT(
"/" ) ) )
1085 sheetName.RemoveLast();
1086 if( refName.EndsWith( wxT(
"/" ) ) )
1087 refName.RemoveLast();
1089 wxArrayString sheetPath = wxSplit( sheetName,
'/' );
1090 wxArrayString refPath = wxSplit( refName,
'/' );
1092 if( refPath.size() > sheetPath.size() )
1095 if( ( refName.Matches( wxT(
"/" ) ) || refName.IsEmpty() ) && sheetName.IsEmpty() )
1100 for(
size_t i = 0; i < refPath.size(); i++ )
1102 if( !sheetPath[i].Matches( refPath[i] ) )
1111#define MISSING_REF_ARG( f ) \
1112 wxString::Format( _( "Missing footprint argument (reference designator) to %s." ), f )
1122 if( !arg || arg->
AsString().IsEmpty() )
1137 [item, arg]() ->
double
1202 if(
via->IsBlindVia() ||
via->IsBuriedVia() )
1219 [a, b, context]() ->
double
1226 wxString coupledNet;
1240 if( board->FindNet( coupledNet ) )
1253#define MISSING_DP_ARG( f ) \
1254 wxString::Format( _( "Missing diff-pair name argument to %s." ), f )
1266 if( !argv || argv->
AsString().IsEmpty() )
1278 [item, argv]() ->
double
1289 wxString baseName, coupledNet;
1294 if( baseName.Matches( arg ) )
1297 if( baseName.EndsWith(
"_" ) && baseName.BeforeLast(
'_' ).Matches( arg ) )
1321 aCtx->
ReportError( wxString::Format(
_(
"Missing field name argument to %s." ),
1322 wxT(
"getField()" ) ) );
1332 [item, arg]() -> wxString
1357 if( !arg || arg->
AsString().IsEmpty() )
1360 aCtx->
ReportError(
_(
"Missing netclass name argument to hasNetclass()" ) );
1372 [item, arg]() ->
double
1396 if( !arg || arg->
AsString().IsEmpty() )
1399 aCtx->
ReportError(
_(
"Missing netclass name argument to hasExactNetclass()" ) );
1411 [item, arg]() ->
double
1418 wxString netclassName;
1422 std::shared_lock<std::shared_mutex> readLock( board->
m_CachesMutex );
1427 netclassName = it->second;
1430 if( netclassName.empty() )
1435 netclassName = netclass->
GetName();
1439 std::unique_lock<std::shared_mutex> writeLock( board->
m_CachesMutex );
1444 return ( netclassName == arg->
AsString() ) ? 1.0 : 0.0;
1457 if( !arg || arg->
AsString().IsEmpty() )
1460 aCtx->
ReportError(
_(
"Missing component class name argument to hasComponentClass()" ) );
1472 [item, arg]() ->
double
1477 footprint =
static_cast<FOOTPRINT*
>( item );
constexpr int ARC_LOW_DEF
BASE_SET & set(size_t pos)
A base class derived from BOARD_ITEM for items that can be connected and have a net,...
virtual NETCLASS * GetEffectiveNetClass() const
Return the NETCLASS for this item.
wxString GetNetname() const
NETINFO_ITEM * GetNet() const
Return #NET_INFO object for a given item.
int GetDRCEpsilon() const
Return an epsilon which accounts for rounding errors, etc.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
virtual bool IsConnected() const
Returns information if the object is derived from BOARD_CONNECTED_ITEM.
virtual void TransformShapeToPolygon(SHAPE_POLY_SET &aBuffer, PCB_LAYER_ID aLayer, int aClearance, int aError, ERROR_LOC aErrorLoc, bool ignoreLineWidth=false) const
Convert the item shape to a closed polygon.
virtual bool IsOnLayer(PCB_LAYER_ID aLayer) const
Test to see if this object is on the given layer.
virtual std::shared_ptr< SHAPE > GetEffectiveShape(PCB_LAYER_ID aLayer=UNDEFINED_LAYER, FLASHING aFlash=FLASHING::DEFAULT) const
Some pad shapes can be complex (rounded/chamfered rectangle), even without considering custom shapes.
virtual const BOARD * GetBoard() const
Return the BOARD in which this BOARD_ITEM resides, or NULL if none.
FOOTPRINT * GetParentFootprint() const
virtual LSET GetLayerSet() const
Return a std::bitset of all layers on which the item physically resides.
BOARD_ITEM_CONTAINER * GetParent() const
virtual std::shared_ptr< SHAPE_SEGMENT > GetEffectiveHoleShape() const
Information pertinent to a Pcbnew printed circuit board.
std::unordered_map< const BOARD_ITEM *, wxString > m_ItemNetclassCache
NETINFO_ITEM * FindNet(int aNetcode) const
Search for a net with the given netcode.
const ZONES & Zones() const
const FOOTPRINTS & Footprints() const
std::unordered_map< wxString, LSET > m_LayerExpressionCache
std::unordered_map< const ZONE *, SHAPE_POLY_SET > m_DeflatedZoneOutlineCache
std::unordered_map< ZONE *, std::unique_ptr< DRC_RTREE > > m_CopperZoneRTreeCache
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
std::shared_mutex m_CachesMutex
const std::unordered_map< KIID, BOARD_ITEM * > & GetItemByIdCache() const
std::unordered_map< wxString, std::vector< ZONE * > > m_ZonesByNameCache
std::shared_ptr< CONNECTIVITY_DATA > GetConnectivity() const
Return a list of missing connections between components/tracks.
constexpr bool Intersects(const BOX2< Vec > &aRect) const
A lightweight representation of a component class.
bool ContainsClassName(const wxString &className) const
Determines if this (effective) component class contains a specific constituent class.
std::shared_ptr< FROM_TO_CACHE > GetFromToCache()
static int MatchDpSuffix(const wxString &aNetName, wxString &aComplementNet, wxString &aBaseDpName)
Check if the given net is a diff pair, returning its polarity and complement if so.
Implement an R-tree for fast spatial and layer indexing of connectable items.
int QueryColliding(BOARD_ITEM *aRefItem, PCB_LAYER_ID aRefLayer, PCB_LAYER_ID aTargetLayer, std::function< bool(BOARD_ITEM *)> aFilter=nullptr, std::function< bool(BOARD_ITEM *)> aVisitor=nullptr, int aClearance=0) const
This is a fast test which essentially does bounding-box overlap given a worst-case clearance.
A set of EDA_ITEMs (i.e., without duplicates).
virtual const BOX2I GetBoundingBox() const
Return the orthogonal bounding box of this object for display purposes.
virtual EDA_GROUP * GetParentGroup() const
KICAD_T Type() const
Returns the type of object.
EDA_ITEM_FLAGS GetFlags() const
virtual const wxString & GetText() const
Return the string associated with the text object.
static ENUM_MAP< T > & Instance()
static bool SniffTest(const wxString &aCandidate)
Returns true if a string has the correct formatting to be a KIID.
void ReportError(const wxString &aErrorMsg)
virtual const wxString & AsString() const
LSET is a set of PCB_LAYER_IDs.
static const LSET & FrontMask()
Return a mask holding all technical layers and the external CU layer on front side.
static const LSET & BackMask()
Return a mask holding all technical layers and the external CU layer on back side.
bool Contains(PCB_LAYER_ID aLayer) const
See if the layer set contains a PCB layer.
A collection of nets and the parameters used to route or test these nets.
bool ContainsNetclassWithName(const wxString &netclass) const
Determines if the given netclass name is a constituent of this (maybe aggregate) netclass.
const wxString GetName() const
Gets the name of this (maybe aggregate) netclass in a format for internal usage or for export to exte...
Handle the data for a net.
const wxString & GetNetname() const
PAD_ATTRIB GetAttribute() const
PCBEXPR_BUILTIN_FUNCTIONS()
void RegisterFunc(const wxString &funcSignature, LIBEVAL::FUNC_CALL_REF funcPtr)
void RegisterAllFunctions()
std::map< wxString, LIBEVAL::FUNC_CALL_REF > m_funcs
int GetConstraint() const
PCB_LAYER_ID GetLayer() const
BOARD_ITEM * GetItem(int index) const
BOARD_ITEM * GetObject(const LIBEVAL::CONTEXT *aCtx) const
void Add(PCB_LAYER_ID aLayer)
SCOPED_LAYERSET(BOARD_ITEM *aItem)
Represent a set of closed polygons.
void ClearArcs()
Removes all arc references from all the outlines and holes in the polyset.
bool Collide(const SHAPE *aShape, int aClearance=0, int *aActual=nullptr, VECTOR2I *aLocation=nullptr) const override
Check if the boundary of shape (this) lies closer to the shape aShape than aClearance,...
SHAPE_LINE_CHAIN & Outline(int aIndex)
Return the reference to aIndex-th outline in the set.
void Deflate(int aAmount, CORNER_STRATEGY aCornerStrategy, int aMaxError)
int OutlineCount() const
Return the number of outlines in the set.
SHAPE_POLY_SET CloneDropTriangulation() const
Handle a list of polygons defining a copper zone.
const BOX2I GetBoundingBox() const override
SHAPE_POLY_SET * Outline()
virtual LSET GetLayerSet() const override
Return a std::bitset of all layers on which the item physically resides.
@ ALLOW_ACUTE_CORNERS
just inflate the polygon. Acute angles create spikes
@ DIFF_PAIR_GAP_CONSTRAINT
#define ROUTER_TRANSIENT
transient items that should NOT be cached
#define HOLE_PROXY
Indicates the BOARD_ITEM is a proxy for its hole.
#define MALFORMED_COURTYARDS
PCB_LAYER_ID
A quick note on layer IDs:
PCB_LAYER_ID ToLAYER_ID(int aLayer)
@ PTH
Plated through hole pad.
Class to handle a set of BOARD_ITEMs.
static void intersectsFrontCourtyardFunc(LIBEVAL::CONTEXT *aCtx, void *self)
#define MISSING_SHEET_ARG(f)
bool collidesWithCourtyard(BOARD_ITEM *aItem, std::shared_ptr< SHAPE > &aItemShape, PCBEXPR_CONTEXT *aCtx, FOOTPRINT *aFootprint, PCB_LAYER_ID aSide)
#define MISSING_LAYER_ARG(f)
static SHAPE_POLY_SET getDeflatedZoneOutline(BOARD *aBoard, ZONE *aArea)
static void intersectsBackCourtyardFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void memberOfGroupFunc(LIBEVAL::CONTEXT *aCtx, void *self)
#define MISSING_AREA_ARG(f)
static void isCoupledDiffPairFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void isPlatedFunc(LIBEVAL::CONTEXT *aCtx, void *self)
bool searchAreas(BOARD *aBoard, const wxString &aArg, PCBEXPR_CONTEXT *aCtx, const std::function< bool(ZONE *)> &aFunc)
static void isBuriedVia(LIBEVAL::CONTEXT *aCtx, void *self)
static void existsOnLayerFunc(LIBEVAL::CONTEXT *aCtx, void *self)
#define MISSING_GROUP_ARG(f)
static bool testFootprintSelector(FOOTPRINT *aFp, const wxString &aSelector)
static void isBlindBuriedViaFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void memberOfSheetFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void hasComponentClassFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void isBlindVia(LIBEVAL::CONTEXT *aCtx, void *self)
static void hasExactNetclassFunc(LIBEVAL::CONTEXT *aCtx, void *self)
#define MISSING_REF_ARG(f)
#define MISSING_DP_ARG(f)
static void enclosedByAreaFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void memberOfSheetOrChildrenFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void memberOfFootprintFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void isMicroVia(LIBEVAL::CONTEXT *aCtx, void *self)
static void getFieldFunc(LIBEVAL::CONTEXT *aCtx, void *self)
bool collidesWithArea(BOARD_ITEM *aItem, PCB_LAYER_ID aLayer, PCBEXPR_CONTEXT *aCtx, ZONE *aArea)
static void hasNetclassFunc(LIBEVAL::CONTEXT *aCtx, void *self)
bool fromToFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void intersectsCourtyardFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static bool searchFootprints(BOARD *aBoard, const wxString &aArg, PCBEXPR_CONTEXT *aCtx, const std::function< bool(FOOTPRINT *)> &aFunc)
static void inDiffPairFunc(LIBEVAL::CONTEXT *aCtx, void *self)
static void intersectsAreaFunc(LIBEVAL::CONTEXT *aCtx, void *self)
#define MISSING_FP_ARG(f)
std::vector< FAB_LAYER_COLOR > dummy
wxString result
Test unit parsing edge cases and error handling.
@ PCB_VIA_T
class PCB_VIA, a via (like a track segment on a copper layer)
@ PCB_ZONE_T
class ZONE, a copper pour area
@ PCB_FOOTPRINT_T
class FOOTPRINT, a footprint
@ PCB_PAD_T
class PAD, a pad in a footprint