/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2012 Jean-Pierre Charras, jean-pierre.charras@ujf-grenoble.fr * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck * Copyright (C) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors. * * 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. * * 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. * * 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., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #include #include #include #include #include #include #include #include #include #include #include BOARD_ITEM::~BOARD_ITEM() { wxASSERT( m_group == nullptr ); } const BOARD* BOARD_ITEM::GetBoard() const { if( Type() == PCB_T ) return static_cast( this ); BOARD_ITEM* parent = GetParent(); if( parent ) return parent->GetBoard(); return nullptr; } BOARD* BOARD_ITEM::GetBoard() { if( Type() == PCB_T ) return static_cast( this ); BOARD_ITEM* parent = GetParent(); if( parent ) return parent->GetBoard(); return nullptr; } bool BOARD_ITEM::IsLocked() const { if( GetParentGroup() && GetParentGroup()->IsLocked() ) return true; const BOARD* board = GetBoard(); return board && board->GetBoardUse() != BOARD_USE::FPHOLDER && m_isLocked; } STROKE_PARAMS BOARD_ITEM::GetStroke() const { wxCHECK( false, STROKE_PARAMS( pcbIUScale.mmToIU( DEFAULT_LINE_WIDTH ) ) ); } void BOARD_ITEM::SetStroke( const STROKE_PARAMS& aStroke ) { wxCHECK( false, /* void */ ); } const KIFONT::METRICS& BOARD_ITEM::GetFontMetrics() const { return KIFONT::METRICS::Default(); } wxString BOARD_ITEM::GetLayerName() const { const BOARD* board = GetBoard(); if( board ) return board->GetLayerName( m_layer ); // If no parent, return standard name return BOARD::GetStandardLayerName( m_layer ); } wxString BOARD_ITEM::layerMaskDescribe() const { const BOARD* board = GetBoard(); LSET layers = GetLayerSet() & board->GetEnabledLayers(); LSET copperLayers = layers & LSET::AllCuMask(); LSET techLayers = layers & LSET::AllTechMask(); // Try to be smart and useful. Check all copper first. if( (int) copperLayers.count() == board->GetCopperLayerCount() ) return _( "all copper layers" ); for( LSET testLayers : { copperLayers, techLayers, layers } ) { for( int bit = PCBNEW_LAYER_ID_START; bit < PCB_LAYER_ID_COUNT; ++bit ) { if( testLayers[ bit ] ) { wxString layerInfo = board->GetLayerName( static_cast( bit ) ); if( testLayers.count() > 1 ) layerInfo << wxS( " " ) + _( "and others" ); return layerInfo; } } } // No copper, no technicals: no layer return _( "no layers" ); } void BOARD_ITEM::ViewGetLayers( int aLayers[], int& aCount ) const { // Basic fallback aCount = 1; aLayers[0] = m_layer; if( IsLocked() ) aLayers[aCount++] = LAYER_LOCKED_ITEM_SHADOW; } void BOARD_ITEM::DeleteStructure() { BOARD_ITEM_CONTAINER* parent = GetParent(); if( parent ) parent->Remove( this ); delete this; } void BOARD_ITEM::swapData( BOARD_ITEM* aImage ) { } void BOARD_ITEM::SwapItemData( BOARD_ITEM* aImage ) { if( aImage == nullptr ) return; EDA_ITEM* parent = GetParent(); PCB_GROUP* group = GetParentGroup(); SetParentGroup( nullptr ); aImage->SetParentGroup( nullptr ); swapData( aImage ); // Restore pointers to be sure they are not broken SetParent( parent ); SetParentGroup( group ); } BOARD_ITEM* BOARD_ITEM::Duplicate() const { BOARD_ITEM* dupe = static_cast( Clone() ); const_cast( dupe->m_Uuid ) = KIID(); if( dupe->GetParentGroup() ) dupe->GetParentGroup()->AddItem( dupe ); return dupe; } void BOARD_ITEM::TransformShapeToPolygon( SHAPE_POLY_SET& aBuffer, PCB_LAYER_ID aLayer, int aClearance, int aError, ERROR_LOC aErrorLoc, bool ignoreLineWidth ) const { wxASSERT_MSG( false, wxT( "Called TransformShapeToPolygon() on unsupported BOARD_ITEM." ) ); }; bool BOARD_ITEM::ptr_cmp::operator() ( const BOARD_ITEM* a, const BOARD_ITEM* b ) const { if( a->Type() != b->Type() ) return a->Type() < b->Type(); if( a->GetLayerSet() != b->GetLayerSet() ) return a->GetLayerSet().Seq() < b->GetLayerSet().Seq(); if( a->m_Uuid != b->m_Uuid ) // UUIDs *should* always be unique (for valid boards anyway) return a->m_Uuid < b->m_Uuid; return a < b; // But just in case; ptrs are guaranteed to be different } std::shared_ptr BOARD_ITEM::GetEffectiveShape( PCB_LAYER_ID aLayer, FLASHING aFlash ) const { static std::shared_ptr shape; UNIMPLEMENTED_FOR( GetClass() ); return shape; } std::shared_ptr BOARD_ITEM::GetEffectiveHoleShape() const { static std::shared_ptr slot; UNIMPLEMENTED_FOR( GetClass() ); return slot; } FOOTPRINT* BOARD_ITEM::GetParentFootprint() const { // EDA_ITEM::IsType is too slow here. auto isContainer = []( BOARD_ITEM_CONTAINER* aTest ) { switch( aTest->Type() ) { case PCB_GROUP_T: case PCB_GENERATOR_T: case PCB_TABLE_T: return true; default: return false; } }; BOARD_ITEM_CONTAINER* ancestor = GetParent(); while( ancestor && isContainer( ancestor ) ) ancestor = ancestor->GetParent(); if( ancestor && ancestor->Type() == PCB_FOOTPRINT_T ) return static_cast( ancestor ); return nullptr; } VECTOR2I BOARD_ITEM::GetFPRelativePosition() const { VECTOR2I pos = GetPosition(); if( FOOTPRINT* parentFP = GetParentFootprint() ) { pos -= parentFP->GetPosition(); RotatePoint( pos, -parentFP->GetOrientation() ); } return pos; } void BOARD_ITEM::SetFPRelativePosition( const VECTOR2I& aPos ) { VECTOR2I pos( aPos ); if( FOOTPRINT* parentFP = GetParentFootprint() ) { RotatePoint( pos, parentFP->GetOrientation() ); pos += parentFP->GetPosition(); } SetPosition( pos ); } void BOARD_ITEM::Rotate( const VECTOR2I& aRotCentre, const EDA_ANGLE& aAngle ) { wxMessageBox( wxT( "virtual BOARD_ITEM::Rotate used, should not occur" ), GetClass() ); } void BOARD_ITEM::Flip( const VECTOR2I& aCentre, bool aFlipLeftRight ) { wxMessageBox( wxT( "virtual BOARD_ITEM::Flip used, should not occur" ), GetClass() ); } wxString BOARD_ITEM::GetParentAsString() const { if( FOOTPRINT* fp = dynamic_cast( m_parent ) ) return fp->GetReference(); return m_parent->m_Uuid.AsString(); } static struct BOARD_ITEM_DESC { BOARD_ITEM_DESC() { ENUM_MAP& layerEnum = ENUM_MAP::Instance(); if( layerEnum.Choices().GetCount() == 0 ) { layerEnum.Undefined( UNDEFINED_LAYER ); for( LSEQ seq = LSET::AllLayersMask().Seq(); seq; ++seq ) layerEnum.Map( *seq, LSET::Name( *seq ) ); } PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance(); REGISTER_TYPE( BOARD_ITEM ); propMgr.InheritsAfter( TYPE_HASH( BOARD_ITEM ), TYPE_HASH( EDA_ITEM ) ); propMgr.AddProperty( new PROPERTY( _HKI( "Parent" ), NO_SETTER( BOARD_ITEM, wxString ), &BOARD_ITEM::GetParentAsString ) ) .SetIsHiddenFromLibraryEditors() .SetIsHiddenFromPropertiesManager(); propMgr.AddProperty( new PROPERTY( _HKI( "Position X" ), &BOARD_ITEM::SetX, &BOARD_ITEM::GetX, PROPERTY_DISPLAY::PT_COORD, ORIGIN_TRANSFORMS::ABS_X_COORD ) ); propMgr.AddProperty( new PROPERTY( _HKI( "Position Y" ), &BOARD_ITEM::SetY, &BOARD_ITEM::GetY, PROPERTY_DISPLAY::PT_COORD, ORIGIN_TRANSFORMS::ABS_Y_COORD ) ); propMgr.AddProperty( new PROPERTY_ENUM( _HKI( "Layer" ), &BOARD_ITEM::SetLayer, &BOARD_ITEM::GetLayer ) ); propMgr.AddProperty( new PROPERTY( _HKI( "Locked" ), &BOARD_ITEM::SetLocked, &BOARD_ITEM::IsLocked ) ) .SetAvailableFunc( [=]( INSPECTABLE* aItem ) -> bool { BOARD_ITEM* item = dynamic_cast( aItem ); return item && item->GetBoard() && !item->GetBoard()->IsFootprintHolder(); } ); } } _BOARD_ITEM_DESC; IMPLEMENT_ENUM_TO_WXANY( PCB_LAYER_ID )