/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2009 Jean-Pierre Charras, jaen-pierre.charras@gipsa-lab.inpg.com * 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 #include #include #include #include /// Factor to convert the maker unit shape to internal units: #define SCALING_FACTOR schIUScale.mmToIU( 0.15 ) SCH_MARKER::SCH_MARKER( std::shared_ptr aItem, const VECTOR2I& aPos ) : SCH_ITEM( nullptr, SCH_MARKER_T ), MARKER_BASE( SCALING_FACTOR, aItem, MARKER_BASE::MARKER_ERC ) { if( m_rcItem ) m_rcItem->SetParent( this ); m_Pos = aPos; m_isLegacyMarker = false; } SCH_MARKER::~SCH_MARKER() { if( m_rcItem ) m_rcItem->SetParent( nullptr ); } EDA_ITEM* SCH_MARKER::Clone() const { return new SCH_MARKER( *this ); } void SCH_MARKER::SwapData( SCH_ITEM* aItem ) { SCH_ITEM::SwapFlags( aItem ); SCH_MARKER* item = static_cast( aItem ); std::swap( m_isLegacyMarker, item->m_isLegacyMarker ); std::swap( m_Pos, item->m_Pos ); std::swap( m_markerType, item->m_markerType ); std::swap( m_excluded, item->m_excluded ); std::swap( m_rcItem, item->m_rcItem ); std::swap( m_scalingFactor, item->m_scalingFactor ); std::swap( m_shapeBoundingBox, item->m_shapeBoundingBox ); std::swap( *((SCH_MARKER*) this), *((SCH_MARKER*) aItem ) ); } wxString SCH_MARKER::SerializeToString() const { std::shared_ptr erc = std::static_pointer_cast( m_rcItem ); wxString sheetSpecificPath, mainItemPath, auxItemPath; if( erc->IsSheetSpecific() ) sheetSpecificPath = erc->GetSpecificSheetPath().Path().AsString(); if( erc->MainItemHasSheetPath() ) mainItemPath = erc->GetMainItemSheetPath().Path().AsString(); if( erc->AuxItemHasSheetPath() ) auxItemPath = erc->GetAuxItemSheetPath().Path().AsString(); if( m_rcItem->GetErrorCode() == ERCE_GENERIC_WARNING || m_rcItem->GetErrorCode() == ERCE_GENERIC_ERROR ) { SCH_ITEM* sch_item = Schematic()->GetItem( erc->GetMainItemID() ); SCH_ITEM* parent = static_cast( sch_item->GetParent() ); EDA_TEXT* text_item = dynamic_cast( sch_item ); // SCH_FIELDs and SCH_ITEMs inside LIB_SYMBOLs don't have persistent KIIDs. So the // exclusion must refer to the parent's KIID, and include the text of the original text // item for later look-up. if( parent->IsType( { SCH_SYMBOL_T, SCH_LABEL_T, SCH_SHEET_T } ) ) { return wxString::Format( wxT( "%s|%d|%d|%s|%s|%s|%s|%s" ), m_rcItem->GetSettingsKey(), m_Pos.x, m_Pos.y, parent->m_Uuid.AsString(), text_item->GetText(), sheetSpecificPath, mainItemPath, wxEmptyString ); } else { return wxString::Format( wxT( "%s|%d|%d|%s|%s|%s|%s|%s" ), m_rcItem->GetSettingsKey(), m_Pos.x, m_Pos.y, sch_item->m_Uuid.AsString(), wxEmptyString, sheetSpecificPath, mainItemPath, wxEmptyString ); } } else { return wxString::Format( wxT( "%s|%d|%d|%s|%s|%s|%s|%s" ), m_rcItem->GetSettingsKey(), m_Pos.x, m_Pos.y, m_rcItem->GetMainItemID().AsString(), m_rcItem->GetAuxItemID().AsString(), sheetSpecificPath, mainItemPath, auxItemPath ); } } SCH_MARKER* SCH_MARKER::DeserializeFromString( const SCH_SHEET_LIST& aSheetList, const wxString& data ) { wxArrayString props = wxSplit( data, '|' ); VECTOR2I markerPos( (int) strtol( props[1].c_str(), nullptr, 10 ), (int) strtol( props[2].c_str(), nullptr, 10 ) ); std::shared_ptr ercItem = ERC_ITEM::Create( props[0] ); if( !ercItem ) return nullptr; if( ercItem->GetErrorCode() == ERCE_GENERIC_WARNING || ercItem->GetErrorCode() == ERCE_GENERIC_ERROR ) { // SCH_FIELDs and SCH_ITEMs inside LIB_SYMBOLs don't have persistent KIIDs. So the // exclusion will contain the parent's KIID in prop[3], and the text of the original // text item in prop[4]. if( !props[4].IsEmpty() ) { KIID uuid = niluuid; SCH_ITEM* parent = aSheetList.GetItem( KIID( props[3] ) ); // Check fields and pins for a match parent->RunOnChildren( [&]( SCH_ITEM* child ) { if( EDA_TEXT* text_item = dynamic_cast( child ) ) { if( text_item->GetText() == props[4] ) uuid = child->m_Uuid; } } ); // If it's a symbol, we must also check non-overridden LIB_SYMBOL text children if( uuid == niluuid && parent->Type() == SCH_SYMBOL_T ) { static_cast( parent )->GetLibSymbolRef()->RunOnChildren( [&]( SCH_ITEM* child ) { if( child->Type() == SCH_FIELD_T ) { // Match only on SCH_SYMBOL fields, not LIB_SYMBOL fields. } else if( EDA_TEXT* text_item = dynamic_cast( child ) ) { if( text_item->GetText() == props[4] ) uuid = child->m_Uuid; } } ); } if( uuid != niluuid ) ercItem->SetItems( uuid ); else return nullptr; } else { ercItem->SetItems( KIID( props[3] ) ); } } else { ercItem->SetItems( KIID( props[3] ), KIID( props[4] ) ); } bool isLegacyMarker = true; // Deserialize sheet / item specific paths - we are not able to use the file version to determine // if markers are legacy as there could be a file opened with a prior version but which has // new markers - this code is called not just during schematic load, but also to match new // ERC exceptions to exclusions. if( props.size() == 8 ) { isLegacyMarker = false; if( !props[5].IsEmpty() ) { KIID_PATH sheetSpecificKiidPath( props[5] ); std::optional sheetSpecificPath = aSheetList.GetSheetPathByKIIDPath( sheetSpecificKiidPath, true ); if( sheetSpecificPath.has_value() ) ercItem->SetSheetSpecificPath( sheetSpecificPath.value() ); } if( !props[6].IsEmpty() ) { KIID_PATH mainItemKiidPath( props[6] ); std::optional mainItemPath = aSheetList.GetSheetPathByKIIDPath( mainItemKiidPath, true ); if( mainItemPath.has_value() ) { if( props[7].IsEmpty() ) { ercItem->SetItemsSheetPaths( mainItemPath.value() ); } else { KIID_PATH auxItemKiidPath( props[7] ); std::optional auxItemPath = aSheetList.GetSheetPathByKIIDPath( auxItemKiidPath, true ); if( auxItemPath.has_value() ) ercItem->SetItemsSheetPaths( mainItemPath.value(), auxItemPath.value() ); } } } } SCH_MARKER* marker = new SCH_MARKER( ercItem, markerPos ); marker->SetIsLegacyMarker( isLegacyMarker ); return marker; } #if defined(DEBUG) void SCH_MARKER::Show( int nestLevel, std::ostream& os ) const { // for now, make it look like XML: NestedSpace( nestLevel, os ) << '<' << GetClass().Lower().mb_str() << GetPos() << "/>\n"; } #endif void SCH_MARKER::ViewGetLayers( int aLayers[], int& aCount ) const { wxCHECK_RET( Schematic(), "No SCHEMATIC set for SCH_MARKER!" ); // Don't display sheet-specific markers when SCH_SHEET_PATHs do not match std::shared_ptr ercItem = std::static_pointer_cast( GetRCItem() ); if( ercItem->IsSheetSpecific() && ( ercItem->GetSpecificSheetPath() != Schematic()->CurrentSheet() ) ) { aCount = 0; return; } aCount = 2; if( IsExcluded() ) { aLayers[0] = LAYER_ERC_EXCLUSION; } else { switch( Schematic()->ErcSettings().GetSeverity( m_rcItem->GetErrorCode() ) ) { default: case SEVERITY::RPT_SEVERITY_ERROR: aLayers[0] = LAYER_ERC_ERR; break; case SEVERITY::RPT_SEVERITY_WARNING: aLayers[0] = LAYER_ERC_WARN; break; } } aLayers[1] = LAYER_SELECTION_SHADOWS; } SCH_LAYER_ID SCH_MARKER::GetColorLayer() const { if( IsExcluded() ) return LAYER_ERC_EXCLUSION; wxCHECK_MSG( Schematic(), LAYER_ERC_ERR, "No SCHEMATIC set for SCH_MARKER!" ); switch( Schematic()->ErcSettings().GetSeverity( m_rcItem->GetErrorCode() ) ) { default: case SEVERITY::RPT_SEVERITY_ERROR: return LAYER_ERC_ERR; case SEVERITY::RPT_SEVERITY_WARNING: return LAYER_ERC_WARN; } } KIGFX::COLOR4D SCH_MARKER::getColor() const { COLOR_SETTINGS* colors = Pgm().GetSettingsManager().GetColorSettings(); return colors->GetColor( GetColorLayer() ); } SEVERITY SCH_MARKER::GetSeverity() const { if( IsExcluded() ) return RPT_SEVERITY_EXCLUSION; ERC_ITEM* item = static_cast( m_rcItem.get() ); return Schematic()->ErcSettings().GetSeverity( item->GetErrorCode() ); } void SCH_MARKER::Print( const SCH_RENDER_SETTINGS* aSettings, int aUnit, int aBodyStyle, const VECTOR2I& aOffset, bool aForceNoFill, bool aDimmed ) { PrintMarker( aSettings, aOffset ); } bool SCH_MARKER::Matches( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) const { return SCH_ITEM::Matches( m_rcItem->GetErrorMessage(), aSearchData ); } const BOX2I SCH_MARKER::GetBoundingBox() const { return GetBoundingBoxMarker(); } void SCH_MARKER::GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector& aList ) { aList.emplace_back( _( "Type" ), _( "Marker" ) ); aList.emplace_back( _( "Violation" ), m_rcItem->GetErrorMessage() ); switch( GetSeverity() ) { case RPT_SEVERITY_IGNORE: aList.emplace_back( _( "Severity" ), _( "Ignore" ) ); break; case RPT_SEVERITY_WARNING: aList.emplace_back( _( "Severity" ), _( "Warning" ) ); break; case RPT_SEVERITY_ERROR: aList.emplace_back( _( "Severity" ), _( "Error" ) ); break; default: break; } if( GetMarkerType() == MARKER_DRAWING_SHEET ) { aList.emplace_back( _( "Drawing Sheet" ), wxEmptyString ); } else { wxString mainText; wxString auxText; EDA_ITEM* mainItem = nullptr; EDA_ITEM* auxItem = nullptr; if( m_rcItem->GetMainItemID() != niluuid ) mainItem = aFrame->GetItem( m_rcItem->GetMainItemID() ); if( m_rcItem->GetAuxItemID() != niluuid ) auxItem = aFrame->GetItem( m_rcItem->GetAuxItemID() ); if( mainItem ) mainText = mainItem->GetItemDescription( aFrame, true ); if( auxItem ) auxText = auxItem->GetItemDescription( aFrame, true ); aList.emplace_back( mainText, auxText ); } if( IsExcluded() ) aList.emplace_back( _( "Excluded" ), m_comment ); } BITMAPS SCH_MARKER::GetMenuImage() const { return BITMAPS::erc; } void SCH_MARKER::Rotate( const VECTOR2I& aCenter, bool aRotateCCW ) { // Marker geometry isn't user-editable } void SCH_MARKER::MirrorVertically( int aCenter ) { // Marker geometry isn't user-editable } void SCH_MARKER::MirrorHorizontally( int aCenter ) { // Marker geometry isn't user-editable } bool SCH_MARKER::HitTest( const VECTOR2I& aPosition, int aAccuracy ) const { return HitTestMarker( aPosition, aAccuracy ); }