SWIG Improvements

*) Extend SWIG support deeper into the BOARD class.
*) Move swig *.i files into a directory identified for SWIG, in preparation
   for a parallel universe involving Phoenix's SIP.
*) Move swig files which will be common to both eeschema and pcbnew into
   common/swig.
*) Sketch out a "common" python module, and plan on dovetailing that into a
   libkicad_shared.{dll,so}
*) Add common/swig/ki_exceptions.i and define a macro HANDLE_EXCEPTIONS()
   which is to be applied to any function which needs C++ to python
   exception translation.
*) Move the test for SWIG tool into top level CMakeLists.txt file for use
   in all python modules beyond pcbnew, i.e. eeschema and common.
*) Add SWIG_MODULE_pcbnew_EXTRA_DEPS which generates a better Makefile, one
   which rebuilds the swig generated *.cxx file when one of its dependencies
   change.
*) Re-architect the board.i file so that it can be split into multiple *.i
   files easily.
*) Make some KIWAY from python progress, in preparation for Modular KiCad
   phase III.

pcbnew/python/examples/createFPC40.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python2.7
+from pcbnew import *
+
+size_025_160mm = wxSizeMM(0.25,1.6)
+size_150_200mm = wxSizeMM(1.50,2.0)
+pads = 40
+
+# create a blank board
+pcb = BOARD()
+
+pcb.m_NetClasses.GetDefault().SetClearance(FromMM(0.1))
+
+# create a new module, it's parent is our previously created pcb
+module = MODULE(pcb)
+module.SetReference("FPC"+str(pads))   # give it a reference name
+module.Reference().SetPos0(wxPointMM(-1,-1))
+pcb.Add(module)             # add it to our pcb
+m_pos = wxPointMM(50,50)
+module.SetPosition(m_pos)
+
+# create a pad array and add it to the module
+
+
+def smdRectPad(module,size,pos,name):
+    pad = D_PAD(module)
+    pad.SetSize(size)
+    pad.SetShape(PAD_RECT)
+    pad.SetAttribute(PAD_SMD)
+    pad.SetLayerMask(PAD_SMD_DEFAULT_LAYERS)
+    pad.SetPos0(pos)
+    pad.SetPadName(name)
+    return pad
+
+for n in range (0,pads):
+    pad = smdRectPad(module,size_025_160mm,wxPointMM(0.5*n,0),str(n+1))
+    module.Add(pad)
+
+
+pad_s0 = smdRectPad(module,size_150_200mm,wxPointMM(-1.6,1.3),"0")
+pad_s1 = smdRectPad(module,size_150_200mm,wxPointMM((pads-1)*0.5+1.6,1.3),"0")
+module.Add(pad_s0)
+module.Add(pad_s1)
+
+e = EDGE_MODULE(module)
+e.SetStart0(wxPointMM(-1,0))
+e.SetEnd0(wxPointMM(0,0))
+e.SetWidth(FromMM(0.2))
+e.SetLayer(EDGE_LAYER)
+e.SetShape(S_SEGMENT)
+module.Add(e)
+
+# save the PCB to disk
+fpid = FPID("FPC"+str(pads))   #the name in library
+module.SetFPID( fpid )
+
+try:
+    FootprintLibCreate("fpc40.mod")
+except:
+    pass # we try to create, but may be it exists already
+FootprintSave("fpc40.mod",module)

pcbnew/python/examples/createPcb.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python2.7
+from pcbnew import *
+
+size_0_6mm = wxSizeMM(0.6,0.6)
+size_1_0mm = wxSizeMM(1.0,1.0)
+
+# create a blank board
+pcb = BOARD()
+
+pcb.m_NetClasses.GetDefault().SetClearance(FromMM(0.1))
+
+# create a new module, it's parent is our previously created pcb
+module = MODULE(pcb)
+module.SetReference("M1")   # give it a reference name
+module.Reference().SetPos0(wxPointMM(-10,-10))
+pcb.Add(module)             # add it to our pcb
+m_pos = wxPointMM(50,50)
+module.SetPosition(m_pos)
+
+# create a pad array and add it to the module
+n = 1
+for y in range (0,10):
+    for x in range (0,10):
+        pad = D_PAD(module)
+        pad.SetDrillSize(size_0_6mm)
+        pad.SetSize(size_1_0mm)
+        pt = wxPointMM(1.27*x,1.27*y)
+        pad.SetPos0(pt);
+        #pad.SetPosition(pt)
+        pad.SetPadName(str(n))
+        module.Add(pad)
+        n+=1
+
+
+# save the PCB to disk
+pcb.Save("my2.kicad_pcb")
+pcb.Save("my2.brd")
+
+pcb = LoadBoard("my2.kicad_pcb")
+
+print map( lambda x: x.GetReference() , list(pcb.GetModules()))
+
+for m in pcb.GetModules():
+    for p in m.Pads():
+        print p.GetPadName(), p.GetPosition(), p.GetOffset()
+
+
+# pcb.GetDesignSettings()

pcbnew/python/examples/hidePcbValuesShowReferences.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python
+import sys
+from pcbnew import *
+
+filename=sys.argv[1]
+
+pcb = LoadBoard(filename)
+
+for module in pcb.GetModules():    
+    print "* Module: %s"%module.GetReference()
+    module.Value().SetVisible(False)      # set Value as Hidden
+    module.Reference().SetVisible(True)   # set Reference as Visible
+    
+pcb.Save("mod_"+filename)	

pcbnew/python/examples/listPcb.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python
+import sys
+from pcbnew import *
+
+filename=sys.argv[1]
+
+pcb = LoadBoard(filename)
+
+ToUnits = ToMM
+FromUnits = FromMM
+#ToUnits=ToMils
+#FromUnits=FromMils
+
+print "LISTING VIAS:"
+
+for item in pcb.GetTracks():
+    if type(item) is VIA:
+
+        pos = item.GetPosition()
+        drill = item.GetDrillValue()
+        width = item.GetWidth()
+        print " * Via:   %s - %f/%f "%(ToUnits(pos),ToUnits(drill),ToUnits(width))
+
+    elif type(item) is TRACK:
+
+        start = item.GetStart()
+        end = item.GetEnd()
+        width = item.GetWidth()
+
+        print " * Track: %s to %s, width %f" % (ToUnits(start),ToUnits(end),ToUnits(width))
+
+    else:
+        print "Unknown type    %s" % type(item)
+
+print ""
+print "LIST DRAWINGS:"
+
+for item in pcb.GetDrawings():
+    if type(item) is TEXTE_PCB:
+        print "* Text:    '%s' at %s"%(item.GetText(), item.GetPosition())
+    elif type(item) is DRAWSEGMENT:
+        print "* Drawing: %s"%item.GetShapeStr() # dir(item)
+    else:
+        print type(item)
+
+print ""
+print "LIST MODULES:"
+
+for module in pcb.GetModules():
+    print "* Module: %s at %s"%(module.GetReference(),ToUnits(module.GetPosition()))
+
+print ""
+print "Ratsnest cnt:",len(pcb.GetFullRatsnest())
+print "track w cnt:",len(pcb.GetTrackWidthList())
+print "via s cnt:",len(pcb.GetViasDimensionsList())
+
+print ""
+print "LIST ZONES:", pcb.GetAreaCount()
+
+for idx in range(0, pcb.GetAreaCount()):
+    zone=pcb.GetArea(idx)
+    print "zone:", idx, "priority:", zone.GetPriority(), "netname", zone.GetNetname()
+
+print ""
+print "NetClasses:", pcb.GetNetClasses().GetCount(),
+

pcbnew/python/examples/listPcbLibrary.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+from pcbnew import *
+
+lst = FootprintEnumerate("/usr/share/kicad/modules/sockets.mod")
+
+for name in lst:
+    m = FootprintLoad("/usr/share/kicad/modules/sockets.mod",name)
+    print name,"->",m.GetLibRef(), m.GetReference()
+
+    for p in m.Pads():
+        print "\t",p.GetPadName(),p.GetPosition(),p.GetPos0(), p.GetOffset()
+