sch_pin.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2015 Jean-Pierre Charras, jaen-pierre.charras at wanadoo.fr
 * Copyright (C) 2015 Wayne Stambaugh <[email protected]>
 * Copyright (C) 2018 CERN
 * Copyright The KiCad Developers, see AUTHOR.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 <https://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include <mutex>
#include <memory>
#include <set>
#include <vector>
 
#include <pin_type.h>
#include <pin_comparison.h>
#include <sch_item.h>
 
class LIB_SYMBOL;
class TRANSFORM;
class SCH_SYMBOL;
class LIB_ID;
class SCH_SHEET_PATH;
class PIN_LAYOUT_CACHE;
 
namespace KIFONT
{
class FONT;
}
 
// Circle diameter drawn at the active end of pins:
#define TARGET_PIN_RADIUS   schIUScale.MilsToIU( 15 )

wxString FormatStackedPinForDisplay( const wxString& aPinNumber, int aPinLength, int aTextSize,
                                     KIFONT::FONT* aFont, const KIFONT::METRICS& aFontMetrics );
 
 
class SCH_PIN : public SCH_ITEM
{
public:
    using ALT = PIN_ALTERNATE;
 
    PIN_COMPARISON_DATA ComparisonData() const;
 
    SCH_PIN( LIB_SYMBOL* aParentSymbol );
 
    SCH_PIN( LIB_SYMBOL* aParentSymbol, const wxString& aName, const wxString& aNumber,
             PIN_ORIENTATION aOrientation, ELECTRICAL_PINTYPE aPinType, int aLength,
             int aNameTextSize, int aNumTextSize, int aBodyStyle, const VECTOR2I& aPos, int aUnit );
 
    SCH_PIN( SCH_SYMBOL* aParentSymbol, SCH_PIN* aLibPin );

    SCH_PIN( SCH_SYMBOL* aParentSymbol, const wxString& aNumber, const wxString& aAlt,
             const KIID& aUuid );
 
    SCH_PIN( const SCH_PIN& aPin );
 
    ~SCH_PIN();
 
    SCH_PIN& operator=( const SCH_PIN& aPin );
 
    void Serialize( google::protobuf::Any& aContainer ) const override;
    bool Deserialize( const google::protobuf::Any& aContainer ) override;
 
    wxString GetClass() const override
    {
        return wxT( "SCH_PIN" );
    }
 
    static bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == SCH_PIN_T;
    }
 
    wxString GetFriendlyName() const override
    {
        return _( "Pin" );
    }
 
    SCH_PIN* GetLibPin() const { return m_libPin; }
    void SetLibPin( SCH_PIN* aLibPin ) { m_libPin = aLibPin; }
 
    PIN_ORIENTATION GetOrientation() const;
    void SetOrientation( PIN_ORIENTATION aOrientation ) { m_orientation = aOrientation; }
 
    GRAPHIC_PINSHAPE GetShape() const;
    void SetShape( GRAPHIC_PINSHAPE aShape ) { m_shape = aShape; }
 
    int GetLength() const;
    void SetLength( int aLength ) { m_length = aLength; }

    void ChangeLength( int aLength );
 
    ELECTRICAL_PINTYPE GetType() const;
    void SetType( ELECTRICAL_PINTYPE aType );
    wxString GetCanonicalElectricalTypeName() const;
    wxString GetElectricalTypeName() const;
 
    bool IsVisible() const;
    void SetVisible( bool aVisible ) { m_hidden = !aVisible; }
 
    const wxString& GetName() const;
    const wxString& GetShownName() const;
    void            SetName( const wxString& aName );
    const wxString& GetBaseName() const;
 
    const wxString&       GetNumber() const { return m_number; }
    const wxString&       GetShownNumber() const;
    std::vector<wxString> GetStackedPinNumbers( bool* aValid = nullptr ) const;

    int GetStackedPinCount( bool* aValid = nullptr ) const;

    std::optional<wxString> GetSmallestLogicalNumber() const;

    wxString GetSmallestStackedPadNumber() const;

    enum class PAD_RESOLUTION
    {
        MAPPED,   
        IDENTITY, 
        UNMAPPED  
    };

    wxString GetEffectivePadNumber( const SCH_SHEET_PATH& aSheet, const wxString& aVariantName,
                                    const LIB_ID& aFootprintLibId, const std::set<wxString>* aFootprintPadNumbers,
                                    PAD_RESOLUTION* aState = nullptr ) const;

    wxString GetEffectivePadNumber( const SCH_SHEET_PATH& aSheet, const wxString& aVariantName = wxEmptyString ) const;
 
    static bool HasIdentityPad( const wxString& aPinNumber, const std::set<wxString>& aPads );
 
    void SetNumber( const wxString& aNumber );
 
    int GetNameTextSize() const;
    void SetNameTextSize( int aSize );
 
    int GetNumberTextSize() const;
    void SetNumberTextSize( int aSize );
 
    const std::map<wxString, ALT>& GetAlternates() const
    {
        if( m_libPin )
            return m_libPin->GetAlternates();
 
        return m_alternates;
    }
 
    std::map<wxString, ALT>& GetAlternates()
    {
        return const_cast<std::map<wxString, ALT>&>(
                static_cast<const SCH_PIN*>( this )->GetAlternates() );
    }
 
    ALT GetAlt( const wxString& aAlt )
    {
        return GetAlternates()[ aAlt ];
    }
 
    wxString GetAlt() const { return m_alt; }

    void SetAlt( const wxString& aAlt );

    PIN_ORIENTATION PinDrawOrient( const TRANSFORM& aTransform ) const;

    bool StackedTextSideFlipped( const TRANSFORM& aTransform ) const;
 
#if defined(DEBUG)
    void Show( int nestLevel, std::ostream& os ) const override;
#endif
 
    bool HitTest( const VECTOR2I& aPosition, int aAccuracy = 0 ) const override;
 
    bool HitTest( const BOX2I& aRect, bool aContained, int aAccuracy = 0 ) const override;
 
    void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
 
    const BOX2I ViewBBox() const override;
 
    std::vector<int> ViewGetLayers() const override;
 
    /* Cannot use a default parameter here as it will not be compatible with the virtual. */
    const BOX2I GetBoundingBox() const override
    {
        return GetBoundingBox( false, true, m_flags & SHOW_ELEC_TYPE );
    }

    BOX2I GetBoundingBox( bool aIncludeLabelsOnInvisiblePins, bool aIncludeNameAndNumber,
                          bool aIncludeElectricalType ) const;

    bool IsGlobalPower() const;

    bool IsLocalPower() const;

    bool IsPower() const;
 
    int GetPenWidth() const override { return 0; }
 
    void Move( const VECTOR2I& aOffset ) override;
 
    VECTOR2I GetPosition() const override;
    VECTOR2I GetLocalPosition() const { return m_position; }
    void SetPosition( const VECTOR2I& aPos ) override { m_position = aPos; }
 
    // For properties system
    int GetX() const { return m_position.x; }
    void SetX( int aX ) { m_position.x = aX; }
    int GetY() const { return m_position.y; }
    void SetY( int aY ) { m_position.y = aY; }
 
    VECTOR2I GetPinRoot() const;

    void MirrorHorizontally( int aCenter ) override;
    void MirrorVertically( int aCenter ) override;
    void Rotate( const VECTOR2I& aCenter, bool aRotateCCW = true ) override;

    void MirrorHorizontallyPin( int aCenter );
    void MirrorVerticallyPin( int aCenter );
    void RotatePin( const VECTOR2I& aCenter, bool aRotateCCW = true );

    void PlotPinTexts( PLOTTER *aPlotter, const VECTOR2I &aPinPos, PIN_ORIENTATION aPinOrient,
                       int aTextInside, bool aDrawPinNum, bool aDrawPinName, bool aDimmed ) const;
 
    void PlotPinType( PLOTTER *aPlotter, const VECTOR2I &aPosition, PIN_ORIENTATION aOrientation,
                      bool aDimmed ) const;
 
    void Plot( PLOTTER* aPlotter, bool aBackground, const SCH_PLOT_OPTS& aPlotOpts,
               int aUnit, int aBodyStyle, const VECTOR2I& aOffset, bool aDimmed ) override;
 
    BITMAPS GetMenuImage() const override;
 
    wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, bool aFull ) const override;
    wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, ALT* aAlt ) const;
 
    EDA_ITEM* Clone() const override;
 
    void CalcEdit( const VECTOR2I& aPosition ) override;
 
    bool Matches( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) const override;
 
    bool Replace( const EDA_SEARCH_DATA& aSearchData, void* aAuxData ) override;

    static wxString GetCanonicalElectricalTypeName( ELECTRICAL_PINTYPE aType );
 
    bool IsConnectable() const override { return true; }
 
    bool IsLocked() const override;
 
    bool HasConnectivityChanges( const SCH_ITEM* aItem,
                                 const SCH_SHEET_PATH* aInstance = nullptr ) const override;
 
    void ClearDefaultNetName( const SCH_SHEET_PATH* aPath );
    wxString GetDefaultNetName( const SCH_SHEET_PATH& aPath, bool aForceNoConnect = false );
 
    bool IsDangling() const override;
    bool SetIsDangling( bool aIsDangling );

    bool IsStacked( const SCH_PIN* aPin ) const;
 
    bool IsPointClickableAnchor( const VECTOR2I& aPos ) const override
    {
        return m_isDangling && GetPosition() == aPos;
    }
 
    bool ConnectionPropagatesTo( const EDA_ITEM* aItem ) const override;
 
    const wxString& GetOperatingPoint() const { return m_operatingPoint; }
    void SetOperatingPoint( const wxString& aText ) { m_operatingPoint = aText; }

    const wxString& GetRemappedFromNumber() const { return m_remappedFromNumber; }
    void            SetRemappedFromNumber( const wxString& aNumber ) { m_remappedFromNumber = aNumber; }

    bool GetFlipStackedTextSide() const { return m_flipStackedTextSide; }
    void SetFlipStackedTextSide( bool aFlip ) { m_flipStackedTextSide = aFlip; }
 
    double Similarity( const SCH_ITEM& aOther ) const override;
 
    bool operator==( const SCH_ITEM& aPin ) const override;
    bool operator==( const SCH_PIN& aPin ) const;
 
    bool operator>( const SCH_ITEM& aRhs ) const { return compare( aRhs, ~COMPARE_FLAGS::UUID ) > 0; }

    PIN_LAYOUT_CACHE& GetLayoutCache() const;
 
protected:
    void swapData( SCH_ITEM* aItem ) override;
 
    wxString getItemDescription( ALT* aAlt ) const;
 
    struct EXTENTS_CACHE
    {
        KIFONT::FONT* m_Font = nullptr;
        int           m_FontSize = 0;
        VECTOR2I      m_Extents;
    };
 
    void validateExtentsCache( KIFONT::FONT* aFont, int aSize, const wxString& aText, EXTENTS_CACHE* aCache ) const;
 
    std::ostream& operator<<( std::ostream& aStream );
 
private:
    int compare( const SCH_ITEM& aOther, int aCompareFlags = 0 ) const override;
 
protected:
    SCH_PIN*                m_libPin;          // The corresponding pin in the LIB_SYMBOL
                                               //   (nullptr for a pin *in* the LIB_SYMBOL)
 
    std::map<wxString, ALT> m_alternates;      // Map of alternate name to ALT structure
                                               //   (only valid for pins in LIB_SYMBOLS)
 
    VECTOR2I                m_position;        // Position of the pin.
    std::optional<int>      m_length;          // Length of the pin.
    PIN_ORIENTATION         m_orientation;     // Pin orientation (Up, Down, Left, Right)
    GRAPHIC_PINSHAPE        m_shape;           // Shape drawn around pin
    ELECTRICAL_PINTYPE      m_type;            // Electrical type of the pin.
    std::optional<bool>     m_hidden;
    wxString                m_name;
    wxString                m_number;
    std::optional<int>      m_numTextSize;     // Pin num and Pin name sizes
    std::optional<int>      m_nameTextSize;
    wxString                m_alt;             // The current alternate for an instance
 
    wxString                m_operatingPoint;

    wxString                m_remappedFromNumber;

    bool                    m_flipStackedTextSide = false;
 
    bool                    m_isDangling;

    mutable std::unique_ptr<PIN_LAYOUT_CACHE> m_layoutCache;

    std::recursive_mutex                                      m_netmap_mutex;
    std::map<const SCH_SHEET_PATH, std::pair<wxString, bool>> m_net_name_map;
};