/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2016 Jean-Pierre Charras, jp.charras at wanadoo.fr * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck * Copyright (C) 1992-2016 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 */ /** * @file class_pad.cpp * D_PAD class implementation. */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include /** * Helper function * Return a string (to be shown to the user) describing a layer mask. * Useful for showing where is a pad. * The BOARD is needed because layer names are (somewhat) customizable */ static wxString LayerMaskDescribe( const BOARD* aBoard, LSET aMask ); int D_PAD::m_PadSketchModePenSize = 0; // Pen size used to draw pads in sketch mode D_PAD::D_PAD( MODULE* parent ) : BOARD_CONNECTED_ITEM( parent, PCB_PAD_T ) { m_NumPadName = 0; m_Size.x = m_Size.y = Mils2iu( 60 ); // Default pad size 60 mils. m_Drill.x = m_Drill.y = Mils2iu( 30 ); // Default drill size 30 mils. m_Orient = 0; // Pad rotation in 1/10 degrees. m_LengthPadToDie = 0; if( m_Parent && m_Parent->Type() == PCB_MODULE_T ) { m_Pos = GetParent()->GetPosition(); } SetShape( PAD_SHAPE_CIRCLE ); // Default pad shape is PAD_CIRCLE. SetDrillShape( PAD_DRILL_SHAPE_CIRCLE ); // Default pad drill shape is a circle. m_Attribute = PAD_ATTRIB_STANDARD; // Default pad type is NORMAL (thru hole) m_LocalClearance = 0; m_LocalSolderMaskMargin = 0; m_LocalSolderPasteMargin = 0; m_LocalSolderPasteMarginRatio = 0.0; // Parameters for round rect only: m_padRoundRectRadiusScale = 0.25; // from IPC-7351C standard m_ZoneConnection = PAD_ZONE_CONN_INHERITED; // Use parent setting by default m_ThermalWidth = 0; // Use parent setting by default m_ThermalGap = 0; // Use parent setting by default // Set layers mask to default for a standard thru hole pad. m_layerMask = StandardMask(); SetSubRatsnest( 0 ); // used in ratsnest calculations m_boundingRadius = -1; } LSET D_PAD::StandardMask() { static LSET saved = LSET::AllCuMask() | LSET( 2, B_Mask, F_Mask ); return saved; } LSET D_PAD::SMDMask() { static LSET saved( 3, F_Cu, F_Paste, F_Mask ); return saved; } LSET D_PAD::ConnSMDMask() { static LSET saved( 2, F_Cu, F_Mask ); return saved; } LSET D_PAD::UnplatedHoleMask() { static LSET saved = LSET::AllCuMask() | LSET( 2, B_Mask, F_Mask ); return saved; } bool D_PAD::IsFlipped() const { if( GetParent() && GetParent()->GetLayer() == B_Cu ) return true; return false; } int D_PAD::boundingRadius() const { int x, y; int radius; switch( GetShape() ) { case PAD_SHAPE_CIRCLE: radius = m_Size.x / 2; break; case PAD_SHAPE_OVAL: radius = std::max( m_Size.x, m_Size.y ) / 2; break; case PAD_SHAPE_RECT: radius = 1 + KiROUND( EuclideanNorm( m_Size ) / 2 ); break; case PAD_SHAPE_TRAPEZOID: x = m_Size.x + std::abs( m_DeltaSize.y ); // Remember: m_DeltaSize.y is the m_Size.x change y = m_Size.y + std::abs( m_DeltaSize.x ); // Remember: m_DeltaSize.x is the m_Size.y change radius = 1 + KiROUND( hypot( x, y ) / 2 ); break; case PAD_SHAPE_ROUNDRECT: radius = GetRoundRectCornerRadius(); x = m_Size.x >> 1; y = m_Size.y >> 1; radius += 1 + KiROUND( EuclideanNorm( wxSize( x - radius, y - radius ))); break; default: radius = 0; } return radius; } int D_PAD::GetRoundRectCornerRadius( const wxSize& aSize ) const { // radius of rounded corners, usually 25% of shorter pad edge for now int r = aSize.x > aSize.y ? aSize.y : aSize.x; r = int( r * m_padRoundRectRadiusScale ); return r; } const EDA_RECT D_PAD::GetBoundingBox() const { EDA_RECT area; wxPoint quadrant1, quadrant2, quadrant3, quadrant4; int x, y, dx, dy; switch( GetShape() ) { case PAD_SHAPE_CIRCLE: area.SetOrigin( m_Pos ); area.Inflate( m_Size.x / 2 ); break; case PAD_SHAPE_OVAL: // Calculate the position of each rounded ent quadrant1.x = m_Size.x/2; quadrant1.y = 0; quadrant2.x = 0; quadrant2.y = m_Size.y/2; RotatePoint( &quadrant1, m_Orient ); RotatePoint( &quadrant2, m_Orient ); // Calculate the max position of each end, relative to the pad position // (the min position is symetrical) dx = std::max( std::abs( quadrant1.x ) , std::abs( quadrant2.x ) ); dy = std::max( std::abs( quadrant1.y ) , std::abs( quadrant2.y ) ); // Set the bbox area.SetOrigin( m_Pos ); area.Inflate( dx, dy ); break; case PAD_SHAPE_RECT: case PAD_SHAPE_ROUNDRECT: // Use two opposite corners and track their rotation // (use symmetry for other points) quadrant1.x = m_Size.x/2; quadrant1.y = m_Size.y/2; quadrant2.x = -m_Size.x/2; quadrant2.y = m_Size.y/2; RotatePoint( &quadrant1, m_Orient ); RotatePoint( &quadrant2, m_Orient ); dx = std::max( std::abs( quadrant1.x ) , std::abs( quadrant2.x ) ); dy = std::max( std::abs( quadrant1.y ) , std::abs( quadrant2.y ) ); // Set the bbox area.SetOrigin( m_Pos ); area.Inflate( dx, dy ); break; case PAD_SHAPE_TRAPEZOID: //Use the four corners and track their rotation // (Trapezoids will not be symmetric) quadrant1.x = (m_Size.x + m_DeltaSize.y)/2; quadrant1.y = (m_Size.y - m_DeltaSize.x)/2; quadrant2.x = -(m_Size.x + m_DeltaSize.y)/2; quadrant2.y = (m_Size.y + m_DeltaSize.x)/2; quadrant3.x = -(m_Size.x - m_DeltaSize.y)/2; quadrant3.y = -(m_Size.y + m_DeltaSize.x)/2; quadrant4.x = (m_Size.x - m_DeltaSize.y)/2; quadrant4.y = -(m_Size.y - m_DeltaSize.x)/2; RotatePoint( &quadrant1, m_Orient ); RotatePoint( &quadrant2, m_Orient ); RotatePoint( &quadrant3, m_Orient ); RotatePoint( &quadrant4, m_Orient ); x = std::min( quadrant1.x, std::min( quadrant2.x, std::min( quadrant3.x, quadrant4.x) ) ); y = std::min( quadrant1.y, std::min( quadrant2.y, std::min( quadrant3.y, quadrant4.y) ) ); dx = std::max( quadrant1.x, std::max( quadrant2.x, std::max( quadrant3.x, quadrant4.x) ) ); dy = std::max( quadrant1.y, std::max( quadrant2.y, std::max( quadrant3.y, quadrant4.y) ) ); area.SetOrigin( m_Pos.x+x, m_Pos.y+y ); area.SetSize( dx-x, dy-y ); break; default: break; } return area; } void D_PAD::SetDrawCoord() { MODULE* module = (MODULE*) m_Parent; m_Pos = m_Pos0; if( module == NULL ) return; double angle = module->GetOrientation(); RotatePoint( &m_Pos.x, &m_Pos.y, angle ); m_Pos += module->GetPosition(); } void D_PAD::SetLocalCoord() { MODULE* module = (MODULE*) m_Parent; if( module == NULL ) { m_Pos0 = m_Pos; return; } m_Pos0 = m_Pos - module->GetPosition(); RotatePoint( &m_Pos0.x, &m_Pos0.y, -module->GetOrientation() ); } void D_PAD::SetAttribute( PAD_ATTR_T aAttribute ) { m_Attribute = aAttribute; if( aAttribute == PAD_ATTRIB_SMD ) m_Drill = wxSize( 0, 0 ); } void D_PAD::SetOrientation( double aAngle ) { NORMALIZE_ANGLE_POS( aAngle ); m_Orient = aAngle; } void D_PAD::Flip( const wxPoint& aCentre ) { int y = GetPosition().y; MIRROR( y, aCentre.y ); // invert about x axis. SetY( y ); MIRROR( m_Pos0.y, 0 ); MIRROR( m_Offset.y, 0 ); MIRROR( m_DeltaSize.y, 0 ); SetOrientation( -GetOrientation() ); // flip pads layers // PADS items are currently on all copper layers, or // currently, only on Front or Back layers. // So the copper layers count is not taken in account SetLayerSet( FlipLayerMask( m_layerMask ) ); // m_boundingRadius = -1; the shape has not been changed } void D_PAD::AppendConfigs( PARAM_CFG_ARRAY* aResult ) { // Parameters stored in config are only significant parameters // for a template. // So not all parameters are stored, just few. aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadDrill" ), &m_Drill.x, Millimeter2iu( 0.6 ), Millimeter2iu( 0.1 ), Millimeter2iu( 10.0 ), NULL, MM_PER_IU ) ); aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadDrillOvalY" ), &m_Drill.y, Millimeter2iu( 0.6 ), Millimeter2iu( 0.1 ), Millimeter2iu( 10.0 ), NULL, MM_PER_IU ) ); aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadSizeH" ), &m_Size.x, Millimeter2iu( 1.4 ), Millimeter2iu( 0.1 ), Millimeter2iu( 20.0 ), NULL, MM_PER_IU ) ); aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadSizeV" ), &m_Size.y, Millimeter2iu( 1.4 ), Millimeter2iu( 0.1 ), Millimeter2iu( 20.0 ), NULL, MM_PER_IU ) ); } // Returns the position of the pad. wxPoint D_PAD::ShapePos() const { if( m_Offset.x == 0 && m_Offset.y == 0 ) return m_Pos; wxPoint loc_offset = m_Offset; RotatePoint( &loc_offset, m_Orient ); wxPoint shape_pos = m_Pos + loc_offset; return shape_pos; } wxString D_PAD::GetPadName() const { wxString name; StringPadName( name ); return name; } void D_PAD::StringPadName( wxString& text ) const { text.Empty(); for( int ii = 0; ii < PADNAMEZ && m_Padname[ii]; ii++ ) { // m_Padname is 8 bit KiCad font junk, do not sign extend text.Append( (unsigned char) m_Padname[ii] ); } } // Change pad name void D_PAD::SetPadName( const wxString& name ) { int ii, len; len = name.Length(); if( len > PADNAMEZ ) len = PADNAMEZ; // m_Padname[] is not UTF8, it is an 8 bit character that matches the KiCad font, // so only copy the lower 8 bits of each character. for( ii = 0; ii < len; ii++ ) m_Padname[ii] = (char) name.GetChar( ii ); for( ii = len; ii < PADNAMEZ; ii++ ) m_Padname[ii] = '\0'; } bool D_PAD::IncrementPadName( bool aSkipUnconnectable, bool aFillSequenceGaps ) { bool skip = aSkipUnconnectable && ( GetAttribute() == PAD_ATTRIB_HOLE_NOT_PLATED ); if( !skip ) SetPadName( GetParent()->GetNextPadName( aFillSequenceGaps ) ); return !skip; } void D_PAD::CopyNetlistSettings( D_PAD* aPad, bool aCopyLocalSettings ) { // Don't do anything foolish like trying to copy to yourself. wxCHECK_RET( aPad != NULL && aPad != this, wxT( "Cannot copy to NULL or yourself." ) ); aPad->SetNetCode( GetNetCode() ); if( aCopyLocalSettings ) { aPad->SetLocalClearance( m_LocalClearance ); aPad->SetLocalSolderMaskMargin( m_LocalSolderMaskMargin ); aPad->SetLocalSolderPasteMargin( m_LocalSolderPasteMargin ); aPad->SetLocalSolderPasteMarginRatio( m_LocalSolderPasteMarginRatio ); aPad->SetZoneConnection( m_ZoneConnection ); aPad->SetThermalWidth( m_ThermalWidth ); aPad->SetThermalGap( m_ThermalGap ); } } int D_PAD::GetClearance( BOARD_CONNECTED_ITEM* aItem ) const { // A pad can have specific clearance parameters that // overrides its NETCLASS clearance value int clearance = m_LocalClearance; if( clearance == 0 ) { // If local clearance is 0, use the parent footprint clearance value if( GetParent() && GetParent()->GetLocalClearance() ) clearance = GetParent()->GetLocalClearance(); } if( clearance == 0 ) // If the parent footprint clearance value = 0, use NETCLASS value return BOARD_CONNECTED_ITEM::GetClearance( aItem ); // We have a specific clearance. // if aItem, return the biggest clearance if( aItem ) { int hisClearance = aItem->GetClearance(); return std::max( hisClearance, clearance ); } // Return the specific clearance. return clearance; } // Mask margins handling: int D_PAD::GetSolderMaskMargin() const { int margin = m_LocalSolderMaskMargin; MODULE* module = GetParent(); if( module ) { if( margin == 0 ) { if( module->GetLocalSolderMaskMargin() ) margin = module->GetLocalSolderMaskMargin(); } if( margin == 0 ) { BOARD* brd = GetBoard(); margin = brd->GetDesignSettings().m_SolderMaskMargin; } } // ensure mask have a size always >= 0 if( margin < 0 ) { int minsize = -std::min( m_Size.x, m_Size.y ) / 2; if( margin < minsize ) margin = minsize; } return margin; } wxSize D_PAD::GetSolderPasteMargin() const { int margin = m_LocalSolderPasteMargin; double mratio = m_LocalSolderPasteMarginRatio; MODULE* module = GetParent(); if( module ) { if( margin == 0 ) margin = module->GetLocalSolderPasteMargin(); BOARD * brd = GetBoard(); if( margin == 0 ) margin = brd->GetDesignSettings().m_SolderPasteMargin; if( mratio == 0.0 ) mratio = module->GetLocalSolderPasteMarginRatio(); if( mratio == 0.0 ) { mratio = brd->GetDesignSettings().m_SolderPasteMarginRatio; } } wxSize pad_margin; pad_margin.x = margin + KiROUND( m_Size.x * mratio ); pad_margin.y = margin + KiROUND( m_Size.y * mratio ); // ensure mask have a size always >= 0 if( pad_margin.x < -m_Size.x / 2 ) pad_margin.x = -m_Size.x / 2; if( pad_margin.y < -m_Size.y / 2 ) pad_margin.y = -m_Size.y / 2; return pad_margin; } ZoneConnection D_PAD::GetZoneConnection() const { MODULE* module = GetParent(); if( m_ZoneConnection == PAD_ZONE_CONN_INHERITED && module ) return module->GetZoneConnection(); else return m_ZoneConnection; } int D_PAD::GetThermalWidth() const { MODULE* module = GetParent(); if( m_ThermalWidth == 0 && module ) return module->GetThermalWidth(); else return m_ThermalWidth; } int D_PAD::GetThermalGap() const { MODULE* module = GetParent(); if( m_ThermalGap == 0 && module ) return module->GetThermalGap(); else return m_ThermalGap; } void D_PAD::GetMsgPanelInfo( std::vector< MSG_PANEL_ITEM>& aList ) { MODULE* module; wxString Line; BOARD* board; module = (MODULE*) m_Parent; if( module ) { wxString msg = module->GetReference(); aList.push_back( MSG_PANEL_ITEM( _( "Footprint" ), msg, DARKCYAN ) ); StringPadName( Line ); aList.push_back( MSG_PANEL_ITEM( _( "Pad" ), Line, BROWN ) ); } aList.push_back( MSG_PANEL_ITEM( _( "Net" ), GetNetname(), DARKCYAN ) ); /* For test and debug only: display m_physical_connexion and * m_logical_connexion */ #if 1 // Used only to debug connectivity calculations Line.Printf( wxT( "%d-%d-%d " ), GetSubRatsnest(), GetSubNet(), GetZoneSubNet() ); aList.push_back( MSG_PANEL_ITEM( wxT( "L-P-Z" ), Line, DARKGREEN ) ); #endif board = GetBoard(); aList.push_back( MSG_PANEL_ITEM( _( "Layer" ), LayerMaskDescribe( board, m_layerMask ), DARKGREEN ) ); aList.push_back( MSG_PANEL_ITEM( ShowPadShape(), ShowPadAttr(), DARKGREEN ) ); Line = ::CoordinateToString( m_Size.x ); aList.push_back( MSG_PANEL_ITEM( _( "Width" ), Line, RED ) ); Line = ::CoordinateToString( m_Size.y ); aList.push_back( MSG_PANEL_ITEM( _( "Height" ), Line, RED ) ); Line = ::CoordinateToString( (unsigned) m_Drill.x ); if( GetDrillShape() == PAD_DRILL_SHAPE_CIRCLE ) { aList.push_back( MSG_PANEL_ITEM( _( "Drill" ), Line, RED ) ); } else { Line = ::CoordinateToString( (unsigned) m_Drill.x ); wxString msg; msg = ::CoordinateToString( (unsigned) m_Drill.y ); Line += wxT( "/" ) + msg; aList.push_back( MSG_PANEL_ITEM( _( "Drill X / Y" ), Line, RED ) ); } double module_orient_degrees = module ? module->GetOrientationDegrees() : 0; if( module_orient_degrees != 0.0 ) Line.Printf( wxT( "%3.1f(+%3.1f)" ), GetOrientationDegrees() - module_orient_degrees, module_orient_degrees ); else Line.Printf( wxT( "%3.1f" ), GetOrientationDegrees() ); aList.push_back( MSG_PANEL_ITEM( _( "Angle" ), Line, LIGHTBLUE ) ); Line = ::CoordinateToString( m_Pos.x ) + wxT( ", " ) + ::CoordinateToString( m_Pos.y ); aList.push_back( MSG_PANEL_ITEM( _( "Position" ), Line, LIGHTBLUE ) ); if( GetPadToDieLength() ) { Line = ::CoordinateToString( GetPadToDieLength() ); aList.push_back( MSG_PANEL_ITEM( _( "Length in package" ), Line, CYAN ) ); } } void D_PAD::GetOblongDrillGeometry( wxPoint& aStartPoint, wxPoint& aEndPoint, int& aWidth ) const { // calculates the start point, end point and width // of an equivalent segment which have the same position and width as the hole int delta_cx, delta_cy; wxSize halfsize = GetDrillSize(); halfsize.x /= 2; halfsize.y /= 2; if( m_Drill.x > m_Drill.y ) // horizontal { delta_cx = halfsize.x - halfsize.y; delta_cy = 0; aWidth = m_Drill.y; } else // vertical { delta_cx = 0; delta_cy = halfsize.y - halfsize.x; aWidth = m_Drill.x; } RotatePoint( &delta_cx, &delta_cy, m_Orient ); aStartPoint.x = delta_cx; aStartPoint.y = delta_cy; aEndPoint.x = - delta_cx; aEndPoint.y = - delta_cy; } bool D_PAD::HitTest( const wxPoint& aPosition ) const { int dx, dy; wxPoint shape_pos = ShapePos(); wxPoint delta = aPosition - shape_pos; // first test: a test point must be inside a minimum sized bounding circle. int radius = GetBoundingRadius(); if( ( abs( delta.x ) > radius ) || ( abs( delta.y ) > radius ) ) return false; dx = m_Size.x >> 1; // dx also is the radius for rounded pads dy = m_Size.y >> 1; switch( GetShape() ) { case PAD_SHAPE_CIRCLE: if( KiROUND( EuclideanNorm( delta ) ) <= dx ) return true; break; case PAD_SHAPE_TRAPEZOID: { wxPoint poly[4]; BuildPadPolygon( poly, wxSize(0,0), 0 ); RotatePoint( &delta, -m_Orient ); return TestPointInsidePolygon( poly, 4, delta ); } case PAD_SHAPE_OVAL: { RotatePoint( &delta, -m_Orient ); // An oval pad has the same shape as a segment with rounded ends // After rotation, the test point is relative to an horizontal pad int dist; wxPoint offset; if( dy > dx ) // shape is a vertical oval { offset.y = dy - dx; dist = dx; } else //if( dy <= dx ) shape is an horizontal oval { offset.x = dy - dx; dist = dy; } return TestSegmentHit( delta, - offset, offset, dist ); } break; case PAD_SHAPE_RECT: RotatePoint( &delta, -m_Orient ); if( (abs( delta.x ) <= dx ) && (abs( delta.y ) <= dy) ) return true; break; case PAD_SHAPE_ROUNDRECT: { // Check for hit in polygon SHAPE_POLY_SET outline; const int segmentToCircleCount = 32; TransformRoundRectToPolygon( outline, wxPoint(0,0), GetSize(), m_Orient, GetRoundRectCornerRadius(), segmentToCircleCount ); const SHAPE_LINE_CHAIN &poly = outline.COutline( 0 ); return TestPointInsidePolygon( (const wxPoint*)&poly.CPoint(0), poly.PointCount(), delta ); } break; } return false; } int D_PAD::Compare( const D_PAD* padref, const D_PAD* padcmp ) { int diff; if( ( diff = padref->GetShape() - padcmp->GetShape() ) != 0 ) return diff; if( ( diff = padref->GetDrillShape() - padcmp->GetDrillShape() ) != 0) return diff; if( ( diff = padref->m_Drill.x - padcmp->m_Drill.x ) != 0 ) return diff; if( ( diff = padref->m_Drill.y - padcmp->m_Drill.y ) != 0 ) return diff; if( ( diff = padref->m_Size.x - padcmp->m_Size.x ) != 0 ) return diff; if( ( diff = padref->m_Size.y - padcmp->m_Size.y ) != 0 ) return diff; if( ( diff = padref->m_Offset.x - padcmp->m_Offset.x ) != 0 ) return diff; if( ( diff = padref->m_Offset.y - padcmp->m_Offset.y ) != 0 ) return diff; if( ( diff = padref->m_DeltaSize.x - padcmp->m_DeltaSize.x ) != 0 ) return diff; if( ( diff = padref->m_DeltaSize.y - padcmp->m_DeltaSize.y ) != 0 ) return diff; // TODO: test custom shapes // Dick: specctra_export needs this // Lorenzo: gencad also needs it to implement padstacks! #if __cplusplus >= 201103L long long d = padref->m_layerMask.to_ullong() - padcmp->m_layerMask.to_ullong(); if( d < 0 ) return -1; else if( d > 0 ) return 1; return 0; #else // these strings are not typically constructed, since we don't get here often. std::string s1 = padref->m_layerMask.to_string(); std::string s2 = padcmp->m_layerMask.to_string(); return s1.compare( s2 ); #endif } void D_PAD::Rotate( const wxPoint& aRotCentre, double aAngle ) { RotatePoint( &m_Pos, aRotCentre, aAngle ); m_Orient = NormalizeAngle360( m_Orient + aAngle ); SetLocalCoord(); } wxString D_PAD::ShowPadShape() const { switch( GetShape() ) { case PAD_SHAPE_CIRCLE: return _( "Circle" ); case PAD_SHAPE_OVAL: return _( "Oval" ); case PAD_SHAPE_RECT: return _( "Rect" ); case PAD_SHAPE_TRAPEZOID: return _( "Trap" ); case PAD_SHAPE_ROUNDRECT: return _( "Roundrect" ); default: return wxT( "???" ); } } wxString D_PAD::ShowPadAttr() const { switch( GetAttribute() ) { case PAD_ATTRIB_STANDARD: return _( "Std" ); case PAD_ATTRIB_SMD: return _( "SMD" ); case PAD_ATTRIB_CONN: return _( "Conn" ); case PAD_ATTRIB_HOLE_NOT_PLATED: return _( "Not Plated" ); default: return wxT( "???" ); } } wxString D_PAD::GetSelectMenuText() const { wxString text; wxString padlayers( LayerMaskDescribe( GetBoard(), m_layerMask ) ); wxString padname( GetPadName() ); if( padname.IsEmpty() ) { text.Printf( _( "Pad on %s of %s" ), GetChars( padlayers ), GetChars(GetParent()->GetReference() ) ); } else { text.Printf( _( "Pad %s on %s of %s" ), GetChars(GetPadName() ), GetChars( padlayers ), GetChars(GetParent()->GetReference() ) ); } return text; } BITMAP_DEF D_PAD::GetMenuImage() const { return pad_xpm; } EDA_ITEM* D_PAD::Clone() const { return new D_PAD( *this ); } void D_PAD::ViewGetLayers( int aLayers[], int& aCount ) const { aCount = 0; // These types of pads contain a hole if( m_Attribute == PAD_ATTRIB_STANDARD || m_Attribute == PAD_ATTRIB_HOLE_NOT_PLATED ) aLayers[aCount++] = ITEM_GAL_LAYER( PADS_HOLES_VISIBLE ); if( IsOnLayer( F_Cu ) && IsOnLayer( B_Cu ) ) { // Multi layer pad aLayers[aCount++] = ITEM_GAL_LAYER( PADS_VISIBLE ); aLayers[aCount++] = NETNAMES_GAL_LAYER( PADS_NETNAMES_VISIBLE ); } else if( IsOnLayer( F_Cu ) ) { aLayers[aCount++] = ITEM_GAL_LAYER( PAD_FR_VISIBLE ); aLayers[aCount++] = NETNAMES_GAL_LAYER( PAD_FR_NETNAMES_VISIBLE ); } else if( IsOnLayer( B_Cu ) ) { aLayers[aCount++] = ITEM_GAL_LAYER( PAD_BK_VISIBLE ); aLayers[aCount++] = NETNAMES_GAL_LAYER( PAD_BK_NETNAMES_VISIBLE ); } // Check non-copper layers. This list should include all the layers that the // footprint editor allows a pad to be placed on. static const LAYER_ID layers_mech[] = { F_Mask, B_Mask, F_Paste, B_Paste, F_Adhes, B_Adhes, F_SilkS, B_SilkS, Dwgs_User, Eco1_User, Eco2_User }; for( LAYER_ID each_layer : layers_mech ) { if( IsOnLayer( each_layer ) ) aLayers[aCount++] = each_layer; } #ifdef __WXDEBUG__ if( aCount == 0 ) // Should not occur { wxString msg; msg.Printf( wxT( "footprint %s, pad %s: could not find valid layer for pad" ), GetParent() ? GetParent()->GetReference() : "", GetPadName().IsEmpty() ? "(unnamed)" : GetPadName() ); wxLogWarning( msg ); } #endif } unsigned int D_PAD::ViewGetLOD( int aLayer, KIGFX::VIEW* aView ) const { // Netnames will be shown only if zoom is appropriate if( IsNetnameLayer( aLayer ) ) { int divisor = std::max( m_Size.x, m_Size.y ); // Pad sizes can be zero briefly when someone is typing a number like "0.5" // in the pad properties dialog if( divisor == 0 ) return UINT_MAX; return ( Millimeter2iu( 100 ) / divisor ); } // Other layers are shown without any conditions return 0; } const BOX2I D_PAD::ViewBBox() const { // Bounding box includes soldermask too int solderMaskMargin = GetSolderMaskMargin(); VECTOR2I solderPasteMargin = VECTOR2D( GetSolderPasteMargin() ); EDA_RECT bbox = GetBoundingBox(); // Look for the biggest possible bounding box int xMargin = std::max( solderMaskMargin, solderPasteMargin.x ); int yMargin = std::max( solderMaskMargin, solderPasteMargin.y ); return BOX2I( VECTOR2I( bbox.GetOrigin() ) - VECTOR2I( xMargin, yMargin ), VECTOR2I( bbox.GetSize() ) + VECTOR2I( 2 * xMargin, 2 * yMargin ) ); } wxString LayerMaskDescribe( const BOARD *aBoard, LSET aMask ) { // Try the single or no- layer case (easy) LAYER_ID layer = aMask.ExtractLayer(); switch( (int) layer ) { case UNSELECTED_LAYER: return _( "No layers" ); case UNDEFINED_LAYER: break; default: return aBoard->GetLayerName( layer ); } // Try to be smart and useful, starting with outer copper // (which are more important than internal ones) wxString layerInfo; if( aMask[F_Cu] ) AccumulateDescription( layerInfo, aBoard->GetLayerName( F_Cu ) ); if( aMask[B_Cu] ) AccumulateDescription( layerInfo, aBoard->GetLayerName( B_Cu ) ); if( ( aMask & LSET::InternalCuMask() ).any() ) AccumulateDescription( layerInfo, _("Internal" ) ); if( ( aMask & LSET::AllNonCuMask() ).any() ) AccumulateDescription( layerInfo, _("Non-copper" ) ); return layerInfo; } void D_PAD::ImportSettingsFromMaster( const D_PAD& aMasterPad ) { SetShape( aMasterPad.GetShape() ); SetLayerSet( aMasterPad.GetLayerSet() ); SetAttribute( aMasterPad.GetAttribute() ); // The pad orientation, for historical reasons is the // pad rotation + parent rotation. // So we have to manage this parent rotation double pad_rot = aMasterPad.GetOrientation(); if( aMasterPad.GetParent() ) pad_rot -= aMasterPad.GetParent()->GetOrientation(); if( GetParent() ) pad_rot += GetParent()->GetOrientation(); SetOrientation( pad_rot ); SetSize( aMasterPad.GetSize() ); SetDelta( wxSize( 0, 0 ) ); SetOffset( aMasterPad.GetOffset() ); SetDrillSize( aMasterPad.GetDrillSize() ); SetDrillShape( aMasterPad.GetDrillShape() ); SetRoundRectRadiusRatio( aMasterPad.GetRoundRectRadiusRatio() ); switch( aMasterPad.GetShape() ) { case PAD_SHAPE_TRAPEZOID: SetDelta( aMasterPad.GetDelta() ); break; case PAD_SHAPE_CIRCLE: // ensure size.y == size.x SetSize( wxSize( GetSize().x, GetSize().x ) ); break; default: ; } switch( aMasterPad.GetAttribute() ) { case PAD_ATTRIB_SMD: case PAD_ATTRIB_CONN: // These pads do not have hole (they are expected to be only on one // external copper layer) SetDrillSize( wxSize( 0, 0 ) ); break; default: ; } }