pad.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018 Jean-Pierre Charras, jp.charras at wanadoo.fr
 * Copyright The 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
 */
 
#pragma once
 
#include <mutex>
#include <array>
#include <optional>
 
#include <board_connected_item.h>
#include <core/arraydim.h>
#include <core/mirror.h>
#include <geometry/eda_angle.h>
#include <geometry/shape_poly_set.h>
#include <geometry/shape_compound.h>
#include <lset.h>
#include <padstack.h>
#include <zones.h>
 
class PCB_SHAPE;
class SHAPE;
class SHAPE_SEGMENT;
 
class LINE_READER;
class EDA_3D_CANVAS;
class FOOTPRINT;
 
namespace KIGFX
{
    class VIEW;
}
 
class PAD : public BOARD_CONNECTED_ITEM
{
public:
    PAD( FOOTPRINT* parent );
 
    // Copy constructor & operator= are needed because the list of basic shapes
    // must be duplicated in copy.
    PAD( const PAD& aPad );
    PAD& operator=( const PAD &aOther );
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
 
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    /*
     * Default layers used for pads, according to the pad type.
     *
     * This is default values only, they can be changed for a given pad.
     */
    static LSET PTHMask();          
    static LSET SMDMask();          
    static LSET ConnSMDMask();      
    static LSET UnplatedHoleMask(); 
    static LSET ApertureMask();     
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && PCB_PAD_T == aItem->Type();
    }
 
    bool IsType( const std::vector<KICAD_T>& aScanTypes ) const override
    {
        if( BOARD_CONNECTED_ITEM::IsType( aScanTypes ) )
            return true;
 
        for( KICAD_T scanType : aScanTypes )
        {
            if( HasHole() )
            {
                if( scanType == PCB_LOCATE_HOLE_T )
                    return true;
                else if( scanType == PCB_LOCATE_PTH_T && m_attribute != PAD_ATTRIB::NPTH )
                    return true;
                else if( scanType == PCB_LOCATE_NPTH_T && m_attribute == PAD_ATTRIB::NPTH )
                    return true;
            }
        }
 
        return false;
    }
 
    bool HasHole() const override
    {
        return GetDrillSizeX() > 0 && GetDrillSizeY() > 0;
    }
 
    bool HasDrilledHole() const override
    {
        return HasHole() && GetDrillSizeX() == GetDrillSizeY();
    }
 
    bool IsLocked() const override;

    void ImportSettingsFrom( const PAD& aMasterPad );

    bool IsFlipped() const;

    void SetNumber( const wxString& aNumber ) { m_number = aNumber; }
    const wxString& GetNumber() const { return m_number; }

    bool CanHaveNumber() const;

    void SetPinFunction( const wxString& aName ) { m_pinFunction = aName; }
    const wxString& GetPinFunction() const { return m_pinFunction; }

    void SetPinType( const wxString& aType ) { m_pinType = aType; }
    const wxString& GetPinType() const { return m_pinType; }

    bool SameLogicalPadAs( const PAD* aOther ) const
    {
        // hide tricks behind sensible API
        return GetParentFootprint() == aOther->GetParentFootprint()
            && !m_number.IsEmpty() && m_number == aOther->m_number;
    }

    bool SharesNetTieGroup( const PAD* aOther ) const;

    bool IsNoConnectPad() const;

    bool IsFreePad() const;

    void SetShape( PCB_LAYER_ID aLayer, PAD_SHAPE aShape )
    {
        m_padStack.SetShape( aShape, aLayer );
        SetDirty();
    }

    PAD_SHAPE GetShape( PCB_LAYER_ID aLayer ) const { return m_padStack.Shape( aLayer ); }
 
    // Used for the properties panel, which does not support padstacks at the moment
    void SetFrontShape( PAD_SHAPE aShape );
 
    PAD_SHAPE GetFrontShape() const { return m_padStack.Shape( F_Cu ); }
 
    void SetPosition( const VECTOR2I& aPos ) override
    {
        m_pos = aPos;
        SetDirty();
    }
 
    VECTOR2I GetPosition() const override { return m_pos; }

    PAD_SHAPE GetAnchorPadShape( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.AnchorShape( aLayer );
    }

    CUSTOM_SHAPE_ZONE_MODE GetCustomShapeInZoneOpt() const
    {
        return m_padStack.CustomShapeInZoneMode();
    }

    void SetCustomShapeInZoneOpt( CUSTOM_SHAPE_ZONE_MODE aOption )
    {
        m_padStack.SetCustomShapeInZoneMode( aOption );
    }

    void SetAnchorPadShape( PCB_LAYER_ID aLayer, PAD_SHAPE aShape )
    {
        m_padStack.SetAnchorShape( aShape == PAD_SHAPE::RECTANGLE ? PAD_SHAPE::RECTANGLE
                                                                  : PAD_SHAPE::CIRCLE,
                                   aLayer );
        SetDirty();
    }

    bool IsOnCopperLayer() const override;
 
    void SetY( int y )                          { m_pos.y = y; SetDirty(); }
    void SetX( int x )                          { m_pos.x = x; SetDirty(); }
 
    void SetSize( PCB_LAYER_ID aLayer, const VECTOR2I& aSize )
    {
        m_padStack.SetSize( aSize, aLayer );
        SetDirty();
    }
    const VECTOR2I& GetSize( PCB_LAYER_ID aLayer ) const { return m_padStack.Size( aLayer ); }
 
    // These accessors are for the properties panel, which does not have the ability to deal with
    // custom padstacks where the properties can vary by layer.  The properties should be disabled
    // in the GUI when the padstack mode is set to anything other than NORMAL, but so that the code
    // compiles, these are set up to work with the front layer (in other words, assume the mode is
    // NORMAL, where F_Cu stores the whole padstack data)
    void SetSizeX( const int aX )
    {
        if( aX > 0 )
        {
            m_padStack.SetSize( { aX, m_padStack.Size( PADSTACK::ALL_LAYERS ).y }, PADSTACK::ALL_LAYERS );
            SetDirty();
        }
    }
 
    int GetSizeX() const { return m_padStack.Size( PADSTACK::ALL_LAYERS ).x; }
 
    void SetSizeY( const int aY )
    {
        if( aY > 0 )
        {
            m_padStack.SetSize( { m_padStack.Size( PADSTACK::ALL_LAYERS ).x, aY }, PADSTACK::ALL_LAYERS );
            SetDirty();
        }
    }
 
    int GetSizeY() const { return m_padStack.Size( PADSTACK::ALL_LAYERS ).y; }
 
    void SetDelta( PCB_LAYER_ID aLayer, const VECTOR2I& aSize )
    {
        m_padStack.TrapezoidDeltaSize( aLayer ) = aSize;
        SetDirty();
    }
 
    const VECTOR2I& GetDelta( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.TrapezoidDeltaSize( aLayer );
    }
 
    void SetPrimaryDrillSize( const VECTOR2I& aSize );
    const VECTOR2I& GetPrimaryDrillSize() const { return m_padStack.Drill().size; }
    void SetPrimaryDrillSizeX( int aX );
    int GetPrimaryDrillSizeX() const            { return m_padStack.Drill().size.x; }
    void SetPrimaryDrillSizeY( int aY );
    int GetPrimaryDrillSizeY() const            { return m_padStack.Drill().size.y; }
 
    void SetDrillSize( const VECTOR2I& aSize )  { SetPrimaryDrillSize( aSize ); }
    const VECTOR2I& GetDrillSize() const        { return GetPrimaryDrillSize(); }
    void SetDrillSizeX( int aX );
    int GetDrillSizeX() const                   { return GetPrimaryDrillSizeX(); }
    void SetDrillSizeY( int aY );
    int GetDrillSizeY() const                   { return GetPrimaryDrillSizeY(); }
 
    void SetOffset( PCB_LAYER_ID aLayer, const VECTOR2I& aOffset )
    {
        m_padStack.Offset( aLayer ) = aOffset;
        SetDirty();
    }
 
    const VECTOR2I& GetOffset( PCB_LAYER_ID aLayer ) const { return m_padStack.Offset( aLayer ); }
 
    VECTOR2I GetCenter() const override           { return GetPosition(); }
 
    const PADSTACK& Padstack() const              { return m_padStack; }
    PADSTACK& Padstack()                          { return m_padStack; }
    void SetPadstack( const PADSTACK& aPadstack ) { m_padStack = aPadstack; }

    void AddPrimitivePoly( PCB_LAYER_ID aLayer, const SHAPE_POLY_SET& aPoly, int aThickness,
                           bool aFilled );
    void AddPrimitivePoly( PCB_LAYER_ID aLayer, const std::vector<VECTOR2I>& aPoly, int aThickness,
                           bool aFilled );

    void MergePrimitivesAsPolygon( PCB_LAYER_ID aLayer, SHAPE_POLY_SET* aMergedPolygon,
                                   ERROR_LOC aErrorLoc = ERROR_INSIDE ) const;

    void DeletePrimitivesList( PCB_LAYER_ID aLayer = UNDEFINED_LAYER );

    const std::vector<std::shared_ptr<PCB_SHAPE>>& GetPrimitives( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.Primitives( aLayer );
    }
 
    void Flip( const VECTOR2I& VECTOR2I, FLIP_DIRECTION aFlipDirection ) override;

    void FlipPrimitives( FLIP_DIRECTION aFlipDirection );

    void ReplacePrimitives( PCB_LAYER_ID aLayer,
                            const std::vector<std::shared_ptr<PCB_SHAPE>>& aPrimitivesList );

    void AppendPrimitives( PCB_LAYER_ID aLayer,
                           const std::vector<std::shared_ptr<PCB_SHAPE>>& aPrimitivesList );

    void AddPrimitive( PCB_LAYER_ID aLayer, PCB_SHAPE* aPrimitive );

    void SetOrientation( const EDA_ANGLE& aAngle );
    void SetFPRelativeOrientation( const EDA_ANGLE& aAngle );

    EDA_ANGLE GetOrientation() const { return m_padStack.GetOrientation(); }
    EDA_ANGLE GetFPRelativeOrientation() const;
 
    // For property system
    void SetOrientationDegrees( double aOrientation )
    {
        SetOrientation( EDA_ANGLE( aOrientation, DEGREES_T ) );
    }
    double GetOrientationDegrees() const
    {
        return m_padStack.GetOrientation().AsDegrees();
    }
 
    void SetPrimaryDrillShape( PAD_DRILL_SHAPE aShape );
    PAD_DRILL_SHAPE GetPrimaryDrillShape() const { return m_padStack.Drill().shape; }
 
    void SetDrillShape( PAD_DRILL_SHAPE aShape ) { SetPrimaryDrillShape( aShape ); }
    PAD_DRILL_SHAPE GetDrillShape() const { return GetPrimaryDrillShape(); }
 
    void SetPrimaryDrillStartLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetPrimaryDrillStartLayer() const { return m_padStack.Drill().start; }
    void SetPrimaryDrillEndLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetPrimaryDrillEndLayer() const { return m_padStack.Drill().end; }
 
    void SetFrontPostMachining( const std::optional<PAD_DRILL_POST_MACHINING_MODE>& aMode ) { m_padStack.FrontPostMachining().mode = aMode; }
    std::optional<PAD_DRILL_POST_MACHINING_MODE> GetFrontPostMachining() const { return m_padStack.FrontPostMachining().mode; }
 
    void SetFrontPostMachiningMode( PAD_DRILL_POST_MACHINING_MODE aMode )
    {
        m_padStack.FrontPostMachining().mode = aMode;
    }
 
    PAD_DRILL_POST_MACHINING_MODE GetFrontPostMachiningMode() const
    {
        return m_padStack.FrontPostMachining().mode.value_or( PAD_DRILL_POST_MACHINING_MODE::NOT_POST_MACHINED );
    }
 
    void SetFrontPostMachiningSize( int aSize ) { m_padStack.FrontPostMachining().size = aSize; }
    int GetFrontPostMachiningSize() const { return m_padStack.FrontPostMachining().size; }
    void SetFrontPostMachiningDepth( int aDepth ) { m_padStack.FrontPostMachining().depth = aDepth; }
    int GetFrontPostMachiningDepth() const { return m_padStack.FrontPostMachining().depth; }
    void SetFrontPostMachiningAngle( int aAngle ) { m_padStack.FrontPostMachining().angle = aAngle; }
    int GetFrontPostMachiningAngle() const { return m_padStack.FrontPostMachining().angle; }
 
    void SetBackPostMachining( const std::optional<PAD_DRILL_POST_MACHINING_MODE>& aMode ) { m_padStack.BackPostMachining().mode = aMode; }
    std::optional<PAD_DRILL_POST_MACHINING_MODE> GetBackPostMachining() const { return m_padStack.BackPostMachining().mode; }
 
    void SetBackPostMachiningMode( PAD_DRILL_POST_MACHINING_MODE aMode )
    {
        m_padStack.BackPostMachining().mode = aMode;
    }
 
    PAD_DRILL_POST_MACHINING_MODE GetBackPostMachiningMode() const
    {
        return m_padStack.BackPostMachining().mode.value_or( PAD_DRILL_POST_MACHINING_MODE::NOT_POST_MACHINED );
    }
 
    void SetBackPostMachiningSize( int aSize ) { m_padStack.BackPostMachining().size = aSize; }
    int GetBackPostMachiningSize() const { return m_padStack.BackPostMachining().size; }
    void SetBackPostMachiningDepth( int aDepth ) { m_padStack.BackPostMachining().depth = aDepth; }
    int GetBackPostMachiningDepth() const { return m_padStack.BackPostMachining().depth; }
    void SetBackPostMachiningAngle( int aAngle ) { m_padStack.BackPostMachining().angle = aAngle; }
    int GetBackPostMachiningAngle() const { return m_padStack.BackPostMachining().angle; }

    bool IsBackdrilledOrPostMachined( PCB_LAYER_ID aLayer ) const;

    int GetPostMachiningKnockout( PCB_LAYER_ID aLayer ) const;
 
    void SetPrimaryDrillFilled( const std::optional<bool>& aFilled );
    void SetPrimaryDrillFilledFlag( bool aFilled );
    std::optional<bool> GetPrimaryDrillFilled() const { return m_padStack.Drill().is_filled; }
    bool GetPrimaryDrillFilledFlag() const { return m_padStack.Drill().is_filled.value_or( false ); }
 
    void SetPrimaryDrillCapped( const std::optional<bool>& aCapped );
    void SetPrimaryDrillCappedFlag( bool aCapped );
    std::optional<bool> GetPrimaryDrillCapped() const { return m_padStack.Drill().is_capped; }
    bool GetPrimaryDrillCappedFlag() const { return m_padStack.Drill().is_capped.value_or( false ); }
 
    void SetSecondaryDrillSize( const VECTOR2I& aSize );
    const VECTOR2I& GetSecondaryDrillSize() const { return m_padStack.SecondaryDrill().size; }
    void ClearSecondaryDrillSize();
 
    void SetSecondaryDrillSizeX( int aX );
    int GetSecondaryDrillSizeX() const { return m_padStack.SecondaryDrill().size.x; }
    void SetSecondaryDrillSizeY( int aY );
    int GetSecondaryDrillSizeY() const { return m_padStack.SecondaryDrill().size.y; }
 
    void SetSecondaryDrillShape( PAD_DRILL_SHAPE aShape );
    PAD_DRILL_SHAPE GetSecondaryDrillShape() const { return m_padStack.SecondaryDrill().shape; }
 
    void SetSecondaryDrillStartLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetSecondaryDrillStartLayer() const { return m_padStack.SecondaryDrill().start; }
    void SetSecondaryDrillEndLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetSecondaryDrillEndLayer() const { return m_padStack.SecondaryDrill().end; }
 
    void SetTertiaryDrillSize( const VECTOR2I& aSize );
    const VECTOR2I& GetTertiaryDrillSize() const { return m_padStack.TertiaryDrill().size; }
    void ClearTertiaryDrillSize();
 
    void SetTertiaryDrillSizeX( int aX );
    int GetTertiaryDrillSizeX() const { return m_padStack.TertiaryDrill().size.x; }
    void SetTertiaryDrillSizeY( int aY );
    int GetTertiaryDrillSizeY() const { return m_padStack.TertiaryDrill().size.y; }
 
    void SetTertiaryDrillShape( PAD_DRILL_SHAPE aShape );
    PAD_DRILL_SHAPE GetTertiaryDrillShape() const { return m_padStack.TertiaryDrill().shape; }
 
    void SetTertiaryDrillStartLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetTertiaryDrillStartLayer() const { return m_padStack.TertiaryDrill().start; }
    void SetTertiaryDrillEndLayer( PCB_LAYER_ID aLayer );
    PCB_LAYER_ID GetTertiaryDrillEndLayer() const { return m_padStack.TertiaryDrill().end; }
 
    bool IsDirty() const
    {
        return m_shapesDirty || m_polyDirty[ERROR_INSIDE] || m_polyDirty[ERROR_OUTSIDE];
    }
 
    void SetDirty()
    {
        m_shapesDirty = true;
        m_polyDirty[ERROR_INSIDE] = true;
        m_polyDirty[ERROR_OUTSIDE] = true;
    }
 
    void SetLayerSet( const LSET& aLayers ) override   { m_padStack.SetLayerSet( aLayers ); SetDirty(); }
    LSET GetLayerSet() const override           { return m_padStack.LayerSet(); }
 
    void SetAttribute( PAD_ATTRIB aAttribute );
    PAD_ATTRIB GetAttribute() const             { return m_attribute; }
 
    void SetProperty( PAD_PROP aProperty );
    PAD_PROP GetProperty() const                { return m_property; }
 
    // We don't currently have an attribute for APERTURE, and adding one will change the file
    // format, so for now just infer a copper-less pad to be an APERTURE pad.
    bool IsAperturePad() const
    {
        return ( m_padStack.LayerSet() & LSET::AllCuMask() ).none();
    }
 
    void SetPadToDieLength( int aLength )       { m_lengthPadToDie = aLength; }
    int GetPadToDieLength() const               { return m_lengthPadToDie; }
 
    void SetPadToDieDelay( int aDelay ) { m_delayPadToDie = aDelay; }
    int  GetPadToDieDelay() const { return m_delayPadToDie; }
 
    std::optional<int> GetLocalClearance() const override   { return m_padStack.Clearance(); }
    void SetLocalClearance( std::optional<int> aClearance ) { m_padStack.Clearance() = aClearance; }
 
    std::optional<int> GetLocalSolderMaskMargin() const { return m_padStack.SolderMaskMargin(); }
    void               SetLocalSolderMaskMargin( std::optional<int> aMargin )
    {
        m_padStack.SolderMaskMargin( F_Mask ) = aMargin;
        m_padStack.SolderMaskMargin( B_Mask ) = aMargin;
    }
 
    std::optional<int> GetLocalSolderPasteMargin() const { return m_padStack.SolderPasteMargin(); }
    void               SetLocalSolderPasteMargin( std::optional<int> aMargin )
    {
        m_padStack.SolderPasteMargin( F_Paste ) = aMargin;
        m_padStack.SolderPasteMargin( B_Paste ) = aMargin;
    }
 
    std::optional<double> GetLocalSolderPasteMarginRatio() const
    {
        return m_padStack.SolderPasteMarginRatio();
    }
    void SetLocalSolderPasteMarginRatio( std::optional<double> aRatio )
    {
        m_padStack.SolderPasteMarginRatio( F_Paste ) = aRatio;
        m_padStack.SolderPasteMarginRatio( B_Paste ) = aRatio;
    }
 
    void SetLocalZoneConnection( ZONE_CONNECTION aType ) { m_padStack.ZoneConnection() = aType; }
    ZONE_CONNECTION GetLocalZoneConnection() const
    {
        return m_padStack.ZoneConnection().value_or( ZONE_CONNECTION::INHERITED );
    }

    int GetOwnClearance( PCB_LAYER_ID aLayer, wxString* aSource = nullptr ) const override;

    void TransformShapeToPolygon( SHAPE_POLY_SET& aBuffer, PCB_LAYER_ID aLayer, int aClearance,
                                  int aMaxError, ERROR_LOC aErrorLoc = ERROR_INSIDE,
                                  bool ignoreLineWidth = false ) const override;

    bool TransformHoleToPolygon( SHAPE_POLY_SET& aBuffer, int aClearance, int aError,
                                 ERROR_LOC aErrorLoc = ERROR_INSIDE ) const;

    virtual std::shared_ptr<SHAPE>
    GetEffectiveShape( PCB_LAYER_ID aLayer,
                       FLASHING flashPTHPads = FLASHING::DEFAULT ) const override;
 
    const std::shared_ptr<SHAPE_POLY_SET>& GetEffectivePolygon( PCB_LAYER_ID aLayer,
                                                                ERROR_LOC aErrorLoc = ERROR_INSIDE ) const;

    std::shared_ptr<SHAPE_SEGMENT> GetEffectiveHoleShape() const override;

    int GetBoundingRadius() const;

    std::optional<int> GetLocalClearance( wxString* aSource ) const override;

    std::optional<int> GetClearanceOverrides( wxString* aSource ) const override;

    int GetSolderMaskExpansion( PCB_LAYER_ID aLayer ) const;

    VECTOR2I GetSolderPasteMargin( PCB_LAYER_ID aLayer ) const;
 
    ZONE_CONNECTION GetZoneConnectionOverrides( wxString* aSource = nullptr ) const;

    void SetLocalThermalSpokeWidthOverride( std::optional<int> aWidth )
    {
        m_padStack.ThermalSpokeWidth() = aWidth;
    }
    std::optional<int> GetLocalThermalSpokeWidthOverride() const
    {
        return m_padStack.ThermalSpokeWidth();
    }
 
    int GetLocalSpokeWidthOverride( wxString* aSource = nullptr ) const;

    void SetThermalSpokeAngle( const EDA_ANGLE& aAngle )
    {
        m_padStack.SetThermalSpokeAngle( aAngle );
    }
    EDA_ANGLE GetThermalSpokeAngle() const
    {
        return m_padStack.ThermalSpokeAngle();
    }
 
    // For property system
    void SetThermalSpokeAngleDegrees( double aAngle )
    {
        m_padStack.SetThermalSpokeAngle( EDA_ANGLE( aAngle, DEGREES_T ) );
    }
    double GetThermalSpokeAngleDegrees() const
    {
        return m_padStack.ThermalSpokeAngle().AsDegrees();
    }
 
    void SetThermalGap( int aGap ) { m_padStack.ThermalGap() = aGap; }
    int GetThermalGap() const { return m_padStack.ThermalGap().value_or( 0 ); }
 
    int GetLocalThermalGapOverride( wxString* aSource ) const;
 
    std::optional<int> GetLocalThermalGapOverride() const
    {
        return m_padStack.ThermalGap();
    }
    void SetLocalThermalGapOverride( const std::optional<int>& aOverride )
    {
        m_padStack.ThermalGap() = aOverride;
    }

    void SetRoundRectCornerRadius( PCB_LAYER_ID aLayer, double aRadius );
    int GetRoundRectCornerRadius( PCB_LAYER_ID aLayer ) const;
 
    VECTOR2I ShapePos( PCB_LAYER_ID aLayer ) const;

    void SetRoundRectRadiusRatio( PCB_LAYER_ID aLayer, double aRadiusScale );
    double GetRoundRectRadiusRatio( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.RoundRectRadiusRatio( aLayer );
    }
 
    // For properties panel, which only supports normal padstacks
    void SetFrontRoundRectRadiusRatio( double aRadiusScale );
    double GetFrontRoundRectRadiusRatio() const
    {
       return m_padStack.RoundRectRadiusRatio( F_Cu );
    }
 
    // For properties panel, which only supports normal padstacks
    void SetFrontRoundRectRadiusSize( int aRadius );
    int  GetFrontRoundRectRadiusSize() const;

    void SetChamferRectRatio( PCB_LAYER_ID aLayer, double aChamferScale );
    double GetChamferRectRatio( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.ChamferRatio( aLayer );
    }

    void SetChamferPositions( PCB_LAYER_ID aLayer, int aPositions )
    {
        m_padStack.SetChamferPositions( aPositions, aLayer );
    }
 
    int GetChamferPositions( PCB_LAYER_ID aLayer ) const
    {
        return m_padStack.ChamferPositions( aLayer );
    }

    int GetSubRatsnest() const                  { return m_subRatsnest; }
    void SetSubRatsnest( int aSubRatsnest )     { m_subRatsnest = aSubRatsnest; }

    void SetRemoveUnconnected( bool aSet )
    {
        m_padStack.SetUnconnectedLayerMode( aSet ? UNCONNECTED_LAYER_MODE::REMOVE_ALL
                                                 : UNCONNECTED_LAYER_MODE::KEEP_ALL );
    }
 
    bool GetRemoveUnconnected() const
    {
        return m_padStack.UnconnectedLayerMode() != UNCONNECTED_LAYER_MODE::KEEP_ALL;
    }

    void SetKeepTopBottom( bool aSet )
    {
        m_padStack.SetUnconnectedLayerMode( aSet ? UNCONNECTED_LAYER_MODE::REMOVE_EXCEPT_START_AND_END
                                                 : UNCONNECTED_LAYER_MODE::REMOVE_ALL );
    }
 
    bool GetKeepTopBottom() const
    {
        return m_padStack.UnconnectedLayerMode() == UNCONNECTED_LAYER_MODE::REMOVE_EXCEPT_START_AND_END;
    }
 
    void SetUnconnectedLayerMode( UNCONNECTED_LAYER_MODE aMode )
    {
        m_padStack.SetUnconnectedLayerMode( aMode );
    }
 
    UNCONNECTED_LAYER_MODE GetUnconnectedLayerMode() const
    {
        return m_padStack.UnconnectedLayerMode();
    }
 
    bool ConditionallyFlashed( PCB_LAYER_ID aLayer ) const
    {
        switch( m_padStack.UnconnectedLayerMode() )
        {
        case UNCONNECTED_LAYER_MODE::KEEP_ALL:
            return false;
 
        case UNCONNECTED_LAYER_MODE::REMOVE_ALL:
            return true;
 
        case UNCONNECTED_LAYER_MODE::REMOVE_EXCEPT_START_AND_END:
        case UNCONNECTED_LAYER_MODE::START_END_ONLY:
            return aLayer != m_padStack.Drill().start && aLayer != m_padStack.Drill().end;
        }
 
        return true;
    }
 
    void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
 
    bool IsOnLayer( PCB_LAYER_ID aLayer ) const override
    {
        return m_padStack.LayerSet().test( aLayer );
    }

    bool FlashLayer( int aLayer, bool aOnlyCheckIfPermitted = false ) const;
 
    bool CanFlashLayer( int aLayer )
    {
        return FlashLayer( aLayer, true );
    }
 
    PCB_LAYER_ID GetLayer() const override;

    PCB_LAYER_ID GetPrincipalLayer() const;

    bool FlashLayer( const LSET& aLayers ) const;
 
    bool HitTest( const VECTOR2I& aPosition, int aAccuracy = 0 ) const override;
    bool HitTest( const BOX2I& aRect, bool aContained, int aAccuracy = 0 ) const override;
    bool HitTest( const SHAPE_LINE_CHAIN& aPoly, bool aContained ) const override;

    bool HitTest( const VECTOR2I& aPosition, int aAccuracy, PCB_LAYER_ID aLayer ) const;

    std::vector<PCB_SHAPE*> Recombine( bool aIsDryRun, int aMaxError );
 
    wxString GetClass() const override
    {
        return wxT( "PAD" );
    }

    const BOX2I GetBoundingBox() const override;
    const BOX2I GetBoundingBox( PCB_LAYER_ID aLayer ) const;

    static int Compare( const PAD* aPadRef, const PAD* aPadCmp );
 
    void Move( const VECTOR2I& aMoveVector ) override
    {
        m_pos += aMoveVector;
        SetDirty();
    }
 
    void Rotate( const VECTOR2I& aRotCentre, const EDA_ANGLE& aAngle ) override;
 
    wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, bool aFull ) const override;
 
    BITMAPS GetMenuImage() const override;

    static wxString ShowPadShape( PAD_SHAPE aShape );
    wxString ShowPadShape( PCB_LAYER_ID aLayer ) const;

    wxString ShowLegacyPadShape( PCB_LAYER_ID aLayer ) const;

    wxString ShowPadAttr() const;
 
    EDA_ITEM* Clone() const override;

    PAD* ClonePad() const
    {
        return (PAD*) Clone();
    }

    void BuildEffectiveShapes() const;
    void BuildEffectivePolygon( ERROR_LOC aErrorLoc = ERROR_INSIDE ) const;
 
    virtual std::vector<int> ViewGetLayers() const override;
 
    double ViewGetLOD( int aLayer, const KIGFX::VIEW* aView ) const override;
 
    virtual const BOX2I ViewBBox() const override;
 
    void ClearZoneLayerOverrides();
 
    const ZONE_LAYER_OVERRIDE& GetZoneLayerOverride( PCB_LAYER_ID aLayer ) const;
 
    void SetZoneLayerOverride( PCB_LAYER_ID aLayer, ZONE_LAYER_OVERRIDE aOverride );
 
    void CheckPad( UNITS_PROVIDER* aUnitsProvider, bool aForPadProperties,
                   const std::function<void( int aErrorCode, const wxString& aMsg )>& aErrorHandler ) const;
 
    BACKDRILL_MODE GetBackdrillMode() const { return m_padStack.GetBackdrillMode(); }
    void SetBackdrillMode( BACKDRILL_MODE aMode ) { m_padStack.SetBackdrillMode( aMode ); }
 
    std::optional<int> GetBottomBackdrillSize() const { return m_padStack.GetBackdrillSize( false ); }
    void SetBottomBackdrillSize( std::optional<int> aSize ) { m_padStack.SetBackdrillSize( false, aSize ); }
 
    PCB_LAYER_ID GetBottomBackdrillLayer() const { return m_padStack.GetBackdrillEndLayer( false ); }
    void SetBottomBackdrillLayer( PCB_LAYER_ID aLayer ) { m_padStack.SetBackdrillEndLayer( false, aLayer ); }
 
    std::optional<int> GetTopBackdrillSize() const { return m_padStack.GetBackdrillSize( true ); }
    void SetTopBackdrillSize( std::optional<int> aSize ) { m_padStack.SetBackdrillSize( true, aSize ); }
 
    PCB_LAYER_ID GetTopBackdrillLayer() const { return m_padStack.GetBackdrillEndLayer( true ); }
    void SetTopBackdrillLayer( PCB_LAYER_ID aLayer ) { m_padStack.SetBackdrillEndLayer( true, aLayer ); }
 
    double Similarity( const BOARD_ITEM& aOther ) const override;
 
    bool operator==( const PAD& aOther ) const;
    bool operator==( const BOARD_ITEM& aBoardItem ) const override;
 
#if defined(DEBUG)
    virtual void Show( int nestLevel, std::ostream& os ) const override { ShowDummy( os ); }
#endif
 
protected:
    virtual void swapData( BOARD_ITEM* aImage ) override;
 
private:
    const SHAPE_COMPOUND& buildEffectiveShape( PCB_LAYER_ID aLayer ) const;
 
    void doCheckPad( PCB_LAYER_ID aLayer, UNITS_PROVIDER* aUnitsProvider, bool aForPadProperties,
                     const std::function<void( int aErrorCode, const wxString& aMsg )>& aErrorHandler ) const;
 
private:
    wxString          m_number;             // Pad name (pin number in schematic)
    wxString          m_pinFunction;        // Pin name in schematic
    wxString          m_pinType;            // Pin electrical type in schematic
 
    VECTOR2I          m_pos;                // Pad Position on board
 
    PADSTACK          m_padStack;
 
    // Must be set to true to force rebuild shapes to draw (after geometry change for instance)
    typedef std::map<PCB_LAYER_ID, std::shared_ptr<SHAPE_COMPOUND>> LAYER_SHAPE_MAP;
    mutable bool                              m_shapesDirty;
    mutable std::mutex                        m_shapesBuildingLock;
    mutable BOX2I                             m_effectiveBoundingBox;
    mutable LAYER_SHAPE_MAP                   m_effectiveShapes;
    mutable std::shared_ptr<SHAPE_SEGMENT>    m_effectiveHoleShape;
 
    typedef std::map<PCB_LAYER_ID, std::array<std::shared_ptr<SHAPE_POLY_SET>, 2>> LAYER_POLYGON_MAP;
    mutable bool                              m_polyDirty[2];
    mutable std::mutex                        m_polyBuildingLock;
    mutable LAYER_POLYGON_MAP                 m_effectivePolygons;
    mutable int                               m_effectiveBoundingRadius;
    // Last zoom level used to draw the pad: the LAYER_PAD_HOLEWALLS layer shape
    // depend on the zoom level. So keep trace on the last used zoom level
    mutable double                            m_lastGalZoomLevel;
 
    int               m_subRatsnest;        // Variable used to handle subnet (block) number in
                                            //   ratsnest computations
 
    PAD_ATTRIB        m_attribute = PAD_ATTRIB::PTH;
 
    PAD_PROP          m_property;           // Property in fab files (BGA, FIDUCIAL, TESTPOINT, etc.)
 
    int               m_lengthPadToDie;     // Length net from pad to die, inside the package
    int               m_delayPadToDie;      // Propagation delay from pad to die
 
    mutable std::mutex                          m_zoneLayerOverridesMutex;
    std::map<PCB_LAYER_ID, ZONE_LAYER_OVERRIDE> m_zoneLayerOverrides;
};