sch_pin.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018 CERN
 * Copyright (C) 2019-2021 KiCad Developers, see change_log.txt for contributors.
 * @author Jon Evans <[email protected]>
 *
 * 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, see <http://www.gnu.org/licenses/>.
 */

#include <lib_pin.h>
#include <sch_symbol.h>
#include <sch_pin.h>
#include <schematic.h>
#include <schematic_settings.h>
#include <sch_sheet_path.h>
#include <sch_edit_frame.h>


SCH_PIN::SCH_PIN( LIB_PIN* aLibPin, SCH_SYMBOL* aParentSymbol ) :
 SCH_ITEM( aParentSymbol, SCH_PIN_T )
{
 m_alt = wxEmptyString;
 m_number = aLibPin->GetNumber();
 m_libPin = aLibPin;
 SetPosition( aLibPin->GetPosition() );
 m_isDangling = true;
}


SCH_PIN::SCH_PIN( SCH_SYMBOL* aParentSymbol, const wxString& aNumber, const wxString& aAlt ) :
 SCH_ITEM( aParentSymbol, SCH_PIN_T )
{
 m_alt = aAlt;
 m_number = aNumber;
 m_libPin = nullptr;
 m_isDangling = true;
}


SCH_PIN::SCH_PIN( const SCH_PIN& aPin ) :
 SCH_ITEM( aPin )
{
 m_alt = aPin.m_alt;
 m_number = aPin.m_number;
 m_libPin = aPin.m_libPin;
 m_position = aPin.m_position;
 m_isDangling = aPin.m_isDangling;
}


SCH_PIN& SCH_PIN::operator=( const SCH_PIN& aPin )
{
 SCH_ITEM::operator=( aPin );

 m_alt = aPin.m_alt;
 m_number = aPin.m_number;
 m_libPin = aPin.m_libPin;
 m_position = aPin.m_position;
 m_isDangling = aPin.m_isDangling;

 return *this;
}


wxString SCH_PIN::GetName() const
{
 if( !m_alt.IsEmpty() )
 return m_alt;

 return m_libPin->GetName();
}


wxString SCH_PIN::GetShownName() const
{
 wxString name = m_libPin->GetName();

 if( !m_alt.IsEmpty() )
 name = m_alt;

 if( name == wxT( "~" ) )
 return wxEmptyString;
 else
 return name;
}


wxString SCH_PIN::GetShownNumber() const
{
 if( m_number == wxT( "~" ) )
 return wxEmptyString;
 else
 return m_number;
}


ELECTRICAL_PINTYPE SCH_PIN::GetType() const
{
 if( !m_alt.IsEmpty() )
 return m_libPin->GetAlt( m_alt ).m_Type;

 return m_libPin->GetType();
}


GRAPHIC_PINSHAPE SCH_PIN::GetShape() const
{
 if( !m_alt.IsEmpty() )
 return m_libPin->GetAlt( m_alt ).m_Shape;

 return m_libPin->GetShape();
}


int SCH_PIN::GetOrientation() const
{
 return m_libPin->GetOrientation();
}


int SCH_PIN::GetLength() const
{
 return m_libPin->GetLength();
}


void SCH_PIN::ViewGetLayers( int aLayers[], int& aCount ) const
{
 aCount = 3;
 aLayers[0] = LAYER_DANGLING;
 aLayers[1] = LAYER_DEVICE;
 aLayers[2] = LAYER_SELECTION_SHADOWS;
}


bool SCH_PIN::Matches( const wxFindReplaceData& aSearchData, void* aAuxDat ) const
{
 if( !( aSearchData.GetFlags() & FR_SEARCH_ALL_PINS ) )
 return false;

 return EDA_ITEM::Matches( GetName(), aSearchData )
 || EDA_ITEM::Matches( GetNumber(), aSearchData );
}


bool SCH_PIN::Replace( const wxFindReplaceData& aSearchData, void* aAuxData )
{
 bool isReplaced = false;

 /* TODO: waiting on a way to override pins in the schematic...
 isReplaced |= EDA_ITEM::Replace( aSearchData, m_name );
 isReplaced |= EDA_ITEM::Replace( aSearchData, m_number );
 */

 return isReplaced;
}


SCH_SYMBOL* SCH_PIN::GetParentSymbol() const
{
 return static_cast<SCH_SYMBOL*>( GetParent() );
}


wxString SCH_PIN::GetSelectMenuText( EDA_UNITS aUnits ) const
{
 return wxString::Format( wxT( "%s %s" ),
 GetParentSymbol()->GetSelectMenuText( aUnits ),
 m_libPin->GetSelectMenuText( aUnits ) );
}


void SCH_PIN::GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList )
{
 EDA_UNITS units = aFrame->GetUserUnits();
 wxString msg;

 aList.emplace_back( _( "Type" ), _( "Pin" ) );

 if( m_libPin->GetUnit() == 0 )
 msg = _( "All" );
 else
 msg.Printf( wxT( "%d" ), m_libPin->GetUnit() );

 aList.emplace_back( _( "Unit" ), msg );

 if( m_libPin->GetConvert() == LIB_ITEM::LIB_CONVERT::BASE )
 msg = _( "no" );
 else if( m_libPin->GetConvert() == LIB_ITEM::LIB_CONVERT::DEMORGAN )
 msg = _( "yes" );
 else
 msg = wxT( "?" );

 aList.emplace_back( _( "Converted" ), msg );

 aList.emplace_back( _( "Name" ), GetShownName() );
 aList.emplace_back( _( "Number" ), GetShownNumber() );
 aList.emplace_back( _( "Type" ), ElectricalPinTypeGetText( GetType() ) );
 aList.emplace_back( _( "Style" ), PinShapeGetText( GetShape() ) );

 aList.emplace_back( _( "Visible" ), IsVisible() ? _( "Yes" ) : _( "No" ) );

 aList.emplace_back( _( "Length" ), MessageTextFromValue( units, GetLength() ), true );

 int i = PinOrientationIndex( GetOrientation() );
 aList.emplace_back( _( "Orientation" ), PinOrientationName( (unsigned) i ) );

 SCH_EDIT_FRAME* schframe = dynamic_cast<SCH_EDIT_FRAME*>( aFrame );
 SCH_SHEET_PATH* currentSheet = schframe ? &schframe->GetCurrentSheet() : nullptr;
 SCH_SYMBOL* symbol = GetParentSymbol();

 aList.emplace_back( symbol->GetRef( currentSheet ), symbol->GetValue( currentSheet, true ) );

#if defined(DEBUG)
 if( !IsConnectivityDirty() && dynamic_cast<SCH_EDIT_FRAME*>( aFrame ) )
 {
 SCH_CONNECTION* conn = Connection();

 if( conn )
 conn->AppendInfoToMsgPanel( aList );
 }
#endif

}


void SCH_PIN::ClearDefaultNetName( const SCH_SHEET_PATH* aPath )
{
 std::lock_guard<std::recursive_mutex> lock( m_netmap_mutex );

 if( aPath )
 m_net_name_map.erase( *aPath );
 else
 m_net_name_map.clear();
}


wxString SCH_PIN::GetDefaultNetName( const SCH_SHEET_PATH& aPath, bool aForceNoConnect )
{
 if( m_libPin->IsPowerConnection() )
 return m_libPin->GetName();

 std::lock_guard<std::recursive_mutex> lock( m_netmap_mutex );

 auto it = m_net_name_map.find( aPath );

 if( it != m_net_name_map.end() )
 {
 if( it->second.second == aForceNoConnect )
 return it->second.first;
 }

 wxString name = wxT( "Net-(" );

 if( aForceNoConnect || GetType() == ELECTRICAL_PINTYPE::PT_NC )
 name = ( wxT( "unconnected-(" ) );

 name << GetParentSymbol()->GetRef( &aPath );

 bool annotated = true;

 // Add timestamp for uninitialized symbols
 if( name.Last() == '?' )
 {
 name << GetParentSymbol()->m_Uuid.AsString();
 annotated = false;
 }

 name << wxT( "-Pad" ) << m_libPin->GetNumber() << wxT( ")" );

 if( annotated )
 m_net_name_map[ aPath ] = std::make_pair( name, aForceNoConnect );

 return name;
}


wxPoint SCH_PIN::GetTransformedPosition() const
{
 TRANSFORM t = GetParentSymbol()->GetTransform();
 return t.TransformCoordinate( GetLocalPosition() ) + GetParentSymbol()->GetPosition();
}


const EDA_RECT SCH_PIN::GetBoundingBox() const
{
 TRANSFORM t = GetParentSymbol()->GetTransform();
 EDA_RECT r = m_libPin->GetBoundingBox();

 r.RevertYAxis();

 r = t.TransformCoordinate( r );
 r.Offset( GetParentSymbol()->GetPosition() );

 return r;
}


bool SCH_PIN::HitTest( const wxPoint& aPosition, int aAccuracy ) const
{
 // When looking for an "exact" hit aAccuracy will be 0 which works poorly if the pin has
 // no pin number or name. Give it a floor.
 if( Schematic() )
 aAccuracy = std::max( aAccuracy, Schematic()->Settings().m_PinSymbolSize / 4 );

 EDA_RECT rect = GetBoundingBox();
 return rect.Inflate( aAccuracy ).Contains( aPosition );
}


EDA_ITEM* SCH_PIN::Clone() const
{
 return new SCH_PIN( *this );
}


bool SCH_PIN::ConnectionPropagatesTo( const EDA_ITEM* aItem ) const
{
 // Reciprocal checking is done in CONNECTION_GRAPH anyway
 return !( m_libPin->GetType() == ELECTRICAL_PINTYPE::PT_NC );
}