KiCad PCB EDA Suite
Loading...
Searching...
No Matches
board_item.cpp
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2012 Jean-Pierre Charras, [email protected]
5 * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
6 * Copyright (C) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors.
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, you may find one here:
20 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
21 * or you may search the http://www.gnu.org website for the version 2 license,
22 * or you may write to the Free Software Foundation, Inc.,
23 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
24 */
25
26#include <pybind11/pybind11.h>
27
28#include <wx/debug.h>
29#include <wx/msgdlg.h>
30#include <i18n_utility.h>
31#include <macros.h>
32#include <board.h>
34#include <lset.h>
35#include <pcb_group.h>
36#include <pcb_generator.h>
37#include <footprint.h>
38#include <font/font.h>
39
40
42{
43 wxASSERT( m_group == nullptr );
44}
45
46
48{
49 if( Type() == PCB_T )
50 return static_cast<const BOARD*>( this );
51
52 BOARD_ITEM* parent = GetParent();
53
54 if( parent )
55 return parent->GetBoard();
56
57 return nullptr;
58}
59
60
62{
63 if( Type() == PCB_T )
64 return static_cast<BOARD*>( this );
65
66 BOARD_ITEM* parent = GetParent();
67
68 if( parent )
69 return parent->GetBoard();
70
71 return nullptr;
72}
73
74
76{
78 return true;
79
80 const BOARD* board = GetBoard();
81
82 return board && board->GetBoardUse() != BOARD_USE::FPHOLDER && m_isLocked;
83}
84
85
87{
88 wxCHECK( false, STROKE_PARAMS( pcbIUScale.mmToIU( DEFAULT_LINE_WIDTH ) ) );
89}
90
91
93{
94 wxCHECK( false, /* void */ );
95}
96
97
99{
101}
102
103
105{
106 if( const BOARD* board = GetBoard() )
107 return board->GetLayerName( m_layer );
108
109 // If no parent, return standard name
111}
112
113
115{
116 if( ( GetLayerSet() & LSET::SideSpecificMask() ).any() )
117 return true;
118
119 if( const BOARD* board = GetBoard() )
120 {
121 LAYER_T principalLayerType = board->GetLayerType( m_layer );
122
123 if( principalLayerType == LT_FRONT || principalLayerType == LT_BACK )
124 return true;
125 }
126
127 return false;
128}
129
130
132{
133 const BOARD* board = GetBoard();
134 LSET layers = GetLayerSet() & board->GetEnabledLayers();
135
136 LSET copperLayers = layers & LSET::AllCuMask();
137 LSET techLayers = layers & LSET::AllTechMask();
138
139 // Try to be smart and useful. Check all copper first.
140 if( (int) copperLayers.count() == board->GetCopperLayerCount() )
141 return _( "all copper layers" );
142
143 for( LSET testLayers : { copperLayers, techLayers, layers } )
144 {
145 for( int bit = PCBNEW_LAYER_ID_START; bit < PCB_LAYER_ID_COUNT; ++bit )
146 {
147 if( testLayers[ bit ] )
148 {
149 wxString layerInfo = board->GetLayerName( static_cast<PCB_LAYER_ID>( bit ) );
150
151 if( testLayers.count() > 1 )
152 layerInfo << wxS( " " ) + _( "and others" );
153
154 return layerInfo;
155 }
156 }
157 }
158
159 // No copper, no technicals: no layer
160 return _( "no layers" );
161}
162
163
164void BOARD_ITEM::ViewGetLayers( int aLayers[], int& aCount ) const
165{
166 // Basic fallback
167 aCount = 1;
168 aLayers[0] = m_layer;
169
170 if( IsLocked() )
171 aLayers[aCount++] = LAYER_LOCKED_ITEM_SHADOW;
172}
173
174
176{
178
179 if( parent )
180 parent->Remove( this );
181
182 delete this;
183}
184
185
187{
188}
189
190
192{
193 if( aImage == nullptr )
194 return;
195
196 EDA_ITEM* parent = GetParent();
198
199 SetParentGroup( nullptr );
200 aImage->SetParentGroup( nullptr );
201 swapData( aImage );
202
203 // Restore pointers to be sure they are not broken
204 SetParent( parent );
206}
207
208
210{
211 BOARD_ITEM* dupe = static_cast<BOARD_ITEM*>( Clone() );
212 const_cast<KIID&>( dupe->m_Uuid ) = KIID();
213
214 if( dupe->GetParentGroup() )
215 dupe->GetParentGroup()->AddItem( dupe );
216
217 return dupe;
218}
219
220
222 int aClearance, int aError, ERROR_LOC aErrorLoc,
223 bool ignoreLineWidth ) const
224{
225 wxASSERT_MSG( false, wxT( "Called TransformShapeToPolygon() on unsupported BOARD_ITEM." ) );
226};
227
228
230{
231 if( a->Type() != b->Type() )
232 return a->Type() < b->Type();
233
234 if( a->GetLayerSet() != b->GetLayerSet() )
235 return a->GetLayerSet().Seq() < b->GetLayerSet().Seq();
236
237 if( a->m_Uuid != b->m_Uuid ) // UUIDs *should* always be unique (for valid boards anyway)
238 return a->m_Uuid < b->m_Uuid;
239
240 return a < b; // But just in case; ptrs are guaranteed to be different
241}
242
243
244std::shared_ptr<SHAPE> BOARD_ITEM::GetEffectiveShape( PCB_LAYER_ID aLayer, FLASHING aFlash ) const
245{
246 static std::shared_ptr<SHAPE> shape;
247
249
250 return shape;
251}
252
253
254std::shared_ptr<SHAPE_SEGMENT> BOARD_ITEM::GetEffectiveHoleShape() const
255{
256 static std::shared_ptr<SHAPE_SEGMENT> slot;
257
259
260 return slot;
261}
262
263
265{
266 // EDA_ITEM::IsType is too slow here.
267 auto isContainer = []( BOARD_ITEM_CONTAINER* aTest )
268 {
269 switch( aTest->Type() )
270 {
271 case PCB_GROUP_T:
272 case PCB_GENERATOR_T:
273 case PCB_TABLE_T:
274 return true;
275
276 default:
277 return false;
278 }
279 };
280
281 BOARD_ITEM_CONTAINER* ancestor = GetParent();
282
283 while( ancestor && isContainer( ancestor ) )
284 ancestor = ancestor->GetParent();
285
286 if( ancestor && ancestor->Type() == PCB_FOOTPRINT_T )
287 return static_cast<FOOTPRINT*>( ancestor );
288
289 return nullptr;
290}
291
292
294{
295 VECTOR2I pos = GetPosition();
296
297 if( FOOTPRINT* parentFP = GetParentFootprint() )
298 {
299 pos -= parentFP->GetPosition();
300 RotatePoint( pos, -parentFP->GetOrientation() );
301 }
302
303 return pos;
304}
305
306
308{
309 VECTOR2I pos( aPos );
310
311 if( FOOTPRINT* parentFP = GetParentFootprint() )
312 {
313 RotatePoint( pos, parentFP->GetOrientation() );
314 pos += parentFP->GetPosition();
315 }
316
317 SetPosition( pos );
318}
319
320
321void BOARD_ITEM::Rotate( const VECTOR2I& aRotCentre, const EDA_ANGLE& aAngle )
322{
323 wxMessageBox( wxT( "virtual BOARD_ITEM::Rotate used, should not occur" ), GetClass() );
324}
325
326
327void BOARD_ITEM::Flip( const VECTOR2I& aCentre, bool aFlipLeftRight )
328{
329 wxMessageBox( wxT( "virtual BOARD_ITEM::Flip used, should not occur" ), GetClass() );
330}
331
332
334{
335 if( FOOTPRINT* fp = dynamic_cast<FOOTPRINT*>( m_parent ) )
336 return fp->GetReference();
337
338 return m_parent->m_Uuid.AsString();
339}
340
341
342static struct BOARD_ITEM_DESC
343{
345 {
347
348 if( layerEnum.Choices().GetCount() == 0 )
349 {
350 layerEnum.Undefined( UNDEFINED_LAYER );
351
352 for( PCB_LAYER_ID layer : LSET::AllLayersMask().Seq() )
353 layerEnum.Map( layer, LSET::Name( layer ) );
354 }
355
359
360 propMgr.AddProperty( new PROPERTY<BOARD_ITEM, wxString>( _HKI( "Parent" ),
364
365 propMgr.AddProperty( new PROPERTY<BOARD_ITEM, int>( _HKI( "Position X" ),
366 &BOARD_ITEM::SetX, &BOARD_ITEM::GetX, PROPERTY_DISPLAY::PT_COORD,
368 propMgr.AddProperty( new PROPERTY<BOARD_ITEM, int>( _HKI( "Position Y" ),
369 &BOARD_ITEM::SetY, &BOARD_ITEM::GetY, PROPERTY_DISPLAY::PT_COORD,
373 propMgr.AddProperty( new PROPERTY<BOARD_ITEM, bool>( _HKI( "Locked" ),
376 [=]( INSPECTABLE* aItem ) -> bool
377 {
378 BOARD_ITEM* item = dynamic_cast<BOARD_ITEM*>( aItem );
379 return item && item->GetBoard() && !item->GetBoard()->IsFootprintHolder();
380 } );
381 }
383
constexpr EDA_IU_SCALE pcbIUScale
Definition: base_units.h:108
LAYER_T
The allowed types of layers, same as Specctra DSN spec.
Definition: board.h:152
@ LT_FRONT
Definition: board.h:159
@ LT_BACK
Definition: board.h:160
#define DEFAULT_LINE_WIDTH
static struct BOARD_ITEM_DESC _BOARD_ITEM_DESC
size_t count() const
Definition: base_set.h:106
Abstract interface for BOARD_ITEMs capable of storing other items inside.
virtual void Remove(BOARD_ITEM *aItem, REMOVE_MODE aMode=REMOVE_MODE::NORMAL)=0
Removes an item from the container.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:79
virtual PCB_LAYER_ID GetLayer() const
Return the primary layer this item is on.
Definition: board_item.h:240
void SetParentGroup(PCB_GROUP *aGroup)
Definition: board_item.h:92
int GetY() const
Definition: board_item.h:103
void DeleteStructure()
Delete this object after removing from its parent if it has one.
Definition: board_item.cpp:175
void SwapItemData(BOARD_ITEM *aImage)
Swap data between aItem and aImage.
Definition: board_item.cpp:191
virtual void Flip(const VECTOR2I &aCentre, bool aFlipLeftRight)
Flip this object, i.e.
Definition: board_item.cpp:327
virtual STROKE_PARAMS GetStroke() const
Definition: board_item.cpp:86
virtual void SetLocked(bool aLocked)
Definition: board_item.h:316
PCB_GROUP * GetParentGroup() const
Definition: board_item.h:93
PCB_GROUP * m_group
Definition: board_item.h:414
virtual void SetStroke(const STROKE_PARAMS &aStroke)
Definition: board_item.cpp:92
PCB_LAYER_ID m_layer
Definition: board_item.h:409
bool m_isLocked
Definition: board_item.h:412
wxString GetParentAsString() const
For "parent" property.
Definition: board_item.cpp:333
int GetX() const
Definition: board_item.h:97
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.
Definition: board_item.cpp:221
virtual void Rotate(const VECTOR2I &aRotCentre, const EDA_ANGLE &aAngle)
Rotate this object.
Definition: board_item.cpp:321
void SetX(int aX)
Definition: board_item.h:119
virtual BOARD_ITEM * Duplicate() const
Create a copy of this BOARD_ITEM.
Definition: board_item.cpp:209
void SetY(int aY)
Definition: board_item.h:125
virtual void SetLayer(PCB_LAYER_ID aLayer)
Set the layer this item is on.
Definition: board_item.h:276
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.
Definition: board_item.cpp:244
virtual const BOARD * GetBoard() const
Return the BOARD in which this BOARD_ITEM resides, or NULL if none.
Definition: board_item.cpp:47
FOOTPRINT * GetParentFootprint() const
Definition: board_item.cpp:264
VECTOR2I GetFPRelativePosition() const
Definition: board_item.cpp:293
virtual LSET GetLayerSet() const
Return a std::bitset of all layers on which the item physically resides.
Definition: board_item.h:245
virtual void swapData(BOARD_ITEM *aImage)
Definition: board_item.cpp:186
const KIFONT::METRICS & GetFontMetrics() const
Definition: board_item.cpp:98
void SetFPRelativePosition(const VECTOR2I &aPos)
Definition: board_item.cpp:307
virtual bool IsLocked() const
Definition: board_item.cpp:75
BOARD_ITEM_CONTAINER * GetParent() const
Definition: board_item.h:218
virtual void ViewGetLayers(int aLayers[], int &aCount) const override
Return the all the layers within the VIEW the object is painted on.
Definition: board_item.cpp:164
bool IsSideSpecific() const
Definition: board_item.cpp:114
virtual wxString layerMaskDescribe() const
Return a string (to be shown to the user) describing a layer mask.
Definition: board_item.cpp:131
wxString GetLayerName() const
Return the name of the PCB layer on which the item resides.
Definition: board_item.cpp:104
virtual std::shared_ptr< SHAPE_SEGMENT > GetEffectiveHoleShape() const
Definition: board_item.cpp:254
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:289
bool IsFootprintHolder() const
Find out if the board is being used to hold a single footprint for editing/viewing.
Definition: board.h:319
LSET GetEnabledLayers() const
A proxy function that calls the corresponding function in m_BoardSettings.
Definition: board.cpp:757
BOARD_USE GetBoardUse() const
Get what the board use is.
Definition: board.h:308
static wxString GetStandardLayerName(PCB_LAYER_ID aLayerId)
Return an "English Standard" name of a PCB layer when given aLayerNumber.
Definition: board.h:779
int GetCopperLayerCount() const
Definition: board.cpp:733
const wxString GetLayerName(PCB_LAYER_ID aLayer) const
Return the name of a aLayer.
Definition: board.cpp:575
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:89
virtual VECTOR2I GetPosition() const
Definition: eda_item.h:243
virtual void SetPosition(const VECTOR2I &aPos)
Definition: eda_item.h:244
const KIID m_Uuid
Definition: eda_item.h:489
KICAD_T Type() const
Returns the type of object.
Definition: eda_item.h:101
virtual void SetParent(EDA_ITEM *aParent)
Definition: eda_item.h:104
virtual EDA_ITEM * Clone() const
Create a duplicate of this item with linked list members set to NULL.
Definition: eda_item.cpp:82
virtual wxString GetClass() const =0
Return the class name.
EDA_ITEM * m_parent
Linked list: Link (parent struct)
Definition: eda_item.h:500
ENUM_MAP & Map(T aValue, const wxString &aName)
Definition: property.h:669
static ENUM_MAP< T > & Instance()
Definition: property.h:663
ENUM_MAP & Undefined(T aValue)
Definition: property.h:676
wxPGChoices & Choices()
Definition: property.h:712
Class that other classes need to inherit from, in order to be inspectable.
Definition: inspectable.h:36
static const METRICS & Default()
Definition: font.cpp:52
Definition: kiid.h:49
wxString AsString() const
Definition: kiid.cpp:246
LSET is a set of PCB_LAYER_IDs.
Definition: lset.h:35
static LSET AllLayersMask()
Definition: lset.cpp:767
LSEQ Seq(const PCB_LAYER_ID *aWishListSequence, unsigned aCount) const
Return an LSEQ from the union of this LSET and a desired sequence.
Definition: lset.cpp:392
static LSET AllTechMask()
Return a mask holding all technical layers (no CU layer) on both side.
Definition: lset.cpp:800
static LSET AllCuMask(int aCuLayerCount=MAX_CU_LAYERS)
Return a mask holding the requested number of Cu PCB_LAYER_IDs.
Definition: lset.cpp:732
static LSET SideSpecificMask()
Definition: lset.cpp:851
static const wxChar * Name(PCB_LAYER_ID aLayerId)
Return the fixed name association with aLayerId.
Definition: lset.cpp:63
A set of BOARD_ITEMs (i.e., without duplicates).
Definition: pcb_group.h:52
virtual bool AddItem(BOARD_ITEM *aItem)
Add item to group.
Definition: pcb_group.cpp:80
PROPERTY_BASE & SetAvailableFunc(std::function< bool(INSPECTABLE *)> aFunc)
Set a callback function to determine whether an object provides this property.
Definition: property.h:257
PROPERTY_BASE & SetIsHiddenFromPropertiesManager(bool aHide=true)
Definition: property.h:300
PROPERTY_BASE & SetIsHiddenFromLibraryEditors(bool aIsHidden=true)
Definition: property.h:314
Provide class metadata.Helper macro to map type hashes to names.
Definition: property_mgr.h:85
void InheritsAfter(TYPE_ID aDerived, TYPE_ID aBase)
Declare an inheritance relationship between types.
static PROPERTY_MANAGER & Instance()
Definition: property_mgr.h:87
PROPERTY_BASE & AddProperty(PROPERTY_BASE *aProperty, const wxString &aGroup=wxEmptyString)
Register a property.
Represent a set of closed polygons.
Simple container to manage line stroke parameters.
Definition: stroke_params.h:81
#define _HKI(x)
#define _(s)
ERROR_LOC
When approximating an arc or circle, should the error be placed on the outside or inside of the curve...
Some functions to handle hotkeys in KiCad.
constexpr PCB_LAYER_ID PCBNEW_LAYER_ID_START
Definition: layer_ids.h:140
FLASHING
Enum used during connectivity building to ensure we do not query connectivity while building the data...
Definition: layer_ids.h:149
@ LAYER_LOCKED_ITEM_SHADOW
shadow layer for locked items
Definition: layer_ids.h:243
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
@ UNDEFINED_LAYER
Definition: layer_ids.h:61
@ PCB_LAYER_ID_COUNT
Definition: layer_ids.h:137
This file contains miscellaneous commonly used macros and functions.
#define UNIMPLEMENTED_FOR(type)
Definition: macros.h:96
Class to handle a set of BOARD_ITEMs.
#define TYPE_HASH(x)
Definition: property.h:71
#define IMPLEMENT_ENUM_TO_WXANY(type)
Definition: property.h:763
#define NO_SETTER(owner, type)
Definition: property.h:774
#define REGISTER_TYPE(x)
Definition: property_mgr.h:371
bool operator()(const BOARD_ITEM *a, const BOARD_ITEM *b) const
Definition: board_item.cpp:229
constexpr int mmToIU(double mm) const
Definition: base_units.h:88
void RotatePoint(int *pX, int *pY, const EDA_ANGLE &aAngle)
Calculate the new point of coord coord pX, pY, for a rotation center 0, 0.
Definition: trigo.cpp:228
@ PCB_T
Definition: typeinfo.h:82
@ PCB_GENERATOR_T
class PCB_GENERATOR, generator on a layer
Definition: typeinfo.h:91
@ PCB_GROUP_T
class PCB_GROUP, a set of BOARD_ITEMs
Definition: typeinfo.h:110
@ PCB_FOOTPRINT_T
class FOOTPRINT, a footprint
Definition: typeinfo.h:86
@ PCB_TABLE_T
class PCB_TABLE, table of PCB_TABLECELLs
Definition: typeinfo.h:94