KiCad PCB EDA Suite
D_PAD Class Reference

#include <class_pad.h>

Inheritance diagram for D_PAD:
BOARD_CONNECTED_ITEM BOARD_ITEM EDA_ITEM KIGFX::VIEW_ITEM

Public Member Functions

 D_PAD (MODULE *parent)
 
D_PADNext () const
 
MODULEGetParent () const
 
void ImportSettingsFromMaster (const D_PAD &aMasterPad)
 Imports the pad settings from aMasterPad. More...
 
bool IsFlipped () const
 
void SetName (const wxString &aName)
 Set the pad name (sometimes called pad number, although it can be an array reference like AA12). More...
 
const wxString & GetName () const
 
bool IncrementPadName (bool aSkipUnconnectable, bool aFillSequenceGaps)
 Function IncrementPadName. More...
 
bool PadNameEqual (const D_PAD *other) const
 
PAD_SHAPE_T GetShape () const
 Function GetShape. More...
 
void SetShape (PAD_SHAPE_T aShape)
 
void SetPosition (const wxPoint &aPos) override
 
const wxPointGetPosition () const override
 
PAD_SHAPE_T GetAnchorPadShape () const
 Function GetAnchorPadShape. More...
 
CUST_PAD_SHAPE_IN_ZONE GetCustomShapeInZoneOpt () const
 
void SetCustomShapeInZoneOpt (CUST_PAD_SHAPE_IN_ZONE aOption)
 Set the option for the custom pad shape to use as clearance area in copper zones. More...
 
void SetAnchorPadShape (PAD_SHAPE_T aShape)
 Function SetAnchorPadShape Set the shape of the anchor pad for custm shped pads. More...
 
void SetY (int y)
 
void SetX (int x)
 
void SetPos0 (const wxPoint &aPos)
 
const wxPointGetPos0 () const
 
void SetY0 (int y)
 
void SetX0 (int x)
 
void SetSize (const wxSize &aSize)
 
const wxSize & GetSize () const
 
void SetDelta (const wxSize &aSize)
 
const wxSize & GetDelta () const
 
void SetDrillSize (const wxSize &aSize)
 
const wxSize & GetDrillSize () const
 
void SetOffset (const wxPoint &aOffset)
 
const wxPointGetOffset () const
 
void AddPrimitive (std::vector< wxPoint > &aPoly, int aThickness)
 Has meaning only for free shape pads. More...
 
void AddPrimitive (wxPoint aStart, wxPoint aEnd, int aThickness)
 segment basic shape More...
 
void AddPrimitive (wxPoint aCenter, int aRadius, int aThickness)
 ring or circle basic shape More...
 
void AddPrimitive (wxPoint aCenter, wxPoint aStart, int aArcAngle, int aThickness)
 arc basic shape More...
 
bool MergePrimitivesAsPolygon (SHAPE_POLY_SET *aMergedPolygon=NULL, int aCircleToSegmentsCount=32)
 Merge all basic shapes, converted to a polygon in one polygon, in m_customShapeAsPolygon. More...
 
void DeletePrimitivesList ()
 clear the basic shapes list More...
 
void CustomShapeAsPolygonToBoardPosition (SHAPE_POLY_SET *aMergedPolygon, wxPoint aPosition, double aRotation) const
 When created, the corners coordinates are relative to the pad position, orientation 0, in m_customShapeAsPolygon CustomShapeAsPolygonToBoardPosition transform these coordinates to actual (board) coordinates. More...
 
const std::vector< PAD_CS_PRIMITIVE > & GetPrimitives () const
 Accessor to the basic shape list. More...
 
const SHAPE_POLY_SETGetCustomShapeAsPolygon () const
 Accessor to the custom shape as one polygon. More...
 
void Flip (const wxPoint &aCentre) override
 Function Flip Flip this object, i.e. More...
 
void FlipPrimitives ()
 Flip the basic shapes, in custom pads. More...
 
bool SetPrimitives (const std::vector< PAD_CS_PRIMITIVE > &aPrimitivesList)
 Import to the basic shape list. More...
 
void SetOrientation (double aAngle)
 Function SetOrientation sets the rotation angle of the pad. More...
 
void SetOrientationDegrees (double aOrientation)
 Set orientation in degrees. More...
 
double GetOrientation () const
 Function GetOrientation returns the rotation angle of the pad in tenths of degrees, but soon degrees. More...
 
double GetOrientationDegrees () const
 
double GetOrientationRadians () const
 
void SetDrillShape (PAD_DRILL_SHAPE_T aDrillShape)
 
PAD_DRILL_SHAPE_T GetDrillShape () const
 
void GetOblongDrillGeometry (wxPoint &aStartPoint, wxPoint &aEndPoint, int &aWidth) const
 Function GetOblongDrillGeometry calculates the start point, end point and width of an equivalent segment which have the same position and width as the hole Usefull to plot/draw oblong holes like segments with rounded ends used in draw and plot functions. More...
 
void SetLayerSet (LSET aLayerMask)
 
LSET GetLayerSet () const override
 Function GetLayerSet returns a "layer mask", which is a bitmap of all layers on which the TRACK segment or VIA physically resides. More...
 
void SetAttribute (PAD_ATTR_T aAttribute)
 
PAD_ATTR_T GetAttribute () const
 
void SetPadToDieLength (int aLength)
 
int GetPadToDieLength () const
 
int GetLocalSolderMaskMargin () const
 
void SetLocalSolderMaskMargin (int aMargin)
 
int GetLocalClearance () const
 
void SetLocalClearance (int aClearance)
 
int GetLocalSolderPasteMargin () const
 
void SetLocalSolderPasteMargin (int aMargin)
 
double GetLocalSolderPasteMarginRatio () const
 
void SetLocalSolderPasteMarginRatio (double aRatio)
 
void TransformShapeWithClearanceToPolygon (SHAPE_POLY_SET &aCornerBuffer, int aClearanceValue, int aCircleToSegmentsCount, double aCorrectionFactor) const
 Function TransformShapeWithClearanceToPolygon Convert the pad shape to a closed polygon Used in filling zones calculations Circles and arcs are approximated by segments. More...
 
int GetClearance (BOARD_CONNECTED_ITEM *aItem=NULL) const override
 Function GetClearance returns the clearance in internal units. More...
 
int GetSolderMaskMargin () const
 Function GetSolderMaskMargin. More...
 
wxSize GetSolderPasteMargin () const
 Function GetSolderPasteMargin. More...
 
void SetZoneConnection (ZoneConnection aType)
 
ZoneConnection GetZoneConnection () const
 
void SetThermalWidth (int aWidth)
 
int GetThermalWidth () const
 
void SetThermalGap (int aGap)
 
int GetThermalGap () const
 
void Draw (EDA_DRAW_PANEL *aPanel, wxDC *aDC, GR_DRAWMODE aDrawMode, const wxPoint &aOffset=ZeroOffset) override
 Function Draw BOARD_ITEMs have their own color information. More...
 
void DrawShape (EDA_RECT *aClipBox, wxDC *aDC, PAD_DRAWINFO &aDrawInfo)
 Function DrawShape basic function to draw a pad. More...
 
void BuildPadPolygon (wxPoint aCoord[4], wxSize aInflateValue, double aRotation) const
 Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Corner list of the polygonal shape, depending on shape, extra size (clearance ...) and orientation. More...
 
int GetRoundRectCornerRadius () const
 Function GetRoundRectCornerRadius Has meaning only for rounded rect pads. More...
 
int GetRoundRectCornerRadius (const wxSize &aSize) const
 Helper function GetRoundRectCornerRadius Has meaning only for rounded rect pads Returns the radius of the rounded corners of a rectangle size aSize, using others setting of the pad. More...
 
void BuildPadShapePolygon (SHAPE_POLY_SET &aCornerBuffer, wxSize aInflateValue, int aSegmentsPerCircle, double aCorrectionFactor) const
 Function BuildPadShapePolygon Build the Corner list of the polygonal shape, depending on shape, extra size (clearance ...) pad and orientation This function is similar to TransformShapeWithClearanceToPolygon, but the difference is BuildPadShapePolygon creates a polygon shape exactly similar to pad shape, which a size inflated by aInflateValue and TransformShapeWithClearanceToPolygon creates a more complex shape (for instance a rectangular pad is converted in a rectangulr shape with ronded corners) More...
 
bool BuildPadDrillShapePolygon (SHAPE_POLY_SET &aCornerBuffer, int aInflateValue, int aSegmentsPerCircle) const
 Function BuildPadDrillShapePolygon Build the Corner list of the polygonal drill shape, depending on shape pad hole and orientation. More...
 
int BuildSegmentFromOvalShape (wxPoint &aSegStart, wxPoint &aSegEnd, double aRotation, const wxSize &aMargin) const
 Function BuildSegmentFromOvalShape Has meaning only for OVAL (and ROUND) pads Build an equivalent segment having the same shape as the OVAL shape, Useful in draw function and in DRC and HitTest functions, because segments are already well handled by track tests. More...
 
int GetBoundingRadius () const
 Function GetBoundingRadius returns the radius of a minimum sized circle which fully encloses this pad. More...
 
wxPoint ShapePos () const
 
double GetRoundRectRadiusRatio () const
 has meaning only for rounded rect pads More...
 
void SetRoundRectRadiusRatio (double aRadiusScale)
 has meaning only for rounded rect pads Set the scaling factor between the smaller Y or Y size and the radius of the rounded corners. More...
 
int GetSubRatsnest () const
 Function GetSubRatsnest. More...
 
void SetSubRatsnest (int aSubRatsnest)
 
void GetMsgPanelInfo (std::vector< MSG_PANEL_ITEM > &aList) override
 Function GetMsgPanelInfo populates aList of MSG_PANEL_ITEM objects with it's internal state for display purposes. More...
 
bool IsOnLayer (PCB_LAYER_ID aLayer) const override
 Function IsOnLayer tests to see if this object is on the given layer. More...
 
bool HitTest (const wxPoint &aPosition) const override
 Function HitTest tests if aPosition is contained within or on the bounding area of an item. More...
 
bool HitTest (const EDA_RECT &aRect, bool aContained, int aAccuracy=0) const override
 Function HitTest tests if the aRect intersects or contains this object (depending on aContained). More...
 
wxString GetClass () const override
 Function GetClass returns the class name. More...
 
const EDA_RECT GetBoundingBox () const override
 Function GetBoundingBox returns the orthogonal, bounding box of this object for display purposes. More...
 
void SetDrawCoord ()
 

Set absolute coordinates.

More...
 
void SetLocalCoord ()
 

Set relative coordinates.

More...
 
void Move (const wxPoint &aMoveVector) override
 Function Move move this object. More...
 
void Rotate (const wxPoint &aRotCentre, double aAngle) override
 Function Rotate Rotate this object. More...
 
wxString GetSelectMenuText () const override
 Function GetSelectMenuText returns the text to display to be used in the selection clarification context menu when multiple items are found at the current cursor position. More...
 
BITMAP_DEF GetMenuImage () const override
 Function GetMenuImage returns a pointer to an image to be used in menus. More...
 
wxString ShowPadShape () const
 Function ShowPadShape. More...
 
wxString ShowPadAttr () const
 Function ShowPadAttr. More...
 
void AppendConfigs (PARAM_CFG_ARRAY *aResult)
 Function AppendConfigs appends to aResult the configuration setting accessors which will later allow reading or writing of configuration file information directly into this object. More...
 
EDA_ITEMClone () const override
 Function Clone creates a duplicate of this item with linked list members set to NULL. More...
 
D_PADDuplicate () const
 same as Clone, but returns a D_PAD item. More...
 
virtual void ViewGetLayers (int aLayers[], int &aCount) const override
 Function ViewGetLayers() Returns the all the layers within the VIEW the object is painted on. More...
 
virtual unsigned int ViewGetLOD (int aLayer, KIGFX::VIEW *aView) const override
 Function ViewGetLOD() Returns the level of detail of the item. More...
 
virtual const BOX2I ViewBBox () const override
 Function ViewBBox() returns the bounding box of the item covering all its layers. More...
 
void CopyNetlistSettings (D_PAD *aPad, bool aCopyLocalSettings)
 Function CopyNetlistSettings copies the netlist settings to aPad, and the net name. More...
 
bool IsConnected () const override
 > More...
 
NETINFO_ITEMGetNet () const
 Function GetNet Returns NET_INFO object for a given item. More...
 
void SetNet (NETINFO_ITEM *aNetInfo)
 Function SetNet Sets a NET_INFO object for the item. More...
 
int GetNetCode () const
 Function GetNetCode. More...
 
bool SetNetCode (int aNetCode, bool aNoAssert=false)
 Function SetNetCode sets net using a net code. More...
 
const wxString & GetNetname () const
 Function GetNetname. More...
 
const wxString & GetShortNetname () const
 Function GetShortNetname. More...
 
std::shared_ptr< NETCLASSGetNetClass () const
 Function GetNetClass returns the NETCLASS for this item. More...
 
wxString GetNetClassName () const
 Function GetNetClassName returns a pointer to the netclass of the zone. More...
 
void SetLocalRatsnestVisible (bool aVisible)
 
bool GetLocalRatsnestVisible () const
 
virtual const wxPoint GetCenter () const
 Function GetCenter() More...
 
BOARD_ITEMBack () const
 
PCB_LAYER_ID GetLayer () const
 Function GetLayer returns the primary layer this item is on. More...
 
virtual void SetLayer (PCB_LAYER_ID aLayer)
 Function SetLayer sets the layer this item is on. More...
 
void SwapData (BOARD_ITEM *aImage)
 Swap data between aItem and aImage. More...
 
bool IsTrack () const
 Function IsTrack tests to see if this object is a track or via (or microvia). More...
 
virtual bool IsLocked () const
 Function IsLocked. More...
 
virtual void SetLocked (bool aLocked)
 Function SetLocked modifies 'lock' status for of the item. More...
 
virtual void UnLink ()
 Function UnLink detaches this object from its owner. More...
 
void DeleteStructure ()
 Function DeleteStructure deletes this object after UnLink()ing it from its owner if it has one. More...
 
virtual BOARDGetBoard () const
 Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none. More...
 
wxString GetLayerName () const
 Function GetLayerName returns the name of the PCB layer on which the item resides. More...
 
KICAD_T Type () const
 Function Type() More...
 
void SetTimeStamp (time_t aNewTimeStamp)
 
time_t GetTimeStamp () const
 
DHEADGetList () const
 
void SetParent (EDA_ITEM *aParent)
 
void SetList (DHEAD *aList)
 
bool IsNew () const
 
bool IsModified () const
 
bool IsMoving () const
 
bool IsDragging () const
 
bool IsWireImage () const
 
bool IsSelected () const
 
bool IsResized () const
 
bool IsHighlighted () const
 
bool IsBrightened () const
 
void SetWireImage ()
 
void SetSelected ()
 
void SetHighlighted ()
 
void SetBrightened ()
 
void ClearSelected ()
 
void ClearHighlighted ()
 
void ClearBrightened ()
 
void SetModified ()
 
int GetState (int type) const
 
void SetState (int type, int state)
 
STATUS_FLAGS GetStatus () const
 
void SetStatus (STATUS_FLAGS aStatus)
 
void SetFlags (STATUS_FLAGS aMask)
 
void ClearFlags (STATUS_FLAGS aMask=EDA_ITEM_ALL_FLAGS)
 
STATUS_FLAGS GetFlags () const
 
void SetForceVisible (bool aEnable)
 Function SetForceVisible is used to set and cleag force visible flag used to force the item to be drawn even if it's draw attribute is set to not visible. More...
 
virtual SEARCH_RESULT Visit (INSPECTOR inspector, void *testData, const KICAD_T scanTypes[])
 Function Visit may be re-implemented for each derived class in order to handle all the types given by its member data. More...
 
virtual bool Matches (wxFindReplaceData &aSearchData, void *aAuxData, wxPoint *aFindLocation)
 Function Matches compares the item against the search criteria in aSearchData. More...
 
bool Replace (wxFindReplaceData &aSearchData, wxString &aText)
 Helper function used in search and replace dialog Function Replace performs a text replace on aText using the find and replace criteria in aSearchData on items that support text find and replace. More...
 
virtual bool Replace (wxFindReplaceData &aSearchData, void *aAuxData=NULL)
 Function Replace performs a text replace using the find and replace criteria in aSearchData on items that support text find and replace. More...
 
virtual bool IsReplaceable () const
 Function IsReplaceable. More...
 
bool operator< (const EDA_ITEM &aItem) const
 Test if another item is less than this object. More...
 
virtual void ViewDraw (int aLayer, VIEW *aView) const
 Function ViewDraw() Draws the parts of the object belonging to layer aLayer. More...
 
VIEW_ITEM_DATA * viewPrivData () const
 

Static Public Member Functions

static LSET StandardMask ()
 layer set for a through hole pad More...
 
static LSET SMDMask ()
 layer set for a SMD pad on Front layer More...
 
static LSET ConnSMDMask ()
 layer set for a SMD pad on Front layer used for edge board connectors More...
 
static LSET UnplatedHoleMask ()
 layer set for a mechanical unplated through hole pad More...
 
static bool ClassOf (const EDA_ITEM *aItem)
 
static int Compare (const D_PAD *padref, const D_PAD *padcmp)
 Function Compare compares two pads and return 0 if they are equal. More...
 
static wxString ShowShape (STROKE_T aShape)
 Function ShowShape converts the enum STROKE_T integer value to a wxString. More...
 
static std::string FormatInternalUnits (int aValue)
 Function FormatInternalUnits converts aValue from board internal units to a string appropriate for writing to file. More...
 
static std::string FormatInternalUnits (const wxPoint &aPoint)
 
static std::string FormatInternalUnits (const wxSize &aSize)
 
static std::string FormatAngle (double aAngle)
 Function FormatAngle converts aAngle from board units to a string appropriate for writing to file. More...
 
static SEARCH_RESULT IterateForward (EDA_ITEM *listStart, INSPECTOR inspector, void *testData, const KICAD_T scanTypes[])
 Function IterateForward walks through the object tree calling the inspector() on each object type requested in scanTypes. More...
 
static bool Sort (const EDA_ITEM *aLeft, const EDA_ITEM *aRight)
 Function Sort is a helper function to be used by the C++ STL sort algorithm for sorting a STL container of EDA_ITEM pointers. More...
 

Static Public Attributes

static int m_PadSketchModePenSize = 0
 Pen size used to draw pads in sketch mode (mode used to print pads on silkscreen layer) More...
 
static wxPoint ZeroOffset
 A value of wxPoint(0,0) which can be passed to the Draw() functions. More...
 

Protected Member Functions

bool Matches (const wxString &aText, wxFindReplaceData &aSearchData)
 Function Matches compares aText against search criteria in aSearchData. More...
 

Static Protected Member Functions

static int getTrailingInt (wxString aStr)
 
static int getNextNumberInSequence (const std::set< int > &aSeq, bool aFillSequenceGaps)
 

Protected Attributes

NETINFO_ITEMm_netinfo
 Stores all informations about the net that item belongs to. More...
 
PCB_LAYER_ID m_Layer
 
EDA_ITEMPnext
 next in linked list More...
 
EDA_ITEMPback
 previous in linked list More...
 
DHEADm_List
 which DLIST I am on. More...
 
EDA_ITEMm_Parent
 Linked list: Link (parent struct) More...
 
time_t m_TimeStamp
 Time stamp used for logical links. More...
 
bool m_forceVisible
 Set to true to override the visibility setting of the item. More...
 
STATUS_FLAGS m_Flags
 Flag bits for editing and other uses. More...
 

Private Member Functions

int boundingRadius () const
 Function boundingRadius returns a calculated radius of a bounding circle for this pad. More...
 

Private Attributes

int m_boundingRadius
 radius of the circle containing the pad shape More...
 
wxString m_name
 
wxPoint m_Pos
 pad Position on board More...
 
PAD_SHAPE_T m_padShape
 Shape: PAD_SHAPE_CIRCLE, PAD_SHAPE_RECT, PAD_SHAPE_OVAL, PAD_SHAPE_TRAPEZOID, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_POLYGON. More...
 
std::vector< PAD_CS_PRIMITIVEm_basicShapes
 for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to m_Pos They are expected to define only one copper area. More...
 
SHAPE_POLY_SET m_customShapeAsPolygon
 for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos More...
 
CUST_PAD_SHAPE_IN_ZONE m_customShapeClearanceArea
 How to build the custom shape in zone, to create the clearance area: CUST_PAD_SHAPE_IN_ZONE_OUTLINE = use pad shape CUST_PAD_SHAPE_IN_ZONE_CONVEXHULL = use the convex hull of the pad shape other values are currently reserved. More...
 
int m_SubRatsnest
 variable used in rats nest computations handle subnet (block) number in ratsnest connection More...
 
wxSize m_Drill
 Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE, drill diam = m_Drill.x. More...
 
wxSize m_Size
 X and Y size ( relative to orient 0) More...
 
PAD_DRILL_SHAPE_T m_drillShape
 PAD_DRILL_SHAPE_CIRCLE, PAD_DRILL_SHAPE_OBLONG. More...
 
double m_padRoundRectRadiusScale
 scaling factor from smallest m_Size coord to corner radius, default 0.25 More...
 
PAD_SHAPE_T m_anchorPadShape
 for custom shaped pads: shape of pad anchor, PAD_SHAPE_RECT, PAD_SHAPE_CIRCLE More...
 
wxPoint m_Offset
 m_Offset is useful only for oblong and rect pads (it can be used for other shapes, but without any interest). More...
 
LSET m_layerMask
 Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 . More...
 
wxSize m_DeltaSize
 delta on rectangular shapes More...
 
wxPoint m_Pos0
 Initial Pad position (i.e. More...
 
PAD_ATTR_T m_Attribute
 PAD_ATTRIB_NORMAL, PAD_ATTRIB_SMD, PAD_ATTRIB_CONN, PAD_ATTRIB_HOLE_NOT_PLATED. More...
 
double m_Orient
 in 1/10 degrees More...
 
int m_LengthPadToDie
 Length net from pad to die, inside the package. More...
 
int m_LocalClearance
 Local clearance. More...
 
int m_LocalSolderMaskMargin
 Local mask margins: when 0, the parent footprint design values are used. More...
 
int m_LocalSolderPasteMargin
 Local solder paste margin absolute value. More...
 
double m_LocalSolderPasteMarginRatio
 Local solder mask margin ratio value of pad size The final margin is the sum of these 2 values. More...
 
ZoneConnection m_ZoneConnection
 how the connection to zone is made: no connection, thermal relief ... More...
 
int m_ThermalWidth
 
int m_ThermalGap
 

Detailed Description

Definition at line 119 of file class_pad.h.

Constructor & Destructor Documentation

D_PAD::D_PAD ( MODULE parent)

Definition at line 59 of file class_pad.cpp.

References CUST_PAD_SHAPE_IN_ZONE_OUTLINE, GetParent(), MODULE::GetPosition(), m_Attribute, m_boundingRadius, m_customShapeClearanceArea, m_Drill, m_layerMask, m_LengthPadToDie, m_LocalClearance, m_LocalSolderMaskMargin, m_LocalSolderPasteMargin, m_LocalSolderPasteMarginRatio, m_Orient, m_padRoundRectRadiusScale, EDA_ITEM::m_Parent, m_Pos, m_Size, m_ThermalGap, m_ThermalWidth, m_ZoneConnection, PAD_ATTRIB_STANDARD, PAD_DRILL_SHAPE_CIRCLE, PAD_SHAPE_CIRCLE, PAD_ZONE_CONN_INHERITED, PCB_MODULE_T, SetAnchorPadShape(), SetDrillShape(), SetShape(), SetSubRatsnest(), StandardMask(), and EDA_ITEM::Type().

Referenced by Clone().

59  :
61 {
62  m_Size.x = m_Size.y = Mils2iu( 60 ); // Default pad size 60 mils.
63  m_Drill.x = m_Drill.y = Mils2iu( 30 ); // Default drill size 30 mils.
64  m_Orient = 0; // Pad rotation in 1/10 degrees.
65  m_LengthPadToDie = 0;
66 
67  if( m_Parent && m_Parent->Type() == PCB_MODULE_T )
68  {
70  }
71 
72  SetShape( PAD_SHAPE_CIRCLE ); // Default pad shape is PAD_CIRCLE.
73  SetAnchorPadShape( PAD_SHAPE_CIRCLE ); // Default shape for custom shaped pads
74  // is PAD_CIRCLE.
75  SetDrillShape( PAD_DRILL_SHAPE_CIRCLE ); // Default pad drill shape is a circle.
76  m_Attribute = PAD_ATTRIB_STANDARD; // Default pad type is NORMAL (thru hole)
77  m_LocalClearance = 0;
81  // Parameters for round rect only:
82  m_padRoundRectRadiusScale = 0.25; // from IPC-7351C standard
83 
84  m_ZoneConnection = PAD_ZONE_CONN_INHERITED; // Use parent setting by default
85  m_ThermalWidth = 0; // Use parent setting by default
86  m_ThermalGap = 0; // Use parent setting by default
87 
89 
90  // Set layers mask to default for a standard thru hole pad.
92 
93  SetSubRatsnest( 0 ); // used in ratsnest calculations
94 
95  m_boundingRadius = -1;
96 }
int m_LocalClearance
Local clearance.
Definition: class_pad.h:811
int m_ThermalGap
Definition: class_pad.h:824
int m_LocalSolderMaskMargin
Local mask margins: when 0, the parent footprint design values are used.
Definition: class_pad.h:815
KICAD_T Type() const
Function Type()
Definition: base_struct.h:212
double m_padRoundRectRadiusScale
scaling factor from smallest m_Size coord to corner radius, default 0.25
Definition: class_pad.h:771
int m_boundingRadius
radius of the circle containing the pad shape
Definition: class_pad.h:731
EDA_ITEM * m_Parent
Linked list: Link (parent struct)
Definition: base_struct.h:182
static LSET StandardMask()
layer set for a through hole pad
Definition: class_pad.cpp:99
int m_LocalSolderPasteMargin
Local solder paste margin absolute value.
Definition: class_pad.h:816
const wxPoint & GetPosition() const override
Definition: class_module.h:155
BOARD_CONNECTED_ITEM(BOARD_ITEM *aParent, KICAD_T idtype)
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
MODULE * GetParent() const
Definition: class_pad.h:147
class D_PAD, a pad in a footprint
Definition: typeinfo.h:102
void SetSubRatsnest(int aSubRatsnest)
Definition: class_pad.h:615
class MODULE, a footprint
Definition: typeinfo.h:101
void SetAnchorPadShape(PAD_SHAPE_T aShape)
Function SetAnchorPadShape Set the shape of the anchor pad for custm shped pads.
Definition: class_pad.h:238
CUST_PAD_SHAPE_IN_ZONE m_customShapeClearanceArea
How to build the custom shape in zone, to create the clearance area: CUST_PAD_SHAPE_IN_ZONE_OUTLINE =...
Definition: class_pad.h:758
int m_ThermalWidth
Definition: class_pad.h:823
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
void SetDrillShape(PAD_DRILL_SHAPE_T aDrillShape)
Definition: class_pad.h:361
int m_LengthPadToDie
Length net from pad to die, inside the package.
Definition: class_pad.h:806
Usual pad.
Definition: pad_shapes.h:60
void SetShape(PAD_SHAPE_T aShape)
Definition: class_pad.h:202
PAD_ATTR_T m_Attribute
PAD_ATTRIB_NORMAL, PAD_ATTRIB_SMD, PAD_ATTRIB_CONN, PAD_ATTRIB_HOLE_NOT_PLATED.
Definition: class_pad.h:802
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
double m_LocalSolderPasteMarginRatio
Local solder mask margin ratio value of pad size The final margin is the sum of these 2 values...
Definition: class_pad.h:818
ZoneConnection m_ZoneConnection
how the connection to zone is made: no connection, thermal relief ...
Definition: class_pad.h:821
wxPoint m_Pos
pad Position on board
Definition: class_pad.h:735

Member Function Documentation

void D_PAD::AddPrimitive ( std::vector< wxPoint > &  aPoly,
int  aThickness 
)

Has meaning only for free shape pads.

add a free shape to the shape list. the shape can be a polygon (outline can have a thickness) a thick segment a filled circle or ring ( if thickness == 0, this is a filled circle, else a ring) a arcadd a polygonal basic shape

Definition at line 69 of file class_pad_custom_shape_functions.cpp.

References m_basicShapes, PAD_CS_PRIMITIVE::m_Poly, PAD_CS_PRIMITIVE::m_Thickness, MergePrimitivesAsPolygon(), and S_POLYGON.

Referenced by PCB_EDIT_FRAME::Create_MuWaveComponent().

70 {
71  PAD_CS_PRIMITIVE shape( S_POLYGON );
72  shape.m_Poly = aPoly;
73  shape.m_Thickness = aThickness;
74  m_basicShapes.push_back( shape );
75 
77 }
bool MergePrimitivesAsPolygon(SHAPE_POLY_SET *aMergedPolygon=NULL, int aCircleToSegmentsCount=32)
Merge all basic shapes, converted to a polygon in one polygon, in m_customShapeAsPolygon.
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
polygon (not yet used for tracks, but could be in microwave apps)
Helper class to handle a primitive (basic shape: polygon, segment, circle or arc) to build a custom p...
Definition: class_pad.h:89
void D_PAD::AddPrimitive ( wxPoint  aStart,
wxPoint  aEnd,
int  aThickness 
)

segment basic shape

Definition at line 80 of file class_pad_custom_shape_functions.cpp.

References m_basicShapes, PAD_CS_PRIMITIVE::m_End, PAD_CS_PRIMITIVE::m_Start, PAD_CS_PRIMITIVE::m_Thickness, MergePrimitivesAsPolygon(), and S_SEGMENT.

81 {
82  PAD_CS_PRIMITIVE shape( S_SEGMENT );
83  shape.m_Start = aStart;
84  shape.m_End = aEnd;
85  shape.m_Thickness = aThickness;
86  m_basicShapes.push_back( shape );
87 
89 }
bool MergePrimitivesAsPolygon(SHAPE_POLY_SET *aMergedPolygon=NULL, int aCircleToSegmentsCount=32)
Merge all basic shapes, converted to a polygon in one polygon, in m_customShapeAsPolygon.
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
usual segment : line with rounded ends
Helper class to handle a primitive (basic shape: polygon, segment, circle or arc) to build a custom p...
Definition: class_pad.h:89
void D_PAD::AddPrimitive ( wxPoint  aCenter,
int  aRadius,
int  aThickness 
)

ring or circle basic shape

Definition at line 105 of file class_pad_custom_shape_functions.cpp.

References m_basicShapes, PAD_CS_PRIMITIVE::m_Radius, PAD_CS_PRIMITIVE::m_Start, PAD_CS_PRIMITIVE::m_Thickness, MergePrimitivesAsPolygon(), and S_CIRCLE.

106 {
107  PAD_CS_PRIMITIVE shape( S_CIRCLE );
108  shape.m_Start = aCenter;
109  shape.m_Radius = aRadius;
110  shape.m_Thickness = aThickness;
111  m_basicShapes.push_back( shape );
112 
114 }
bool MergePrimitivesAsPolygon(SHAPE_POLY_SET *aMergedPolygon=NULL, int aCircleToSegmentsCount=32)
Merge all basic shapes, converted to a polygon in one polygon, in m_customShapeAsPolygon.
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
Helper class to handle a primitive (basic shape: polygon, segment, circle or arc) to build a custom p...
Definition: class_pad.h:89
void D_PAD::AddPrimitive ( wxPoint  aCenter,
wxPoint  aStart,
int  aArcAngle,
int  aThickness 
)

arc basic shape

Definition at line 92 of file class_pad_custom_shape_functions.cpp.

References PAD_CS_PRIMITIVE::m_ArcAngle, m_basicShapes, PAD_CS_PRIMITIVE::m_End, PAD_CS_PRIMITIVE::m_Start, PAD_CS_PRIMITIVE::m_Thickness, MergePrimitivesAsPolygon(), and S_ARC.

93 {
94  PAD_CS_PRIMITIVE shape( S_ARC );
95  shape.m_Start = aCenter;
96  shape.m_End = aStart;
97  shape.m_ArcAngle = aArcAngle;
98  shape.m_Thickness = aThickness;
99  m_basicShapes.push_back( shape );
100 
102 }
bool MergePrimitivesAsPolygon(SHAPE_POLY_SET *aMergedPolygon=NULL, int aCircleToSegmentsCount=32)
Merge all basic shapes, converted to a polygon in one polygon, in m_customShapeAsPolygon.
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
Arcs (with rounded ends)
Helper class to handle a primitive (basic shape: polygon, segment, circle or arc) to build a custom p...
Definition: class_pad.h:89
void D_PAD::AppendConfigs ( PARAM_CFG_ARRAY aResult)

Function AppendConfigs appends to aResult the configuration setting accessors which will later allow reading or writing of configuration file information directly into this object.

Definition at line 468 of file class_pad.cpp.

References m_Drill, and m_Size.

Referenced by BOARD_DESIGN_SETTINGS::AppendConfigs().

469 {
470  // Parameters stored in config are only significant parameters
471  // for a template.
472  // So not all parameters are stored, just few.
473  aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadDrill" ),
474  &m_Drill.x,
475  Millimeter2iu( 0.6 ),
476  Millimeter2iu( 0.1 ), Millimeter2iu( 10.0 ),
477  NULL, MM_PER_IU ) );
478 
479  aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadDrillOvalY" ),
480  &m_Drill.y,
481  Millimeter2iu( 0.6 ),
482  Millimeter2iu( 0.1 ), Millimeter2iu( 10.0 ),
483  NULL, MM_PER_IU ) );
484 
485  aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadSizeH" ),
486  &m_Size.x,
487  Millimeter2iu( 1.4 ),
488  Millimeter2iu( 0.1 ), Millimeter2iu( 20.0 ),
489  NULL, MM_PER_IU ) );
490 
491  aResult->push_back( new PARAM_CFG_INT_WITH_SCALE( wxT( "PadSizeV" ),
492  &m_Size.y,
493  Millimeter2iu( 1.4 ),
494  Millimeter2iu( 0.1 ), Millimeter2iu( 20.0 ),
495  NULL, MM_PER_IU ) );
496 }
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
Configuration parameter - Integer Class with unit conversion.
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
BOARD_ITEM* BOARD_ITEM::Back ( ) const
inlineinherited

Definition at line 125 of file class_board_item.h.

References EDA_ITEM::Pback.

Referenced by PCB_EDIT_FRAME::Delete_Segment_Edge().

125 { return static_cast<BOARD_ITEM*>( Pback ); }
EDA_ITEM * Pback
previous in linked list
Definition: base_struct.h:179
Class BOARD_ITEM is a base class for any item which can be embedded within the BOARD container class...
int D_PAD::boundingRadius ( ) const
private

Function boundingRadius returns a calculated radius of a bounding circle for this pad.

Definition at line 133 of file class_pad.cpp.

References abs, SHAPE_POLY_SET::COutline(), SHAPE_LINE_CHAIN::CPoint(), dist, EuclideanNorm(), VECTOR2< T >::EuclideanNorm(), GetRoundRectCornerRadius(), GetShape(), KiROUND(), m_customShapeAsPolygon, m_DeltaSize, m_Size, max, SHAPE_POLY_SET::OutlineCount(), PAD_SHAPE_CIRCLE, PAD_SHAPE_CUSTOM, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, and SHAPE_LINE_CHAIN::PointCount().

Referenced by GetBoundingRadius().

134 {
135  int x, y;
136  int radius;
137 
138  switch( GetShape() )
139  {
140  case PAD_SHAPE_CIRCLE:
141  radius = m_Size.x / 2;
142  break;
143 
144  case PAD_SHAPE_OVAL:
145  radius = std::max( m_Size.x, m_Size.y ) / 2;
146  break;
147 
148  case PAD_SHAPE_RECT:
149  radius = 1 + KiROUND( EuclideanNorm( m_Size ) / 2 );
150  break;
151 
152  case PAD_SHAPE_TRAPEZOID:
153  x = m_Size.x + std::abs( m_DeltaSize.y ); // Remember: m_DeltaSize.y is the m_Size.x change
154  y = m_Size.y + std::abs( m_DeltaSize.x ); // Remember: m_DeltaSize.x is the m_Size.y change
155  radius = 1 + KiROUND( hypot( x, y ) / 2 );
156  break;
157 
158  case PAD_SHAPE_ROUNDRECT:
159  radius = GetRoundRectCornerRadius();
160  x = m_Size.x >> 1;
161  y = m_Size.y >> 1;
162  radius += 1 + KiROUND( EuclideanNorm( wxSize( x - radius, y - radius )));
163  break;
164 
165  case PAD_SHAPE_CUSTOM:
166  radius = 0;
167 
168  for( int cnt = 0; cnt < m_customShapeAsPolygon.OutlineCount(); ++cnt )
169  {
170  const SHAPE_LINE_CHAIN& poly = m_customShapeAsPolygon.COutline( cnt );
171  for( int ii = 0; ii < poly.PointCount(); ++ii )
172  {
173  int dist = KiROUND( poly.CPoint( ii ).EuclideanNorm() );
174  radius = std::max( radius, dist );
175  }
176  }
177 
178  radius += 1;
179  break;
180 
181  default:
182  radius = 0;
183  }
184 
185  return radius;
186 }
double EuclideanNorm(const wxPoint &vector)
Euclidean norm of a 2D vector.
Definition: trigo.h:104
static int KiROUND(double v)
KiROUND rounds a floating point number to an int using "round halfway cases away from zero"...
Definition: common.h:107
int PointCount() const
Function PointCount()
int GetRoundRectCornerRadius() const
Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.
Definition: class_pad.h:493
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
static const int dist[10][10]
Definition: dist.cpp:57
int OutlineCount() const
Returns the number of outlines in the set
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
#define abs(a)
Definition: auxiliary.h:84
T EuclideanNorm() const
Destructor.
Definition: vector2d.h:295
const SHAPE_LINE_CHAIN & COutline(int aIndex) const
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
wxSize m_DeltaSize
delta on rectangular shapes
Definition: class_pad.h:797
#define max(a, b)
Definition: auxiliary.h:86
Class SHAPE_LINE_CHAIN.
const VECTOR2I & CPoint(int aIndex) const
Function CPoint()
bool D_PAD::BuildPadDrillShapePolygon ( SHAPE_POLY_SET aCornerBuffer,
int  aInflateValue,
int  aSegmentsPerCircle 
) const

Function BuildPadDrillShapePolygon Build the Corner list of the polygonal drill shape, depending on shape pad hole and orientation.

Parameters
aCornerBuffer= a buffer to fill.
aInflateValue= the clearance or margin value. value > 0: inflate, < 0 deflate, = 0 : no change
aSegmentsPerCircle= number of segments to approximate a circle (used for round and oblong shapes only(16 to 32 is a good value)
Returns
false if the pad has no hole, true otherwise

Definition at line 771 of file board_items_to_polygon_shape_transform.cpp.

References GetDrillSize(), GetOblongDrillGeometry(), GetPosition(), TransformCircleToPolygon(), and TransformRoundedEndsSegmentToPolygon().

Referenced by CINFO3D_VISU::createLayers().

773 {
774  wxSize drillsize = GetDrillSize();
775 
776  if( !drillsize.x || !drillsize.y )
777  return false;
778 
779  if( drillsize.x == drillsize.y ) // usual round hole
780  {
781  TransformCircleToPolygon( aCornerBuffer, GetPosition(),
782  (drillsize.x / 2) + aInflateValue, aSegmentsPerCircle );
783  }
784  else // Oblong hole
785  {
786  wxPoint start, end;
787  int width;
788 
789  GetOblongDrillGeometry( start, end, width );
790 
791  width += aInflateValue * 2;
792 
794  GetPosition() + start, GetPosition() + end, aSegmentsPerCircle, width );
795  }
796 
797  return true;
798 }
void TransformRoundedEndsSegmentToPolygon(SHAPE_POLY_SET &aCornerBuffer, wxPoint aStart, wxPoint aEnd, int aCircleToSegmentsCount, int aWidth)
Function TransformRoundedEndsSegmentToPolygon convert a segment with rounded ends to a polygon Conver...
void TransformCircleToPolygon(SHAPE_POLY_SET &aCornerBuffer, wxPoint aCenter, int aRadius, int aCircleToSegmentsCount)
Function TransformCircleToPolygon convert a circle to a polygon, using multiple straight lines...
const wxSize & GetDrillSize() const
Definition: class_pad.h:260
const wxPoint & GetPosition() const override
Definition: class_pad.h:205
void GetOblongDrillGeometry(wxPoint &aStartPoint, wxPoint &aEndPoint, int &aWidth) const
Function GetOblongDrillGeometry calculates the start point, end point and width of an equivalent segm...
Definition: class_pad.cpp:749
void D_PAD::BuildPadPolygon ( wxPoint  aCoord[4],
wxSize  aInflateValue,
double  aRotation 
) const

Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Corner list of the polygonal shape, depending on shape, extra size (clearance ...) and orientation.

Parameters
aCoord= a buffer to fill (4 corners).
aInflateValue= wxSize: the clearance or margin value. value > 0: inflate, < 0 deflate
aRotation= full rotation of the polygon

Definition at line 764 of file class_pad_draw_functions.cpp.

References PNS::angle(), delta, GetShape(), KiROUND(), m_DeltaSize, m_Size, PAD_SHAPE_RECT, PAD_SHAPE_TRAPEZOID, RotatePoint(), wxPoint::x, and wxPoint::y.

Referenced by CINFO3D_VISU::buildPadShapePolygon(), BuildPadShapePolygon(), DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), CINFO3D_VISU::createNewPad(), CINFO3D_VISU::createNewPadWithClearance(), KIGFX::PCB_PAINTER::draw(), DrawShape(), HitTest(), BRDITEMS_PLOTTER::PlotPad(), PNS_KICAD_IFACE::syncPad(), and TransformShapeWithClearanceToPolygon().

766 {
767  wxSize delta;
768  wxSize halfsize;
769 
770  halfsize.x = m_Size.x >> 1;
771  halfsize.y = m_Size.y >> 1;
772 
773  switch( GetShape() )
774  {
775  case PAD_SHAPE_RECT:
776  // For rectangular shapes, inflate is easy
777  halfsize += aInflateValue;
778 
779  // Verify if do not deflate more than than size
780  // Only possible for inflate negative values.
781  if( halfsize.x < 0 )
782  halfsize.x = 0;
783 
784  if( halfsize.y < 0 )
785  halfsize.y = 0;
786  break;
787 
788  case PAD_SHAPE_TRAPEZOID:
789  // Trapezoidal pad: verify delta values
790  delta.x = ( m_DeltaSize.x >> 1 );
791  delta.y = ( m_DeltaSize.y >> 1 );
792 
793  // be sure delta values are not to large
794  if( (delta.x < 0) && (delta.x <= -halfsize.y) )
795  delta.x = -halfsize.y + 1;
796 
797  if( (delta.x > 0) && (delta.x >= halfsize.y) )
798  delta.x = halfsize.y - 1;
799 
800  if( (delta.y < 0) && (delta.y <= -halfsize.x) )
801  delta.y = -halfsize.x + 1;
802 
803  if( (delta.y > 0) && (delta.y >= halfsize.x) )
804  delta.y = halfsize.x - 1;
805  break;
806 
807  default: // is used only for rect and trap. pads
808  return;
809  }
810 
811  // Build the basic rectangular or trapezoid shape
812  // delta is null for rectangular shapes
813  aCoord[0].x = -halfsize.x - delta.y; // lower left
814  aCoord[0].y = +halfsize.y + delta.x;
815 
816  aCoord[1].x = -halfsize.x + delta.y; // upper left
817  aCoord[1].y = -halfsize.y - delta.x;
818 
819  aCoord[2].x = +halfsize.x - delta.y; // upper right
820  aCoord[2].y = -halfsize.y + delta.x;
821 
822  aCoord[3].x = +halfsize.x + delta.y; // lower right
823  aCoord[3].y = +halfsize.y - delta.x;
824 
825  // Offsetting the trapezoid shape id needed
826  // It is assumed delta.x or/and delta.y == 0
827  if( GetShape() == PAD_SHAPE_TRAPEZOID && (aInflateValue.x != 0 || aInflateValue.y != 0) )
828  {
829  double angle;
830  wxSize corr;
831 
832  if( delta.y ) // lower and upper segment is horizontal
833  {
834  // Calculate angle of left (or right) segment with vertical axis
835  angle = atan2( (double) m_DeltaSize.y, (double) m_Size.y );
836 
837  // left and right sides are moved by aInflateValue.x in their perpendicular direction
838  // We must calculate the corresponding displacement on the horizontal axis
839  // that is delta.x +- corr.x depending on the corner
840  corr.x = KiROUND( tan( angle ) * aInflateValue.x );
841  delta.x = KiROUND( aInflateValue.x / cos( angle ) );
842 
843  // Horizontal sides are moved up and down by aInflateValue.y
844  delta.y = aInflateValue.y;
845 
846  // corr.y = 0 by the constructor
847  }
848  else if( delta.x ) // left and right segment is vertical
849  {
850  // Calculate angle of lower (or upper) segment with horizontal axis
851  angle = atan2( (double) m_DeltaSize.x, (double) m_Size.x );
852 
853  // lower and upper sides are moved by aInflateValue.x in their perpendicular direction
854  // We must calculate the corresponding displacement on the vertical axis
855  // that is delta.y +- corr.y depending on the corner
856  corr.y = KiROUND( tan( angle ) * aInflateValue.y );
857  delta.y = KiROUND( aInflateValue.y / cos( angle ) );
858 
859  // Vertical sides are moved left and right by aInflateValue.x
860  delta.x = aInflateValue.x;
861 
862  // corr.x = 0 by the constructor
863  }
864  else // the trapezoid is a rectangle
865  {
866  delta = aInflateValue; // this pad is rectangular (delta null).
867  }
868 
869  aCoord[0].x += -delta.x - corr.x; // lower left
870  aCoord[0].y += delta.y + corr.y;
871 
872  aCoord[1].x += -delta.x + corr.x; // upper left
873  aCoord[1].y += -delta.y - corr.y;
874 
875  aCoord[2].x += delta.x - corr.x; // upper right
876  aCoord[2].y += -delta.y + corr.y;
877 
878  aCoord[3].x += delta.x + corr.x; // lower right
879  aCoord[3].y += delta.y - corr.y;
880 
881  /* test coordinates and clamp them if the offset correction is too large:
882  * Note: if a coordinate is bad, the other "symmetric" coordinate is bad
883  * So when a bad coordinate is found, the 2 symmetric coordinates
884  * are set to the minimun value (0)
885  */
886 
887  if( aCoord[0].x > 0 ) // lower left x coordinate must be <= 0
888  aCoord[0].x = aCoord[3].x = 0;
889 
890  if( aCoord[1].x > 0 ) // upper left x coordinate must be <= 0
891  aCoord[1].x = aCoord[2].x = 0;
892 
893  if( aCoord[0].y < 0 ) // lower left y coordinate must be >= 0
894  aCoord[0].y = aCoord[1].y = 0;
895 
896  if( aCoord[3].y < 0 ) // lower right y coordinate must be >= 0
897  aCoord[3].y = aCoord[2].y = 0;
898  }
899 
900  if( aRotation )
901  {
902  for( int ii = 0; ii < 4; ii++ )
903  RotatePoint( &aCoord[ii], aRotation );
904  }
905 }
static int KiROUND(double v)
KiROUND rounds a floating point number to an int using "round halfway cases away from zero"...
Definition: common.h:107
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
static const int delta[8][2]
Definition: solve.cpp:112
wxSize m_DeltaSize
delta on rectangular shapes
Definition: class_pad.h:797
static DIRECTION_45::AngleType angle(const VECTOR2I &a, const VECTOR2I &b)
void D_PAD::BuildPadShapePolygon ( SHAPE_POLY_SET aCornerBuffer,
wxSize  aInflateValue,
int  aSegmentsPerCircle,
double  aCorrectionFactor 
) const

Function BuildPadShapePolygon Build the Corner list of the polygonal shape, depending on shape, extra size (clearance ...) pad and orientation This function is similar to TransformShapeWithClearanceToPolygon, but the difference is BuildPadShapePolygon creates a polygon shape exactly similar to pad shape, which a size inflated by aInflateValue and TransformShapeWithClearanceToPolygon creates a more complex shape (for instance a rectangular pad is converted in a rectangulr shape with ronded corners)

Parameters
aCornerBuffer= a buffer to fill.
aInflateValue= the clearance or margin value. value > 0: inflate, < 0 deflate, = 0 : no change the clearance can have different values for x and y directions (relative to the pad)
aSegmentsPerCircle= number of segments to approximate a circle (used for round and oblong shapes only (16 to 32 is a good value)
aCorrectionFactor= the correction to apply to circles radius to keep the pad size/clearance when the arcs are approximated by segments

Definition at line 733 of file board_items_to_polygon_shape_transform.cpp.

References SHAPE_POLY_SET::Append(), BuildPadPolygon(), GetShape(), m_Orient, SHAPE_POLY_SET::NewOutline(), PAD_SHAPE_CIRCLE, PAD_SHAPE_CUSTOM, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, ShapePos(), and TransformShapeWithClearanceToPolygon().

Referenced by CINFO3D_VISU::buildPadShapeThickOutlineAsSegments(), PNS_KICAD_IFACE::syncPad(), and MODULE::TransformPadsShapesWithClearanceToPolygon().

736 {
737  wxPoint corners[4];
738  wxPoint padShapePos = ShapePos(); /* Note: for pad having a shape offset,
739  * the pad position is NOT the shape position */
740  switch( GetShape() )
741  {
742  case PAD_SHAPE_CIRCLE:
743  case PAD_SHAPE_OVAL:
744  case PAD_SHAPE_ROUNDRECT:
745  case PAD_SHAPE_CUSTOM:
746  TransformShapeWithClearanceToPolygon( aCornerBuffer, aInflateValue.x,
747  aSegmentsPerCircle, aCorrectionFactor );
748  break;
749 
750  case PAD_SHAPE_TRAPEZOID:
751  case PAD_SHAPE_RECT:
752  aCornerBuffer.NewOutline();
753 
754  BuildPadPolygon( corners, aInflateValue, m_Orient );
755  for( int ii = 0; ii < 4; ii++ )
756  {
757  corners[ii] += padShapePos; // Shift origin to position
758  aCornerBuffer.Append( corners[ii].x, corners[ii].y );
759  }
760 
761  break;
762  }
763 }
void BuildPadPolygon(wxPoint aCoord[4], wxSize aInflateValue, double aRotation) const
Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Co...
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
void TransformShapeWithClearanceToPolygon(SHAPE_POLY_SET &aCornerBuffer, int aClearanceValue, int aCircleToSegmentsCount, double aCorrectionFactor) const
Function TransformShapeWithClearanceToPolygon Convert the pad shape to a closed polygon Used in filli...
int NewOutline()
Creates a new empty polygon in the set and returns its index
wxPoint ShapePos() const
Definition: class_pad.cpp:500
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
int Append(int x, int y, int aOutline=-1, int aHole=-1, bool aAllowDuplication=false)
Appends a vertex at the end of the given outline/hole (default: the last outline) ...
int D_PAD::BuildSegmentFromOvalShape ( wxPoint aSegStart,
wxPoint aSegEnd,
double  aRotation,
const wxSize &  aMargin 
) const

Function BuildSegmentFromOvalShape Has meaning only for OVAL (and ROUND) pads Build an equivalent segment having the same shape as the OVAL shape, Useful in draw function and in DRC and HitTest functions, because segments are already well handled by track tests.

Function BuildSegmentFromOvalShape Has meaning only for OVAL (and ROUND) pads.

Parameters
aSegStart= the starting point of the equivalent segment relative to the shape position.
aSegEnd= the ending point of the equivalent segment, relative to the shape position
aRotation= full rotation of the segment
aRotation= full rotation of the segment
aMargin= a margin around the shape (for instance mask margin)
Returns
the width of the segment

Build an equivalent segment having the same shape as the OVAL shape, aSegStart and aSegEnd are the ending points of the equivalent segment of the shape aRotation is the asked rotation of the segment (usually m_Orient)

Definition at line 730 of file class_pad_draw_functions.cpp.

References delta, m_Size, RotatePoint(), wxPoint::x, and wxPoint::y.

Referenced by DrawShape(), and PNS_KICAD_IFACE::syncPad().

732 {
733  int width;
734 
735  if( m_Size.y < m_Size.x ) // Build an horizontal equiv segment
736  {
737  int delta = ( m_Size.x - m_Size.y ) / 2;
738  aSegStart.x = -delta - aMargin.x;
739  aSegStart.y = 0;
740  aSegEnd.x = delta + aMargin.x;
741  aSegEnd.y = 0;
742  width = m_Size.y + ( aMargin.y * 2 );
743  }
744  else // Vertical oval: build a vertical equiv segment
745  {
746  int delta = ( m_Size.y -m_Size.x ) / 2;
747  aSegStart.x = 0;
748  aSegStart.y = -delta - aMargin.y;
749  aSegEnd.x = 0;
750  aSegEnd.y = delta + aMargin.y;
751  width = m_Size.x + ( aMargin.x * 2 );
752  }
753 
754  if( aRotation )
755  {
756  RotatePoint( &aSegStart, aRotation);
757  RotatePoint( &aSegEnd, aRotation);
758  }
759 
760  return width;
761 }
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
static const int delta[8][2]
Definition: solve.cpp:112
static bool D_PAD::ClassOf ( const EDA_ITEM aItem)
inlinestatic

Definition at line 140 of file class_pad.h.

References PCB_PAD_T, and EDA_ITEM::Type().

141  {
142  return aItem && PCB_PAD_T == aItem->Type();
143  }
KICAD_T Type() const
Function Type()
Definition: base_struct.h:212
class D_PAD, a pad in a footprint
Definition: typeinfo.h:102
void EDA_ITEM::ClearBrightened ( )
inlineinherited

Definition at line 247 of file base_struct.h.

References BRIGHTENED, and EDA_ITEM::ClearFlags().

Referenced by GERBVIEW_SELECTION_TOOL::disambiguationMenu(), and SELECTION_TOOL::disambiguationMenu().

247 { ClearFlags( BRIGHTENED ); }
#define BRIGHTENED
item is drawn with a bright contour
Definition: base_struct.h:151
void ClearFlags(STATUS_FLAGS aMask=EDA_ITEM_ALL_FLAGS)
Definition: base_struct.h:268
void EDA_ITEM::ClearFlags ( STATUS_FLAGS  aMask = EDA_ITEM_ALL_FLAGS)
inlineinherited

Definition at line 268 of file base_struct.h.

Referenced by Abort_Edit_Pcb_Text(), Abort_EditEdge(), Abort_Move_ModuleOutline(), Abort_Move_Pad(), Abort_MoveOrCopyModule(), Abort_MoveTrack(), Abort_Zone_Create_Outline(), Abort_Zone_Move_Corner_Or_Outlines(), AbortMoveAndEditTarget(), abortMoveBitmap(), AbortMoveDimensionText(), abortMoveItem(), AbortMoveTextModule(), AbortPinMove(), SCH_SCREEN::addConnectedItemsToBlock(), SCH_EDIT_FRAME::addCurrentItemToList(), PNS_KICAD_IFACE::AddItem(), PCB_EDIT_FRAME::AppendBoardFile(), SCH_EDIT_FRAME::AppendOneEEProject(), PCB_EDIT_FRAME::Begin_DrawSegment(), FOOTPRINT_EDIT_FRAME::Begin_Edge_Module(), PCB_EDIT_FRAME::Begin_Zone(), SCH_EDIT_FRAME::BeginSegment(), PCB_EDIT_FRAME::Block_Delete(), PCB_EDIT_FRAME::Block_Flip(), PCB_EDIT_FRAME::Block_Move(), PCB_EDIT_FRAME::Change_Side_Module(), SCH_SCREEN::ClearAnnotation(), EDA_ITEM::ClearBrightened(), EDA_ITEM::ClearHighlighted(), ClearMarkItems(), clearModuleItemFlags(), EDA_ITEM::ClearSelected(), SCH_EDIT_FRAME::ConvertPart(), SCH_EDIT_FRAME::copyBlockItems(), CopyMarkedItems(), DIALOG_EDIT_COMPONENT_IN_SCHEMATIC::copyPanelToOptions(), MWAVE::CreateMicrowaveInductor(), FOOTPRINT_EDIT_FRAME::CreateTextModule(), PCB_EDIT_FRAME::Delete_LastCreatedCorner(), PCB_EDIT_FRAME::Delete_Segment_Edge(), LIB_PART::DeleteSelectedItems(), DIALOG_LIB_EDIT_PIN::DIALOG_LIB_EDIT_PIN(), PCB_EDIT_FRAME::EditDimension(), PCB_EDIT_FRAME::End_Edge(), FOOTPRINT_EDIT_FRAME::End_Edge_Module(), PCB_EDIT_FRAME::End_Move_Zone_Corner_Or_Outlines(), PCB_EDIT_FRAME::End_Zone(), SCH_EDIT_FRAME::EndSegment(), PCB_EDIT_FRAME::Exchange_Module(), ExitSheet(), SCH_SCREEN::GetConnection(), PCB_BASE_FRAME::GlobalChange_PadSettings(), PCB_BASE_FRAME::Import_Pad_Settings(), SCH_JUNCTION::IsSelectStateChanged(), SCH_NO_CONNECT::IsSelectStateChanged(), SCH_MARKER::IsSelectStateChanged(), SCH_BUS_ENTRY_BASE::IsSelectStateChanged(), SCH_LINE::IsSelectStateChanged(), SCH_BITMAP::IsSelectStateChanged(), SCH_TEXT::IsSelectStateChanged(), SCH_COMPONENT::IsSelectStateChanged(), SCH_SHEET::IsSelectStateChanged(), FOOTPRINT_EDIT_FRAME::Load_Module_From_BOARD(), MarkItemsInBloc(), MirrorX(), MirrorY(), moveBitmap(), FOOTPRINT_EDIT_FRAME::OnEditItemRequest(), LIB_EDIT_FRAME::OnEditPin(), FOOTPRINT_EDIT_FRAME::OnLeftClick(), SCH_EDIT_FRAME::OnLeftClick(), PCB_EDIT_FRAME::OnLeftClick(), LIB_EDIT_FRAME::OnRotateItem(), SCH_EDIT_FRAME::OnSelectUnit(), SCH_FIELD::Place(), PCB_EDIT_FRAME::Place_DrawItem(), FOOTPRINT_EDIT_FRAME::Place_EdgeMod(), PCB_EDIT_FRAME::Place_Texte_Pcb(), PCB_EDIT_FRAME::PlaceDimensionText(), PCB_EDIT_FRAME::PlaceDraggedOrMovedTrackSegment(), PCB_BASE_FRAME::PlaceModule(), PCB_BASE_FRAME::PlacePad(), PCB_EDIT_FRAME::PlaceTarget(), DRAWING_TOOL::PlaceText(), PCB_BASE_FRAME::PlaceTexteModule(), FOOTPRINT_EDIT_FRAME::Process_Special_Functions(), LIB_EDIT_FRAME::Process_Special_Functions(), EDIT_TOOL::Properties(), BOARD_COMMIT::Push(), PCB_BASE_EDIT_FRAME::PutDataInPreviousState(), SCH_EDIT_FRAME::PutDataInPreviousState(), SCH_EDIT_FRAME::RepeatDrawItem(), LIB_EDIT_FRAME::RepeatPinItem(), BOARD_COMMIT::Revert(), PCB_BASE_FRAME::Rotate_Module(), RotateListOfItems(), LIB_PIN::Save(), PCB_BASE_EDIT_FRAME::SaveCopyInUndoList(), FOOTPRINT_VIEWER_FRAME::SelectCurrentFootprint(), SCH_EDIT_FRAME::SetRepeatItem(), PCB_EDIT_FRAME::Start_DragTrackSegmentAndKeepSlope(), PCB_EDIT_FRAME::StartMoveModule(), PCB_EDIT_FRAME::StartMoveOneNodeOrSegment(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

268 { m_Flags &= ~aMask; }
STATUS_FLAGS m_Flags
Flag bits for editing and other uses.
Definition: base_struct.h:189
void EDA_ITEM::ClearHighlighted ( )
inlineinherited

Definition at line 246 of file base_struct.h.

References EDA_ITEM::ClearFlags(), and HIGHLIGHTED.

246 { ClearFlags( HIGHLIGHTED ); }
#define HIGHLIGHTED
item is drawn in normal colors, when the rest is darkened
Definition: base_struct.h:150
void ClearFlags(STATUS_FLAGS aMask=EDA_ITEM_ALL_FLAGS)
Definition: base_struct.h:268
void EDA_ITEM::ClearSelected ( )
inlineinherited
EDA_ITEM * D_PAD::Clone ( ) const
overridevirtual

Function Clone creates a duplicate of this item with linked list members set to NULL.

The default version will return NULL in release builds and likely crash the program. In debug builds, a warning message indicating the derived class has not implemented cloning. This really should be a pure virtual function. Due to the fact that there are so many objects derived from EDA_ITEM, the decision was made to return NULL until all the objects derived from EDA_ITEM implement cloning. Once that happens, this function should be made pure.

Returns
A clone of the item.

Reimplemented from EDA_ITEM.

Definition at line 1208 of file class_pad.cpp.

References D_PAD().

Referenced by Duplicate().

1209 {
1210  return new D_PAD( *this );
1211 }
D_PAD(MODULE *parent)
Definition: class_pad.cpp:59
int D_PAD::Compare ( const D_PAD padref,
const D_PAD padcmp 
)
static

Function Compare compares two pads and return 0 if they are equal.

Returns
int - <0 if left less than right, 0 if equal, >0 if left greater than right.

Definition at line 1063 of file class_pad.cpp.

References GetDrillShape(), GetShape(), m_DeltaSize, m_Drill, m_layerMask, m_Offset, m_Size, wxPoint::x, and wxPoint::y.

Referenced by CreatePadsShapesSection(), and PadListSortByShape().

1064 {
1065  int diff;
1066 
1067  if( ( diff = padref->GetShape() - padcmp->GetShape() ) != 0 )
1068  return diff;
1069 
1070  if( ( diff = padref->GetDrillShape() - padcmp->GetDrillShape() ) != 0)
1071  return diff;
1072 
1073  if( ( diff = padref->m_Drill.x - padcmp->m_Drill.x ) != 0 )
1074  return diff;
1075 
1076  if( ( diff = padref->m_Drill.y - padcmp->m_Drill.y ) != 0 )
1077  return diff;
1078 
1079  if( ( diff = padref->m_Size.x - padcmp->m_Size.x ) != 0 )
1080  return diff;
1081 
1082  if( ( diff = padref->m_Size.y - padcmp->m_Size.y ) != 0 )
1083  return diff;
1084 
1085  if( ( diff = padref->m_Offset.x - padcmp->m_Offset.x ) != 0 )
1086  return diff;
1087 
1088  if( ( diff = padref->m_Offset.y - padcmp->m_Offset.y ) != 0 )
1089  return diff;
1090 
1091  if( ( diff = padref->m_DeltaSize.x - padcmp->m_DeltaSize.x ) != 0 )
1092  return diff;
1093 
1094  if( ( diff = padref->m_DeltaSize.y - padcmp->m_DeltaSize.y ) != 0 )
1095  return diff;
1096 
1097 // TODO: test custom shapes
1098 
1099  // Dick: specctra_export needs this
1100  // Lorenzo: gencad also needs it to implement padstacks!
1101 
1102 #if __cplusplus >= 201103L
1103  long long d = padref->m_layerMask.to_ullong() - padcmp->m_layerMask.to_ullong();
1104  if( d < 0 )
1105  return -1;
1106  else if( d > 0 )
1107  return 1;
1108 
1109  return 0;
1110 #else
1111  // these strings are not typically constructed, since we don't get here often.
1112  std::string s1 = padref->m_layerMask.to_string();
1113  std::string s2 = padcmp->m_layerMask.to_string();
1114  return s1.compare( s2 );
1115 #endif
1116 }
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
PAD_DRILL_SHAPE_T GetDrillShape() const
Definition: class_pad.h:363
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
wxSize m_DeltaSize
delta on rectangular shapes
Definition: class_pad.h:797
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
wxPoint m_Offset
m_Offset is useful only for oblong and rect pads (it can be used for other shapes, but without any interest).
Definition: class_pad.h:791
LSET D_PAD::ConnSMDMask ( )
static

layer set for a SMD pad on Front layer used for edge board connectors

Definition at line 113 of file class_pad.cpp.

References F_Cu, and F_Mask.

114 {
115  static LSET saved( 2, F_Cu, F_Mask );
116  return saved;
117 }
Class LSET is a set of PCB_LAYER_IDs.
void D_PAD::CopyNetlistSettings ( D_PAD aPad,
bool  aCopyLocalSettings 
)

Function CopyNetlistSettings copies the netlist settings to aPad, and the net name.

Used to copy some pad parameters when replacing a footprint by an other footprint when reading a netlist, or in exchange footprint dialog

The netlist settings are all of the D_PAD settings not define by a D_PAD in a netlist. The copied settings are the net name and optionally include local clearance, etc. The pad physical geometry settings are not copied.

Parameters
aPadis the D_PAD to copy the settings to.
aCopyLocalSettings= false to copy only the net name true to also copy local prms

Definition at line 526 of file class_pad.cpp.

References BOARD_CONNECTED_ITEM::GetNetCode(), m_LocalClearance, m_LocalSolderMaskMargin, m_LocalSolderPasteMargin, m_LocalSolderPasteMarginRatio, m_ThermalGap, m_ThermalWidth, m_ZoneConnection, SetLocalClearance(), SetLocalSolderMaskMargin(), SetLocalSolderPasteMargin(), SetLocalSolderPasteMarginRatio(), BOARD_CONNECTED_ITEM::SetNetCode(), SetThermalGap(), SetThermalWidth(), and SetZoneConnection().

Referenced by MODULE::CopyNetlistSettings().

527 {
528  // Don't do anything foolish like trying to copy to yourself.
529  wxCHECK_RET( aPad != NULL && aPad != this, wxT( "Cannot copy to NULL or yourself." ) );
530 
531  aPad->SetNetCode( GetNetCode() );
532 
533  if( aCopyLocalSettings )
534  {
541  aPad->SetThermalGap( m_ThermalGap );
542  }
543 }
int m_LocalClearance
Local clearance.
Definition: class_pad.h:811
int m_ThermalGap
Definition: class_pad.h:824
int m_LocalSolderMaskMargin
Local mask margins: when 0, the parent footprint design values are used.
Definition: class_pad.h:815
int m_LocalSolderPasteMargin
Local solder paste margin absolute value.
Definition: class_pad.h:816
void SetZoneConnection(ZoneConnection aType)
Definition: class_pad.h:451
void SetThermalWidth(int aWidth)
Definition: class_pad.h:454
bool SetNetCode(int aNetCode, bool aNoAssert=false)
Function SetNetCode sets net using a net code.
int m_ThermalWidth
Definition: class_pad.h:823
void SetLocalClearance(int aClearance)
Definition: class_pad.h:389
void SetLocalSolderPasteMarginRatio(double aRatio)
Definition: class_pad.h:395
int GetNetCode() const
Function GetNetCode.
void SetLocalSolderMaskMargin(int aMargin)
Definition: class_pad.h:386
void SetLocalSolderPasteMargin(int aMargin)
Definition: class_pad.h:392
double m_LocalSolderPasteMarginRatio
Local solder mask margin ratio value of pad size The final margin is the sum of these 2 values...
Definition: class_pad.h:818
void SetThermalGap(int aGap)
Definition: class_pad.h:457
ZoneConnection m_ZoneConnection
how the connection to zone is made: no connection, thermal relief ...
Definition: class_pad.h:821
void D_PAD::CustomShapeAsPolygonToBoardPosition ( SHAPE_POLY_SET aMergedPolygon,
wxPoint  aPosition,
double  aRotation 
) const

When created, the corners coordinates are relative to the pad position, orientation 0, in m_customShapeAsPolygon CustomShapeAsPolygonToBoardPosition transform these coordinates to actual (board) coordinates.

Parameters
aMergedPolygon= the corners coordinates, relative to aPosition and rotated by aRotation
aPosition= the position of the shape (usually the pad shape, but not always, when moving the pad)
aRotation= the rotation of the shape (usually the pad rotation, but not always, in DRC)

Definition at line 245 of file class_pad_custom_shape_functions.cpp.

References SHAPE_POLY_SET::Outline(), SHAPE_POLY_SET::OutlineCount(), SHAPE_LINE_CHAIN::Point(), SHAPE_LINE_CHAIN::PointCount(), RotatePoint(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by CINFO3D_VISU::buildPadShapePolygon(), DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), CINFO3D_VISU::createNewPadWithClearance(), DrawShape(), GetBoundingBox(), BRDITEMS_PLOTTER::PlotPad(), PNS_KICAD_IFACE::syncPad(), and TransformShapeWithClearanceToPolygon().

247 {
248  if( aMergedPolygon->OutlineCount() == 0 )
249  return;
250 
251  // Move, rotate, ... coordinates in aMergedPolygon according to the
252  // pad position and orientation
253  for( int cnt = 0; cnt < aMergedPolygon->OutlineCount(); ++cnt )
254  {
255  SHAPE_LINE_CHAIN& poly = aMergedPolygon->Outline( cnt );
256 
257  for( int ii = 0; ii < poly.PointCount(); ++ii )
258  {
259  wxPoint corner( poly.Point( ii ).x, poly.Point( ii ).y );
260  RotatePoint( &corner, aRotation );
261  corner += aPosition;
262 
263  poly.Point( ii ).x = corner.x;
264  poly.Point( ii ).y = corner.y;
265  }
266  }
267 }
int PointCount() const
Function PointCount()
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
int OutlineCount() const
Returns the number of outlines in the set
SHAPE_LINE_CHAIN & Outline(int aIndex)
Returns the reference to aIndex-th outline in the set
Class SHAPE_LINE_CHAIN.
VECTOR2I & Point(int aIndex)
Function Point()
void D_PAD::DeletePrimitivesList ( )

clear the basic shapes list

Definition at line 131 of file class_pad_custom_shape_functions.cpp.

References m_basicShapes, m_customShapeAsPolygon, and SHAPE_POLY_SET::RemoveAllContours().

Referenced by DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

132 {
133  m_basicShapes.clear();
135 }
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
void RemoveAllContours()
Removes all outlines & holes (clears) the polygon set.
void BOARD_ITEM::DeleteStructure ( )
inherited
void D_PAD::Draw ( EDA_DRAW_PANEL panel,
wxDC *  DC,
GR_DRAWMODE  aDrawMode,
const wxPoint offset = ZeroOffset 
)
overridevirtual

Function Draw BOARD_ITEMs have their own color information.

Implements BOARD_ITEM.

Definition at line 76 of file class_pad_draw_functions.cpp.

References KIGFX::COLOR4D::a, LSET::AllCuMask(), B_Cu, B_Mask, B_Paste, LSET::BackMask(), BLACK, color, PCB_GENERAL_SETTINGS::Colors(), DARKDARKGRAY, DARKGRAY, DO_NOT_DRAW, DrawShape(), LSET::ExtractLayer(), F_Cu, F_Mask, F_Paste, LSET::FrontMask(), GetAttribute(), BOARD_ITEM::GetBoard(), GetClearance(), EDA_DRAW_PANEL::GetClipBox(), EDA_DRAW_PANEL::GetParent(), GetSolderMaskMargin(), GetSolderPasteMargin(), BOARD::GetVisibleLayers(), GR_ALLOW_HIGHCONTRAST, GR_AND, GR_HIGHLIGHT, ID_TRACK_BUTT, IsCopperLayer(), BOARD::IsElementVisible(), IsOnLayer(), LAYER_NO_CONNECTS, LAYER_NON_PLATED, LAYER_PAD_BK, LAYER_PAD_FR, PCB_SCREEN::m_Active_Layer, PAD_DRAWINFO::m_Color, DISPLAY_OPTIONS::m_ContrastModeDisplay, PAD_DRAWINFO::m_Display_netname, PAD_DRAWINFO::m_Display_padnum, DISPLAY_OPTIONS::m_DisplayNetNamesMode, DISPLAY_OPTIONS::m_DisplayPadFill, DISPLAY_OPTIONS::m_DisplayPadIsol, DISPLAY_OPTIONS::m_DisplayPadNum, PAD_DRAWINFO::m_DrawMode, PAD_DRAWINFO::m_DrawPanel, EDA_ITEM::m_Flags, PAD_DRAWINFO::m_IsPrinting, BASE_SCREEN::m_IsPrinting, m_layerMask, PAD_DRAWINFO::m_Mask_margin, PAD_DRAWINFO::m_NPHoleColor, PAD_DRAWINFO::m_Offset, PAD_DRAWINFO::m_PadClearance, PCB_SCREEN::m_Route_Layer_BOTTOM, PCB_SCREEN::m_Route_Layer_TOP, PAD_DRAWINFO::m_ShowNCMark, PAD_DRAWINFO::m_ShowNotPlatedHole, PAD_DRAWINFO::m_ShowPadFilled, PAD_ATTRIB_CONN, PAD_ATTRIB_HOLE_NOT_PLATED, PAD_ATTRIB_SMD, PCB_BASE_FRAME::Settings(), SKETCH, UNDEFINED_LAYER, and UNSELECTED_LAYER.

Referenced by Abort_Move_Pad(), DrawMovingBlockOutlines(), MODULE::DrawOutlinesWhenMoving(), PCB_BASE_FRAME::PlacePad(), Show_Pad_Move(), and PCB_BASE_FRAME::StartMovePad().

78 {
79  wxSize mask_margin; // margin (clearance) used for some non copper layers
80 
81 #ifdef SHOW_PADMASK_REAL_SIZE_AND_COLOR
82  int showActualMaskSize = 0; /* Layer number if the actual pad size on mask layer can
83  * be displayed i.e. if only one layer is shown for this pad
84  * and this layer is a mask (solder mask or solder paste
85  */
86 #endif
87 
88  if( m_Flags & DO_NOT_DRAW )
89  return;
90 
91  PAD_DRAWINFO drawInfo;
92 
93  drawInfo.m_Offset = aOffset;
94 
95  /* We can show/hide pads from the layer manager.
96  * options are show/hide pads on front and/or back side of the board
97  * For through pads, we hide them only if both sides are hidden.
98  * smd pads on back are hidden for all layers (copper and technical layers)
99  * on back side of the board
100  * smd pads on front are hidden for all layers (copper and technical layers)
101  * on front side of the board
102  * ECO, edge and Draw layers and not considered
103  */
104 
105  BOARD* brd = GetBoard();
106 
107  auto frame = static_cast<PCB_EDIT_FRAME*> ( aPanel->GetParent() );
108  const auto& cds = frame->Settings().Colors();
109 
110  bool frontVisible = brd->IsElementVisible( LAYER_PAD_FR );
111  bool backVisible = brd->IsElementVisible( LAYER_PAD_BK );
112 
113  if( !frontVisible && !backVisible )
114  return;
115 
116  // If pad is only on front side (no layer on back side)
117  // and if hide front side pads is enabled, do not draw
118  if( !frontVisible && !( m_layerMask & LSET::BackMask() ).any() )
119  return;
120 
121  // If pad is only on back side (no layer on front side)
122  // and if hide back side pads is enabled, do not draw
123  if( !backVisible && !( m_layerMask & LSET::FrontMask() ).any() )
124  return;
125 
126 
127  wxCHECK_RET( frame != NULL, wxT( "Panel has no parent frame window." ) );
128 
129  DISPLAY_OPTIONS* displ_opts = (DISPLAY_OPTIONS*)frame->GetDisplayOptions();
130  PCB_SCREEN* screen = frame->GetScreen();
131 
132  if( displ_opts && displ_opts->m_DisplayPadFill == SKETCH )
133  drawInfo.m_ShowPadFilled = false;
134  else
135  drawInfo.m_ShowPadFilled = true;
136 
138 
139  if( m_layerMask[F_Cu] )
140  {
141  color = cds.GetItemColor( LAYER_PAD_FR );
142  }
143 
144  if( m_layerMask[B_Cu] )
145  {
146  color = color.LegacyMix( cds.GetItemColor( LAYER_PAD_BK ) );
147  }
148 
149  if( color == BLACK ) // Not on a visible copper layer (i.e. still nothing to show)
150  {
151  // If the pad is on only one tech layer, use the layer color else use DARKGRAY
152  LSET mask_non_copper_layers = m_layerMask & ~LSET::AllCuMask();
153 
154 #ifdef SHOW_PADMASK_REAL_SIZE_AND_COLOR
155  mask_non_copper_layers &= brd->GetVisibleLayers();
156 #endif
157  PCB_LAYER_ID pad_layer = mask_non_copper_layers.ExtractLayer();
158 
159  switch( (int) pad_layer )
160  {
161  case UNDEFINED_LAYER: // More than one layer
162  color = DARKGRAY;
163  break;
164 
165  case UNSELECTED_LAYER: // Shouldn't really happen...
166  break;
167 
168  default:
169  color = cds.GetLayerColor( pad_layer );
170 #ifdef SHOW_PADMASK_REAL_SIZE_AND_COLOR
171  showActualMaskSize = pad_layer;
172 #endif
173  }
174  }
175 
176  // if SMD or connector pad and high contrast mode
177  if( ( aDraw_mode & GR_ALLOW_HIGHCONTRAST ) &&
179  displ_opts && displ_opts->m_ContrastModeDisplay )
180  {
181  // when routing tracks
182  if( frame->GetToolId() == ID_TRACK_BUTT )
183  {
184  PCB_LAYER_ID routeTop = screen->m_Route_Layer_TOP;
185  PCB_LAYER_ID routeBot = screen->m_Route_Layer_BOTTOM;
186 
187  // if routing between copper and component layers,
188  // or the current layer is one of said 2 external copper layers,
189  // then highlight only the current layer.
190  if( ( screen->m_Active_Layer == F_Cu || screen->m_Active_Layer == B_Cu ) ||
191  ( routeTop==F_Cu && routeBot==B_Cu ) ||
192  ( routeTop==B_Cu && routeBot==F_Cu )
193  )
194  {
195  if( !IsOnLayer( screen->m_Active_Layer ) )
196  color = COLOR4D( DARKDARKGRAY );
197  }
198  // else routing between an internal signal layer and some other
199  // layer. Grey out all PAD_ATTRIB_SMD pads not on current or the single
200  // selected external layer.
201  else if( !IsOnLayer( screen->m_Active_Layer )
202  && !IsOnLayer( routeTop )
203  && !IsOnLayer( routeBot ) )
204  {
205  color = COLOR4D( DARKDARKGRAY );
206  }
207  }
208  // when not edting tracks, show PAD_ATTRIB_SMD components not on active layer
209  // as greyed out
210  else
211  {
212  if( !IsOnLayer( screen->m_Active_Layer ) )
213  color = COLOR4D( DARKDARKGRAY );
214  }
215  }
216 
217 #ifdef SHOW_PADMASK_REAL_SIZE_AND_COLOR
218  if( showActualMaskSize )
219  {
220  switch( showActualMaskSize )
221  {
222  case B_Mask:
223  case F_Mask:
224  mask_margin.x = mask_margin.y = GetSolderMaskMargin();
225  break;
226 
227  case B_Paste:
228  case F_Paste:
229  mask_margin = GetSolderPasteMargin();
230  break;
231 
232  default:
233  // Another layer which has no margin to handle
234  break;
235  }
236  }
237 #endif
238 
239  // if Contrast mode is ON and a technical layer active, show pads on this
240  // layer so we can see pads on paste or solder layer and the size of the
241  // mask
242  if( ( aDraw_mode & GR_ALLOW_HIGHCONTRAST ) &&
243  displ_opts && displ_opts->m_ContrastModeDisplay && !IsCopperLayer( screen->m_Active_Layer ) )
244  {
245  if( IsOnLayer( screen->m_Active_Layer ) )
246  {
247  color = cds.GetLayerColor( screen->m_Active_Layer );
248 
249  // In high contrast mode, and if the active layer is the mask
250  // layer shows the pad size with the mask clearance
251  switch( screen->m_Active_Layer )
252  {
253  case B_Mask:
254  case F_Mask:
255  mask_margin.x = mask_margin.y = GetSolderMaskMargin();
256  break;
257 
258  case B_Paste:
259  case F_Paste:
260  mask_margin = GetSolderPasteMargin();
261  break;
262 
263  default:
264  break;
265  }
266  }
267  else
268  color = DARKDARKGRAY;
269  }
270 
271  if( ( aDraw_mode & GR_HIGHLIGHT ) && !( aDraw_mode & GR_AND ) )
272  color.SetToLegacyHighlightColor();
273 
274  bool DisplayIsol = displ_opts && displ_opts->m_DisplayPadIsol;
275 
276  if( !( m_layerMask & LSET::AllCuMask() ).any() )
277  DisplayIsol = false;
278 
281  {
282  drawInfo.m_ShowNotPlatedHole = true;
283  drawInfo.m_NPHoleColor = cds.GetItemColor( LAYER_NON_PLATED );
284  }
285 
286  drawInfo.m_DrawMode = aDraw_mode;
287  drawInfo.m_Color = color;
288  drawInfo.m_DrawPanel = aPanel;
289  drawInfo.m_Mask_margin = mask_margin;
291  drawInfo.m_IsPrinting = screen->m_IsPrinting;
292  color.a = 0.666;
293 
294  /* Get the pad clearance. This has a meaning only for Pcbnew.
295  * for CvPcb GetClearance() creates debug errors because
296  * there is no net classes so a call to GetClearance() is made only when
297  * needed (never needed in CvPcb)
298  */
299  drawInfo.m_PadClearance = DisplayIsol ? GetClearance() : 0;
300 
301  // Draw the pad number
302  if( displ_opts && !displ_opts->m_DisplayPadNum )
303  drawInfo.m_Display_padnum = false;
304 
305  if( displ_opts &&
306  (( displ_opts ->m_DisplayNetNamesMode == 0 ) || ( displ_opts->m_DisplayNetNamesMode == 2 )) )
307  drawInfo.m_Display_netname = false;
308 
309  // Display net names is restricted to pads that are on the active layer
310  // in high contrast mode display
311  if( ( aDraw_mode & GR_ALLOW_HIGHCONTRAST ) &&
312  !IsOnLayer( screen->m_Active_Layer ) && displ_opts && displ_opts->m_ContrastModeDisplay )
313  drawInfo.m_Display_netname = false;
314 
315  DrawShape( aPanel->GetClipBox(), aDC, drawInfo );
316 }
static LSET AllCuMask(int aCuLayerCount=MAX_CU_LAYERS)
Function AllCuMask returns a mask holding the requested number of Cu PCB_LAYER_IDs.
Definition: lset.cpp:639
show a marker on pads with no nets
bool IsElementVisible(GAL_LAYER_ID LAYER_aPCB) const
Function IsElementVisible tests whether a given element category is visible.
bool m_Display_padnum
Definition: class_pad.h:73
PAD_ATTR_T GetAttribute() const
Definition: class_pad.h:380
like PAD_STANDARD, but not plated mechanical use only, no connection allowed
Definition: pad_shapes.h:65
Smd pad, appears on the solder paste layer (default)
Definition: pad_shapes.h:61
bool m_ShowNCMark
Definition: class_pad.h:77
PCB_LAYER_ID m_Active_Layer
smd pads, back layer
static LSET FrontMask()
Function FrontMask returns a mask holding all technical layers and the external CU layer on front sid...
Definition: lset.cpp:738
bool m_IsPrinting
Definition: class_pad.h:80
PCB_LAYER_ID ExtractLayer() const
Find the first set PCB_LAYER_ID.
Definition: lset.cpp:578
PCB_LAYER_ID
A quick note on layer IDs:
double a
Alpha component.
Definition: color4d.h:289
Class LSET is a set of PCB_LAYER_IDs.
PCB_GENERAL_SETTINGS & Settings()
int GetSolderMaskMargin() const
Function GetSolderMaskMargin.
Definition: class_pad.cpp:577
GR_DRAWMODE m_DrawMode
Definition: class_pad.h:66
EDA_DRAW_PANEL * m_DrawPanel
Definition: class_pad.h:65
bool m_ContrastModeDisplay
Definition: pcbstruct.h:85
PCB_LAYER_ID m_Route_Layer_BOTTOM
bool m_ShowNotPlatedHole
Definition: class_pad.h:78
void DrawShape(EDA_RECT *aClipBox, wxDC *aDC, PAD_DRAWINFO &aDrawInfo)
Function DrawShape basic function to draw a pad.
Like smd, does not appear on the solder paste layer (default) note also has a special attribute in Ge...
Definition: pad_shapes.h:62
int m_PadClearance
Definition: class_pad.h:71
COLORS_DESIGN_SETTINGS & Colors()
Class DISPLAY_OPTIONS handles display options like enable/disable some optional drawings.
Definition: pcbstruct.h:62
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
bool m_DisplayPadFill
Definition: pcbstruct.h:65
bool m_DisplayPadIsol
Definition: pcbstruct.h:68
wxPoint m_Offset
Definition: class_pad.h:81
smd pads, front layer
handle color for not plated holes
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
bool m_DisplayPadNum
Definition: pcbstruct.h:67
LSET GetVisibleLayers() const
Function GetVisibleLayers is a proxy function that calls the correspondent function in m_BoardSetting...
STATUS_FLAGS m_Flags
Flag bits for editing and other uses.
Definition: base_struct.h:189
wxSize GetSolderPasteMargin() const
Function GetSolderPasteMargin.
Definition: class_pad.cpp:610
int m_DisplayNetNamesMode
Definition: pcbstruct.h:78
int GetClearance(BOARD_CONNECTED_ITEM *aItem=NULL) const override
Function GetClearance returns the clearance in internal units.
Definition: class_pad.cpp:546
static LSET BackMask()
Function BackMask returns a mask holding all technical layers and the external CU layer on back side...
Definition: lset.cpp:745
bool m_ShowPadFilled
Definition: class_pad.h:75
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
bool IsCopperLayer(LAYER_NUM aLayerId)
Function IsCopperLayer tests whether a layer is a copper layer.
COLOR4D m_NPHoleColor
Definition: class_pad.h:70
COLOR4D m_Color
Definition: class_pad.h:67
Definition: colors.h:45
bool m_Display_netname
Definition: class_pad.h:74
bool IsOnLayer(PCB_LAYER_ID aLayer) const override
Function IsOnLayer tests to see if this object is on the given layer.
Definition: class_pad.h:619
wxSize m_Mask_margin
Definition: class_pad.h:72
PCB_LAYER_ID m_Route_Layer_TOP
#define DO_NOT_DRAW
Used to disable draw function.
Definition: base_struct.h:139
Class COLOR4D is the color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:39
void D_PAD::DrawShape ( EDA_RECT aClipBox,
wxDC *  aDC,
PAD_DRAWINFO aDrawInfo 
)

Function DrawShape basic function to draw a pad.

This function is used by Draw after calculation of parameters (color, ) final orientation transforms are set. It can also be called to draw a pad on any panel even if this panel is not a EDA_DRAW_PANEL for instance on a wxPanel inside the pad editor.

Definition at line 319 of file class_pad_draw_functions.cpp.

References PNS::angle(), SHAPE_POLY_SET::Append(), B_Cu, BLACK, BLUE, BuildPadPolygon(), BuildSegmentFromOvalShape(), CustomShapeAsPolygonToBoardPosition(), DrawGraphicHaloText(), F_Cu, GetAnchorPadShape(), EDA_DRAW_PANEL::GetClipBox(), GetDrillShape(), GetGRForceBlackPenState(), BOARD_CONNECTED_ITEM::GetNetCode(), GetOblongDrillGeometry(), GetOrientation(), GetPosition(), GetRoundRectCornerCenters(), GetRoundRectCornerRadius(), GetShape(), BOARD_CONNECTED_ITEM::GetShortNetname(), GetSize(), GR_COPY, GR_TEXT_HJUSTIFY_CENTER, GR_TEXT_VJUSTIFY_CENTER, GR_XOR, GRCircle(), GRClosedPoly(), GRCSegm(), GRFillCSegm(), GRFilledCircle(), GRFilledSegment(), GRForceBlackPen(), GRLine(), GRSetDrawMode(), SHAPE_POLY_SET::Inflate(), PAD_DRAWINFO::m_Color, m_customShapeAsPolygon, PAD_DRAWINFO::m_Display_netname, PAD_DRAWINFO::m_Display_padnum, PAD_DRAWINFO::m_DrawMode, PAD_DRAWINFO::m_DrawPanel, m_Drill, PAD_DRAWINFO::m_HoleColor, PAD_DRAWINFO::m_IsPrinting, m_layerMask, PAD_DRAWINFO::m_Mask_margin, m_name, PAD_DRAWINFO::m_NPHoleColor, PAD_DRAWINFO::m_Offset, m_Orient, PAD_DRAWINFO::m_PadClearance, m_PadSketchModePenSize, m_Pos, PAD_DRAWINFO::m_ShowNCMark, PAD_DRAWINFO::m_ShowNotPlatedHole, PAD_DRAWINFO::m_ShowPadFilled, m_Size, max, min, MIN_TEXT_SIZE, NORMALIZE_ANGLE_90(), SHAPE_POLY_SET::Outline(), SHAPE_POLY_SET::OutlineCount(), PAD_DRILL_SHAPE_CIRCLE, PAD_DRILL_SHAPE_OBLONG, PAD_SHAPE_CIRCLE, PAD_SHAPE_CUSTOM, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, SHAPE_LINE_CHAIN::Point(), SHAPE_LINE_CHAIN::PointCount(), SHAPE_POLY_SET::RemoveAllContours(), RotatePoint(), SEGCOUNT, ShapePos(), TransformRoundRectToPolygon(), TransformShapeWithClearanceToPolygon(), WHITE, wxPoint::x, and wxPoint::y.

Referenced by Draw(), and DIALOG_PAD_PROPERTIES::OnPaintShowPanel().

320 {
321  wxPoint coord[12];
322  double angle = m_Orient;
323  int seg_width;
324 
325  GRSetDrawMode( aDC, aDrawInfo.m_DrawMode );
326 
327  // calculate pad shape position :
328  wxPoint shape_pos = ShapePos() - aDrawInfo.m_Offset;
329 
330  wxSize halfsize = m_Size;
331  halfsize.x >>= 1;
332  halfsize.y >>= 1;
333 
334  switch( GetShape() )
335  {
336  case PAD_SHAPE_CIRCLE:
337  if( aDrawInfo.m_ShowPadFilled )
338  GRFilledCircle( aClipBox, aDC, shape_pos.x, shape_pos.y,
339  halfsize.x + aDrawInfo.m_Mask_margin.x, 0,
340  aDrawInfo.m_Color, aDrawInfo.m_Color );
341  else
342  GRCircle( aClipBox, aDC, shape_pos.x, shape_pos.y,
343  halfsize.x + aDrawInfo.m_Mask_margin.x,
344  m_PadSketchModePenSize, aDrawInfo.m_Color );
345 
346  if( aDrawInfo.m_PadClearance )
347  {
348  GRCircle( aClipBox,
349  aDC, shape_pos.x, shape_pos.y,
350  halfsize.x + aDrawInfo.m_PadClearance,
351  0, aDrawInfo.m_Color );
352  }
353 
354  break;
355 
356  case PAD_SHAPE_OVAL:
357  {
358  wxPoint segStart, segEnd;
359  seg_width = BuildSegmentFromOvalShape(segStart, segEnd, angle,
360  aDrawInfo.m_Mask_margin);
361  segStart += shape_pos;
362  segEnd += shape_pos;
363 
364  if( aDrawInfo.m_ShowPadFilled )
365  {
366  GRFillCSegm( aClipBox, aDC, segStart.x, segStart.y, segEnd.x, segEnd.y,
367  seg_width, aDrawInfo.m_Color );
368  }
369  else
370  {
371  GRCSegm( aClipBox, aDC, segStart.x, segStart.y, segEnd.x, segEnd.y,
372  seg_width, m_PadSketchModePenSize, aDrawInfo.m_Color );
373  }
374 
375  // Draw the clearance line
376  if( aDrawInfo.m_PadClearance )
377  {
378  seg_width += 2 * aDrawInfo.m_PadClearance;
379  GRCSegm( aClipBox, aDC, segStart.x, segStart.y, segEnd.x, segEnd.y,
380  seg_width, aDrawInfo.m_Color );
381  }
382  }
383  break;
384 
385  case PAD_SHAPE_RECT:
386  case PAD_SHAPE_TRAPEZOID:
387  BuildPadPolygon( coord, aDrawInfo.m_Mask_margin, angle );
388 
389  for( int ii = 0; ii < 4; ii++ )
390  coord[ii] += shape_pos;
391 
392  GRClosedPoly( aClipBox, aDC, 4, coord, aDrawInfo.m_ShowPadFilled,
393  aDrawInfo.m_ShowPadFilled ? 0 : m_PadSketchModePenSize,
394  aDrawInfo.m_Color, aDrawInfo.m_Color );
395 
396  if( aDrawInfo.m_PadClearance )
397  {
398  #define SEGCOUNT 32 // number of segments to approximate a circle
399  SHAPE_POLY_SET outline;
401 
402  // Draw the polygon: Inflate creates only one convex polygon
403  SHAPE_LINE_CHAIN& poly = outline.Outline( 0 );
404 
405  GRClosedPoly( aClipBox, aDC, poly.PointCount(),
406  (wxPoint*)&poly.Point( 0 ), false, 0,
407  aDrawInfo.m_Color, aDrawInfo.m_Color );
408  }
409  break;
410 
411  case PAD_SHAPE_ROUNDRECT:
412  {
413  // Use solder[Paste/Mask]size or pad size to build pad shape to draw
414  wxSize size( GetSize() );
415  size += aDrawInfo.m_Mask_margin * 2;
416  int corner_radius = GetRoundRectCornerRadius( size );
417 
418  // Draw the polygon: Inflate creates only one convex polygon
419  SHAPE_POLY_SET outline;
420  bool filled = aDrawInfo.m_ShowPadFilled;
421 
422  if( filled )
423  {
424  wxPoint centers[4];
425  GetRoundRectCornerCenters( centers, corner_radius, shape_pos,
426  size, GetOrientation() );
427  GRClosedPoly( aClipBox, aDC, 4, centers, true, corner_radius*2,
428  aDrawInfo.m_Color, aDrawInfo.m_Color );
429  }
430  else
431  {
432  TransformRoundRectToPolygon( outline, shape_pos, size, GetOrientation(),
433  corner_radius, 64 );
434 
435  SHAPE_LINE_CHAIN& poly = outline.Outline( 0 );
436 
437  GRClosedPoly( aClipBox, aDC, poly.PointCount(),
438  (wxPoint*)&poly.Point( 0 ), aDrawInfo.m_ShowPadFilled, 0,
439  aDrawInfo.m_Color, aDrawInfo.m_Color );
440  }
441 
442  if( aDrawInfo.m_PadClearance )
443  {
444  outline.RemoveAllContours();
445  size = GetSize();
446  size.x += aDrawInfo.m_PadClearance * 2;
447  size.y += aDrawInfo.m_PadClearance * 2;
448  corner_radius = GetRoundRectCornerRadius() + aDrawInfo.m_PadClearance;
449 
450  TransformRoundRectToPolygon( outline, shape_pos, size, GetOrientation(),
451  corner_radius, 32 );
452 
453  // Draw the polygon: Inflate creates only one convex polygon
454  SHAPE_LINE_CHAIN& clearance_poly = outline.Outline( 0 );
455 
456  GRClosedPoly( aClipBox, aDC, clearance_poly.PointCount(),
457  (wxPoint*)&clearance_poly.Point( 0 ), false, 0,
458  aDrawInfo.m_Color, aDrawInfo.m_Color );
459  }
460  }
461  break;
462 
463  case PAD_SHAPE_CUSTOM:
464  {
465  // The full shape has 2 items
466  // 1- The anchor pad: a round or rect pad located at pad position
467  // 2- The custom complex shape
468  // Note: The anchor pad shape is containing by the custom complex shape polygon
469  // The anchor pad is shown to help user to see where is the anchor, only in sketch mode
470  // (In filled mode, it is merged with the basic shapes)
471  wxPoint pad_pos = GetPosition() - aDrawInfo.m_Offset;
472 
473  // In sketch mode only: Draw the anchor pad: a round or rect pad
474  if( !aDrawInfo.m_ShowPadFilled )
475  {
477  {
478  wxPoint poly[4];
479  poly[0] = wxPoint( - halfsize.x, - halfsize.y );
480  poly[1] = wxPoint( - halfsize.x, + halfsize.y );
481  poly[2] = wxPoint( + halfsize.x, + halfsize.y );
482  poly[3] = wxPoint( + halfsize.x, - halfsize.y );
483 
484  for( int ii = 0; ii < 4; ++ii )
485  {
486  RotatePoint( &poly[ii], m_Orient );
487  poly[ii] += pad_pos;
488  }
489 
490  GRClosedPoly( aClipBox, aDC, 4, poly, false, 0,
491  aDrawInfo.m_Color, aDrawInfo.m_Color );
492  }
493  else
494  {
495  GRCircle( aClipBox, aDC, pad_pos.x, pad_pos.y,
496  halfsize.x,
497  m_PadSketchModePenSize, aDrawInfo.m_Color );
498  }
499  }
500 
501  SHAPE_POLY_SET outline; // Will contain the corners in board coordinates
502  outline.Append( m_customShapeAsPolygon );
503  CustomShapeAsPolygonToBoardPosition( &outline, pad_pos, GetOrientation() );
504  SHAPE_LINE_CHAIN* poly;
505 
506  const int segmentToCircleCount = 32;
507 
508  if( aDrawInfo.m_Mask_margin.x )
509  {
510  SHAPE_POLY_SET clearance_outline;
511  clearance_outline.Append( outline );
512  clearance_outline.Inflate( aDrawInfo.m_Mask_margin.x, segmentToCircleCount );
513 
514  poly = &clearance_outline.Outline( 0 );
515  }
516  else
517  {
518  // Draw the polygon: only one polygon is expected
519  // However we provide a multi polygon shape drawing
520  // ( for the future or to show a non expected shape )
521  for( int jj = 0; jj < outline.OutlineCount(); ++jj )
522  {
523  poly = &outline.Outline( jj );
524 
525  GRClosedPoly( aClipBox, aDC, poly->PointCount(),
526  (wxPoint*)&poly->Point( 0 ), aDrawInfo.m_ShowPadFilled, 0,
527  aDrawInfo.m_Color, aDrawInfo.m_Color );
528  }
529  }
530 
531  if( aDrawInfo.m_PadClearance )
532  {
533  SHAPE_POLY_SET clearance_outline;
534  clearance_outline.Append( outline );
535 
536  clearance_outline.Inflate( aDrawInfo.m_PadClearance, segmentToCircleCount );
537 
538  for( int jj = 0; jj < clearance_outline.OutlineCount(); ++jj )
539  {
540  poly = &clearance_outline.Outline( jj );
541 
542  GRClosedPoly( aClipBox, aDC, poly->PointCount(),
543  (wxPoint*)&poly->Point( 0 ), false, 0,
544  aDrawInfo.m_Color, aDrawInfo.m_Color );
545  }
546  }
547  break;
548  }
549 
550  default:
551  break;
552  }
553 
554  // Draw the pad hole
555  wxPoint holepos = m_Pos - aDrawInfo.m_Offset;
556  int hole = m_Drill.x >> 1;
557 
558  bool drawhole = hole > 0;
559 
560  if( !aDrawInfo.m_ShowPadFilled && !aDrawInfo.m_ShowNotPlatedHole )
561  drawhole = false;
562 
563  if( drawhole )
564  {
565  bool blackpenstate = false;
566 
567  if( aDrawInfo.m_IsPrinting )
568  {
569  blackpenstate = GetGRForceBlackPenState();
570  GRForceBlackPen( false );
571  aDrawInfo.m_HoleColor = WHITE;
572  aDrawInfo.m_NPHoleColor = WHITE;
573  }
574  else
575  {
576  GRSetDrawMode( aDC, ( aDrawInfo.m_DrawMode != GR_XOR ) ? GR_COPY : GR_XOR );
577  }
578 
579  COLOR4D hole_color = aDrawInfo.m_HoleColor;
580 
581  if( aDrawInfo. m_ShowNotPlatedHole ) // Draw a specific hole color
582  hole_color = aDrawInfo.m_NPHoleColor;
583 
584  switch( GetDrillShape() )
585  {
587  if( aDC->LogicalToDeviceXRel( hole ) > 1 ) // hole is drawn if hole > 1pixel
588  GRFilledCircle( aClipBox, aDC, holepos.x, holepos.y, hole, 0,
589  hole_color, hole_color );
590  break;
591 
593  {
594  wxPoint drl_start, drl_end;
595  GetOblongDrillGeometry( drl_start, drl_end, seg_width );
596  GRFilledSegment( aClipBox, aDC, holepos + drl_start,
597  holepos + drl_end, seg_width, hole_color );
598  }
599  break;
600 
601  default:
602  break;
603  }
604 
605  if( aDrawInfo.m_IsPrinting )
606  GRForceBlackPen( blackpenstate );
607  }
608 
609  GRSetDrawMode( aDC, aDrawInfo.m_DrawMode );
610 
611  // Draw "No connect" ( / or \ or cross X ) if necessary
612  if( GetNetCode() == 0 && aDrawInfo.m_ShowNCMark )
613  {
614  int dx0 = std::min( halfsize.x, halfsize.y );
615  COLOR4D nc_color = COLOR4D( BLUE );
616 
617  if( m_layerMask[F_Cu] ) /* Draw \ */
618  GRLine( aClipBox, aDC, holepos.x - dx0, holepos.y - dx0,
619  holepos.x + dx0, holepos.y + dx0, 0, nc_color );
620 
621  if( m_layerMask[B_Cu] ) // Draw /
622  GRLine( aClipBox, aDC, holepos.x + dx0, holepos.y - dx0,
623  holepos.x - dx0, holepos.y + dx0, 0, nc_color );
624  }
625 
626  if( !aDrawInfo.m_IsPrinting )
627  GRSetDrawMode( aDC, ( aDrawInfo.m_DrawMode != GR_XOR ) ? GR_COPY : GR_XOR );
628 
629  // Draw the pad number
630  if( !aDrawInfo.m_Display_padnum && !aDrawInfo.m_Display_netname )
631  return;
632 
633  wxPoint tpos0 = shape_pos; // Position of the centre of text
634  wxPoint tpos = tpos0;
635  wxSize AreaSize; // size of text area, normalized to AreaSize.y < AreaSize.x
636  int shortname_len = 0;
637 
638  if( aDrawInfo.m_Display_netname )
639  shortname_len = GetShortNetname().Len();
640 
641  if( GetShape() == PAD_SHAPE_CIRCLE )
642  angle = 0;
643 
644  AreaSize = m_Size;
645 
646  if( m_Size.y > m_Size.x )
647  {
648  angle += 900;
649  AreaSize.x = m_Size.y;
650  AreaSize.y = m_Size.x;
651  }
652 
653  if( shortname_len > 0 ) // if there is a netname, provides room to display this netname
654  {
655  AreaSize.y /= 2; // Text used only the upper area of the
656  // pad. The lower area displays the net name
657  tpos.y -= AreaSize.y / 2;
658  }
659 
660  // Calculate the position of text, that is the middle point of the upper
661  // area of the pad
662  RotatePoint( &tpos, shape_pos, angle );
663 
664  // Draw text with an angle between -90 deg and + 90 deg
665  double t_angle = angle;
666  NORMALIZE_ANGLE_90( t_angle );
667 
668  /* Note: in next calculations, texte size is calculated for 3 or more
669  * chars. Of course, pads numbers and nets names can have less than 3
670  * chars. but after some tries, i found this is gives the best look
671  */
672  constexpr int MIN_CHAR_COUNT = 3;
673 
674  unsigned int tsize;
675  EDA_RECT* clipBox = aDrawInfo.m_DrawPanel?
676  aDrawInfo.m_DrawPanel->GetClipBox() : NULL;
677 
678  if( aDrawInfo.m_Display_padnum )
679  {
680  int numpad_len = std::max( (int) m_name.Length(), MIN_CHAR_COUNT );
681  tsize = std::min( (int) AreaSize.y, AreaSize.x / numpad_len );
682 
683  if( aDC->LogicalToDeviceXRel( tsize ) >= MIN_TEXT_SIZE ) // Not drawable when size too small.
684  {
685  // tsize reserve room for marges and segments thickness
686  tsize = ( tsize * 7 ) / 10;
687  DrawGraphicHaloText( clipBox, aDC, tpos,
688  aDrawInfo.m_Color, BLACK, WHITE,
689  m_name, t_angle,
690  wxSize( tsize , tsize ), GR_TEXT_HJUSTIFY_CENTER,
691  GR_TEXT_VJUSTIFY_CENTER, tsize / 7, false, false );
692 
693  }
694  }
695 
696  // display the short netname, if exists
697  if( shortname_len == 0 )
698  return;
699 
700  shortname_len = std::max( shortname_len, MIN_CHAR_COUNT );
701  tsize = std::min( AreaSize.y, AreaSize.x / shortname_len );
702 
703  if( aDC->LogicalToDeviceXRel( tsize ) >= MIN_TEXT_SIZE ) // Not drawable in size too small.
704  {
705  tpos = tpos0;
706 
707  if( aDrawInfo.m_Display_padnum )
708  tpos.y += AreaSize.y / 2;
709 
710  RotatePoint( &tpos, shape_pos, angle );
711 
712  // tsize reserve room for marges and segments thickness
713  tsize = ( tsize * 7 ) / 10;
714  DrawGraphicHaloText( clipBox, aDC, tpos,
715  aDrawInfo.m_Color, BLACK, WHITE,
716  GetShortNetname(), t_angle,
717  wxSize( tsize, tsize ), GR_TEXT_HJUSTIFY_CENTER,
718  GR_TEXT_VJUSTIFY_CENTER, tsize / 7, false, false );
719  }
720 }
Definition: colors.h:57
void DrawGraphicHaloText(EDA_RECT *aClipBox, wxDC *aDC, const wxPoint &aPos, const COLOR4D aBgColor, COLOR4D aColor1, COLOR4D aColor2, const wxString &aText, double aOrient, const wxSize &aSize, enum EDA_TEXT_HJUSTIFY_T aH_justify, enum EDA_TEXT_VJUSTIFY_T aV_justify, int aWidth, bool aItalic, bool aBold, void(*aCallback)(int x0, int y0, int xf, int yf), PLOTTER *aPlotter)
Draw graphic text with a border, so that it can be read on different backgrounds. ...
Definition: drawtxt.cpp:176
static int m_PadSketchModePenSize
Pen size used to draw pads in sketch mode (mode used to print pads on silkscreen layer) ...
Definition: class_pad.h:122
PAD_SHAPE_T GetAnchorPadShape() const
Function GetAnchorPadShape.
Definition: class_pad.h:211
bool m_Display_padnum
Definition: class_pad.h:73
void GRSetDrawMode(wxDC *DC, GR_DRAWMODE draw_mode)
Definition: gr_basic.cpp:290
void BuildPadPolygon(wxPoint aCoord[4], wxSize aInflateValue, double aRotation) const
Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Co...
int PointCount() const
Function PointCount()
void GRLine(EDA_RECT *ClipBox, wxDC *DC, int x1, int y1, int x2, int y2, int width, COLOR4D Color)
Definition: gr_basic.cpp:352
void TransformRoundRectToPolygon(SHAPE_POLY_SET &aCornerBuffer, const wxPoint &aPosition, const wxSize &aSize, double aRotation, int aCornerRadius, int aCircleToSegmentsCount)
Function TransformRoundRectToPolygon convert a rectangle with rounded corners to a polygon Convert ar...
int GetRoundRectCornerRadius() const
Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.
Definition: class_pad.h:493
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
#define SEGCOUNT
void GRCSegm(EDA_RECT *ClipBox, wxDC *DC, int x1, int y1, int x2, int y2, int width, int aPenSize, COLOR4D Color)
Definition: gr_basic.cpp:481
PAD_DRILL_SHAPE_T GetDrillShape() const
Definition: class_pad.h:363
bool m_ShowNCMark
Definition: class_pad.h:77
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
int OutlineCount() const
Returns the number of outlines in the set
void GRFilledCircle(EDA_RECT *ClipBox, wxDC *DC, int x, int y, int r, int width, COLOR4D Color, COLOR4D BgColor)
Definition: gr_basic.cpp:833
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
void NORMALIZE_ANGLE_90(T &Angle)
Definition: trigo.h:277
void GRClosedPoly(EDA_RECT *ClipBox, wxDC *DC, int n, wxPoint Points[], bool Fill, COLOR4D Color, COLOR4D BgColor)
Function GRClosedPoly draws a closed polygon onto the drawing context aDC and optionally fills and/or...
Definition: gr_basic.cpp:777
bool m_IsPrinting
Definition: class_pad.h:80
wxString m_name
Definition: class_pad.h:733
void TransformShapeWithClearanceToPolygon(SHAPE_POLY_SET &aCornerBuffer, int aClearanceValue, int aCircleToSegmentsCount, double aCorrectionFactor) const
Function TransformShapeWithClearanceToPolygon Convert the pad shape to a closed polygon Used in filli...
void CustomShapeAsPolygonToBoardPosition(SHAPE_POLY_SET *aMergedPolygon, wxPoint aPosition, double aRotation) const
When created, the corners coordinates are relative to the pad position, orientation 0...
void Inflate(int aFactor, int aCircleSegmentsCount)
Performs outline inflation/deflation, using round corners.
#define MIN_TEXT_SIZE
Definition: drawtxt.h:43
void GRForceBlackPen(bool flagforce)
Function GRForceBlackPen.
Definition: gr_basic.cpp:271
Class SHAPE_POLY_SET.
SHAPE_LINE_CHAIN & Outline(int aIndex)
Returns the reference to aIndex-th outline in the set
void GRFillCSegm(EDA_RECT *ClipBox, wxDC *DC, int x1, int y1, int x2, int y2, int width, COLOR4D Color)
Definition: gr_basic.cpp:584
GR_DRAWMODE m_DrawMode
Definition: class_pad.h:66
const wxPoint & GetPosition() const override
Definition: class_pad.h:205
EDA_DRAW_PANEL * m_DrawPanel
Definition: class_pad.h:65
COLOR4D m_HoleColor
Definition: class_pad.h:69
const wxSize & GetSize() const
Definition: class_pad.h:254
EDA_RECT * GetClipBox()
bool m_ShowNotPlatedHole
Definition: class_pad.h:78
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
int m_PadClearance
Definition: class_pad.h:71
int GetNetCode() const
Function GetNetCode.
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
int BuildSegmentFromOvalShape(wxPoint &aSegStart, wxPoint &aSegEnd, double aRotation, const wxSize &aMargin) const
Function BuildSegmentFromOvalShape Has meaning only for OVAL (and ROUND) pads Build an equivalent seg...
wxPoint m_Offset
Definition: class_pad.h:81
void GetOblongDrillGeometry(wxPoint &aStartPoint, wxPoint &aEndPoint, int &aWidth) const
Function GetOblongDrillGeometry calculates the start point, end point and width of an equivalent segm...
Definition: class_pad.cpp:749
#define max(a, b)
Definition: auxiliary.h:86
Class SHAPE_LINE_CHAIN.
void GRFilledSegment(EDA_RECT *aClipBox, wxDC *aDC, wxPoint aStart, wxPoint aEnd, int aWidth, COLOR4D aColor)
Definition: gr_basic.cpp:592
static DIRECTION_45::AngleType angle(const VECTOR2I &a, const VECTOR2I &b)
void GRCircle(EDA_RECT *ClipBox, wxDC *DC, int xc, int yc, int r, int width, COLOR4D Color)
Definition: gr_basic.cpp:791
void RemoveAllContours()
Removes all outlines & holes (clears) the polygon set.
double GetOrientation() const
Function GetOrientation returns the rotation angle of the pad in tenths of degrees, but soon degrees.
Definition: class_pad.h:357
Class EDA_RECT handles the component boundary box.
void GetRoundRectCornerCenters(wxPoint aCenters[4], int aRadius, const wxPoint &aPosition, const wxSize &aSize, double aRotation)
Helper function GetRoundRectCornerCenters Has meaning only for rounded rect Returns the centers of th...
Definition: colors.h:49
wxPoint ShapePos() const
Definition: class_pad.cpp:500
bool m_ShowPadFilled
Definition: class_pad.h:75
COLOR4D m_NPHoleColor
Definition: class_pad.h:70
COLOR4D m_Color
Definition: class_pad.h:67
VECTOR2I & Point(int aIndex)
Function Point()
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
Definition: colors.h:45
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
bool m_Display_netname
Definition: class_pad.h:74
bool GetGRForceBlackPenState(void)
Function GetGRForceBlackPenState.
Definition: gr_basic.cpp:281
wxSize m_Mask_margin
Definition: class_pad.h:72
#define min(a, b)
Definition: auxiliary.h:85
wxPoint m_Pos
pad Position on board
Definition: class_pad.h:735
int Append(int x, int y, int aOutline=-1, int aHole=-1, bool aAllowDuplication=false)
Appends a vertex at the end of the given outline/hole (default: the last outline) ...
Class COLOR4D is the color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:39
const wxString & GetShortNetname() const
Function GetShortNetname.
D_PAD* D_PAD::Duplicate ( ) const
inline

same as Clone, but returns a D_PAD item.

Useful mainly for pythons scripts, because Clone (virtual function) returns an EDA_ITEM.

Definition at line 688 of file class_pad.h.

References Clone().

689  {
690  return (D_PAD*) Clone();
691  }
EDA_ITEM * Clone() const override
Function Clone creates a duplicate of this item with linked list members set to NULL.
Definition: class_pad.cpp:1208
void D_PAD::Flip ( const wxPoint aCentre)
overridevirtual

Function Flip Flip this object, i.e.

change the board side for this object

Parameters
aCentre- the rotation point.

Reimplemented from BOARD_ITEM.

Definition at line 408 of file class_pad.cpp.

References FlipLayerMask(), FlipPrimitives(), GetOrientation(), GetPosition(), m_DeltaSize, m_layerMask, m_Offset, m_Pos0, MIRROR(), SetLayerSet(), SetOrientation(), SetY(), and wxPoint::y.

409 {
410  int y = GetPosition().y;
411  MIRROR( y, aCentre.y ); // invert about x axis.
412  SetY( y );
413 
414  MIRROR( m_Pos0.y, 0 );
415  MIRROR( m_Offset.y, 0 );
416  MIRROR( m_DeltaSize.y, 0 );
417 
419 
420  // flip pads layers
421  // PADS items are currently on all copper layers, or
422  // currently, only on Front or Back layers.
423  // So the copper layers count is not taken in account
425 
426  // Flip the basic shapes, in custom pads
427  FlipPrimitives();
428 
429  // m_boundingRadius = -1; the shape has not been changed
430 }
LSET FlipLayerMask(LSET aMask, int aCopperLayersCount)
Calculate the mask layer when flipping a footprint BACK and FRONT copper layers, mask, paste, solder layers are swapped internal layers are flipped only if the copper layers count is known.
Definition: lset.cpp:491
void FlipPrimitives()
Flip the basic shapes, in custom pads.
Definition: class_pad.cpp:434
void MIRROR(T &aPoint, const T &aMirrorRef)
Definition: macros.h:111
const wxPoint & GetPosition() const override
Definition: class_pad.h:205
wxSize m_DeltaSize
delta on rectangular shapes
Definition: class_pad.h:797
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
void SetLayerSet(LSET aLayerMask)
Definition: class_pad.h:376
void SetY(int y)
Definition: class_pad.h:244
wxPoint m_Pos0
Initial Pad position (i.e.
Definition: class_pad.h:799
double GetOrientation() const
Function GetOrientation returns the rotation angle of the pad in tenths of degrees, but soon degrees.
Definition: class_pad.h:357
void SetOrientation(double aAngle)
Function SetOrientation sets the rotation angle of the pad.
Definition: class_pad.cpp:401
wxPoint m_Offset
m_Offset is useful only for oblong and rect pads (it can be used for other shapes, but without any interest).
Definition: class_pad.h:791
void D_PAD::FlipPrimitives ( )

Flip the basic shapes, in custom pads.

Definition at line 434 of file class_pad.cpp.

References PAD_CS_PRIMITIVE::m_ArcAngle, m_basicShapes, m_customShapeAsPolygon, PAD_CS_PRIMITIVE::m_End, PAD_CS_PRIMITIVE::m_Poly, PAD_CS_PRIMITIVE::m_Shape, PAD_CS_PRIMITIVE::m_Start, MIRROR(), SHAPE_POLY_SET::Outline(), SHAPE_POLY_SET::OutlineCount(), SHAPE_LINE_CHAIN::Point(), SHAPE_LINE_CHAIN::PointCount(), S_POLYGON, wxPoint::y, and VECTOR2< T >::y.

Referenced by Flip(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

435 {
436  // Flip custom shapes
437  for( unsigned ii = 0; ii < m_basicShapes.size(); ++ii )
438  {
439  PAD_CS_PRIMITIVE& primitive = m_basicShapes[ii];
440 
441  MIRROR( primitive.m_Start.y, 0 );
442  MIRROR( primitive.m_End.y, 0 );
443  primitive.m_ArcAngle = -primitive.m_ArcAngle;
444 
445  switch( primitive.m_Shape )
446  {
447  case S_POLYGON: // polygon
448  for( unsigned jj = 0; jj < primitive.m_Poly.size(); jj++ )
449  MIRROR( primitive.m_Poly[jj].y, 0 );
450  break;
451 
452  default:
453  break;
454  }
455  }
456 
457  // Flip local coordinates in merged Polygon
458  for( int cnt = 0; cnt < m_customShapeAsPolygon.OutlineCount(); ++cnt )
459  {
461 
462  for( int ii = 0; ii < poly.PointCount(); ++ii )
463  MIRROR( poly.Point( ii ).y, 0 );
464  }
465 }
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
int PointCount() const
Function PointCount()
wxPoint m_Start
angle of an arc, from its starting point, in 0.1 deg
Definition: class_pad.h:98
polygon (not yet used for tracks, but could be in microwave apps)
int OutlineCount() const
Returns the number of outlines in the set
void MIRROR(T &aPoint, const T &aMirrorRef)
Definition: macros.h:111
std::vector< wxPoint > m_Poly
is also the start point of the arc
Definition: class_pad.h:100
SHAPE_LINE_CHAIN & Outline(int aIndex)
Returns the reference to aIndex-th outline in the set
Helper class to handle a primitive (basic shape: polygon, segment, circle or arc) to build a custom p...
Definition: class_pad.h:89
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
wxPoint m_End
is also the center of the circle and arc
Definition: class_pad.h:99
STROKE_T m_Shape
Definition: class_pad.h:92
Class SHAPE_LINE_CHAIN.
VECTOR2I & Point(int aIndex)
Function Point()
double m_ArcAngle
radius of a circle
Definition: class_pad.h:97
std::string BOARD_ITEM::FormatAngle ( double  aAngle)
staticinherited

Function FormatAngle converts aAngle from board units to a string appropriate for writing to file.

Note
Internal angles for board items can be either degrees or tenths of degree on how KiCad is built.
Parameters
aAngleA angle value to convert.
Returns
A std::string object containing the converted angle.

Definition at line 170 of file class_board_item.cpp.

171 {
172  char temp[50];
173 
174  int len = snprintf( temp, sizeof(temp), "%.10g", aAngle / 10.0 );
175 
176  return std::string( temp, len );
177 }
std::string BOARD_ITEM::FormatInternalUnits ( int  aValue)
staticinherited

Function FormatInternalUnits converts aValue from board internal units to a string appropriate for writing to file.

Note
Internal units for board items can be either deci-mils or nanometers depending on how KiCad is build.
Parameters
aValueA coordinate value to convert.
Returns
A std::string object containing the converted value.

Definition at line 89 of file class_board_item.cpp.

Referenced by checkConnectedTo(), ConvertOutlineToPolygon(), BOARD_ITEM::FormatInternalUnits(), and BOARD::TracksInNetBetweenPoints().

90 {
91 #if 1
92 
93  char buf[50];
94  int len;
95  double mm = aValue / IU_PER_MM;
96 
97  if( mm != 0.0 && fabs( mm ) <= 0.0001 )
98  {
99  len = sprintf( buf, "%.10f", mm );
100 
101  while( --len > 0 && buf[len] == '0' )
102  buf[len] = '\0';
103 
104  if( buf[len] == '.' )
105  buf[len] = '\0';
106  else
107  ++len;
108  }
109  else
110  {
111  len = sprintf( buf, "%.10g", mm );
112  }
113 
114  return std::string( buf, len );
115 
116 #else
117 
118  // Assume aValue is in nanometers, and that we want the result in millimeters,
119  // and that int is 32 bits wide. Then perform an alternative algorithm.
120  // Can be used to verify that the above algorithm is correctly generating text.
121  // Convert aValue into an integer string, then insert a decimal point manually.
122  // Results are the same as above general purpose algorithm.
123 
124  wxASSERT( sizeof(int) == 4 );
125 
126  if( aValue == 0 )
127  return std::string( 1, '0' );
128  else
129  {
130  char buf[50];
131  int len = sprintf( buf, aValue > 0 ? "%06d" : "%07d", aValue ); // optionally pad w/leading zeros
132 
133  std::string ret( buf, len );
134 
135  std::string::iterator it = ret.end() - 1; // last byte
136 
137  // insert '.' at 6 positions from end, dividing by 10e6 (a million), nm => mm
138  std::string::iterator decpoint = ret.end() - 6;
139 
140  // truncate trailing zeros, up to decimal point position
141  for( ; *it=='0' && it >= decpoint; --it )
142  ret.erase( it ); // does not invalidate iterators it or decpoint
143 
144  if( it >= decpoint )
145  {
146  ret.insert( decpoint, '.' );
147 
148  // decpoint is invalidated here, after insert()
149 
150 #if 1 // want a leading zero when decimal point is in first position?
151  if( ret[0] == '.' )
152  {
153  // insert leading zero ahead of decimal point.
154  ret.insert( ret.begin(), '0' );
155  }
156  else if( ret[0]=='-' && ret[1]=='.' )
157  {
158  ret.insert( ret.begin() + 1, '0' );
159  }
160 #endif
161  }
162 
163  return ret;
164  }
165 
166 #endif
167 }
std::string BOARD_ITEM::FormatInternalUnits ( const wxPoint aPoint)
staticinherited

Definition at line 180 of file class_board_item.cpp.

References BOARD_ITEM::FormatInternalUnits(), wxPoint::x, and wxPoint::y.

181 {
182  return FormatInternalUnits( aPoint.x ) + " " + FormatInternalUnits( aPoint.y );
183 }
static std::string FormatInternalUnits(int aValue)
Function FormatInternalUnits converts aValue from board internal units to a string appropriate for wr...
std::string BOARD_ITEM::FormatInternalUnits ( const wxSize &  aSize)
staticinherited

Definition at line 186 of file class_board_item.cpp.

References BOARD_ITEM::FormatInternalUnits().

187 {
188  return FormatInternalUnits( aSize.GetWidth() ) + " " + FormatInternalUnits( aSize.GetHeight() );
189 }
static std::string FormatInternalUnits(int aValue)
Function FormatInternalUnits converts aValue from board internal units to a string appropriate for wr...
PAD_SHAPE_T D_PAD::GetAnchorPadShape ( ) const
inline

Function GetAnchorPadShape.

Returns
the shape of the anchor pad shape, for custom shaped pads.

Definition at line 211 of file class_pad.h.

References m_anchorPadShape.

Referenced by DrawShape(), PCB_IO::format(), PCB_BASE_FRAME::Import_Pad_Settings(), ImportSettingsFromMaster(), DIALOG_PAD_PROPERTIES::initValues(), MergePrimitivesAsPolygon(), DIALOG_PAD_PROPERTIES::TransferDataFromWindow(), and DIALOG_PAD_PROPERTIES::transferDataToPad().

211 { return m_anchorPadShape; }
PAD_SHAPE_T m_anchorPadShape
for custom shaped pads: shape of pad anchor, PAD_SHAPE_RECT, PAD_SHAPE_CIRCLE
Definition: class_pad.h:774
BOARD * BOARD_ITEM::GetBoard ( ) const
virtualinherited

Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.

Definition at line 63 of file class_board_item.cpp.

References BOARD_ITEM::GetBoard(), BOARD_ITEM::GetParent(), PCB_T, and EDA_ITEM::Type().

Referenced by ZONE_CONTAINER::buildFeatureHoleList(), DeleteMarkedItems(), TEXTE_PCB::Draw(), PCB_TARGET::Draw(), EDGE_MODULE::Draw(), ZONE_CONTAINER::Draw(), TEXTE_MODULE::Draw(), TRACK::Draw(), DRAWSEGMENT::Draw(), DIMENSION::Draw(), MODULE::Draw(), SEGZONE::Draw(), VIA::Draw(), Draw(), MODULE::DrawAncre(), ZONE_CONTAINER::DrawFilledArea(), BOARD_PRINTOUT_CONTROLLER::DrawPage(), EVT_COMMAND_RANGE(), TEXTE_PCB::Flip(), TRACK::Flip(), VIA::Flip(), ZONE_CONTAINER::Flip(), BOARD_ITEM::GetBoard(), MODULE::GetBoundingBox(), BOARD_ITEM::GetLayerName(), TRACK::GetMsgPanelInfo(), NETINFO_ITEM::GetMsgPanelInfo(), GetMsgPanelInfo(), TRACK::GetMsgPanelInfoBase(), SEGZONE::GetMsgPanelInfoBase(), VIA::GetMsgPanelInfoBase(), TRACK::GetMsgPanelInfoBase_Common(), BOARD_CONNECTED_ITEM::GetNetClass(), TRACK::GetSelectMenuText(), SEGZONE::GetSelectMenuText(), VIA::GetSelectMenuText(), ZONE_CONTAINER::GetSelectMenuText(), GetSelectMenuText(), GetSolderMaskMargin(), GetSolderPasteMargin(), PushTrack(), BOARD_CONNECTED_ITEM::SetNet(), BOARD_CONNECTED_ITEM::SetNetCode(), and VIA::ViewGetLOD().

64 {
65  if( Type() == PCB_T )
66  return (BOARD*) this;
67 
68  BOARD_ITEM* parent = GetParent();
69 
70  if( parent )
71  return parent->GetBoard();
72 
73  return NULL;
74 }
KICAD_T Type() const
Function Type()
Definition: base_struct.h:212
BOARD_ITEM_CONTAINER * GetParent() const
Definition: typeinfo.h:97
Class BOARD_ITEM is a base class for any item which can be embedded within the BOARD container class...
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
const EDA_RECT D_PAD::GetBoundingBox ( ) const
overridevirtual

Function GetBoundingBox returns the orthogonal, bounding box of this object for display purposes.

This box should be an enclosing perimeter for visible components of this object, and the units should be in the pcb or schematic coordinate system. It is OK to overestimate the size by a few counts.

Reimplemented from EDA_ITEM.

Definition at line 199 of file class_pad.cpp.

References abs, SHAPE_POLY_SET::COutline(), SHAPE_LINE_CHAIN::CPoint(), CustomShapeAsPolygonToBoardPosition(), EDA_RECT::GetBoundingBoxRotated(), GetOrientation(), GetPosition(), GetShape(), EDA_RECT::Inflate(), m_customShapeAsPolygon, m_DeltaSize, m_Orient, m_Pos, m_Size, max, EDA_RECT::Merge(), min, SHAPE_POLY_SET::OutlineCount(), PAD_SHAPE_CIRCLE, PAD_SHAPE_CUSTOM, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, SHAPE_LINE_CHAIN::PointCount(), RotatePoint(), EDA_RECT::SetEnd(), EDA_RECT::SetOrigin(), EDA_RECT::SetSize(), ShapePos(), wxPoint::x, VECTOR2< T >::x, wxPoint::y, and VECTOR2< T >::y.

Referenced by CreateThermalReliefPadPolygon(), HitTest(), PCB_BASE_FRAME::Import_Pad_Settings(), PCB_EDIT_FRAME::moveExact(), DIALOG_PAD_PROPERTIES::TransferDataFromWindow(), and ViewBBox().

200 {
201  EDA_RECT area;
202  wxPoint quadrant1, quadrant2, quadrant3, quadrant4;
203  int x, y, r, dx, dy;
204 
205  wxPoint center = ShapePos();
206  wxPoint endPoint;
207 
208  EDA_RECT endRect;
209 
210  switch( GetShape() )
211  {
212  case PAD_SHAPE_CIRCLE:
213  area.SetOrigin( center );
214  area.Inflate( m_Size.x / 2 );
215  break;
216 
217  case PAD_SHAPE_OVAL:
218  /* To get the BoundingBox of an oval pad:
219  * a) If the pad is ROUND, see method for PAD_SHAPE_CIRCLE above
220  * OTHERWISE:
221  * b) Construct EDA_RECT for portion between circular ends
222  * c) Rotate that EDA_RECT
223  * d) Add the circular ends to the EDA_RECT
224  */
225 
226  // Test if the shape is circular
227  if( m_Size.x == m_Size.y )
228  {
229  area.SetOrigin( center );
230  area.Inflate( m_Size.x / 2 );
231  break;
232  }
233 
234  if( m_Size.x > m_Size.y )
235  {
236  // Pad is horizontal
237  dx = ( m_Size.x - m_Size.y ) / 2;
238  dy = m_Size.y / 2;
239 
240  // Location of end-points
241  x = dx;
242  y = 0;
243  r = dy;
244  }
245  else
246  {
247  // Pad is vertical
248  dx = m_Size.x / 2;
249  dy = ( m_Size.y - m_Size.x ) / 2;
250 
251  x = 0;
252  y = dy;
253  r = dx;
254  }
255 
256  // Construct the center rectangle and rotate
257  area.SetOrigin( center );
258  area.Inflate( dx, dy );
259  area = area.GetBoundingBoxRotated( center, m_Orient );
260 
261  endPoint = wxPoint( x, y );
262  RotatePoint( &endPoint, m_Orient );
263 
264  // Add points at each quadrant of circular regions
265  endRect.SetOrigin( center + endPoint );
266  endRect.Inflate( r );
267 
268  area.Merge( endRect );
269 
270  endRect.SetSize( 0, 0 );
271  endRect.SetOrigin( center - endPoint );
272  endRect.Inflate( r );
273 
274  area.Merge( endRect );
275 
276  break;
277 
278  case PAD_SHAPE_RECT:
279  case PAD_SHAPE_ROUNDRECT:
280  // Use two opposite corners and track their rotation
281  // (use symmetry for other points)
282  quadrant1.x = m_Size.x/2;
283  quadrant1.y = m_Size.y/2;
284  quadrant2.x = -m_Size.x/2;
285  quadrant2.y = m_Size.y/2;
286 
287  RotatePoint( &quadrant1, m_Orient );
288  RotatePoint( &quadrant2, m_Orient );
289  dx = std::max( std::abs( quadrant1.x ) , std::abs( quadrant2.x ) );
290  dy = std::max( std::abs( quadrant1.y ) , std::abs( quadrant2.y ) );
291 
292  // Set the bbox
293  area.SetOrigin( ShapePos() );
294  area.Inflate( dx, dy );
295  break;
296 
297  case PAD_SHAPE_TRAPEZOID:
298  // Use the four corners and track their rotation
299  // (Trapezoids will not be symmetric)
300 
301  quadrant1.x = (m_Size.x + m_DeltaSize.y)/2;
302  quadrant1.y = (m_Size.y - m_DeltaSize.x)/2;
303 
304  quadrant2.x = -(m_Size.x + m_DeltaSize.y)/2;
305  quadrant2.y = (m_Size.y + m_DeltaSize.x)/2;
306 
307  quadrant3.x = -(m_Size.x - m_DeltaSize.y)/2;
308  quadrant3.y = -(m_Size.y + m_DeltaSize.x)/2;
309 
310  quadrant4.x = (m_Size.x - m_DeltaSize.y)/2;
311  quadrant4.y = -(m_Size.y - m_DeltaSize.x)/2;
312 
313  RotatePoint( &quadrant1, m_Orient );
314  RotatePoint( &quadrant2, m_Orient );
315  RotatePoint( &quadrant3, m_Orient );
316  RotatePoint( &quadrant4, m_Orient );
317 
318  x = std::min( quadrant1.x, std::min( quadrant2.x, std::min( quadrant3.x, quadrant4.x) ) );
319  y = std::min( quadrant1.y, std::min( quadrant2.y, std::min( quadrant3.y, quadrant4.y) ) );
320  dx = std::max( quadrant1.x, std::max( quadrant2.x, std::max( quadrant3.x, quadrant4.x) ) );
321  dy = std::max( quadrant1.y, std::max( quadrant2.y, std::max( quadrant3.y, quadrant4.y) ) );
322 
323  area.SetOrigin( ShapePos().x + x, ShapePos().y + y );
324  area.SetSize( dx-x, dy-y );
325  break;
326 
327  case PAD_SHAPE_CUSTOM:
328  {
330  // Move shape to actual position
332  quadrant1 = m_Pos;
333  quadrant2 = m_Pos;
334 
335  for( int cnt = 0; cnt < polySet.OutlineCount(); ++cnt )
336  {
337  const SHAPE_LINE_CHAIN& poly = polySet.COutline( cnt );
338 
339  for( int ii = 0; ii < poly.PointCount(); ++ii )
340  {
341  quadrant1.x = std::min( quadrant1.x, poly.CPoint( ii ).x );
342  quadrant1.y = std::min( quadrant1.y, poly.CPoint( ii ).y );
343  quadrant2.x = std::max( quadrant2.x, poly.CPoint( ii ).x );
344  quadrant2.y = std::max( quadrant2.y, poly.CPoint( ii ).y );
345  }
346  }
347 
348  area.SetOrigin( quadrant1 );
349  area.SetEnd( quadrant2 );
350  }
351  break;
352 
353  default:
354  break;
355  }
356 
357  return area;
358 }
void Merge(const EDA_RECT &aRect)
Function Merge modifies the position and size of the rectangle in order to contain aRect...
int PointCount() const
Function PointCount()
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
void SetOrigin(const wxPoint &pos)
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
#define abs(a)
Definition: auxiliary.h:84
void CustomShapeAsPolygonToBoardPosition(SHAPE_POLY_SET *aMergedPolygon, wxPoint aPosition, double aRotation) const
When created, the corners coordinates are relative to the pad position, orientation 0...
Class SHAPE_POLY_SET.
const wxPoint & GetPosition() const override
Definition: class_pad.h:205
void SetEnd(int x, int y)
const EDA_RECT GetBoundingBoxRotated(wxPoint aRotCenter, double aAngle)
Function GetBoundingBoxRotated.
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
wxSize m_DeltaSize
delta on rectangular shapes
Definition: class_pad.h:797
void SetSize(const wxSize &size)
#define max(a, b)
Definition: auxiliary.h:86
Class SHAPE_LINE_CHAIN.
double GetOrientation() const
Function GetOrientation returns the rotation angle of the pad in tenths of degrees, but soon degrees.
Definition: class_pad.h:357
Class EDA_RECT handles the component boundary box.
wxPoint ShapePos() const
Definition: class_pad.cpp:500
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
const VECTOR2I & CPoint(int aIndex) const
Function CPoint()
EDA_RECT & Inflate(wxCoord dx, wxCoord dy)
Function Inflate inflates the rectangle horizontally by dx and vertically by dy.
#define min(a, b)
Definition: auxiliary.h:85
wxPoint m_Pos
pad Position on board
Definition: class_pad.h:735
int D_PAD::GetBoundingRadius ( ) const
inline

Function GetBoundingRadius returns the radius of a minimum sized circle which fully encloses this pad.

The center is the pad position

Definition at line 568 of file class_pad.h.

References boundingRadius(), and m_boundingRadius.

Referenced by DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), HitTest(), DIALOG_PAD_PROPERTIES::OnPaintShowPanel(), and DRC::testPad2Pad().

569  {
570  // Any member function which would affect this calculation should set
571  // m_boundingRadius to -1 to re-trigger the calculation from here.
572  // Currently that is only m_Size, m_DeltaSize, and m_padShape accessors.
573  if( m_boundingRadius == -1 )
574  {
576  }
577 
578  return m_boundingRadius;
579  }
int m_boundingRadius
radius of the circle containing the pad shape
Definition: class_pad.h:731
int boundingRadius() const
Function boundingRadius returns a calculated radius of a bounding circle for this pad...
Definition: class_pad.cpp:133
virtual const wxPoint BOARD_ITEM::GetCenter ( ) const
inlinevirtualinherited

Function GetCenter()

This defaults to the same point as returned by GetPosition(), unless overridden

Returns
centre point of the item

Reimplemented in DRAWSEGMENT.

Definition at line 105 of file class_board_item.h.

References BOARD_ITEM::GetPosition().

Referenced by LEGACY_ARRAY_CREATOR::getRotationCentre(), and DIALOG_CREATE_ARRAY::ARRAY_CIRCULAR_OPTIONS::TransformItem().

105 { return GetPosition(); }
virtual const wxPoint & GetPosition() const =0
wxString D_PAD::GetClass ( ) const
inlineoverridevirtual

Function GetClass returns the class name.

Returns
wxString

Implements EDA_ITEM.

Definition at line 628 of file class_pad.h.

629  {
630  return wxT( "PAD" );
631  }
int D_PAD::GetClearance ( BOARD_CONNECTED_ITEM aItem = NULL) const
overridevirtual

Function GetClearance returns the clearance in internal units.

If aItem is not NULL then the returned clearance is the greater of this object's clearance and aItem's clearance. If aItem is NULL, then this objects clearance is returned.

Parameters
aItemis another BOARD_CONNECTED_ITEM or NULL
Returns
int - the clearance in internal units.

Reimplemented from BOARD_CONNECTED_ITEM.

Definition at line 546 of file class_pad.cpp.

References BOARD_CONNECTED_ITEM::GetClearance(), MODULE::GetLocalClearance(), GetLocalClearance(), GetParent(), m_LocalClearance, and max.

Referenced by ZONE_CONTAINER::buildFeatureHoleList(), DRC::checkClearancePadToPad(), KIGFX::PCB_PAINTER::draw(), Draw(), genModuleOnRoutingMatrix(), DRC::testPad2Pad(), and DRC::testTexts().

547 {
548  // A pad can have specific clearance parameters that
549  // overrides its NETCLASS clearance value
550  int clearance = m_LocalClearance;
551 
552  if( clearance == 0 )
553  {
554  // If local clearance is 0, use the parent footprint clearance value
555  if( GetParent() && GetParent()->GetLocalClearance() )
556  clearance = GetParent()->GetLocalClearance();
557  }
558 
559  if( clearance == 0 ) // If the parent footprint clearance value = 0, use NETCLASS value
560  return BOARD_CONNECTED_ITEM::GetClearance( aItem );
561 
562  // We have a specific clearance.
563  // if aItem, return the biggest clearance
564  if( aItem )
565  {
566  int hisClearance = aItem->GetClearance();
567  return std::max( hisClearance, clearance );
568  }
569 
570  // Return the specific clearance.
571  return clearance;
572 }
int m_LocalClearance
Local clearance.
Definition: class_pad.h:811
int GetLocalClearance() const
Definition: class_module.h:179
MODULE * GetParent() const
Definition: class_pad.h:147
virtual int GetClearance(BOARD_CONNECTED_ITEM *aItem=NULL) const
Function GetClearance returns the clearance in internal units.
int GetLocalClearance() const
Definition: class_pad.h:388
#define max(a, b)
Definition: auxiliary.h:86
const SHAPE_POLY_SET& D_PAD::GetCustomShapeAsPolygon ( ) const
inline

Accessor to the custom shape as one polygon.

Definition at line 323 of file class_pad.h.

References m_customShapeAsPolygon.

Referenced by CINFO3D_VISU::buildPadShapePolygon(), DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), CINFO3D_VISU::createNewPadWithClearance(), KIGFX::PCB_PAINTER::draw(), and PNS_KICAD_IFACE::syncPad().

323 { return m_customShapeAsPolygon; }
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
CUST_PAD_SHAPE_IN_ZONE D_PAD::GetCustomShapeInZoneOpt ( ) const
inline
Returns
the option for the custom pad shape to use as clearance area in copper zones

Definition at line 217 of file class_pad.h.

References m_customShapeClearanceArea.

Referenced by PCB_IO::format(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

218  {
220  }
CUST_PAD_SHAPE_IN_ZONE m_customShapeClearanceArea
How to build the custom shape in zone, to create the clearance area: CUST_PAD_SHAPE_IN_ZONE_OUTLINE =...
Definition: class_pad.h:758
STATUS_FLAGS EDA_ITEM::GetFlags ( ) const
inlineinherited

Definition at line 269 of file base_struct.h.

References EDA_ITEM::m_Flags.

Referenced by AbortMoveAndEditTarget(), SCH_SCREEN::addConnectedItemsToBlock(), AddMenusForBitmap(), AddMenusForBusEntry(), AddMenusForComponent(), AddMenusForComponentField(), AddMenusForEditComponent(), AddMenusForGLabel(), AddMenusForHierchicalSheet(), AddMenusForHLabel(), AddMenusForLabel(), AddMenusForSheetPin(), AddMenusForText(), SCH_EDIT_FRAME::BeginSegment(), SCH_EDIT_FRAME::ChangeTextOrient(), Collect_TrackSegmentsToDrag(), SCH_EDIT_FRAME::ConvertPart(), DIALOG_EDIT_COMPONENT_IN_SCHEMATIC::copyPanelToOptions(), LIB_EDIT_FRAME::CreatePin(), PCB_EDIT_FRAME::createPopUpMenuForFootprints(), PCB_EDIT_FRAME::createPopUpMenuForFpPads(), PCB_EDIT_FRAME::createPopUpMenuForFpTexts(), PCB_EDIT_FRAME::createPopUpMenuForTexts(), PCB_EDIT_FRAME::createPopupMenuForTracks(), PCB_EDIT_FRAME::createPopUpMenuForZones(), PCB_EDIT_FRAME::Delete_Segment_Edge(), BOARD::Draw(), PCB_EDIT_FRAME::Edit_TrackSegm_Width(), SCH_EDIT_FRAME::EditComponentFieldText(), SCH_EDIT_FRAME::EditImage(), PCB_EDIT_FRAME::FlipTextePcb(), LIB_VIEW_FRAME::GeneralControl(), SCH_EDIT_FRAME::GeneralControl(), SCH_SCREEN::GetConnection(), InitialiseDragParameters(), EDA_DRAW_FRAME::isBusy(), LIB_EDIT_FRAME::LoadOneSymbol(), Magnetize(), SCH_EDIT_FRAME::MirrorImage(), SCH_EDIT_FRAME::MirrorSheet(), moveBitmap(), SCH_EDIT_FRAME::OnAutoplaceFields(), SCH_EDIT_FRAME::OnConvertTextType(), SCH_EDIT_FRAME::OnCopySchematicItemRequest(), SCH_EDIT_FRAME::OnDragItem(), SCH_EDIT_FRAME::OnEditItem(), LIB_EDIT_FRAME::OnEditPin(), FOOTPRINT_EDIT_FRAME::OnHotKey(), SCH_EDIT_FRAME::OnHotKey(), PCB_EDIT_FRAME::OnHotKey(), PCB_EDIT_FRAME::OnHotkeyBeginRoute(), PCB_EDIT_FRAME::OnHotkeyCopyItem(), PCB_EDIT_FRAME::OnHotkeyDeleteItem(), PCB_EDIT_FRAME::OnHotkeyDuplicateOrArrayItem(), PCB_EDIT_FRAME::OnHotkeyEditItem(), PCB_EDIT_FRAME::OnHotkeyFlipItem(), PCB_EDIT_FRAME::OnHotkeyMoveItem(), PCB_EDIT_FRAME::OnHotkeyPlaceItem(), PCB_EDIT_FRAME::OnHotkeyRotateItem(), FOOTPRINT_EDIT_FRAME::OnLeftClick(), SCH_EDIT_FRAME::OnLeftClick(), PCB_EDIT_FRAME::OnLeftClick(), FOOTPRINT_EDIT_FRAME::OnLeftDClick(), SCH_EDIT_FRAME::OnLeftDClick(), PCB_EDIT_FRAME::OnLeftDClick(), SCH_EDIT_FRAME::OnMoveItem(), DIALOG_EDIT_COMPONENT_IN_SCHEMATIC::OnOKButtonClick(), TARGET_PROPERTIES_DIALOG_EDITOR::OnOkClick(), SCH_EDIT_FRAME::OnOpenLibraryEditor(), SCH_EDIT_FRAME::OnOrient(), FOOTPRINT_EDIT_FRAME::OnRightClick(), GERBVIEW_FRAME::OnRightClick(), SCH_EDIT_FRAME::OnRightClick(), PCB_EDIT_FRAME::OnRightClick(), SCH_EDIT_FRAME::OnRotate(), SCH_EDIT_FRAME::OnSelectUnit(), PCB_EDIT_FRAME::PlaceTarget(), FOOTPRINT_EDIT_FRAME::PrepareItemForHotkey(), LIB_EDIT_FRAME::Process_Special_Functions(), EDIT_TOOL::Properties(), PCB_BASE_FRAME::Rotate_Module(), PCB_EDIT_FRAME::Rotate_Texte_Pcb(), SCH_EDIT_FRAME::RotateField(), SCH_EDIT_FRAME::RotateHierarchicalSheet(), SCH_EDIT_FRAME::RotateImage(), PCB_BASE_FRAME::RotateTextModule(), SCH_EDIT_FRAME::SaveCopyInUndoList(), SCH_SCREEN::SelectBlockItems(), SCH_EDIT_FRAME::SetBusEntryShape(), DIALOG_EDIT_COMPONENT_IN_SCHEMATIC::SetInitCmp(), Show_Drag_Track_Segment_With_Cte_Slope(), Show_MoveNode(), PCB_EDIT_FRAME::Start_DragTrackSegmentAndKeepSlope(), PCB_EDIT_FRAME::StartMoveOneNodeOrSegment(), DIALOG_LABEL_EDITOR::TextPropertiesAccept(), DIALOG_PCB_TEXT_PROPERTIES::TransferDataFromWindow(), and DIALOG_MODULE_BOARD_EDITOR::TransferDataFromWindow().

269 { return m_Flags; }
STATUS_FLAGS m_Flags
Flag bits for editing and other uses.
Definition: base_struct.h:189
PCB_LAYER_ID BOARD_ITEM::GetLayer ( ) const
inlineinherited

Function GetLayer returns the primary layer this item is on.

Definition at line 132 of file class_board_item.h.

References BOARD_ITEM::m_Layer.

Referenced by Abort_MoveOrCopyModule(), DIALOG_GLOBAL_DELETION::AcceptPcbDelete(), CINFO3D_VISU::AddGraphicsShapesWithClearanceToContainer(), DIMENSION::AdjustDimensionDetails(), PCB_EDIT_FRAME::Begin_DrawSegment(), PCB_EDIT_FRAME::Begin_Zone(), GRID_HELPER::BestSnapAnchor(), PCB_EDIT_FRAME::Block_SelectItems(), ZONE_CONTAINER::buildFeatureHoleList(), BuildUnconnectedThermalStubsPolygonList(), PCB_EDIT_FRAME::Change_Side_Module(), checkConnectedTo(), BOARD::CombineAllAreasInNet(), BOARD::ConvertBrdLayerToPolygonalContours(), MODULE::CopyNetlistSettings(), CreateBoardSection(), GERBER_JOBFILE_WRITER::CreateJobFile(), CINFO3D_VISU::createLayers(), MWAVE::CreateMicrowaveInductor(), CreateRoutesSection(), DIALOG_DIMENSION_EDITOR::DIALOG_DIMENSION_EDITOR(), DIALOG_TRACK_VIA_PROPERTIES::DIALOG_TRACK_VIA_PROPERTIES(), DRC::doEdgeZoneDrc(), PCB_EDIT_FRAME::DoGenFootprintsPositionFile(), DRC::doTrackKeepoutDrc(), TEXTE_MODULE::Draw(), DRAWSEGMENT::Draw(), KIGFX::PCB_PAINTER::draw(), DRAWING_TOOL::DrawVia(), PCB_EDIT_FRAME::duplicateZone(), FOOTPRINT_EDIT_FRAME::Edit_Edge_Layer(), PCB_EDIT_FRAME::Edit_Zone_Params(), PCB_EDIT_FRAME::End_Zone(), export_vrml_drawsegment(), export_vrml_edge_module(), export_vrml_module(), export_vrml_pcbtext(), export_vrml_text_module(), export_vrml_zones(), PCB_EDIT_FRAME::ExportToGenCAD(), TEXTE_PCB::Flip(), PCB_TARGET::Flip(), EDGE_MODULE::Flip(), TEXTE_MODULE::Flip(), TRACK::Flip(), DIMENSION::Flip(), MODULE::Flip(), DRAWSEGMENT::Flip(), ZONE_CONTAINER::Flip(), PCB_IO::FootprintSave(), FootprintWriteShape(), PCB_IO::formatLayer(), DSN::SPECCTRA_DB::FromBOARD(), genModuleOnRoutingMatrix(), genPlacementRoutingMatrix(), BOARD::GetFootprint(), getOptimalModulePlacement(), BOARD::GetPad(), BOARD::GetVisibleTrack(), SELECTION_TOOL::guessSelectionCandidates(), ZONE_CONTAINER::Hatch(), BOARD::HitTestForAnyFilledArea(), idf_export_module(), DIALOG_NON_COPPER_ZONES_EDITOR::Init(), DIALOG_MODULE_BOARD_EDITOR::InitBoardProperties(), GENERAL_COLLECTOR::Inspect(), IsFlipped(), MODULE::IsFlipped(), ZONE_CONTAINER::IsOnCopperLayer(), ZONE_CONTAINER::IsSame(), itemIsIncludedByFilter(), FOOTPRINT_EDIT_FRAME::Load_Module_From_BOARD(), BOARD::MarkTrace(), BOARD::NormalizeAreaPolygon(), BOARD::OnAreaPolygonModified(), PCB_EDIT_FRAME::OnRightClick(), ZONE_SETTINGS::operator<<(), PlaceCells(), PCB_EDIT_FRAME::PlaceDraggedOrMovedTrackSegment(), BRDITEMS_PLOTTER::Plot_1_EdgeModule(), BRDITEMS_PLOTTER::Plot_Edges_Modules(), BRDITEMS_PLOTTER::PlotAllTextsModule(), BRDITEMS_PLOTTER::PlotDimension(), BRDITEMS_PLOTTER::PlotDrawSegment(), BRDITEMS_PLOTTER::PlotFilledAreas(), BRDITEMS_PLOTTER::PlotPcbTarget(), PlotSilkScreen(), PlotSolderMaskLayer(), PlotStandardLayer(), BRDITEMS_PLOTTER::PlotTextePcb(), Print_Module(), PCB_EDIT_FRAME::PrintPage(), BOARD::RedrawAreasOutlines(), BOARD::RedrawFilledAreas(), PCB_EDIT_FRAME::Remove_Zone_Corner(), TRACKS_CLEANER::removeDuplicatesOfTrack(), SaveCopyOfZones(), SELECTION_TOOL::selectable(), ShowClearance(), PCB_EDIT_FRAME::Start_Move_Zone_Corner(), PCB_EDIT_FRAME::Start_Move_Zone_Drag_Outline_Edge(), PCB_EDIT_FRAME::Start_Move_Zone_Outlines(), PCB_EDIT_FRAME::Swap_Layers(), PNS_KICAD_IFACE::syncTrack(), BOARD::Test_Drc_Areas_Outlines_To_Areas_Outlines(), BOARD::TestAreaIntersection(), BOARD::TestAreaIntersections(), DRC::testKeepoutAreas(), TEXTE_MODULE::TEXTE_MODULE(), TraceSegmentPcb(), TrackListSortByNetcode(), DialogEditModuleText::TransferDataFromWindow(), DIALOG_GRAPHIC_ITEM_PROPERTIES::TransferDataFromWindow(), DIALOG_MODULE_BOARD_EDITOR::TransferDataFromWindow(), DialogEditModuleText::TransferDataToWindow(), DIALOG_PCB_TEXT_PROPERTIES::TransferDataToWindow(), DIALOG_GRAPHIC_ITEM_PROPERTIES::TransferDataToWindow(), DIALOG_MODEDIT_FP_BODY_ITEM_PROPERTIES::TransferDataToWindow(), CINFO3D_VISU::transformGraphicModuleEdgeToPolygonSet(), MODULE::TransformGraphicShapesWithClearanceToPolygonSet(), MODULE::TransformGraphicTextWithClearanceToPolygonSet(), TstModuleOnBoard(), TEXTE_MODULE::ViewGetLayers(), TRACK::ViewGetLayers(), and PCB_EDITOR_CONTROL::ZoneMerge().

132 { return m_Layer; }
PCB_LAYER_ID m_Layer
wxString BOARD_ITEM::GetLayerName ( ) const
inherited

Function GetLayerName returns the name of the PCB layer on which the item resides.

Returns
wxString containing the layer name associated with this item.

Definition at line 77 of file class_board_item.cpp.

References BOARD_ITEM::GetBoard(), BOARD::GetLayerName(), BOARD::GetStandardLayerName(), and BOARD_ITEM::m_Layer.

Referenced by PCB_IO::format(), PCB_IO::formatLayer(), TEXTE_PCB::GetMsgPanelInfo(), EDGE_MODULE::GetMsgPanelInfo(), ZONE_CONTAINER::GetMsgPanelInfo(), DRAWSEGMENT::GetMsgPanelInfo(), TEXTE_MODULE::GetMsgPanelInfo(), EDGE_MODULE::GetSelectMenuText(), TEXTE_PCB::GetSelectMenuText(), TEXTE_MODULE::GetSelectMenuText(), DIMENSION::GetSelectMenuText(), DRAWSEGMENT::GetSelectMenuText(), TRACK::GetSelectMenuText(), SEGZONE::GetSelectMenuText(), MODULE::GetSelectMenuText(), and ZONE_CONTAINER::GetSelectMenuText().

78 {
79  BOARD* board = GetBoard();
80 
81  if( board )
82  return board->GetLayerName( m_Layer );
83 
84  // If no parent, return standard name
86 }
PCB_LAYER_ID m_Layer
const wxString GetLayerName(PCB_LAYER_ID aLayer) const
Function GetLayerName returns the name of a layer given by aLayer.
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
static wxString GetStandardLayerName(PCB_LAYER_ID aLayerId)
Function GetStandardLayerName returns an "English Standard" name of a PCB layer when given aLayerNumb...
Definition: class_board.h:647
LSET D_PAD::GetLayerSet ( ) const
inlineoverridevirtual
DHEAD* EDA_ITEM::GetList ( ) const
inlineinherited
int D_PAD::GetLocalClearance ( ) const
inline
bool BOARD_CONNECTED_ITEM::GetLocalRatsnestVisible ( ) const
inlineinherited
int D_PAD::GetLocalSolderMaskMargin ( ) const
inline

Definition at line 385 of file class_pad.h.

References m_LocalSolderMaskMargin.

Referenced by PCB_IO::format(), PCB_BASE_FRAME::GlobalChange_PadSettings(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

385 { return m_LocalSolderMaskMargin; }
int m_LocalSolderMaskMargin
Local mask margins: when 0, the parent footprint design values are used.
Definition: class_pad.h:815
int D_PAD::GetLocalSolderPasteMargin ( ) const
inline

Definition at line 391 of file class_pad.h.

References m_LocalSolderPasteMargin.

Referenced by PCB_IO::format(), PCB_BASE_FRAME::GlobalChange_PadSettings(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

391 { return m_LocalSolderPasteMargin; }
int m_LocalSolderPasteMargin
Local solder paste margin absolute value.
Definition: class_pad.h:816
double D_PAD::GetLocalSolderPasteMarginRatio ( ) const
inline

Definition at line 394 of file class_pad.h.

References m_LocalSolderPasteMarginRatio.

Referenced by PCB_IO::format(), PCB_BASE_FRAME::GlobalChange_PadSettings(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

double m_LocalSolderPasteMarginRatio
Local solder mask margin ratio value of pad size The final margin is the sum of these 2 values...
Definition: class_pad.h:818
BITMAP_DEF D_PAD::GetMenuImage ( ) const
overridevirtual

Function GetMenuImage returns a pointer to an image to be used in menus.

The default version returns the right arrow image. Override this function to provide object specific menu images.

Returns
The menu image associated with the item.

Reimplemented from EDA_ITEM.

Definition at line 1202 of file class_pad.cpp.

1203 {
1204  return pad_xpm;
1205 }
void D_PAD::GetMsgPanelInfo ( std::vector< MSG_PANEL_ITEM > &  aList)
overridevirtual

Function GetMsgPanelInfo populates aList of MSG_PANEL_ITEM objects with it's internal state for display purposes.

Note
This method replaces DisplayInfo() so that KiCad objects no longer have any knowledge of wxWidgets UI objects.
Parameters
aListis the list to populate.

Reimplemented from EDA_ITEM.

Definition at line 683 of file class_pad.cpp.

References BROWN, CoordinateToString(), CYAN, DARKCYAN, DARKGREEN, BOARD_ITEM::GetBoard(), GetDrillShape(), BOARD_CONNECTED_ITEM::GetNetname(), MODULE::GetOrientationDegrees(), GetOrientationDegrees(), GetPadToDieLength(), MODULE::GetReference(), LayerMaskDescribe(), LIGHTBLUE, m_Drill, m_layerMask, m_name, EDA_ITEM::m_Parent, m_Pos, m_Size, PAD_DRILL_SHAPE_CIRCLE, RED, ShowPadAttr(), ShowPadShape(), wxPoint::x, and wxPoint::y.

684 {
685  MODULE* module;
686  wxString Line;
687  BOARD* board;
688 
689  module = (MODULE*) m_Parent;
690 
691  if( module )
692  {
693  aList.push_back( MSG_PANEL_ITEM( _( "Footprint" ), module->GetReference(), DARKCYAN ) );
694  aList.push_back( MSG_PANEL_ITEM( _( "Pad" ), m_name, BROWN ) );
695  }
696 
697  aList.push_back( MSG_PANEL_ITEM( _( "Net" ), GetNetname(), DARKCYAN ) );
698 
699  board = GetBoard();
700 
701  aList.push_back( MSG_PANEL_ITEM( _( "Layer" ),
702  LayerMaskDescribe( board, m_layerMask ), DARKGREEN ) );
703 
704  aList.push_back( MSG_PANEL_ITEM( ShowPadShape(), ShowPadAttr(), DARKGREEN ) );
705 
706  Line = ::CoordinateToString( m_Size.x );
707  aList.push_back( MSG_PANEL_ITEM( _( "Width" ), Line, RED ) );
708 
709  Line = ::CoordinateToString( m_Size.y );
710  aList.push_back( MSG_PANEL_ITEM( _( "Height" ), Line, RED ) );
711 
712  Line = ::CoordinateToString( (unsigned) m_Drill.x );
713 
715  {
716  aList.push_back( MSG_PANEL_ITEM( _( "Drill" ), Line, RED ) );
717  }
718  else
719  {
720  Line = ::CoordinateToString( (unsigned) m_Drill.x );
721  wxString msg;
722  msg = ::CoordinateToString( (unsigned) m_Drill.y );
723  Line += wxT( "/" ) + msg;
724  aList.push_back( MSG_PANEL_ITEM( _( "Drill X / Y" ), Line, RED ) );
725  }
726 
727  double module_orient_degrees = module ? module->GetOrientationDegrees() : 0;
728 
729  if( module_orient_degrees != 0.0 )
730  Line.Printf( wxT( "%3.1f(+%3.1f)" ),
731  GetOrientationDegrees() - module_orient_degrees,
732  module_orient_degrees );
733  else
734  Line.Printf( wxT( "%3.1f" ), GetOrientationDegrees() );
735 
736  aList.push_back( MSG_PANEL_ITEM( _( "Angle" ), Line, LIGHTBLUE ) );
737 
738  Line = ::CoordinateToString( m_Pos.x ) + wxT( ", " ) + ::CoordinateToString( m_Pos.y );
739  aList.push_back( MSG_PANEL_ITEM( _( "Position" ), Line, LIGHTBLUE ) );
740 
741  if( GetPadToDieLength() )
742  {
744  aList.push_back( MSG_PANEL_ITEM( _( "Length in package" ), Line, CYAN ) );
745  }
746 }
wxString CoordinateToString(int aValue, bool aConvertToMils)
Function CoordinateToString is a helper to convert the integer coordinate aValue to a string in inche...
Definition: base_units.cpp:117
EDA_ITEM * m_Parent
Linked list: Link (parent struct)
Definition: base_struct.h:182
int GetPadToDieLength() const
Definition: class_pad.h:383
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
wxString ShowPadAttr() const
Function ShowPadAttr.
Definition: class_pad.cpp:1157
PAD_DRILL_SHAPE_T GetDrillShape() const
Definition: class_pad.h:363
wxString m_name
Definition: class_pad.h:733
double GetOrientationDegrees() const
Definition: class_module.h:161
Definition: colors.h:59
Definition: colors.h:60
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
const wxString & GetNetname() const
Function GetNetname.
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
const wxString & GetReference() const
Function GetReference.
Definition: class_module.h:419
wxString ShowPadShape() const
Function ShowPadShape.
Definition: class_pad.cpp:1129
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
Class EDA_MSG_ITEM is used EDA_MSG_PANEL as the item type for displaying messages.
Definition: msgpanel.h:53
double GetOrientationDegrees() const
Definition: class_pad.h:358
static wxString LayerMaskDescribe(const BOARD *aBoard, LSET aMask)
Helper function Return a string (to be shown to the user) describing a layer mask.
Definition: class_pad.cpp:1299
wxPoint m_Pos
pad Position on board
Definition: class_pad.h:735
Definition: colors.h:62
NETCLASSPTR BOARD_CONNECTED_ITEM::GetNetClass ( ) const
inherited

Function GetNetClass returns the NETCLASS for this item.

Definition at line 104 of file class_board_connected_item.cpp.

References DBG, BOARD::FindNet(), BOARD_ITEM::GetBoard(), BOARD_DESIGN_SETTINGS::GetDefault(), BOARD::GetDesignSettings(), NETINFO_ITEM::GetNetClass(), BOARD_CONNECTED_ITEM::GetNetCode(), and EDA_ITEM::Type().

Referenced by DIALOG_TRACK_VIA_PROPERTIES::Apply(), DRC::doTrackDrc(), BOARD_CONNECTED_ITEM::GetClearance(), ZONE_CONTAINER::GetClearance(), VIA::GetDrillValue(), TRACK::GetMsgPanelInfo(), BOARD_CONNECTED_ITEM::GetNetClassName(), and ROUTER_TOOL::prepareInteractive().

105 {
106  // It is important that this be implemented without any sequential searching.
107  // Simple array lookups should be fine, performance-wise.
108  BOARD* board = GetBoard();
109 
110  // DO NOT use wxASSERT, because GetNetClass is called inside an OnPaint event
111  // and a call to wxASSERT can crash the application.
112 
113  if( board == NULL ) // Should not occur
114  {
115  DBG(printf( "%s: NULL board,type %d", __func__, Type() );)
116 
117  return NETCLASSPTR();
118  }
119 
120  NETCLASSPTR netclass;
121  NETINFO_ITEM* net = board->FindNet( GetNetCode() );
122 
123  if( net )
124  {
125  netclass = net->GetNetClass();
126 
127  //DBG( if(!netclass) printf( "%s: NULL netclass,type %d", __func__, Type() );)
128  }
129 
130  if( netclass )
131  return netclass;
132  else
133  return board->GetDesignSettings().GetDefault();
134 }
KICAD_T Type() const
Function Type()
Definition: base_struct.h:212
NETCLASSPTR GetDefault() const
Function GetDefault.
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
Function GetDesignSettings.
Definition: class_board.h:532
int GetNetCode() const
Function GetNetCode.
Class NETINFO_ITEM handles the data for a net.
Definition: class_netinfo.h:69
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
NETCLASSPTR GetNetClass()
NETINFO_ITEM * FindNet(int aNetcode) const
Function FindNet searches for a net with the given netcode.
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
#define DBG(x)
Definition: fctsys.h:33
wxString BOARD_CONNECTED_ITEM::GetNetClassName ( ) const
inherited

Function GetNetClassName returns a pointer to the netclass of the zone.

If the net is not found (can happen when a netlist is reread, and the net name does not exist, return the default net class (should not return a null pointer).

Returns
the Net Class name of this item

Definition at line 137 of file class_board_connected_item.cpp.

References NETCLASS::Default, BOARD_CONNECTED_ITEM::GetNetClass(), and name.

Referenced by PCB_EDIT_FRAME::createPopUpMenuForFpPads(), and PCB_EDIT_FRAME::createPopupMenuForTracks().

138 {
139  wxString name;
140  NETCLASSPTR myclass = GetNetClass();
141 
142  if( myclass )
143  name = myclass->GetName();
144  else
145  name = NETCLASS::Default;
146 
147  return name;
148 }
std::shared_ptr< NETCLASS > GetNetClass() const
Function GetNetClass returns the NETCLASS for this item.
static const char Default[]
the name of the default NETCLASS
const char * name
int BOARD_CONNECTED_ITEM::GetNetCode ( ) const
inlineinherited

Function GetNetCode.

Returns
int - the net code.

Definition at line 103 of file class_board_connected_item.h.

References NETINFO_ITEM::GetNet(), and BOARD_CONNECTED_ITEM::m_netinfo.

Referenced by ZONE_CONTAINER::AddClearanceAreasPolygonsToPolysList_NG(), PCB_EDIT_FRAME::Attribut_net(), PCB_EDIT_FRAME::Autoroute(), PCB_EDIT_FRAME::Begin_Route(), PCB_EDIT_FRAME::Begin_Zone(), Build_Work(), ZONE_CONTAINER::buildFeatureHoleList(), BuildUnconnectedThermalStubsPolygonList(), PCB_EDIT_FRAME::Change_Net_Tracks_And_Vias_Sizes(), Collect_TrackSegmentsToDrag(), BOARD::CombineAllAreasInNet(), CopyNetlistSettings(), CreateRoutesSection(), CreateSignalsSection(), PCB_EDIT_FRAME::Delete_net(), PCB_EDIT_FRAME::Delete_Segment(), PCB_EDIT_FRAME::Delete_Track(), DRC::doEdgeZoneDrc(), DRC::doPadToPadsDrc(), DRC::doTrackDrc(), KIGFX::PCB_PAINTER::draw(), VIA::Draw(), BOARD::DrawHighLight(), DrawShape(), TRACK::DrawShortNetname(), PCB_EDIT_FRAME::duplicateZone(), PCB_EDIT_FRAME::End_Zone(), PCB_EDIT_FRAME::EraseRedundantTrack(), PCB_EDIT_FRAME::ExecuteRemoteCommand(), PCB_EDIT_FRAME::Fill_Zone(), PNS::NODE::FindItemByParent(), PCB_IO::format(), DSN::SPECCTRA_DB::FromBOARD(), TRACK::GetBestInsertPoint(), CONNECTIVITY_DATA::GetConnectedItems(), TRACK::GetEndNetCode(), ZONE_CONTAINER::GetMsgPanelInfo(), TRACK::GetMsgPanelInfoBase_Common(), BOARD_CONNECTED_ITEM::GetNetClass(), TRACK::GetSelectMenuText(), VIA::GetSelectMenuText(), ZONE_CONTAINER::GetSelectMenuText(), TRACK::GetStartNetCode(), TRACK::GetTrack(), BOARD::HitTestForAnyFilledArea(), ZONE_CONTAINER::IsSame(), LocateIntrusion(), Magnetize(), DSN::SPECCTRA_DB::makeIMAGE(), CONNECTIVITY_DATA::NearestUnconnectedTargets(), BOARD::NormalizeAreaPolygon(), BOARD::OnAreaPolygonModified(), ZONE_SETTINGS::operator<<(), PlaceCells(), PCB_EDIT_FRAME::PlaceDraggedOrMovedTrackSegment(), PCB_EDIT_FRAME::Process_Special_Functions(), PushTrack(), PCB_EDIT_FRAME::Remove_One_Track(), PCB_EDIT_FRAME::Remove_Zone_Corner(), TRACKS_CLEANER::removeDuplicatesOfTrack(), BOARD::ReplaceNetlist(), PCB_SELECTION_CONDITIONS::sameNetFunc(), SaveCopyOfZones(), BOARD::SetAreasNetCodesFromNetNames(), PCB_EDIT_FRAME::Start_DragTrackSegmentAndKeepSlope(), PCB_EDIT_FRAME::Start_Move_Zone_Corner(), PCB_EDIT_FRAME::Start_Move_Zone_Drag_Outline_Edge(), PCB_EDIT_FRAME::Start_Move_Zone_Outlines(), PCB_EDIT_FRAME::StartMoveOneNodeOrSegment(), PNS_KICAD_IFACE::syncPad(), PNS_KICAD_IFACE::syncTrack(), PNS_KICAD_IFACE::syncVia(), BOARD::Test_Drc_Areas_Outlines_To_Areas_Outlines(), BOARD::TestAreaIntersections(), BOARD_NETLIST_UPDATER::testConnectivity(), DRC::testZones(), TrackListSortByNetcode(), BOARD::TracksInNet(), NETINFO_MAPPING::Update(), ZONE_CONTAINER::ZONE_CONTAINER(), and PCB_EDITOR_CONTROL::ZoneMerge().

104  {
105  return m_netinfo->GetNet();
106  }
int GetNet() const
Function GetNet.
NETINFO_ITEM * m_netinfo
Stores all informations about the net that item belongs to.
int BOARD_ITEM::getNextNumberInSequence ( const std::set< int > &  aSeq,
bool  aFillSequenceGaps 
)
staticprotectedinherited

Definition at line 223 of file class_board_item.cpp.

Referenced by MODULE::GetNextPadName().

224 {
225  if( aSeq.empty() )
226  return 1;
227 
228  // By default go to the end of the sequence
229  int candidate = *aSeq.rbegin();
230 
231  // Filling in gaps in pad numbering
232  if( aFillSequenceGaps )
233  {
234  // start at the beginning
235  candidate = *aSeq.begin();
236 
237  for( auto it : aSeq )
238  {
239  if( it - candidate > 1 )
240  break;
241 
242  candidate = it;
243  }
244  }
245 
246  ++candidate;
247 
248  return candidate;
249 }
void D_PAD::GetOblongDrillGeometry ( wxPoint aStartPoint,
wxPoint aEndPoint,
int &  aWidth 
) const

Function GetOblongDrillGeometry calculates the start point, end point and width of an equivalent segment which have the same position and width as the hole Usefull to plot/draw oblong holes like segments with rounded ends used in draw and plot functions.

Parameters
aStartPoint= first point of the equivalent segment, relative to the pad position.
aEndPoint= second point of the equivalent segment, relative to the pad position.
aWidth= width equivalent segment.

Definition at line 749 of file class_pad.cpp.

References GetDrillSize(), m_Drill, m_Orient, RotatePoint(), wxPoint::x, and wxPoint::y.

Referenced by BuildPadDrillShapePolygon(), CINFO3D_VISU::createNewPadDrill(), and DrawShape().

751 {
752  // calculates the start point, end point and width
753  // of an equivalent segment which have the same position and width as the hole
754  int delta_cx, delta_cy;
755 
756  wxSize halfsize = GetDrillSize();
757  halfsize.x /= 2;
758  halfsize.y /= 2;
759 
760  if( m_Drill.x > m_Drill.y ) // horizontal
761  {
762  delta_cx = halfsize.x - halfsize.y;
763  delta_cy = 0;
764  aWidth = m_Drill.y;
765  }
766  else // vertical
767  {
768  delta_cx = 0;
769  delta_cy = halfsize.y - halfsize.x;
770  aWidth = m_Drill.x;
771  }
772 
773  RotatePoint( &delta_cx, &delta_cy, m_Orient );
774 
775  aStartPoint.x = delta_cx;
776  aStartPoint.y = delta_cy;
777 
778  aEndPoint.x = - delta_cx;
779  aEndPoint.y = - delta_cy;
780 }
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
const wxSize & GetDrillSize() const
Definition: class_pad.h:260
wxSize m_Drill
Drill diam (drill shape = PAD_CIRCLE) or drill size (shape = OVAL) for drill shape = PAD_CIRCLE...
Definition: class_pad.h:763
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
double D_PAD::GetOrientationDegrees ( ) const
inline

Definition at line 358 of file class_pad.h.

References m_Orient.

Referenced by GetMsgPanelInfo(), and DSN::SPECCTRA_DB::makeIMAGE().

358 { return m_Orient/10.0; }
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
double D_PAD::GetOrientationRadians ( ) const
inline

Definition at line 359 of file class_pad.h.

References m_Orient.

Referenced by KIGFX::PCB_PAINTER::draw().

359 { return m_Orient*M_PI/1800; }
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
int D_PAD::GetPadToDieLength ( ) const
inline

Definition at line 383 of file class_pad.h.

References m_LengthPadToDie.

Referenced by PCB_IO::format(), GetMsgPanelInfo(), DIALOG_PAD_PROPERTIES::initValues(), BOARD::MarkTrace(), ShowNewTrackWhenMovingCursor(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

383 { return m_LengthPadToDie; }
int m_LengthPadToDie
Length net from pad to die, inside the package.
Definition: class_pad.h:806
const std::vector<PAD_CS_PRIMITIVE>& D_PAD::GetPrimitives ( ) const
inline

Accessor to the basic shape list.

Definition at line 318 of file class_pad.h.

References m_basicShapes.

Referenced by PCB_IO::format(), PCB_BASE_FRAME::Import_Pad_Settings(), ImportSettingsFromMaster(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

318 { return m_basicShapes; }
std::vector< PAD_CS_PRIMITIVE > m_basicShapes
for free shape pads: a list of basic shapes, in local coordinates, orient 0, coordinates relative to ...
Definition: class_pad.h:745
int D_PAD::GetRoundRectCornerRadius ( ) const
inline

Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.

Returns
The radius of the rounded corners for this pad.

Definition at line 493 of file class_pad.h.

References m_Size.

Referenced by boundingRadius(), DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), CINFO3D_VISU::createNewPadWithClearance(), KIGFX::PCB_PAINTER::draw(), DrawShape(), HitTest(), DIALOG_PAD_PROPERTIES::onCornerSizePercentChange(), BRDITEMS_PLOTTER::PlotPad(), TransformShapeWithClearanceToPolygon(), and DIALOG_PAD_PROPERTIES::updateRoundRectCornerValues().

494  {
496  }
int GetRoundRectCornerRadius() const
Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.
Definition: class_pad.h:493
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
int D_PAD::GetRoundRectCornerRadius ( const wxSize &  aSize) const

Helper function GetRoundRectCornerRadius Has meaning only for rounded rect pads Returns the radius of the rounded corners of a rectangle size aSize, using others setting of the pad.

Parameters
aSize= size of the of the round rect. Usually the pad size but can be the size of the pad on solder mask or solder paste
Returns
The radius of the rounded corners for this pad size.

Definition at line 189 of file class_pad.cpp.

References m_padRoundRectRadiusScale.

190 {
191  // radius of rounded corners, usually 25% of shorter pad edge for now
192  int r = aSize.x > aSize.y ? aSize.y : aSize.x;
193  r = int( r * m_padRoundRectRadiusScale );
194 
195  return r;
196 }
double m_padRoundRectRadiusScale
scaling factor from smallest m_Size coord to corner radius, default 0.25
Definition: class_pad.h:771
double D_PAD::GetRoundRectRadiusRatio ( ) const
inline

has meaning only for rounded rect pads

Returns
the scaling factor between the smaller Y or Y size and the radius of the rounded corners. Cannot be > 0.5 the normalized IPC-7351C value is 0.25

Definition at line 590 of file class_pad.h.

References m_padRoundRectRadiusScale.

Referenced by PCB_IO::format(), ImportSettingsFromMaster(), DIALOG_PAD_PROPERTIES::OnPadShapeSelection(), DIALOG_PAD_PROPERTIES::TransferDataFromWindow(), and DIALOG_PAD_PROPERTIES::updateRoundRectCornerValues().

591  {
593  }
double m_padRoundRectRadiusScale
scaling factor from smallest m_Size coord to corner radius, default 0.25
Definition: class_pad.h:771
wxString D_PAD::GetSelectMenuText ( ) const
overridevirtual

Function GetSelectMenuText returns the text to display to be used in the selection clarification context menu when multiple items are found at the current cursor position.

The default version of this function raises an assertion in the debug mode and returns a string to indicate that it was not overridden to provide the object specific text.

Returns
The menu text string.

Reimplemented from EDA_ITEM.

Definition at line 1179 of file class_pad.cpp.

References BOARD_ITEM::GetBoard(), GetChars(), GetName(), GetParent(), LayerMaskDescribe(), and m_layerMask.

Referenced by PCB_EDIT_FRAME::createPopUpMenuForFpPads(), and DRC::fillMarker().

1180 {
1181  wxString text;
1182  wxString padlayers( LayerMaskDescribe( GetBoard(), m_layerMask ) );
1183  wxString padname( GetName() );
1184 
1185  if( padname.IsEmpty() )
1186  {
1187  text.Printf( _( "Pad on %s of %s" ),
1188  GetChars( padlayers ),
1189  GetChars(GetParent()->GetReference() ) );
1190  }
1191  else
1192  {
1193  text.Printf( _( "Pad %s on %s of %s" ),
1194  GetChars(GetName() ), GetChars( padlayers ),
1195  GetChars(GetParent()->GetReference() ) );
1196  }
1197 
1198  return text;
1199 }
MODULE * GetParent() const
Definition: class_pad.h:147
const wxString & GetName() const
Definition: class_pad.h:175
LSET m_layerMask
Bitwise layer :1= copper layer, 15= cmp, 2..14 = internal layers 16 .
Definition: class_pad.h:793
static const wxChar * GetChars(const wxString &s)
Function GetChars returns a wxChar* to the actual wxChar* data within a wxString, and is helpful for ...
Definition: macros.h:92
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
static wxString LayerMaskDescribe(const BOARD *aBoard, LSET aMask)
Helper function Return a string (to be shown to the user) describing a layer mask.
Definition: class_pad.cpp:1299
PAD_SHAPE_T D_PAD::GetShape ( ) const
inline

Function GetShape.

Returns
the shape of this pad.

Definition at line 201 of file class_pad.h.

References m_padShape.

Referenced by CINFO3D_VISU::AddPadsShapesWithClearanceToContainer(), boundingRadius(), BuildPadPolygon(), CINFO3D_VISU::buildPadShapePolygon(), BuildPadShapePolygon(), CINFO3D_VISU::buildPadShapeThickOutlineAsPolygon(), CINFO3D_VISU::buildPadShapeThickOutlineAsSegments(), DRC::checkClearancePadToPad(), DRC::checkClearanceSegmToPad(), Compare(), CINFO3D_VISU::createNewPad(), CINFO3D_VISU::createNewPadWithClearance(), CreatePadsShapesSection(), CreateThermalReliefPadPolygon(), KIGFX::PCB_PAINTER::draw(), DrawShape(), export_vrml_padshape(), PCB_IO::format(), GetBoundingBox(), PCB_BASE_FRAME::GlobalChange_PadSettings(), globalChangePadSettings(), HitTest(), ImportSettingsFromMaster(), DIALOG_PAD_PROPERTIES::initValues(), DSN::isRoundKeepout(), DSN::SPECCTRA_DB::makePADSTACK(), DIALOG_PAD_PROPERTIES::onCornerSizePercentChange(), DIALOG_PAD_PROPERTIES::OnPaintShowPanel(), EAGLE_PLUGIN::packagePad(), DIALOG_PAD_PROPERTIES::padValuesOK(), GPCB_FPL_CACHE::parseMODULE(), PlacePad(), BRDITEMS_PLOTTER::PlotPad(), ShowPadShape(), PNS_KICAD_IFACE::syncPad(), DIALOG_PAD_PROPERTIES::TransferDataFromWindow(), DIALOG_PAD_PROPERTIES::transferDataToPad(), MODULE::TransformPadsShapesWithClearanceToPolygon(), CINFO3D_VISU::transformPadsShapesWithClearanceToPolygon(), TransformShapeWithClearanceToPolygon(), and DIALOG_PAD_PROPERTIES::updateRoundRectCornerValues().

201 { return m_padShape; }
PAD_SHAPE_T m_padShape
Shape: PAD_SHAPE_CIRCLE, PAD_SHAPE_RECT, PAD_SHAPE_OVAL, PAD_SHAPE_TRAPEZOID, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_POLYGON.
Definition: class_pad.h:737
const wxString& BOARD_CONNECTED_ITEM::GetShortNetname ( ) const
inlineinherited

Function GetShortNetname.

Returns
wxString - the short netname

Definition at line 131 of file class_board_connected_item.h.

References NETINFO_ITEM::GetShortNetname(), and BOARD_CONNECTED_ITEM::m_netinfo.

Referenced by KIGFX::PCB_PAINTER::draw(), and DrawShape().

132  {
133  return m_netinfo->GetShortNetname();
134  }
const wxString & GetShortNetname() const
Function GetShortNetname.
NETINFO_ITEM * m_netinfo
Stores all informations about the net that item belongs to.
int D_PAD::GetSolderMaskMargin ( ) const

Function GetSolderMaskMargin.

Returns
the margin for the solder mask layer usually > 0 (mask shape bigger than pad value is 1 - the local value 2 - if null, the parent footprint value 1 - if null, the global value

Definition at line 577 of file class_pad.cpp.

References BOARD_ITEM::GetBoard(), BOARD::GetDesignSettings(), MODULE::GetLocalSolderMaskMargin(), GetParent(), m_LocalSolderMaskMargin, m_Size, BOARD_DESIGN_SETTINGS::m_SolderMaskMargin, and min.

Referenced by CINFO3D_VISU::AddPadsShapesWithClearanceToContainer(), KIGFX::PCB_PAINTER::draw(), Draw(), MODULE::TransformPadsShapesWithClearanceToPolygon(), CINFO3D_VISU::transformPadsShapesWithClearanceToPolygon(), and ViewBBox().

578 {
579  int margin = m_LocalSolderMaskMargin;
580  MODULE* module = GetParent();
581 
582  if( module )
583  {
584  if( margin == 0 )
585  {
586  if( module->GetLocalSolderMaskMargin() )
587  margin = module->GetLocalSolderMaskMargin();
588  }
589 
590  if( margin == 0 )
591  {
592  BOARD* brd = GetBoard();
593  margin = brd->GetDesignSettings().m_SolderMaskMargin;
594  }
595  }
596 
597  // ensure mask have a size always >= 0
598  if( margin < 0 )
599  {
600  int minsize = -std::min( m_Size.x, m_Size.y ) / 2;
601 
602  if( margin < minsize )
603  margin = minsize;
604  }
605 
606  return margin;
607 }
int m_LocalSolderMaskMargin
Local mask margins: when 0, the parent footprint design values are used.
Definition: class_pad.h:815
int m_SolderMaskMargin
Solder mask margin.
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
MODULE * GetParent() const
Definition: class_pad.h:147
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
Function GetDesignSettings.
Definition: class_board.h:532
int GetLocalSolderMaskMargin() const
Definition: class_module.h:176
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
#define min(a, b)
Definition: auxiliary.h:85
wxSize D_PAD::GetSolderPasteMargin ( ) const

Function GetSolderPasteMargin.

Returns
the margin for the solder mask layer usually < 0 (mask shape smaller than pad because the margin can be dependent on the pad size, the margin has a x and a y value value is 1 - the local value 2 - if null, the parent footprint value 1 - if null, the global value

Definition at line 610 of file class_pad.cpp.

References BOARD_ITEM::GetBoard(), BOARD::GetDesignSettings(), MODULE::GetLocalSolderPasteMargin(), MODULE::GetLocalSolderPasteMarginRatio(), GetParent(), KiROUND(), m_LocalSolderPasteMargin, m_LocalSolderPasteMarginRatio, m_Size, BOARD_DESIGN_SETTINGS::m_SolderPasteMargin, and BOARD_DESIGN_SETTINGS::m_SolderPasteMarginRatio.

Referenced by CINFO3D_VISU::AddPadsShapesWithClearanceToContainer(), KIGFX::PCB_PAINTER::draw(), Draw(), MODULE::TransformPadsShapesWithClearanceToPolygon(), CINFO3D_VISU::transformPadsShapesWithClearanceToPolygon(), and ViewBBox().

611 {
612  int margin = m_LocalSolderPasteMargin;
613  double mratio = m_LocalSolderPasteMarginRatio;
614  MODULE* module = GetParent();
615 
616  if( module )
617  {
618  if( margin == 0 )
619  margin = module->GetLocalSolderPasteMargin();
620 
621  BOARD * brd = GetBoard();
622 
623  if( margin == 0 )
624  margin = brd->GetDesignSettings().m_SolderPasteMargin;
625 
626  if( mratio == 0.0 )
627  mratio = module->GetLocalSolderPasteMarginRatio();
628 
629  if( mratio == 0.0 )
630  {
632  }
633  }
634 
635  wxSize pad_margin;
636  pad_margin.x = margin + KiROUND( m_Size.x * mratio );
637  pad_margin.y = margin + KiROUND( m_Size.y * mratio );
638 
639  // ensure mask have a size always >= 0
640  if( pad_margin.x < -m_Size.x / 2 )
641  pad_margin.x = -m_Size.x / 2;
642 
643  if( pad_margin.y < -m_Size.y / 2 )
644  pad_margin.y = -m_Size.y / 2;
645 
646  return pad_margin;
647 }
static int KiROUND(double v)
KiROUND rounds a floating point number to an int using "round halfway cases away from zero"...
Definition: common.h:107
int m_SolderPasteMargin
Solder paste margin absolute value.
int m_LocalSolderPasteMargin
Local solder paste margin absolute value.
Definition: class_pad.h:816
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
MODULE * GetParent() const
Definition: class_pad.h:147
double GetLocalSolderPasteMarginRatio() const
Definition: class_module.h:185
BOARD_DESIGN_SETTINGS & GetDesignSettings() const
Function GetDesignSettings.
Definition: class_board.h:532
int GetLocalSolderPasteMargin() const
Definition: class_module.h:182
Class BOARD holds information pertinent to a Pcbnew printed circuit board.
Definition: class_board.h:169
virtual BOARD * GetBoard() const
Function GetBoard returns the BOARD in which this BOARD_ITEM resides, or NULL if none.
double m_LocalSolderPasteMarginRatio
Local solder mask margin ratio value of pad size The final margin is the sum of these 2 values...
Definition: class_pad.h:818
double m_SolderPasteMarginRatio
Solder pask margin ratio value of pad size The final margin is the sum of these 2 values...
STATUS_FLAGS EDA_ITEM::GetStatus ( ) const
inlineinherited

Definition at line 264 of file base_struct.h.

References EDA_ITEM::m_Status.

Referenced by PCB_IO::format().

264 { return m_Status; }
STATUS_FLAGS m_Status
Definition: base_struct.h:175
int D_PAD::GetSubRatsnest ( ) const
inline

Function GetSubRatsnest.

Returns
int - the netcode

Definition at line 614 of file class_pad.h.

References m_SubRatsnest.

Referenced by CreatePadsShapesSection(), and CreateShapesSection().

614 { return m_SubRatsnest; }
int m_SubRatsnest
variable used in rats nest computations handle subnet (block) number in ratsnest connection ...
Definition: class_pad.h:760
int D_PAD::GetThermalGap ( ) const

Definition at line 672 of file class_pad.cpp.

References GetParent(), MODULE::GetThermalGap(), and m_ThermalGap.

Referenced by PCB_IO::format(), ZONE_CONTAINER::GetThermalReliefGap(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

673 {
674  MODULE* module = GetParent();
675 
676  if( m_ThermalGap == 0 && module )
677  return module->GetThermalGap();
678  else
679  return m_ThermalGap;
680 }
int m_ThermalGap
Definition: class_pad.h:824
int GetThermalGap() const
Definition: class_module.h:195
MODULE * GetParent() const
Definition: class_pad.h:147
int D_PAD::GetThermalWidth ( ) const

Definition at line 661 of file class_pad.cpp.

References GetParent(), MODULE::GetThermalWidth(), and m_ThermalWidth.

Referenced by PCB_IO::format(), ZONE_CONTAINER::GetThermalReliefCopperBridge(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

662 {
663  MODULE* module = GetParent();
664 
665  if( m_ThermalWidth == 0 && module )
666  return module->GetThermalWidth();
667  else
668  return m_ThermalWidth;
669 }
MODULE * GetParent() const
Definition: class_pad.h:147
int m_ThermalWidth
Definition: class_pad.h:823
int GetThermalWidth() const
Definition: class_module.h:192
int BOARD_ITEM::getTrailingInt ( wxString  aStr)
staticprotectedinherited

Definition at line 200 of file class_board_item.cpp.

Referenced by MODULE::GetNextPadName().

201 {
202  int number = 0;
203  int base = 1;
204 
205  // Trim and extract the trailing numeric part
206  int index = aStr.Len() - 1;
207  while( index >= 0 )
208  {
209  const char chr = aStr.GetChar( index );
210 
211  if( chr < '0' || chr > '9' )
212  break;
213 
214  number += ( chr - '0' ) * base;
215  base *= 10;
216  index--;
217  }
218 
219  return number;
220 }
ZoneConnection D_PAD::GetZoneConnection ( ) const

Definition at line 650 of file class_pad.cpp.

References GetParent(), MODULE::GetZoneConnection(), m_ZoneConnection, and PAD_ZONE_CONN_INHERITED.

Referenced by PCB_IO::format(), ZONE_CONTAINER::GetPadConnection(), DIALOG_PAD_PROPERTIES::initValues(), and DIALOG_PAD_PROPERTIES::TransferDataFromWindow().

651 {
652  MODULE* module = GetParent();
653 
654  if( m_ZoneConnection == PAD_ZONE_CONN_INHERITED && module )
655  return module->GetZoneConnection();
656  else
657  return m_ZoneConnection;
658 }
MODULE * GetParent() const
Definition: class_pad.h:147
ZoneConnection GetZoneConnection() const
Definition: class_module.h:189
ZoneConnection m_ZoneConnection
how the connection to zone is made: no connection, thermal relief ...
Definition: class_pad.h:821
bool D_PAD::HitTest ( const wxPoint aPosition) const
overridevirtual

Function HitTest tests if aPosition is contained within or on the bounding area of an item.

Parameters
aPositionA reference to a wxPoint object containing the coordinates to test.
Returns
True if aPosition is within or on the item bounding area.

Reimplemented from BOARD_ITEM.

Definition at line 783 of file class_pad.cpp.

References abs, BuildPadPolygon(), SHAPE_POLY_SET::COutline(), SHAPE_LINE_CHAIN::CPoint(), delta, dist, EuclideanNorm(), GetBoundingRadius(), GetRoundRectCornerRadius(), GetShape(), GetSize(), KiROUND(), m_customShapeAsPolygon, m_Orient, m_Size, SHAPE_POLY_SET::OutlineCount(), PAD_SHAPE_CIRCLE, PAD_SHAPE_CUSTOM, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, SHAPE_LINE_CHAIN::PointCount(), RotatePoint(), ShapePos(), TestPointInsidePolygon(), TestSegmentHit(), TransformRoundRectToPolygon(), wxPoint::x, and wxPoint::y.

784 {
785  int dx, dy;
786 
787  wxPoint shape_pos = ShapePos();
788 
789  wxPoint delta = aPosition - shape_pos;
790 
791  // first test: a test point must be inside a minimum sized bounding circle.
792  int radius = GetBoundingRadius();
793 
794  if( ( abs( delta.x ) > radius ) || ( abs( delta.y ) > radius ) )
795  return false;
796 
797  dx = m_Size.x >> 1; // dx also is the radius for rounded pads
798  dy = m_Size.y >> 1;
799 
800  switch( GetShape() )
801  {
802  case PAD_SHAPE_CIRCLE:
803  if( KiROUND( EuclideanNorm( delta ) ) <= dx )
804  return true;
805 
806  break;
807 
808  case PAD_SHAPE_TRAPEZOID:
809  {
810  wxPoint poly[4];
811  BuildPadPolygon( poly, wxSize(0,0), 0 );
812  RotatePoint( &delta, -m_Orient );
813 
814  return TestPointInsidePolygon( poly, 4, delta );
815  }
816 
817  case PAD_SHAPE_OVAL:
818  {
819  RotatePoint( &delta, -m_Orient );
820  // An oval pad has the same shape as a segment with rounded ends
821  // After rotation, the test point is relative to an horizontal pad
822  int dist;
823  wxPoint offset;
824  if( dy > dx ) // shape is a vertical oval
825  {
826  offset.y = dy - dx;
827  dist = dx;
828  }
829  else //if( dy <= dx ) shape is an horizontal oval
830  {
831  offset.x = dy - dx;
832  dist = dy;
833  }
834  return TestSegmentHit( delta, - offset, offset, dist );
835  }
836  break;
837 
838  case PAD_SHAPE_RECT:
839  RotatePoint( &delta, -m_Orient );
840 
841  if( (abs( delta.x ) <= dx ) && (abs( delta.y ) <= dy) )
842  return true;
843 
844  break;
845 
846  case PAD_SHAPE_ROUNDRECT:
847  {
848  // Check for hit in polygon
849  SHAPE_POLY_SET outline;
850  const int segmentToCircleCount = 32;
852  GetRoundRectCornerRadius(), segmentToCircleCount );
853 
854  const SHAPE_LINE_CHAIN &poly = outline.COutline( 0 );
855  return TestPointInsidePolygon( (const wxPoint*)&poly.CPoint(0), poly.PointCount(), delta );
856  }
857  break;
858 
859  case PAD_SHAPE_CUSTOM:
860  // Check for hit in polygon
861  RotatePoint( &delta, -m_Orient );
862 
864  {
866  return TestPointInsidePolygon( (const wxPoint*)&poly.CPoint(0), poly.PointCount(), delta );
867  }
868  break;
869  }
870 
871  return false;
872 }
double EuclideanNorm(const wxPoint &vector)
Euclidean norm of a 2D vector.
Definition: trigo.h:104
static int KiROUND(double v)
KiROUND rounds a floating point number to an int using "round halfway cases away from zero"...
Definition: common.h:107
void BuildPadPolygon(wxPoint aCoord[4], wxSize aInflateValue, double aRotation) const
Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Co...
int PointCount() const
Function PointCount()
void TransformRoundRectToPolygon(SHAPE_POLY_SET &aCornerBuffer, const wxPoint &aPosition, const wxSize &aSize, double aRotation, int aCornerRadius, int aCircleToSegmentsCount)
Function TransformRoundRectToPolygon convert a rectangle with rounded corners to a polygon Convert ar...
int GetRoundRectCornerRadius() const
Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.
Definition: class_pad.h:493
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
static const int dist[10][10]
Definition: dist.cpp:57
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
int OutlineCount() const
Returns the number of outlines in the set
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
#define abs(a)
Definition: auxiliary.h:84
static const int delta[8][2]
Definition: solve.cpp:112
bool TestPointInsidePolygon(const CPOLYGONS_LIST &aPolysList, int aIdxstart, int aIdxend, int aRefx, int aRefy)
Function TestPointInsidePolygon test if a point is inside or outside a polygon.
int GetBoundingRadius() const
Function GetBoundingRadius returns the radius of a minimum sized circle which fully encloses this pad...
Definition: class_pad.h:568
Class SHAPE_POLY_SET.
const wxSize & GetSize() const
Definition: class_pad.h:254
const SHAPE_LINE_CHAIN & COutline(int aIndex) const
SHAPE_POLY_SET m_customShapeAsPolygon
for free shape pads: the set of basic shapes, merged as one polygon, in local coordinates, orient 0, coordinates relative to m_Pos
Definition: class_pad.h:750
Class SHAPE_LINE_CHAIN.
wxPoint ShapePos() const
Definition: class_pad.cpp:500
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
bool TestSegmentHit(const wxPoint &aRefPoint, wxPoint aStart, wxPoint aEnd, int aDist)
Function TestSegmentHit test for hit on line segment i.e.
Definition: trigo.cpp:142
const VECTOR2I & CPoint(int aIndex) const
Function CPoint()
bool D_PAD::HitTest ( const EDA_RECT aRect,
bool  aContained,
int  aAccuracy = 0 
) const
overridevirtual

Function HitTest tests if the aRect intersects or contains this object (depending on aContained).

Parameters
aRectA reference to an EDA_RECT object containg the area to test.
aContainedTest if aRect contains this object completly.
aAccuracyIncrease the item bounding box by this amount.
Returns
bool - True if aRect contains this object completly or if aRect intersects the object and aContained is False, otherwise false.

Reimplemented from BOARD_ITEM.

Definition at line 875 of file class_pad.cpp.

References BuildPadPolygon(), EDA_RECT::Contains(), EDA_RECT::GetBottom(), GetBoundingBox(), GetBoundingRadius(), EDA_RECT::GetHeight(), EDA_RECT::GetLeft(), GetPosition(), EDA_RECT::GetRight(), GetRoundRectCornerRadius(), GetShape(), EDA_RECT::GetTop(), EDA_RECT::GetWidth(), EDA_RECT::Inflate(), EDA_RECT::Intersects(), EDA_RECT::IntersectsCircle(), m_Orient, m_Size, EDA_RECT::Normalize(), PAD_SHAPE_CIRCLE, PAD_SHAPE_OVAL, PAD_SHAPE_RECT, PAD_SHAPE_ROUNDRECT, PAD_SHAPE_TRAPEZOID, RotatePoint(), EDA_RECT::SetOrigin(), EDA_RECT::SetSize(), ShapePos(), and TestPointInsidePolygon().

876 {
877  EDA_RECT arect = aRect;
878  arect.Normalize();
879  arect.Inflate( aAccuracy );
880 
881  wxPoint shapePos = ShapePos();
882 
883  EDA_RECT shapeRect;
884 
885  int r;
886 
887  EDA_RECT bb = GetBoundingBox();
888 
889  wxPoint endCenter;
890  int radius;
891 
892  if( !arect.Intersects( bb ) )
893  return false;
894 
895  // This covers total containment for all test cases
896  if( arect.Contains( bb ) )
897  return true;
898 
899  switch( GetShape() )
900  {
901  case PAD_SHAPE_CIRCLE:
902  return arect.IntersectsCircle( GetPosition(), GetBoundingRadius() );
903  case PAD_SHAPE_RECT:
904  shapeRect.SetOrigin( shapePos );
905  shapeRect.Inflate( m_Size.x / 2, m_Size.y / 2 );
906  return arect.Intersects( shapeRect, m_Orient );
907  case PAD_SHAPE_OVAL:
908 
909  // Circlular test if dimensions are equal
910  if( m_Size.x == m_Size.y )
911  return arect.IntersectsCircle( shapePos, GetBoundingRadius() );
912 
913  shapeRect.SetOrigin( shapePos );
914 
915  // Horizontal dimension is greater
916  if( m_Size.x > m_Size.y )
917  {
918  radius = m_Size.y / 2;
919 
920  shapeRect.Inflate( m_Size.x / 2 - radius, radius );
921 
922  endCenter = wxPoint( m_Size.x / 2 - radius, 0 );
923  RotatePoint( &endCenter, m_Orient );
924 
925  // Test circular ends
926  if( arect.IntersectsCircle( shapePos + endCenter, radius ) ||
927  arect.IntersectsCircle( shapePos - endCenter, radius ) )
928  {
929  return true;
930  }
931  }
932  else
933  {
934  radius = m_Size.x / 2;
935 
936  shapeRect.Inflate( radius, m_Size.y / 2 - radius );
937 
938  endCenter = wxPoint( 0, m_Size.y / 2 - radius );
939  RotatePoint( &endCenter, m_Orient );
940 
941  // Test circular ends
942  if( arect.IntersectsCircle( shapePos + endCenter, radius ) ||
943  arect.IntersectsCircle( shapePos - endCenter, radius ) )
944  {
945  return true;
946  }
947  }
948 
949  // Test rectangular portion between rounded ends
950  if( arect.Intersects( shapeRect, m_Orient ) )
951  {
952  return true;
953  }
954 
955  break;
956  case PAD_SHAPE_TRAPEZOID:
957  /* Trapezoid intersection tests:
958  * A) Any points of rect inside trapezoid
959  * B) Any points of trapezoid inside rect
960  * C) Any sides of trapezoid cross rect
961  */
962  {
963 
964  wxPoint poly[4];
965  BuildPadPolygon( poly, wxSize( 0, 0 ), 0 );
966 
967  wxPoint corners[4];
968 
969  corners[0] = wxPoint( arect.GetLeft(), arect.GetTop() );
970  corners[1] = wxPoint( arect.GetRight(), arect.GetTop() );
971  corners[2] = wxPoint( arect.GetRight(), arect.GetBottom() );
972  corners[3] = wxPoint( arect.GetLeft(), arect.GetBottom() );
973 
974  for( int i=0; i<4; i++ )
975  {
976  RotatePoint( &poly[i], m_Orient );
977  poly[i] += shapePos;
978  }
979 
980  for( int ii=0; ii<4; ii++ )
981  {
982  if( TestPointInsidePolygon( poly, 4, corners[ii] ) )
983  {
984  return true;
985  }
986 
987  if( arect.Contains( poly[ii] ) )
988  {
989  return true;
990  }
991 
992  if( arect.Intersects( poly[ii], poly[(ii+1) % 4] ) )
993  {
994  return true;
995  }
996  }
997 
998  return false;
999 
1000  }
1001  case PAD_SHAPE_ROUNDRECT:
1002  /* RoundRect intersection can be broken up into simple tests:
1003  * a) Test intersection of horizontal rect
1004  * b) Test intersection of vertical rect
1005  * c) Test intersection of each corner
1006  */
1007 
1008 
1010 
1011  /* Test A - intersection of horizontal rect */
1012  shapeRect.SetSize( 0, 0 );
1013  shapeRect.SetOrigin( shapePos );
1014  shapeRect.Inflate( m_Size.x / 2, m_Size.y / 2 - r );
1015 
1016  // Short-circuit test for zero width or height
1017  if( shapeRect.GetWidth() > 0 && shapeRect.GetHeight() > 0 &&
1018  arect.Intersects( shapeRect, m_Orient ) )
1019  {
1020  return true;
1021  }
1022 
1023  /* Test B - intersection of vertical rect */
1024  shapeRect.SetSize( 0, 0 );
1025  shapeRect.SetOrigin( shapePos );
1026  shapeRect.Inflate( m_Size.x / 2 - r, m_Size.y / 2 );
1027 
1028  // Short-circuit test for zero width or height
1029  if( shapeRect.GetWidth() > 0 && shapeRect.GetHeight() > 0 &&
1030  arect.Intersects( shapeRect, m_Orient ) )
1031  {
1032  return true;
1033  }
1034 
1035  /* Test C - intersection of each corner */
1036 
1037  endCenter = wxPoint( m_Size.x / 2 - r, m_Size.y / 2 - r );
1038  RotatePoint( &endCenter, m_Orient );
1039 
1040  if( arect.IntersectsCircle( shapePos + endCenter, r ) ||
1041  arect.IntersectsCircle( shapePos - endCenter, r ) )
1042  {
1043  return true;
1044  }
1045 
1046  endCenter = wxPoint( m_Size.x / 2 - r, -m_Size.y / 2 + r );
1047  RotatePoint( &endCenter, m_Orient );
1048 
1049  if( arect.IntersectsCircle( shapePos + endCenter, r ) ||
1050  arect.IntersectsCircle( shapePos - endCenter, r ) )
1051  {
1052  return true;
1053  }
1054 
1055  break;
1056  default:
1057  break;
1058  }
1059 
1060  return false;
1061 }
int GetLeft() const
void BuildPadPolygon(wxPoint aCoord[4], wxSize aInflateValue, double aRotation) const
Function BuildPadPolygon Has meaning only for polygonal pads (trapezoid and rectangular) Build the Co...
bool Contains(const wxPoint &aPoint) const
Function Contains.
bool IntersectsCircle(const wxPoint &aCenter, const int aRadius) const
Function IntersectsCircle tests for a common area between a circle and this rectangle.
int GetRoundRectCornerRadius() const
Function GetRoundRectCornerRadius Has meaning only for rounded rect pads.
Definition: class_pad.h:493
wxSize m_Size
X and Y size ( relative to orient 0)
Definition: class_pad.h:767
int GetHeight() const
void SetOrigin(const wxPoint &pos)
void RotatePoint(int *pX, int *pY, double angle)
Definition: trigo.cpp:317
PAD_SHAPE_T GetShape() const
Function GetShape.
Definition: class_pad.h:201
bool TestPointInsidePolygon(const CPOLYGONS_LIST &aPolysList, int aIdxstart, int aIdxend, int aRefx, int aRefy)
Function TestPointInsidePolygon test if a point is inside or outside a polygon.
int GetBoundingRadius() const
Function GetBoundingRadius returns the radius of a minimum sized circle which fully encloses this pad...
Definition: class_pad.h:568
const wxPoint & GetPosition() const override
Definition: class_pad.h:205
int GetBottom() const
int GetRight() const
void Normalize()
Function Normalize ensures that the height ant width are positive.
void SetSize(const wxSize &size)
bool Intersects(const EDA_RECT &aRect) const
Function Intersects tests for a common area between rectangles.
Class EDA_RECT handles the component boundary box.
int GetWidth() const
wxPoint ShapePos() const
Definition: class_pad.cpp:500
double m_Orient
in 1/10 degrees
Definition: class_pad.h:804
const EDA_RECT GetBoundingBox() const override
Function GetBoundingBox returns the orthogonal, bounding box of this object for display purposes...
Definition: class_pad.cpp:199
EDA_RECT & Inflate(wxCoord dx, wxCoord dy)
Function Inflate inflates the rectangle horizontally by dx and vertically by dy.
int GetTop() const