KiCAD pcbnew scripting
Classes | Public Member Functions | Public Attributes | Static Public Attributes | List of all members
pcbnew.TRACK_List Class Reference
Inheritance diagram for pcbnew.TRACK_List:
Inheritance graph


class  DLISTIter

Public Member Functions

def Get (self)
def __deref__ (self)
def GetFirst (self)
def GetLast (self)
def Append (self, args)
def Insert (self, aNewElement, aElementAfterMe)
def Remove (self, aElement)
def begin (self)
def end (self)
def PopFront (self)
def PopBack (self)
def PushFront (self, aNewElement)
def PushBack (self, aNewElement)
def __iter__ (self)
def __init__ (self)
def ClassOf (self, aItem)
def Next (self)
def Back (self)
def Move (self, aMoveVector)
def Rotate (self, aRotCentre, aAngle)
def Flip (self, aCentre)
def SetPosition (self, aPos)
def GetPosition (self)
def SetWidth (self, aWidth)
def GetWidth (self)
def SetEnd (self, aEnd)
def GetEnd (self)
def SetStart (self, aStart)
def GetStart (self)
def GetEndPoint (self, aEndPoint)
def GetBoundingBox (self)
def IsLocked (self)
def SetLocked (self, aLocked)
def GetBestInsertPoint (self, aPcb)
def GetStartNetCode (self, NetCode)
def GetEndNetCode (self, NetCode)
def GetLength (self)
def Draw (self, args)
def TransformShapeWithClearanceToPolygon (self, aCornerBuffer, aClearanceValue, aCircleToSegmentsCount, aCorrectionFactor)
def IsPointOnEnds
def IsNull (self)
def GetMsgPanelInfo (self, aList)
def ShowWidth (self)
def Visit (self, inspector, testData, scanTypes)
def HitTest (self, args)
def GetVia (self, args)
def GetTrack (self, aStartTrace, aEndTrace, aEndPoint, aSameNetOnly, aSequential)
def GetEndSegments (self, NbSegm, StartTrack, EndTrack)
def GetClass (self)
def GetClearance
def GetSelectMenuText (self)
def GetMenuImage (self)
def Clone (self)
def ViewGetLayers (self, aLayers, aCount)
def ViewGetLOD (self, aLayer, aView)
def IsConnected (self)
def GetNet (self)
def SetNet (self, aNetInfo)
def GetNetCode (self)
def SetNetCode
def GetNetname (self)
def GetShortNetname (self)
def GetNetClass (self)
def GetNetClassName (self)
def SetLocalRatsnestVisible (self, aVisible)
def GetLocalRatsnestVisible (self)
def GetCenter (self)
def GetParent (self)
def GetLayer (self)
def GetLayerSet (self)
def SetLayer (self, aLayer)
def SwapData (self, aImage)
def IsOnLayer (self, aLayer)
def IsTrack (self)
def UnLink (self)
def DeleteStructure (self)
def ShowShape (self, aShape)
def GetBoard (self)
def GetLayerName (self)
def FormatInternalUnits (self, args)
def FormatAngle (self, aAngle)
def Type (self)
def SetTimeStamp (self, aNewTimeStamp)
def GetTimeStamp (self)
def GetList (self)
def SetParent (self, aParent)
def SetList (self, aList)
def IsNew (self)
def IsModified (self)
def IsMoving (self)
def IsDragging (self)
def IsWireImage (self)
def IsSelected (self)
def IsResized (self)
def IsHighlighted (self)
def IsBrightened (self)
def SetWireImage (self)
def SetSelected (self)
def SetHighlighted (self)
def SetBrightened (self)
def ClearSelected (self)
def ClearHighlighted (self)
def ClearBrightened (self)
def SetModified (self)
def GetState (self, type)
def SetState (self, type, state)
def GetStatus (self)
def SetStatus (self, aStatus)
def SetFlags (self, aMask)
def ClearFlags
def GetFlags (self)
def SetForceVisible (self, aEnable)
def IterateForward (self, listStart, inspector, testData, scanTypes)
def Matches (self, aSearchData, aAuxData, aFindLocation)
def Replace (self, args)
def IsReplaceable (self)
def __lt__ (self, aItem)
def Sort (self, aLeft, aRight)
def ViewBBox (self)
- Public Member Functions inherited from pcbnew.DHEAD
def __init__ (self, args, kwargs)
def DeleteAll (self)
def SetOwnership (self, Iown)
def GetCount (self)

Public Attributes


Static Public Attributes

tuple ret = self.last.Get()
 ret = self.last
tuple start = _swig_property(_pcbnew.TRACK_List_start_get, _pcbnew.TRACK_List_start_set)
tuple end = _swig_property(_pcbnew.TRACK_List_end_get, _pcbnew.TRACK_List_end_set)
tuple m_Param = _swig_property(_pcbnew.TRACK_List_m_Param_get, _pcbnew.TRACK_List_m_Param_set)

Detailed Description

Proxy of C++ DLIST<(TRACK)> class

Definition at line 22984 of file

Constructor & Destructor Documentation

def pcbnew.TRACK_List.__init__ (   self)
__init__(DLIST<(TRACK)> self) -> TRACK_List

Definition at line 23101 of file

Member Function Documentation

def pcbnew.TRACK_List.__deref__ (   self)
__deref__(TRACK_List self) -> TRACK

Definition at line 23001 of file

def pcbnew.TRACK_List.__iter__ (   self)

Definition at line 23096 of file

def pcbnew.TRACK_List.__lt__ (   self,
__lt__(TRACK_List self, EDA_ITEM aItem) -> bool

Definition at line 24541 of file

def pcbnew.TRACK_List.Append (   self,
Append(TRACK_List self, TRACK aNewElement)
Append(TRACK_List self, TRACK_List aList)

Definition at line 23016 of file

def pcbnew.TRACK_List.Back (   self)
Back(TRACK_List self) -> TRACK

TRACK* TRACK::Back() const 

Definition at line 23137 of file

def pcbnew.TRACK_List.begin (   self)
begin(TRACK_List self) -> TRACK

Definition at line 23034 of file

def pcbnew.TRACK_List.ClassOf (   self,
ClassOf(TRACK_List self, EDA_ITEM aItem) -> bool

Definition at line 23111 of file

def pcbnew.TRACK_List.ClearBrightened (   self)
ClearBrightened(TRACK_List self)


Definition at line 24348 of file

def pcbnew.TRACK_List.ClearFlags (   self,
  aMask = -1 
ClearFlags(TRACK_List self, STATUS_FLAGS aMask=-1)
ClearFlags(TRACK_List self)


Definition at line 24418 of file

def pcbnew.TRACK_List.ClearHighlighted (   self)
ClearHighlighted(TRACK_List self)


Definition at line 24338 of file

def pcbnew.TRACK_List.ClearSelected (   self)
ClearSelected(TRACK_List self)


Definition at line 24328 of file

def pcbnew.TRACK_List.Clone (   self)
Clone(TRACK_List self) -> EDA_ITEM

EDA_ITEM * TRACK::Clone() const

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.

A clone of the item. 

Definition at line 23713 of file

def pcbnew.TRACK_List.DeleteStructure (   self)
DeleteStructure(TRACK_List self)


Function DeleteStructure deletes this object after UnLink()ing it from
its owner if it has one. 

Definition at line 24073 of file

def pcbnew.TRACK_List.Draw (   self,
Draw(TRACK_List self, EDA_DRAW_PANEL * panel, wxDC * DC, GR_DRAWMODE aDrawMode, wxPoint aOffset)
Draw(TRACK_List self, EDA_DRAW_PANEL * panel, wxDC * DC, GR_DRAWMODE aDrawMode)

*panel, wxDC *DC, GR_DRAWMODE aDrawMode, const wxPoint
&aOffset=ZeroOffset) override

Function Draw BOARD_ITEMs have their own color information. 

Definition at line 23395 of file

Here is the caller graph for this function:

def pcbnew.TRACK_List.end (   self)
end(TRACK_List self) -> TRACK

Definition at line 23039 of file

def pcbnew.TRACK_List.Flip (   self,
Flip(TRACK_List self, wxPoint aCentre)

void TRACK::Flip(const wxPoint
&aCentre) override

Function Flip Flip this object, i.e.

change the board side for this object


aCentre:  - the rotation point. 

Definition at line 23182 of file

def pcbnew.TRACK_List.FormatAngle (   self,
FormatAngle(TRACK_List self, double aAngle) -> string

Definition at line 24128 of file

def pcbnew.TRACK_List.FormatInternalUnits (   self,
FormatInternalUnits(TRACK_List self, int aValue) -> string
FormatInternalUnits(TRACK_List self, wxPoint aPoint) -> string
FormatInternalUnits(TRACK_List self, wxSize aSize) -> string

Definition at line 24119 of file

def pcbnew.TRACK_List.Get (   self)
Get(TRACK_List self) -> TRACK

Definition at line 22996 of file

def pcbnew.TRACK_List.GetBestInsertPoint (   self,
GetBestInsertPoint(TRACK_List self, BOARD aPcb) -> TRACK

TRACK::GetBestInsertPoint(BOARD *aPcb)

Function GetBestInsertPoint searches the "best" insertion point
within the track linked list.

The best point is the begging of the corresponding net code section.
(The BOARD::m_Track and BOARD::m_Zone lists are sorted by netcode.)


aPcb:  The BOARD to search for the insertion point.

TRACK* - the item found in the linked list (or NULL if no track) 

Definition at line 23337 of file

def pcbnew.TRACK_List.GetBoard (   self)
GetBoard(TRACK_List self) -> BOARD

BOARD_ITEM::GetBoard() const

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

Definition at line 24091 of file

def pcbnew.TRACK_List.GetBoundingBox (   self)
GetBoundingBox(TRACK_List self) -> EDA_RECT

const EDA_RECT
TRACK::GetBoundingBox() const override

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.

Definition at line 23293 of file

def pcbnew.TRACK_List.GetCenter (   self)
GetCenter(TRACK_List self) -> wxPoint

virtual const wxPoint
BOARD_ITEM::GetCenter() const

Function GetCenter()

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

centre point of the item 

Definition at line 23928 of file

def pcbnew.TRACK_List.GetClass (   self)
GetClass(TRACK_List self) -> wxString

wxString TRACK::GetClass()
const override

Function GetClass returns the class name.


Definition at line 23638 of file

def pcbnew.TRACK_List.GetClearance (   self,
  aItem = None 
GetClearance(TRACK_List self, BOARD_CONNECTED_ITEM aItem=None) -> int
GetClearance(TRACK_List self) -> int

TRACK::GetClearance(BOARD_CONNECTED_ITEM *aItem=NULL) const override

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.


aItem:  is another BOARD_CONNECTED_ITEM or NULL

int - the clearance in internal units. 

Definition at line 23652 of file

def pcbnew.TRACK_List.GetEnd (   self)
GetEnd(TRACK_List self) -> wxPoint

const wxPoint& TRACK::GetEnd()

Definition at line 23251 of file

def pcbnew.TRACK_List.GetEndNetCode (   self,
GetEndNetCode(TRACK_List self, int NetCode) -> TRACK

TRACK::GetEndNetCode(int NetCode) 

Definition at line 23370 of file

def pcbnew.TRACK_List.GetEndPoint (   self,
GetEndPoint(TRACK_List self, ENDPOINT_T aEndPoint) -> wxPoint

const wxPoint&
TRACK::GetEndPoint(ENDPOINT_T aEndPoint) const

Return the selected endpoint (start or end) 

Definition at line 23281 of file

def pcbnew.TRACK_List.GetEndSegments (   self,
GetEndSegments(TRACK_List self, int NbSegm, TRACK ** StartTrack, TRACK ** EndTrack) -> int

TRACK::GetEndSegments(int NbSegm, TRACK **StartTrack, TRACK

Function GetEndSegments get the segments connected to the end point of
the track.

return 1 if OK, 0 when a track is a closed loop and the beginning and
the end of the track in *StartTrack and *EndTrack Modify *StartTrack
en *EndTrack : (*StartTrack)->m_Start coordinate is the beginning of
the track (*EndTrack)->m_End coordinate is the end of the track
Segments connected must be consecutive in list 

Definition at line 23618 of file

def pcbnew.TRACK_List.GetFirst (   self)
GetFirst(TRACK_List self) -> TRACK

Definition at line 23006 of file

def pcbnew.TRACK_List.GetFlags (   self)
GetFlags(TRACK_List self) -> STATUS_FLAGS

EDA_ITEM::GetFlags() const 

Definition at line 24429 of file

def pcbnew.TRACK_List.GetLast (   self)
GetLast(TRACK_List self) -> TRACK

Definition at line 23011 of file

def pcbnew.TRACK_List.GetLayer (   self)
GetLayer(TRACK_List self) -> PCB_LAYER_ID

BOARD_ITEM::GetLayer() const

Function GetLayer returns the primary layer this item is on. 

Definition at line 23955 of file

def pcbnew.TRACK_List.GetLayerName (   self)
GetLayerName(TRACK_List self) -> wxString

BOARD_ITEM::GetLayerName() const

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

wxString containing the layer name associated with this item. 

Definition at line 24104 of file

def pcbnew.TRACK_List.GetLayerSet (   self)
GetLayerSet(TRACK_List self) -> LSET

virtual LSET
BOARD_ITEM::GetLayerSet() const

Function GetLayerSet returns a "layer mask", which is a bitmap of
all layers on which the TRACK segment or VIA physically resides.

int - a layer mask, see layers_id_colors_visibility.h. 

Definition at line 23967 of file

def pcbnew.TRACK_List.GetLength (   self)
GetLength(TRACK_List self) -> double

double TRACK::GetLength()

Function GetLength returns the length of the track using the
hypotenuse calculation.

double - the length of the track 

Definition at line 23380 of file

def pcbnew.TRACK_List.GetList (   self)
GetList(TRACK_List self) -> DHEAD


Definition at line 24168 of file

def pcbnew.TRACK_List.GetLocalRatsnestVisible (   self)
GetLocalRatsnestVisible(TRACK_List self) -> bool

bool BOARD_CONNECTED_ITEM::GetLocalRatsnestVisible() const 

Definition at line 23919 of file

def pcbnew.TRACK_List.GetMenuImage (   self)
GetMenuImage(TRACK_List self) -> BITMAP_DEF

TRACK::GetMenuImage() const override

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

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

Definition at line 23696 of file

def pcbnew.TRACK_List.GetMsgPanelInfo (   self,
GetMsgPanelInfo(TRACK_List self, std::vector< MSG_PANEL_ITEM,std::allocator< MSG_PANEL_ITEM > > & aList)

TRACK::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.

This method replaces DisplayInfo() so that KiCad objects no longer
have any knowledge of wxWidgets UI objects.


aList:  is the list to populate. 

Definition at line 23467 of file

def pcbnew.TRACK_List.GetNet (   self)
GetNet(TRACK_List self) -> NETINFO_ITEM


Function GetNet Returns NET_INFO object for a given item. 

Definition at line 23792 of file

def pcbnew.TRACK_List.GetNetClass (   self)
GetNetClass(TRACK_List self) -> std::shared_ptr< NETCLASS >


Function GetNetClass returns the NETCLASS for this item. 

Definition at line 23882 of file

def pcbnew.TRACK_List.GetNetClassName (   self)
GetNetClassName(TRACK_List self) -> wxString

wxString BOARD_CONNECTED_ITEM::GetNetClassName() const

Function GetNetClassName returns a pointer to the netclass of the

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). the Net Class name of this item 

Definition at line 23894 of file

def pcbnew.TRACK_List.GetNetCode (   self)
GetNetCode(TRACK_List self) -> int


Function GetNetCode.

int - the net code. 

Definition at line 23816 of file

def pcbnew.TRACK_List.GetNetname (   self)
GetNetname(TRACK_List self) -> wxString

wxString& BOARD_CONNECTED_ITEM::GetNetname() const

Function GetNetname.

wxString - the full netname 

Definition at line 23854 of file

def pcbnew.TRACK_List.GetParent (   self)

BOARD_ITEM::GetParent() const 

Definition at line 23945 of file

def pcbnew.TRACK_List.GetPosition (   self)
GetPosition(TRACK_List self) -> wxPoint

const wxPoint&
TRACK::GetPosition() const override 

Definition at line 23211 of file

Here is the caller graph for this function:

def pcbnew.TRACK_List.GetSelectMenuText (   self)
GetSelectMenuText(TRACK_List self) -> wxString

TRACK::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.

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.

The menu text string. 

Definition at line 23676 of file

def pcbnew.TRACK_List.GetShortNetname (   self)
GetShortNetname(TRACK_List self) -> wxString

wxString& BOARD_CONNECTED_ITEM::GetShortNetname() const

Function GetShortNetname.

wxString - the short netname 

Definition at line 23868 of file

def pcbnew.TRACK_List.GetStart (   self)
GetStart(TRACK_List self) -> wxPoint

const wxPoint&
TRACK::GetStart() const 

Definition at line 23271 of file

def pcbnew.TRACK_List.GetStartNetCode (   self,
GetStartNetCode(TRACK_List self, int NetCode) -> TRACK

TRACK::GetStartNetCode(int NetCode) 

Definition at line 23360 of file

def pcbnew.TRACK_List.GetState (   self,
GetState(TRACK_List self, int type) -> int

int EDA_ITEM::GetState(int
type) const 

Definition at line 24368 of file

def pcbnew.TRACK_List.GetStatus (   self)
GetStatus(TRACK_List self) -> STATUS_FLAGS

EDA_ITEM::GetStatus() const 

Definition at line 24388 of file

def pcbnew.TRACK_List.GetTimeStamp (   self)
GetTimeStamp(TRACK_List self) -> time_t

EDA_ITEM::GetTimeStamp() const 

Definition at line 24158 of file

def pcbnew.TRACK_List.GetTrack (   self,
GetTrack(TRACK_List self, TRACK aStartTrace, TRACK aEndTrace, ENDPOINT_T aEndPoint, bool aSameNetOnly, bool aSequential) -> TRACK

*aStartTrace, TRACK *aEndTrace, ENDPOINT_T aEndPoint, bool
aSameNetOnly, bool aSequential)

Function GetTrack returns the trace segment connected to the segment
at aEndPoint from aStartTrace to aEndTrace.


aStartTrace:  A pointer to the TRACK object to begin searching.

aEndTrace:  A pointer to the TRACK object to stop the search. A NULL
value searches to the end of the list.

aEndPoint:  The start or end point of the segment to test against.

aSameNetOnly:  if true stop searching when the netcode changes

aSequential:  If true, forces a forward sequential search, which is
restartable; the default search can be faster but the position of the
returned track in the list is unpredictable

A TRACK object pointer if found otherwise NULL. 

Definition at line 23586 of file

def pcbnew.TRACK_List.GetVia (   self,
GetVia(TRACK_List self, wxPoint aPosition, PCB_LAYER_ID aLayer=UNDEFINED_LAYER) -> VIA
GetVia(TRACK_List self, wxPoint aPosition) -> VIA
GetVia(TRACK_List self, TRACK aEndTrace, wxPoint aPosition, LSET aLayerMask) -> VIA

*aEndTrace, const wxPoint &aPosition, LSET aLayerMask)

Function GetVia finds the first VIA object at aPosition on aLayer
starting at the trace and ending at aEndTrace.


aEndTrace:  Pointer to the last TRACK object to end search.

aPosition:  The wxPoint to HitTest() against.

aLayerMask:  The layers to match, pass -1 for a don't care.

A pointer to a VIA object if found, else NULL. 

Definition at line 23560 of file

def pcbnew.TRACK_List.GetWidth (   self)
GetWidth(TRACK_List self) -> int

int TRACK::GetWidth() const

Definition at line 23231 of file

def pcbnew.TRACK_List.HitTest (   self,
HitTest(TRACK_List self, wxPoint aPosition) -> bool
HitTest(TRACK_List self, EDA_RECT aRect, bool aContained=True, int aAccuracy=0) -> bool
HitTest(TRACK_List self, EDA_RECT aRect, bool aContained=True) -> bool
HitTest(TRACK_List self, EDA_RECT aRect) -> bool

bool TRACK::HitTest(const
EDA_RECT &aRect, bool aContained=true, int aAccuracy=0) const override

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


aRect:  A reference to an EDA_RECT object containg the area to test.

aContained:  Test if aRect contains this object completly.

aAccuracy:  Increase the item bounding box by this amount.

bool - True if aRect contains this object completly or if aRect
intersects the object and aContained is False, otherwise false. 

Definition at line 23532 of file

Here is the caller graph for this function:

def pcbnew.TRACK_List.Insert (   self,
Insert(TRACK_List self, TRACK aNewElement, TRACK aElementAfterMe)

Definition at line 23024 of file

def pcbnew.TRACK_List.IsBrightened (   self)
IsBrightened(TRACK_List self) -> bool

EDA_ITEM::IsBrightened() const 

Definition at line 24278 of file

def pcbnew.TRACK_List.IsConnected (   self)
IsConnected(TRACK_List self) -> bool

BOARD_CONNECTED_ITEM::IsConnected() const override


Function IsConnected() Returns information if the object is derived
from BOARD_CONNECTED_ITEM. True if the object is of
BOARD_CONNECTED_ITEM type, false otherwise. 

Definition at line 23776 of file

def pcbnew.TRACK_List.IsDragging (   self)
IsDragging(TRACK_List self) -> bool

EDA_ITEM::IsDragging() const 

Definition at line 24228 of file

def pcbnew.TRACK_List.IsHighlighted (   self)
IsHighlighted(TRACK_List self) -> bool

EDA_ITEM::IsHighlighted() const 

Definition at line 24268 of file

def pcbnew.TRACK_List.IsLocked (   self)
IsLocked(TRACK_List self) -> bool

bool TRACK::IsLocked() const

Function IsLocked.

bool - true if the object is locked, else false 

Definition at line 23311 of file

def pcbnew.TRACK_List.IsModified (   self)
IsModified(TRACK_List self) -> bool

EDA_ITEM::IsModified() const 

Definition at line 24208 of file

def pcbnew.TRACK_List.IsMoving (   self)
IsMoving(TRACK_List self) -> bool

bool EDA_ITEM::IsMoving()

Definition at line 24218 of file

def pcbnew.TRACK_List.IsNew (   self)
IsNew(TRACK_List self) -> bool

bool EDA_ITEM::IsNew() const

Definition at line 24198 of file

def pcbnew.TRACK_List.IsNull (   self)
IsNull(TRACK_List self) -> bool

bool TRACK::IsNull()

Function IsNull returns true if segment length is zero. 

Definition at line 23456 of file

def pcbnew.TRACK_List.IsOnLayer (   self,
IsOnLayer(TRACK_List self, PCB_LAYER_ID aLayer) -> bool

virtual bool
BOARD_ITEM::IsOnLayer(PCB_LAYER_ID aLayer) const

Function IsOnLayer tests to see if this object is on the given layer.

Is virtual so objects like D_PAD, which reside on multiple layers can
do their own form of testing.


aLayer:  The layer to test for.

bool - true if on given layer, else false. 

Definition at line 24022 of file

def pcbnew.TRACK_List.IsPointOnEnds (   self,
  min_dist = 0 
IsPointOnEnds(TRACK_List self, wxPoint point, int min_dist=0) -> STATUS_FLAGS
IsPointOnEnds(TRACK_List self, wxPoint point) -> STATUS_FLAGS

TRACK::IsPointOnEnds(const wxPoint &point, int min_dist=0)

Function IsPointOnEnds returns STARTPOINT if point if near (dist =
min_dist) start point, ENDPOINT if point if near (dist = min_dist) end
point,STARTPOINT|ENDPOINT if point if near (dist = min_dist) both
ends, or 0 if none of the above.

if min_dist < 0: min_dist = track_width/2 

Definition at line 23438 of file

def pcbnew.TRACK_List.IsReplaceable (   self)
IsReplaceable(TRACK_List self) -> bool

virtual bool
EDA_ITEM::IsReplaceable() const

Function IsReplaceable.

Override this method in any derived object that supports test find and

True if the item has replaceable text that can be modified using the
find and replace dialog. 

Definition at line 24523 of file

def pcbnew.TRACK_List.IsResized (   self)
IsResized(TRACK_List self) -> bool

EDA_ITEM::IsResized() const 

Definition at line 24258 of file

def pcbnew.TRACK_List.IsSelected (   self)
IsSelected(TRACK_List self) -> bool

EDA_ITEM::IsSelected() const 

Definition at line 24248 of file

def pcbnew.TRACK_List.IsTrack (   self)
IsTrack(TRACK_List self) -> bool

BOARD_ITEM::IsTrack() const

Function IsTrack tests to see if this object is a track or via (or

form of testing. bool - true if a track or via, else false. 

Definition at line 24044 of file

def pcbnew.TRACK_List.IsWireImage (   self)
IsWireImage(TRACK_List self) -> bool

EDA_ITEM::IsWireImage() const 

Definition at line 24238 of file

def pcbnew.TRACK_List.IterateForward (   self,
IterateForward(TRACK_List self, EDA_ITEM listStart, INSPECTOR inspector, void * testData, KICAD_T const [] scanTypes) -> SEARCH_RESULT

Definition at line 24459 of file

Here is the caller graph for this function:

def pcbnew.TRACK_List.Matches (   self,
Matches(TRACK_List self, wxFindReplaceData & aSearchData, void * aAuxData, wxPoint aFindLocation) -> bool

virtual bool
EDA_ITEM::Matches(wxFindReplaceData &aSearchData, void *aAuxData,
wxPoint *aFindLocation)

Function Matches compares the item against the search criteria in

The base class returns false since many of the objects derived from
EDA_ITEM do not have any text to search.


aSearchData:  A reference to a wxFindReplaceData object containing the
search criteria.

aAuxData:  A pointer to optional data required for the search or NULL
if not used.

aFindLocation:  A pointer to a wxPoint object to store the location of
matched item. The pointer can be NULL if it is not used.

True if the item's text matches the search criteria in aSearchData. 

Definition at line 24464 of file

def pcbnew.TRACK_List.Move (   self,
Move(TRACK_List self, wxPoint aMoveVector)

virtual void TRACK::Move(const
wxPoint &aMoveVector) override

Function Move move this object.


aMoveVector:  - the move vector for this object. 

Definition at line 23146 of file

def pcbnew.TRACK_List.Next (   self)
Next(TRACK_List self) -> TRACK

TRACK* TRACK::Next() const 

Definition at line 23128 of file

def pcbnew.TRACK_List.PopBack (   self)
PopBack(TRACK_List self) -> TRACK

Definition at line 23049 of file

def pcbnew.TRACK_List.PopFront (   self)
PopFront(TRACK_List self) -> TRACK

Definition at line 23044 of file

def pcbnew.TRACK_List.PushBack (   self,
PushBack(TRACK_List self, TRACK aNewElement)

Definition at line 23059 of file

def pcbnew.TRACK_List.PushFront (   self,
PushFront(TRACK_List self, TRACK aNewElement)

Definition at line 23054 of file

def pcbnew.TRACK_List.Remove (   self,
Remove(TRACK_List self, TRACK aElement) -> TRACK

Definition at line 23029 of file

def pcbnew.TRACK_List.Replace (   self,
Replace(TRACK_List self, wxFindReplaceData & aSearchData, wxString aText) -> bool
Replace(TRACK_List self, wxFindReplaceData & aSearchData, void * aAuxData=None) -> bool
Replace(TRACK_List self, wxFindReplaceData & aSearchData) -> bool

virtual bool
EDA_ITEM::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.

This function must be overridden for items that support text replace.


aSearchData:  A reference to a wxFindReplaceData object containing the
search and replace criteria.

aAuxData:  A pointer to optional data required for the search or NULL
if not used.

True if the item text was modified, otherwise false. 

Definition at line 24495 of file

def pcbnew.TRACK_List.Rotate (   self,
Rotate(TRACK_List self, wxPoint aRotCentre, double aAngle)

void TRACK::Rotate(const
wxPoint &aRotCentre, double aAngle) override

Function Rotate Rotate this object.


aRotCentre:  - the rotation point.

aAngle:  - the rotation angle in 0.1 degree. 

Definition at line 23163 of file

def pcbnew.TRACK_List.SetBrightened (   self)
SetBrightened(TRACK_List self)


Definition at line 24318 of file

def pcbnew.TRACK_List.SetEnd (   self,
SetEnd(TRACK_List self, wxPoint aEnd)

void TRACK::SetEnd(const
wxPoint &aEnd) 

Definition at line 23241 of file

def pcbnew.TRACK_List.SetFlags (   self,
SetFlags(TRACK_List self, STATUS_FLAGS aMask)


Definition at line 24408 of file

def pcbnew.TRACK_List.SetForceVisible (   self,
SetForceVisible(TRACK_List self, bool aEnable)

EDA_ITEM::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.


aEnable:  True forces the item to be drawn. False uses the item's
visibility setting to determine if the item is to be drawn. 

Definition at line 24439 of file

def pcbnew.TRACK_List.SetHighlighted (   self)
SetHighlighted(TRACK_List self)


Definition at line 24308 of file

def pcbnew.TRACK_List.SetLayer (   self,
SetLayer(TRACK_List self, PCB_LAYER_ID aLayer)

virtual void

Function SetLayer sets the layer this item is on.


aLayer:  The layer number. is virtual because some items (in fact:
class DIMENSION) have a slightly different initialization 

Definition at line 23982 of file

def pcbnew.TRACK_List.SetList (   self,
SetList(TRACK_List self, DHEAD aList)

EDA_ITEM::SetList(DHEAD *aList) 

Definition at line 24188 of file

def pcbnew.TRACK_List.SetLocalRatsnestVisible (   self,
SetLocalRatsnestVisible(TRACK_List self, bool aVisible)

void BOARD_CONNECTED_ITEM::SetLocalRatsnestVisible(bool aVisible) 

Definition at line 23910 of file

def pcbnew.TRACK_List.SetLocked (   self,
SetLocked(TRACK_List self, bool aLocked)

void TRACK::SetLocked(bool
aLocked) override

Function SetLocked modifies 'lock' status for of the item. 

Definition at line 23325 of file

def pcbnew.TRACK_List.SetModified (   self)
SetModified(TRACK_List self)


Definition at line 24358 of file

def pcbnew.TRACK_List.SetNet (   self,
SetNet(TRACK_List self, NETINFO_ITEM aNetInfo)


Function SetNet Sets a NET_INFO object for the item. 

Definition at line 23804 of file

def pcbnew.TRACK_List.SetNetCode (   self,
  aNoAssert = False 
SetNetCode(TRACK_List self, int aNetCode, bool aNoAssert=False) -> bool
SetNetCode(TRACK_List self, int aNetCode) -> bool

BOARD_CONNECTED_ITEM::SetNetCode(int aNetCode, bool aNoAssert=false)

Function SetNetCode sets net using a net code.


aNetCode:  is a net code for the new net. It has to exist in

aNoAssert:  if true, do not assert that the net exists. Otherwise,
item is assigned to the unconnected net.

true on success, false if the net did not exist 

Definition at line 23830 of file

def pcbnew.TRACK_List.SetParent (   self,
SetParent(TRACK_List self, EDA_ITEM aParent)

EDA_ITEM::SetParent(EDA_ITEM *aParent) 

Definition at line 24178 of file

def pcbnew.TRACK_List.SetPosition (   self,
SetPosition(TRACK_List self, wxPoint aPos)

TRACK::SetPosition(const wxPoint &aPos) override 

Definition at line 23201 of file

def pcbnew.TRACK_List.SetSelected (   self)
SetSelected(TRACK_List self)


Definition at line 24298 of file

def pcbnew.TRACK_List.SetStart (   self,
SetStart(TRACK_List self, wxPoint aStart)

void TRACK::SetStart(const
wxPoint &aStart) 

Definition at line 23261 of file

def pcbnew.TRACK_List.SetState (   self,
SetState(TRACK_List self, int type, int state)

EDA_ITEM::SetState(int type, int state) 

Definition at line 24378 of file

def pcbnew.TRACK_List.SetStatus (   self,
SetStatus(TRACK_List self, STATUS_FLAGS aStatus)

EDA_ITEM::SetStatus(STATUS_FLAGS aStatus) 

Definition at line 24398 of file

def pcbnew.TRACK_List.SetTimeStamp (   self,
SetTimeStamp(TRACK_List self, time_t aNewTimeStamp)

EDA_ITEM::SetTimeStamp(time_t aNewTimeStamp) 

Definition at line 24148 of file

def pcbnew.TRACK_List.SetWidth (   self,
SetWidth(TRACK_List self, int aWidth)

void TRACK::SetWidth(int

Definition at line 23221 of file

def pcbnew.TRACK_List.SetWireImage (   self)
SetWireImage(TRACK_List self)


Definition at line 24288 of file

def pcbnew.TRACK_List.ShowShape (   self,
ShowShape(TRACK_List self, STROKE_T aShape) -> wxString

Definition at line 24086 of file

def pcbnew.TRACK_List.ShowWidth (   self)
ShowWidth(TRACK_List self) -> wxString

wxString TRACK::ShowWidth()

Function ShowWidth returns the width of the track in displayable user

Definition at line 23488 of file

def pcbnew.TRACK_List.Sort (   self,
Sort(TRACK_List self, EDA_ITEM aLeft, EDA_ITEM aRight) -> bool

Definition at line 24546 of file

def pcbnew.TRACK_List.SwapData (   self,
SwapData(TRACK_List self, BOARD_ITEM aImage)


Swap data between aItem and aImage.

aItem and aImage should have the same type Used in undo redo command
to swap values between an item and its copy Only values like layer,
size .. which are modified by edition are swapped, not the pointers
like Pnext and Pback because aItem is not changed in the linked list


aImage:  = the item image which contains data to swap 

Definition at line 24000 of file

def pcbnew.TRACK_List.TransformShapeWithClearanceToPolygon (   self,
TransformShapeWithClearanceToPolygon(TRACK_List self, SHAPE_POLY_SET aCornerBuffer, int aClearanceValue, int aCircleToSegmentsCount, double aCorrectionFactor)

void TRACK::TransformShapeWithClearanceToPolygon(SHAPE_POLY_SET
&aCornerBuffer, int aClearanceValue, int aCircleToSegmentsCount,
double aCorrectionFactor) const

Function TransformShapeWithClearanceToPolygon Convert the track shape
to a closed polygon Used in filling zones calculations Circles (vias)
and arcs (ends of tracks) are approximated by segments.


aCornerBuffer:  = a buffer to store the polygon

aClearanceValue:  = the clearance around the pad

aCircleToSegmentsCount:  = the number of segments to approximate a

aCorrectionFactor:  = the correction to apply to circles radius to
keep clearance when the circle is approximated by segment bigger or
equal to the real clearance value (usually near from 1.0) 

Definition at line 23409 of file

def pcbnew.TRACK_List.Type (   self)
Type(TRACK_List self) -> KICAD_T

KICAD_T EDA_ITEM::Type() const

Function Type()

returns the type of object. This attribute should never be changed
after a constructor sets it, so there is no public "setter" method.
KICAD_T - the type of object. 

Definition at line 24133 of file

def pcbnew.TRACK_List.UnLink (   self)
UnLink(TRACK_List self)

void BOARD_ITEM::UnLink()

Function UnLink detaches this object from its owner.

This base class implementation should work for all derived classes
which are held in a DLIST<>. 

Definition at line 24059 of file

Here is the caller graph for this function:

def pcbnew.TRACK_List.ViewBBox (   self)
ViewBBox(TRACK_List self) -> BOX2I const

const BOX2I
EDA_ITEM::ViewBBox() const override

Function ViewBBox() returns the bounding box of the item covering all
its layers.

BOX2I - the current bounding box 

Definition at line 24551 of file

def pcbnew.TRACK_List.ViewGetLayers (   self,
ViewGetLayers(TRACK_List self, int [] aLayers, int & aCount)

TRACK::ViewGetLayers(int aLayers[], int &aCount) const override

Function ViewGetLayers() Returns the all the layers within the VIEW
the object is painted on.

For instance, a D_PAD spans zero or more copper layers and a few
technical layers. ViewDraw() or PAINTER::Draw() is repeatedly called
for each of the layers returned by ViewGetLayers(), depending on the
rendering order.


aLayers[]:  output layer index array

aCount:  number of layer indices in aLayers[] 

Definition at line 23736 of file

def pcbnew.TRACK_List.ViewGetLOD (   self,
ViewGetLOD(TRACK_List self, int aLayer, KIGFX::VIEW * aView) -> unsigned int

unsigned int
TRACK::ViewGetLOD(int aLayer, KIGFX::VIEW *aView) const override

Function ViewGetLOD() Returns the level of detail of the item.

A level of detail is the minimal VIEW scale that is sufficient for an
item to be shown on a given layer. 

Definition at line 23761 of file

def pcbnew.TRACK_List.Visit (   self,
Visit(TRACK_List self, INSPECTOR inspector, void * testData, KICAD_T const [] scanTypes) -> SEARCH_RESULT

TRACK::Visit(INSPECTOR inspector, void *testData, const KICAD_T
scanTypes[]) override

Function Visit may be re-implemented for each derived class in order
to handle all the types given by its member data.

Implementations should call inspector->Inspect() on types in
scanTypes[], and may use IterateForward() to do so on lists of such


inspector:  An INSPECTOR instance to use in the inspection.

testData:  Arbitrary data used by the inspector.

scanTypes:  Which KICAD_T types are of interest and the order is
significant too, terminated by EOT.

SEARCH_RESULT SEARCH_QUIT if the Iterator is to stop the scan, else
SCAN_CONTINUE, and determined by the inspector. 

Definition at line 23501 of file

Member Data Documentation

tuple pcbnew.TRACK_List.end = _swig_property(_pcbnew.TRACK_List_end_get, _pcbnew.TRACK_List_end_set)

Definition at line 23122 of file

tuple pcbnew.TRACK_List.m_Param = _swig_property(_pcbnew.TRACK_List_m_Param_get, _pcbnew.TRACK_List_m_Param_set)

Definition at line 23126 of file

tuple pcbnew.TRACK_List.ret = self.last.Get()

Definition at line 23083 of file

pcbnew.TRACK_List.ret = self.last

Definition at line 23085 of file

tuple pcbnew.TRACK_List.start = _swig_property(_pcbnew.TRACK_List_start_get, _pcbnew.TRACK_List_start_set)

Definition at line 23118 of file


Definition at line 23107 of file

The documentation for this class was generated from the following file: