diff --git a/FlatCAM.py b/FlatCAM.py
index 3f807e0d..18215a57 100644
--- a/FlatCAM.py
+++ b/FlatCAM.py
@@ -16,6 +16,7 @@ from gi.repository import GLib
from gi.repository import GObject
import simplejson as json
+import matplotlib
from matplotlib.figure import Figure
from numpy import arange, sin, pi
from matplotlib.backends.backend_gtk3agg import FigureCanvasGTK3Agg as FigureCanvas
@@ -482,7 +483,9 @@ class FlatCAMCNCjob(FlatCAMObj, CNCjob):
return
self.plot2(self.axes, tooldia=self.options["tooldia"])
- self.app.plotcanvas.auto_adjust_axes()
+
+ #self.app.plotcanvas.auto_adjust_axes()
+ GLib.idle_add(self.app.plotcanvas.auto_adjust_axes)
def convert_units(self, units):
factor = CNCjob.convert_units(self, units)
@@ -625,7 +628,8 @@ class FlatCAMGeometry(FlatCAMObj, Geometry):
print "WARNING: Did not plot:", str(type(geo))
- self.app.plotcanvas.auto_adjust_axes()
+ #self.app.plotcanvas.auto_adjust_axes()
+ GLib.idle_add(self.app.plotcanvas.auto_adjust_axes)
########################################
@@ -1267,13 +1271,16 @@ class App:
try:
f = open(filename, 'r')
except:
- print "WARNING: Failed to open project file:", filename
+ #print "WARNING: Failed to open project file:", filename
+ self.info("ERROR: Failed to open project file: %s" % filename)
return
try:
d = json.load(f, object_hook=dict2obj)
except:
- print "WARNING: Failed to parse project file:", filename
+ #print sys.exc_info()
+ #print "WARNING: Failed to parse project file:", filename
+ self.info("ERROR: Failed to parse project file: %s" % filename)
f.close()
return
diff --git a/camlib.py b/camlib.py
index 79d2b175..69129c8a 100644
--- a/camlib.py
+++ b/camlib.py
@@ -192,10 +192,38 @@ class ApertureMacro:
def __init__(self, name=None):
self.name = name
self.raw = ""
+
+ ## These below are recomputed for every aperture
+ ## definition, in other words, are temporary variables.
self.primitives = []
self.locvars = {}
self.geometry = None
+ def to_dict(self):
+ """
+ Returns the object in a serializable form. Only the name and
+ raw are required.
+
+ :return: Dictionary representing the object. JSON ready.
+ :rtype: dict
+ """
+
+ return {
+ 'name': self.name,
+ 'raw': self.raw
+ }
+
+ def from_dict(self, d):
+ """
+ Populates the object from a serial representation created
+ with ``self.to_dict()``.
+
+ :param d: Serial representation of an ApertureMacro object.
+ :return: None
+ """
+ for attr in ['name', 'raw']:
+ setattr(self, attr, d[attr])
+
def parse_content(self):
"""
Creates numerical lists for all primitives in the aperture
@@ -632,7 +660,7 @@ class Gerber (Geometry):
# from Geometry.
self.ser_attrs += ['int_digits', 'frac_digits', 'apertures', 'paths',
'buffered_paths', 'regions', 'flashes',
- 'flash_geometry']
+ 'flash_geometry', 'aperture_macros']
#### Parser patterns ####
# FS - Format Specification
@@ -714,55 +742,74 @@ class Gerber (Geometry):
Scales the objects' geometry on the XY plane by a given factor.
These are:
- * ``apertures``
- * ``paths``
+ * ``buffered_paths``
+ * ``flash_geometry``
+ * ``solid_geometry``
* ``regions``
- * ``flashes``
- Then ``buffered_paths``, ``flash_geometry`` and ``solid_geometry``
- are re-created with ``self.create_geometry()``.
+ NOTE:
+ Does not modify the data used to create these elements. If these
+ are recreated, the scaling will be lost. This behavior was modified
+ because of the complexity reached in this class.
+
:param factor: Number by which to scale.
:type factor: float
:rtype : None
"""
- ## Apertures
- # List of the non-dimension aperture parameters
- nonDimensions = ["type", "nVertices", "rotation"]
- for apid in self.apertures:
- for param in self.apertures[apid]:
- if param not in nonDimensions: # All others are dimensions.
- print "Tool:", apid, "Parameter:", param
- self.apertures[apid][param] *= factor
-
- ## Paths
- for path in self.paths:
- path['linestring'] = affinity.scale(path['linestring'],
- factor, factor, origin=(0, 0))
-
- ## Flashes
- for fl in self.flashes:
- fl['loc'] = affinity.scale(fl['loc'], factor, factor, origin=(0, 0))
+ # ## Apertures
+ # # List of the non-dimension aperture parameters
+ # nonDimensions = ["type", "nVertices", "rotation"]
+ # for apid in self.apertures:
+ # for param in self.apertures[apid]:
+ # if param not in nonDimensions: # All others are dimensions.
+ # print "Tool:", apid, "Parameter:", param
+ # self.apertures[apid][param] *= factor
+ #
+ # ## Paths
+ # for path in self.paths:
+ # path['linestring'] = affinity.scale(path['linestring'],
+ # factor, factor, origin=(0, 0))
+ #
+ # ## Flashes
+ # for fl in self.flashes:
+ # fl['loc'] = affinity.scale(fl['loc'], factor, factor, origin=(0, 0))
## Regions
for reg in self.regions:
reg['polygon'] = affinity.scale(reg['polygon'], factor, factor,
origin=(0, 0))
- # Now buffered_paths, flash_geometry and solid_geometry
- self.create_geometry()
+ ## Flashes
+ for flash in self.flash_geometry:
+ flash = affinity.scale(flash, factor, factor, origin=(0, 0))
+
+ ## Buffered paths
+ for bp in self.buffered_paths:
+ bp = affinity.scale(bp, factor, factor, origin=(0, 0))
+
+ ## solid_geometry ???
+ # It's a cascaded union of objects.
+ self.solid_geometry = affinity.scale(self.solid_geometry, factor,
+ factor, origin=(0, 0))
+
+ # # Now buffered_paths, flash_geometry and solid_geometry
+ # self.create_geometry()
def offset(self, vect):
"""
Offsets the objects' geometry on the XY plane by a given vector.
These are:
- * ``paths``
+ * ``buffered_paths``
+ * ``flash_geometry``
+ * ``solid_geometry``
* ``regions``
- * ``flashes``
- Then ``buffered_paths``, ``flash_geometry`` and ``solid_geometry``
- are re-created with ``self.create_geometry()``.
+ NOTE:
+ Does not modify the data used to create these elements. If these
+ are recreated, the scaling will be lost. This behavior was modified
+ because of the complexity reached in this class.
:param vect: (x, y) offset vector.
:type vect: tuple
@@ -771,25 +818,48 @@ class Gerber (Geometry):
dx, dy = vect
- ## Paths
- for path in self.paths:
- path['linestring'] = affinity.translate(path['linestring'],
- xoff=dx, yoff=dy)
-
- ## Flashes
- for fl in self.flashes:
- fl['loc'] = affinity.translate(fl['loc'], xoff=dx, yoff=dy)
+ # ## Paths
+ # for path in self.paths:
+ # path['linestring'] = affinity.translate(path['linestring'],
+ # xoff=dx, yoff=dy)
+ #
+ # ## Flashes
+ # for fl in self.flashes:
+ # fl['loc'] = affinity.translate(fl['loc'], xoff=dx, yoff=dy)
## Regions
for reg in self.regions:
reg['polygon'] = affinity.translate(reg['polygon'],
xoff=dx, yoff=dy)
- # Now buffered_paths, flash_geometry and solid_geometry
- self.create_geometry()
+ ## Buffered paths
+ for bp in self.buffered_paths:
+ bp = affinity.translate(bp, xoff=dx, yoff=dy)
+
+ ## Flash geometry
+ for fl in self.flash_geometry:
+ fl = affinity.translate(fl, xoff=dx, yoff=dy)
+
+ ## Solid geometry
+ self.solid_geometry = affinity.translate(self.solid_geometry, xoff=dx, yoff=dy)
+
+ # # Now buffered_paths, flash_geometry and solid_geometry
+ # self.create_geometry()
def mirror(self, axis, point):
"""
+ Mirrors the object around a specified axis passign through
+ the given point. What is affected:
+
+ * ``buffered_paths``
+ * ``flash_geometry``
+ * ``solid_geometry``
+ * ``regions``
+
+ NOTE:
+ Does not modify the data used to create these elements. If these
+ are recreated, the scaling will be lost. This behavior was modified
+ because of the complexity reached in this class.
:param axis: "X" or "Y" indicates around which axis to mirror.
:type axis: str
@@ -801,22 +871,35 @@ class Gerber (Geometry):
px, py = point
xscale, yscale = {"X": (1.0, -1.0), "Y": (-1.0, 1.0)}[axis]
- ## Paths
- for path in self.paths:
- path['linestring'] = affinity.scale(path['linestring'], xscale, yscale,
- origin=(px, py))
-
- ## Flashes
- for fl in self.flashes:
- fl['loc'] = affinity.scale(fl['loc'], xscale, yscale, origin=(px, py))
+ # ## Paths
+ # for path in self.paths:
+ # path['linestring'] = affinity.scale(path['linestring'], xscale, yscale,
+ # origin=(px, py))
+ #
+ # ## Flashes
+ # for fl in self.flashes:
+ # fl['loc'] = affinity.scale(fl['loc'], xscale, yscale, origin=(px, py))
## Regions
for reg in self.regions:
reg['polygon'] = affinity.scale(reg['polygon'], xscale, yscale,
origin=(px, py))
- # Now buffered_paths, flash_geometry and solid_geometry
- self.create_geometry()
+ ## Flashes
+ for flash in self.flash_geometry:
+ flash = affinity.scale(flash, xscale, yscale, origin=(px, py))
+
+ ## Buffered paths
+ for bp in self.buffered_paths:
+ bp = affinity.scale(bp, xscale, yscale, origin=(px, py))
+
+ ## solid_geometry ???
+ # It's a cascaded union of objects.
+ self.solid_geometry = affinity.scale(self.solid_geometry,
+ xscale, yscale, origin=(px, py))
+
+ # # Now buffered_paths, flash_geometry and solid_geometry
+ # self.create_geometry()
def fix_regions(self):
"""
@@ -2266,27 +2349,44 @@ def find_polygon(poly_set, point):
return None
-def to_dict(geo):
+def to_dict(obj):
"""
Makes a Shapely geometry object into serializeable form.
- :param geo: Shapely geometry.
- :type geo: BaseGeometry
- :return: Dictionary with serializable form if ``geo`` was
- BaseGeometry, otherwise returns ``geo``.
+ :param obj: Shapely geometry.
+ :type obj: BaseGeometry
+ :return: Dictionary with serializable form if ``obj`` was
+ BaseGeometry or ApertureMacro, otherwise returns ``obj``.
"""
- if isinstance(geo, BaseGeometry):
+ if isinstance(obj, ApertureMacro):
+ return {
+ "__class__": "ApertureMacro",
+ "__inst__": obj.to_dict()
+ }
+ if isinstance(obj, BaseGeometry):
return {
"__class__": "Shply",
- "__inst__": sdumps(geo)
+ "__inst__": sdumps(obj)
}
- return geo
+ return obj
def dict2obj(d):
+ """
+ Default deserializer.
+
+ :param d: Serializable dictionary representation of an object
+ to be reconstructed.
+ :return: Reconstructed object.
+ """
if '__class__' in d and '__inst__' in d:
- # For now assume all classes are Shapely geometry.
- return sloads(d['__inst__'])
+ if d['__class__'] == "Shply":
+ return sloads(d['__inst__'])
+ if d['__class__'] == "ApertureMacro":
+ am = ApertureMacro()
+ am.from_dict(d['__inst__'])
+ return am
+ return d
else:
return d
diff --git a/doc/build/.doctrees/environment.pickle b/doc/build/.doctrees/environment.pickle
index 845703a8..7a50aee7 100644
Binary files a/doc/build/.doctrees/environment.pickle and b/doc/build/.doctrees/environment.pickle differ
diff --git a/doc/build/genindex.html b/doc/build/genindex.html
index 09641e6a..b9786053 100644
--- a/doc/build/genindex.html
+++ b/doc/build/genindex.html
@@ -103,6 +103,7 @@
FlatCAM Developer Manual
diff --git a/doc/build/index.html b/doc/build/index.html
index 1b9a0320..7947f847 100644
--- a/doc/build/index.html
+++ b/doc/build/index.html
@@ -103,6 +103,7 @@
FlatCAM Developer Manual
@@ -167,6 +168,7 @@
FlatCAM Developer Manual
diff --git a/doc/build/objects.inv b/doc/build/objects.inv
index 48131748..fda81fd9 100644
Binary files a/doc/build/objects.inv and b/doc/build/objects.inv differ
diff --git a/doc/build/py-modindex.html b/doc/build/py-modindex.html
index 765eb2ff..2a9bea0f 100644
--- a/doc/build/py-modindex.html
+++ b/doc/build/py-modindex.html
@@ -109,6 +109,7 @@
FlatCAM Developer Manual
diff --git a/doc/build/search.html b/doc/build/search.html
index 4be7b0b0..8896dcbf 100644
--- a/doc/build/search.html
+++ b/doc/build/search.html
@@ -110,6 +110,7 @@
FlatCAM Developer Manual
diff --git a/doc/build/searchindex.js b/doc/build/searchindex.js
index ec8e1fa1..70284982 100644
--- a/doc/build/searchindex.js
+++ b/doc/build/searchindex.js
@@ -1 +1 @@
-Search.setIndex({envversion:42,terms:{represent:2,all:[1,2,3,4],code:[1,2,3],toolpath:3,replot:1,focus:1,follow:3,on_key_over_plot:1,make_outlin:3,whose:[1,4],make_circl:3,get_ev:1,on_options_upd:[1,4],flash:3,gerber:1,program:1,text:[1,3],plot_al:1,geom:3,spec:3,cnc:[1,3],digit:3,sourc:3,everi:3,string:[1,3],far:1,mous:1,"5e6cff":3,obround:3,affect:3,on_cb_plot_toggl:1,toolshap:3,button:1,list:[1,3],iter:[3,4],item:1,vector:[1,2,3],specal:1,vertic:3,round:[1,3],get_radio_valu:1,create_geometri:3,natur:3,dimens:[2,3],resourc:1,zero:3,pass:[1,3],rectangular:3,click:1,append:[2,3],index:0,what:4,load_default:1,new_ax:1,neg:[1,3],current:1,delet:1,clipboard:1,"new":[1,2,4],method:[1,2,3],whatev:1,widget:[1,4],default2zero:3,flatcamgeometri:1,gener:[1,2,3],onli:[1,3],matplotlib:[1,2,3],adjust_ax:1,on_create_aligndril:1,path:[1,3],along:[3,4],do_someth:3,modifi:[1,2,3,4],make_moir:3,valu:[1,3,4],box:[1,3],convert:[2,3],on_file_saveprojectcopi:1,action:1,chang:[1,3,4],on_activate_nam:1,on_options_object2app:1,diamet:3,via:1,primit:3,modul:0,on_fileopengerb:1,filenam:[1,3],ymin:[1,3],select:1,frac_digit:[1,3],plot:[1,2,3],from:[1,2,3,4],describ:3,doubl:1,regist:1,setup_component_editor:1,call:[1,2,3,4],flash_geometri:3,dict:[1,2,3],type:[1,2,3,4],start:[1,3],toggl:1,more:3,on_toolbar_replot:1,on_delet:1,combo:1,on_gerber_generate_cutout:1,parse_fil:3,known:1,hole:1,must:[1,3,4],on_file_openproject:1,none:[1,2,3],left:1,ser_attr:3,work:3,uniqu:1,gtext:3,crosshair_thick:3,can:[1,2,3,4],drill:[2,3],z_move:2,fetch:[2,4],overrid:[2,3],meant:1,polygon2gcod:3,give:3,process:[1,3],share:1,indic:3,stroke:3,minimum:1,tab:[1,4],xmin:[1,3],serial:2,z_cut:2,apertureid:3,alwai:3,surfac:3,end:3,hadler:1,fix_region:3,write:3,fals:3,circular:3,b5ab3a:3,recogn:4,make_polygon:3,after:1,befor:[1,2],plane:3,mai:1,circumscrib:3,data:[1,3],subsequ:1,entry_text:1,correspond:[1,3],element:[3,4],callback:1,"switch":1,maintain:1,allow:3,enter:1,on_fileopenexcellon:1,on_file_saveprojecta:1,parse_cont:3,travel:3,checkbox:1,rotat:3,over:[1,4],through:[1,4],untouch:3,on_excellon_tool_choos:1,paramet:[1,2,3],fit:1,save_project:1,chosen:1,fix:3,gtk:1,set_list_select:1,window:1,html:1,creat:[1,2,3],pcb:1,on_options_app2object:1,main:[1,3],alter:3,on_zoom_out:1,non:3,"float":[1,2,3],"return":[1,2,3],thei:[2,3,4],handl:[1,2],rectangl:3,number:[1,3],"break":3,vect:[2,3],build_list:1,project_filenam:1,choic:1,name:[1,2,3,4],edit:4,separ:[1,3],solid_geometri:3,each:[3,4],found:3,updat:[1,4],gui:[1,2,4],read_form:[1,2],parse_lin:3,on_closewindow:1,replac:3,continu:[1,2],"static":3,connect:1,aperturetyp:3,event:1,out:1,variabl:[1,3],on_eval_upd:1,generate_from_excellon_by_tool:3,content:[0,1],adjust:1,set_current_pag:1,clear_polygon:3,on_scrol:1,flatcamcncjob:1,linear:3,insid:3,written:4,precaut:1,given:[1,2,3],flatcamexcellon:1,base:[1,2],dictionari:[1,2,3],org:1,care:1,file_chooser_act:1,generate_from_geometri:3,thread:1,launch:1,angl:3,success:1,motion:1,turn:1,length:3,notebook:1,place:[1,4],outsid:3,geometri:1,treeselect:1,onto:3,support:3,first:4,origin:[1,3],copper:1,on_zoom_in:1,arrai:3,independ:4,f0e24d:3,restrict:1,saepar:1,done:[1,3,4],overwrit:3,thick:3,open:[1,4],predefin:3,size:[1,3],differ:3,setup_obj_class:1,on_toggle_unit:1,associ:[1,2,3],interact:2,flatcamobj:1,attach:[1,2],circl:3,store:[3,4],editor:1,option:[1,3],ratio:[1,2],tool:[1,3],copi:[1,2,3],specifi:[1,2,3],get_empty_area:3,generate_from_excellon:3,part:[2,3],pars:3,get_bounding_box:3,exposur:3,kind:[1,2,3,4],whenev:1,tree:1,entry_ev:1,structur:3,project:[1,4],str:[1,2,3],macro:3,posit:3,"function":[1,4],thereaft:4,ani:[1,3],compon:1,do_flash:3,raw:3,"_app_":[1,4],have:[1,3],inform:1,self:[1,2,3],note:[1,3],also:3,on_options_object2project:1,build:[1,2],which:[1,2,3,4],event_handl:1,interior:3,on_success:1,singl:3,simplifi:3,buffer:3,previou:1,on_mouse_mov:1,pair:[1,3],alpha:3,segment:3,"class":[1,2,3],set_progress_bar:1,appertur:3,clear:[1,2],later:2,cover:[1,3],on_mouse_move_over_plot:1,populate_objects_combo:1,make_centerlin:3,axi:[1,3],thicken:3,show:1,on_click_over_plot:1,apertur:3,radiu:3,syntax:[1,4],radio:1,corner:[1,3],find:1,crosshair_len:3,on_scale_object:1,new_object:1,slow:3,locat:3,menu:1,configur:[1,2],activ:1,state:1,comboboxtext:1,version:[1,2,3],suppos:4,factor:[1,2,3],elin:3,on_options_combo_chang:1,overwritten:4,hit:1,get:[1,2,4],express:3,nativ:1,on_options_app2project:1,mpl_connect:1,multipolygon:3,bar:1,on_create_mirror:1,coord:3,"default":[1,3,4],to_dict:3,xmax:[1,3],contain:[1,4],comma:3,movement:1,where:[1,3,4],dpi:3,user:[1,2],set:[1,2,3],noth:1,keyboard:1,startup:[1,4],on_cncjob_exportgcod:1,displai:1,"4650bd":3,see:[1,3],result:[1,3],arg:1,transpar:[2,3],close:1,contour:3,statu:1,detect:4,kei:[1,2,3,4],boundari:3,label:1,figur:[1,2],max_r:3,between:1,progress:1,wether:3,attribut:3,accord:3,extend:2,numer:3,complement:3,isol:1,job:[1,3],entir:3,here:1,extent:1,toler:3,auto_adjust_ax:1,popul:[1,3,4],both:3,feedrat:[2,3],rtype:[1,3],options2form:1,alon:3,setup_project_list:1,on_generate_gerber_bounding_box:1,lowerleft:3,whole:[1,3],col:1,obj_dict:2,load:1,cncjob:1,point:[1,3],color:3,on_gerber_generate_noncopp:1,enlarg:3,param:[1,3],respect:2,throughout:1,backend:1,quit:1,becom:[2,3],convert_unit:[2,3],addition:3,been:1,mark:1,pute:1,json:[1,2,4],get_curr:1,toolbar:1,open_project:1,subscrib:1,immedi:1,radio_set:1,gcode:3,imag:1,search:0,gap:3,on_file_savedefault:[1,4],coordin:[1,3],on_options_project2object:1,func:1,present:3,versioncheck:1,inhibit:1,therefor:[1,4],apparamet:3,look:3,align:1,properti:[1,3],pixel:1,dest:1,defin:[1,3],"while":1,setup_ax:2,abov:3,margin:3,region:3,propag:1,layer:1,them:2,equal:3,itself:3,exterior:3,on_fileopengcod:1,"__init__":1,around:[1,3],make_lowerleftlin:3,belong:3,same:[1,4],respresent:3,instanc:1,pad:3,descend:[2,3],tool_toler:3,complet:1,http:1,widget_nam:1,upon:[1,4],alert:1,initi:1,canva:[1,2],implement:2,appropri:[1,3],off:1,center:[1,3],build_ui:2,well:3,inherit:4,without:1,on_file_new:1,thi:[1,2,3,4],choos:1,on_generate_paintarea:1,make_vectorlin:3,rout:1,latest:1,distanc:3,identifi:[3,4],entri:1,isolation_geometri:3,"true":[1,3],flatcamgerb:1,rest:3,shape:3,aspect:[1,2],linestr:3,speed:3,previous:4,cut:[1,3],on_tools_doublesid:1,trigger:1,shortcut:1,add:2,other:[1,3],board:1,save:[1,3,4],pre_pars:3,take:1,gcode_pars:3,format:2,read:[1,2,3,4],on_file_saveproject:1,background:2,press:1,height:3,mod:3,like:1,specif:[1,2,3],ring:3,zoom:1,integ:3,instanci:3,from_dict:3,necessari:1,either:1,exobj:3,on_clear_plot:1,page:[0,1],depend:[1,2,3],int_digit:3,creation:[1,4],back:1,percentag:1,on_zoom_fit:1,radiobutton:1,"export":2,mirror:[1,3],set_form_item:[1,2],on_generate_excellon_cncjob:1,scale:[1,2,3],bottom:1,definit:3,overlap:3,on_update_plot:1,buffer_path:3,unit:[1,2,3],duplic:1,refer:4,machin:3,object:[1,3,4],run:[1,3],usag:3,how:4,offset:[1,2,3],on_toggle_pointbox:1,about:1,actual:[2,3],file_chooser_save_act:1,on_generate_cncjob:1,side:1,degre:3,dialog:1,constructor:1,options_update_ignor:1,make_therm:3,on_about:1,chooser:1,within:3,encod:3,bound:[1,3],excellon:1,loc:3,accordingli:1,ymax:[1,3],wai:[3,4],area:[1,3],outer_dia_outer_r:3,transfer:1,n_vert:3,fast:3,make_geometri:3,width:3,clear_poli:1,handler:1,interfac:1,includ:3,fraction:3,on_canvas_configur:1,on_offset_object:1,on_generate_isol:1,linear2gcod:3,form:[1,2],tupl:[2,3],don:[2,3],line:[1,3],on_entry_eval_activ:1,info:1,made:3,whether:2,access:1,maximum:1,tooldia:[2,3],record:1,limit:1,featur:3,buffered_path:3,evalu:3,"int":3,request:1,dure:3,parser:3,aperture_pars:3,repres:[2,3],plot2:3,on_row_activ:1,exist:2,file:[1,3,4],doe:[1,3],check:1,again:3,aplic:1,polygon:[1,3],titl:1,to_form:2,when:[1,3,4],detail:1,invalid:3,field:1,valid:1,bool:[2,3],gline:3,ignor:[1,3],on_options_project2app:1,read_form_item:[1,2],deseri:[2,3],on_tree_selection_chang:1,draw:[1,3],event_nam:1,eval:1,outdat:1,rule:3,geometr:[2,3],aperture_macro:3,on_filequit:1,scroll:1},objtypes:{"0":"py:module","1":"py:method","2":"py:class","3":"py:staticmethod","4":"py:attribute"},objnames:{"0":["py","module","Python module"],"1":["py","method","Python method"],"2":["py","class","Python class"],"3":["py","staticmethod","Python static method"],"4":["py","attribute","Python attribute"]},filenames:["index","app","flatcamobj","camlib","devman"],titles:["Welcome to FlatCAM’s documentation!","FlatCAM Application","FlatCAM Objects","Camlib","FlatCAM Developer Manual"],objects:{"":{camlib:[3,0,0,"-"],FlatCAM:[2,0,0,"-"]},"camlib.CNCjob":{scale:[3,1,1,""],polygon2gcode:[3,1,1,""],generate_from_excellon_by_tool:[3,1,1,""],linear2gcode:[3,1,1,""],pre_parse:[3,1,1,""],generate_from_excellon:[3,1,1,""],gcode_parse:[3,1,1,""],generate_from_geometry:[3,1,1,""],offset:[3,1,1,""],plot2:[3,1,1,""]},FlatCAM:{PlotCanvas:[1,2,1,""],FlatCAMGeometry:[2,2,1,""],App:[1,2,1,""],FlatCAMObj:[2,2,1,""],FlatCAMExcellon:[2,2,1,""],FlatCAMGerber:[2,2,1,""],FlatCAMCNCjob:[2,2,1,""]},"FlatCAM.FlatCAMGerber":{convert_units:[2,1,1,""]},"camlib.Geometry":{convert_units:[3,1,1,""],scale:[3,1,1,""],to_dict:[3,1,1,""],bounds:[3,1,1,""],get_empty_area:[3,1,1,""],isolation_geometry:[3,1,1,""],from_dict:[3,1,1,""],clear_polygon:[3,1,1,""],offset:[3,1,1,""],size:[3,1,1,""]},"FlatCAM.App":{read_form:[1,1,1,""],on_about:[1,1,1,""],on_tree_selection_changed:[1,1,1,""],on_canvas_configure:[1,1,1,""],on_zoom_in:[1,1,1,""],on_delete:[1,1,1,""],on_toggle_units:[1,1,1,""],on_closewindow:[1,1,1,""],on_click_over_plot:[1,1,1,""],on_row_activated:[1,1,1,""],on_fileopengerber:[1,1,1,""],file_chooser_action:[1,1,1,""],on_zoom_out:[1,1,1,""],on_zoom_fit:[1,1,1,""],on_options_object2app:[1,1,1,""],on_file_savedefaults:[1,1,1,""],plot_all:[1,1,1,""],set_form_item:[1,1,1,""],on_generate_excellon_cncjob:[1,1,1,""],on_generate_isolation:[1,1,1,""],on_key_over_plot:[1,1,1,""],on_offset_object:[1,1,1,""],on_gerber_generate_noncopper:[1,1,1,""],on_scale_object:[1,1,1,""],new_object:[1,1,1,""],on_activate_name:[1,1,1,""],get_eval:[1,1,1,""],on_cb_plot_toggled:[1,1,1,""],on_update_plot:[1,1,1,""],save_project:[1,1,1,""],on_options_object2project:[1,1,1,""],setup_component_editor:[1,1,1,""],get_current:[1,1,1,""],open_project:[1,1,1,""],on_options_update:[1,1,1,""],on_file_new:[1,1,1,""],on_options_app2object:[1,1,1,""],on_options_project2app:[1,1,1,""],read_form_item:[1,1,1,""],versionCheck:[1,1,1,""],on_toolbar_replot:[1,1,1,""],on_entry_eval_activate:[1,1,1,""],on_tools_doublesided:[1,1,1,""],on_options_combo_change:[1,1,1,""],setup_obj_classes:[1,1,1,""],on_file_saveproject:[1,1,1,""],setup_project_list:[1,1,1,""],on_generate_gerber_bounding_box:[1,1,1,""],on_options_project2object:[1,1,1,""],on_eval_update:[1,1,1,""],build_list:[1,1,1,""],on_toggle_pointbox:[1,1,1,""],on_file_saveprojectas:[1,1,1,""],info:[1,1,1,""],on_file_openproject:[1,1,1,""],on_options_app2project:[1,1,1,""],set_progress_bar:[1,1,1,""],on_file_saveprojectcopy:[1,1,1,""],on_create_mirror:[1,1,1,""],file_chooser_save_action:[1,1,1,""],on_excellon_tool_choose:[1,1,1,""],on_generate_cncjob:[1,1,1,""],on_clear_plots:[1,1,1,""],on_mouse_move_over_plot:[1,1,1,""],on_fileopengcode:[1,1,1,""],on_gerber_generate_cutout:[1,1,1,""],load_defaults:[1,1,1,""],populate_objects_combo:[1,1,1,""],on_create_aligndrill:[1,1,1,""],on_generate_paintarea:[1,1,1,""],get_radio_value:[1,1,1,""],on_filequit:[1,1,1,""],on_cncjob_exportgcode:[1,1,1,""],options2form:[1,1,1,""],set_list_selection:[1,1,1,""],on_fileopenexcellon:[1,1,1,""]},"camlib.Gerber":{parse_lines:[3,1,1,""],scale:[3,1,1,""],frac_digits:[3,4,1,""],mirror:[3,1,1,""],aperture_parse:[3,1,1,""],offset:[3,1,1,""],create_geometry:[3,1,1,""],parse_file:[3,1,1,""],do_flashes:[3,1,1,""],buffer_paths:[3,1,1,""],fix_regions:[3,1,1,""],get_bounding_box:[3,1,1,""],int_digits:[3,4,1,""]},"camlib.ApertureMacro":{make_geometry:[3,1,1,""],default2zero:[3,3,1,""],make_vectorline:[3,3,1,""],make_polygon:[3,3,1,""],make_moire:[3,3,1,""],make_outline:[3,3,1,""],make_circle:[3,3,1,""],make_thermal:[3,3,1,""],make_centerline:[3,3,1,""],parse_content:[3,1,1,""],append:[3,1,1,""],make_lowerleftline:[3,3,1,""]},"FlatCAM.FlatCAMGeometry":{plot:[2,1,1,""],scale:[2,1,1,""],offset:[2,1,1,""]},"FlatCAM.PlotCanvas":{on_mouse_move:[1,1,1,""],on_scroll:[1,1,1,""],adjust_axes:[1,1,1,""],clear:[1,1,1,""],zoom:[1,1,1,""],connect:[1,1,1,""],new_axes:[1,1,1,""],auto_adjust_axes:[1,1,1,""],mpl_connect:[1,1,1,""]},camlib:{Excellon:[3,2,1,""],ApertureMacro:[3,2,1,""],Geometry:[3,2,1,""],CNCjob:[3,2,1,""],Gerber:[3,2,1,""]},"camlib.Excellon":{parse_lines:[3,1,1,""],scale:[3,1,1,""],offset:[3,1,1,""],create_geometry:[3,1,1,""],mirror:[3,1,1,""],parse_file:[3,1,1,""]},"FlatCAM.FlatCAMObj":{read_form:[2,1,1,""],plot:[2,1,1,""],serialize:[2,1,1,""],deserialize:[2,1,1,""],build_ui:[2,1,1,""],to_form:[2,1,1,""],setup_axes:[2,1,1,""],set_form_item:[2,1,1,""],read_form_item:[2,1,1,""]}},titleterms:{cncjob:3,flatcamgerb:2,app:1,indic:0,aperturemacro:3,tabl:0,excellon:3,flatcam:[0,1,2,4],flatcamgeometri:2,develop:4,welcom:0,flatcamobj:2,gerber:3,camlib:3,document:0,flatcamcncjob:2,applic:1,option:4,object:2,flatcamexcellon:2,plotcanva:1,manual:4,geometri:3}})
\ No newline at end of file
+Search.setIndex({envversion:42,terms:{represent:2,all:[1,2,3,4],code:[1,2,3],toolpath:3,replot:1,focus:1,follow:3,on_key_over_plot:1,make_outlin:3,whose:[1,4],make_circl:3,get_ev:1,on_options_upd:[1,4],flash:3,specif:[1,2,3],gerber:[],program:1,on_click_over_plot:1,plot_al:1,geom:3,spec:3,isinst:4,digit:3,sourc:3,everi:3,string:[1,3],far:1,mous:1,"5e6cff":3,obround:3,untouch:3,on_cb_plot_toggl:1,toolshap:3,button:1,list:[1,3,4],iter:[3,4],item:1,vector:[1,2,3],specal:1,round:[1,3],get_radio_valu:1,create_geometri:3,natur:3,dimens:[2,3],resourc:1,zero:3,pass:[1,3],click:1,append:[2,3],index:0,what:4,new_ax:1,neg:[1,3],current:1,delet:1,clipboard:1,buffer_path:3,"new":[1,2,4],method:[1,2,3,4],whatev:1,widget:[1,4],default2zero:3,flatcamgeometri:[],gener:[1,2,3],onli:[1,3],matplotlib:[1,2,3],adjust_ax:1,on_create_aligndril:1,path:[1,3],along:[3,4],vertic:3,modifi:[1,2,3,4],make_moir:3,valu:[1,3,4],box:[1,3],convert:[2,3,4],new_object:1,on_file_saveprojectcopi:1,action:1,chang:[1,3,4],on_activate_nam:1,on_options_object2app:1,diamet:3,via:1,primit:3,modul:0,on_fileopengerb:1,filenam:[1,3,4],basegeometri:4,ymin:[1,3],select:1,frac_digit:[1,3],plot:[1,2,3],from:[1,2,3,4],describ:3,doubl:1,regist:1,setup_component_editor:1,call:[1,2,3,4],save:[1,3,4],suppos:4,type:[1,2,3,4],toggl:1,more:3,on_toolbar_replot:1,evalu:3,on_delet:1,factor:[1,2,3],on_gerber_generate_cutout:1,parse_fil:3,known:1,hole:1,must:[1,3,4],on_file_openproject:1,none:[1,2,3],ser_attr:[3,4],work:3,uniqu:1,gtext:3,crosshair_thick:3,can:[1,2,3,4],drill:[2,3],z_move:2,fetch:[2,4],def:4,overrid:[2,3],overwritten:4,polygon2gcod:3,give:3,process:[1,3,4],share:1,indic:3,stroke:3,minimum:1,tab:[1,4],xmin:[1,3],hit:1,serial:[],z_cut:2,apertureid:3,alwai:3,surfac:3,end:3,hadler:1,fix_region:3,write:3,fals:3,updat:[1,4],parse_lin:3,recogn:4,make_polygon:3,after:1,befor:[1,2],notebook:1,mai:1,setup_obj_class:1,associ:[1,2,3],becom:[2,3],read:[1,2,3,4],onto:3,correspond:[1,3],element:[3,4],inform:1,"switch":1,maintain:1,allow:3,enter:1,make_therm:3,on_file_saveprojecta:1,travel:3,checkbox:1,rotat:3,over:[1,4],tupl:[2,3],through:[1,4],affect:3,on_excellon_tool_choos:1,paramet:[1,2,3],fit:1,respresent:[3,4],chosen:1,fix:3,gtk:1,"__class__":4,set_list_select:1,window:1,html:1,pcb:1,on_options_app2object:1,main:[1,3],pixel:1,non:[3,4],within:3,"return":[1,2,3,4],thei:[2,3,4],handl:[1,2],rectangl:3,number:[1,3],"break":3,vect:[2,3],build_list:1,project_filenam:1,choic:1,name:[1,2,3,4],edit:4,separ:[1,3],solid_geometri:3,each:[3,4],found:3,circular:3,gui:[1,2,4],read_form:[1,2],b5ab3a:3,on_closewindow:1,replac:3,continu:[1,2],"static":3,connect:1,aperturetyp:3,event:1,out:1,variabl:[1,3],on_eval_upd:1,generate_from_excellon_by_tool:3,content:[0,1],adjust:1,set_current_pag:1,clear_polygon:3,on_scrol:1,flatcamcncjob:[],alter:3,linear:3,insid:3,state:1,precaut:1,differ:3,flatcamexcellon:[],base:[1,2],dictionari:[1,2,3,4],latest:1,org:1,care:1,file_chooser_act:1,generate_from_geometri:3,thread:1,launch:1,angl:3,motion:1,turn:1,length:3,plane:3,place:[1,4],outsid:3,geometri:[],treeselect:1,entry_text:1,n_vert:3,first:4,origin:[1,3],copper:1,on_zoom_in:1,arrai:3,independ:4,f0e24d:3,restrict:1,saepar:1,done:[1,3,4],fast:3,thick:3,open:[1,4],predefin:3,size:[1,3],given:[1,2,3],circumscrib:3,on_toggle_unit:1,data:[1,3],interact:2,flatcamobj:[],attach:[1,2],circl:3,interfac:1,locat:3,store:[3,4],includ:[3,4],option:3,handler:1,tool:[1,3],copi:[1,2,3,4],specifi:[1,2,3,4],get_empty_area:3,generate_from_excellon:3,part:[2,3],pars:3,instanci:3,get_bounding_box:3,exposur:3,kind:[1,2,3,4],whenev:1,tree:1,entry_ev:1,structur:3,project:[1,4],str:[1,2,3],build_ui:2,posit:3,initi:1,thereaft:4,ani:[1,3],do_flash:3,raw:3,inherit:4,have:[1,3],callback:1,self:[1,2,3,4],note:[1,3],also:3,on_options_object2project:1,build:[1,2],which:[1,2,3,4],event_handl:1,interior:3,on_success:1,singl:3,simplifi:3,buffer:3,previou:1,on_mouse_mov:1,pair:[1,3],alpha:3,segment:3,"class":[1,2,3],set_progress_bar:1,appertur:3,clear:[1,2],later:[2,4],cover:[1,3],on_mouse_move_over_plot:1,populate_objects_combo:1,make_centerlin:3,axi:[1,3],width:3,thicken:3,recontruct:4,serializ:4,show:1,text:[1,3,4],apertur:3,radiu:3,syntax:[1,4],radio:1,corner:[1,3],find:1,on_scale_object:1,load_default:1,slow:3,ratio:[1,2],menu:1,configur:[1,2],activ:1,written:4,comboboxtext:1,version:[1,2,3],dict:[1,2,3,4],combo:1,elin:3,on_options_combo_chang:1,meant:1,"__inst__":4,get:[1,2,4],on_entry_eval_activ:1,express:3,nativ:1,made:3,geo:4,mpl_connect:1,requir:4,multipolygon:3,bar:1,on_create_mirror:1,coord:3,whether:2,to_dict:[3,4],xmax:[1,3],contain:[1,4],comma:3,movement:1,where:[1,3,4],dpi:3,set:[1,2,3],dump:4,keyboard:1,startup:[1,4],on_cncjob_exportgcod:1,maximum:1,"4650bd":3,see:[1,3],result:[1,3],arg:1,close:1,contour:3,statu:1,detect:4,extend:2,boundari:3,label:1,getattr:4,max_r:3,between:1,progress:1,previous:4,attribut:[3,4],accord:3,kei:[1,2,3,4],numer:3,complement:3,isol:1,job:[1,3],entir:3,here:1,extent:1,toler:3,auto_adjust_ax:1,popul:[1,3,4],both:3,feedrat:[2,3],rtype:[1,3,4],options2form:1,alon:3,setup_project_list:1,instanc:1,lowerleft:3,whole:[1,3],col:1,obj_dict:2,parse_cont:3,load:[1,4],cncjob:[],figur:[1,2],color:3,format:2,on_gerber_generate_noncopp:1,featur:3,shortcut:1,respect:2,throughout:1,backend:1,quit:1,do_someth:3,convert_unit:[2,3],addition:3,been:1,mark:1,pute:1,json:[1,2,4],get_curr:1,toolbar:1,open_project:[1,4],subscrib:1,immedi:1,radio_set:1,gcode:3,imag:1,search:0,gap:3,on_file_savedefault:[1,4],coordin:[1,3],on_options_project2object:1,func:1,present:3,versioncheck:1,inhibit:1,therefor:[1,4],apparamet:3,look:3,align:1,properti:[1,3],rectangular:3,defin:[1,3],"while":1,setup_ax:2,abov:3,margin:3,region:3,propag:1,layer:1,them:2,equal:3,unit:[1,2,3],itself:3,exterior:3,on_fileopengcod:1,"__init__":1,gcode_pars:3,make_lowerleftlin:3,make:4,belong:3,same:[1,4],save_project:[1,4],shply:4,pad:3,descend:[2,3],tool_toler:3,complet:1,http:1,widget_nam:1,upon:[1,4],alert:1,user:[1,2],canva:[1,2],implement:2,appropri:[1,3],off:1,center:[1,3],macro:3,well:3,"_app_":[1,4],without:1,on_file_new:1,thi:[1,2,3,4],choos:1,on_generate_paintarea:1,make_vectorlin:3,rout:1,left:1,distanc:3,identifi:[3,4],crosshair_len:3,isolation_geometri:3,entri:1,rest:3,shape:[3,4],aspect:[1,2],linestr:3,flatcamgerb:[],speed:3,wether:3,cut:[1,3],on_tools_doublesid:1,point:[1,3],param:[1,3,4],add:2,valid:1,board:1,appli:4,subsequ:1,pre_pars:3,take:[1,4],around:[1,3],transpar:[2,3],dest:1,on_file_saveproject:1,background:2,press:1,height:3,mod:3,like:1,success:1,ring:3,zoom:1,integ:3,noth:1,from_dict:3,necessari:1,either:1,exobj:3,on_clear_plot:1,page:[0,1],depend:[1,2,3],encount:4,int_digit:3,creation:[1,4],back:1,percentag:1,on_zoom_fit:1,radiobutton:1,"export":2,mirror:[1,3],set_form_item:[1,2],on_generate_excellon_cncjob:1,scale:[1,2,3],bottom:1,definit:3,overlap:3,on_update_plot:1,flash_geometri:3,cnc:[1,3],duplic:1,refer:4,machin:3,object:3,run:[1,3],usag:3,how:4,offset:[1,2,3],on_toggle_pointbox:1,about:1,actual:[2,3],file_chooser_save_act:1,on_generate_cncjob:1,side:1,degre:3,dialog:1,constructor:1,options_update_ignor:1,on_fileopenexcellon:1,on_about:1,chooser:1,"float":[1,2,3],encod:[3,4],bound:[1,3],excellon:[],compon:1,accordingli:1,ymax:[1,3],wai:[3,4],area:[1,3],outer_dia_outer_r:3,transfer:1,support:3,overwrit:3,make_geometri:3,start:[1,3],clear_poli:1,trigger:1,sdump:4,editor:1,fraction:3,on_canvas_configur:1,"function":[1,4],on_generate_isol:1,linear2gcod:3,form:[1,2,4],on_zoom_out:1,on_offset_object:1,don:[2,3],line:[1,3],"true":[1,3],loc:3,info:1,on_options_app2project:1,attr:4,on_generate_gerber_bounding_box:1,"default":[1,3,4],access:1,displai:1,tooldia:[2,3],record:1,limit:1,otherwis:4,enlarg:3,buffered_path:3,creat:[1,2,3,4],"int":3,request:1,dure:3,parser:3,aperture_pars:3,repres:[2,3],plot2:3,on_row_activ:1,exist:2,file:[1,3,4],doe:[1,3],check:1,again:3,aplic:1,polygon:[1,3],titl:1,to_form:2,when:[1,3,4],detail:1,invalid:3,field:1,other:[1,3],bool:[2,3],gline:3,geometr:[2,3],on_options_project2app:1,read_form_item:[1,2],deseri:[2,3],on_tree_selection_chang:1,draw:[1,3],event_nam:1,eval:1,outdat:1,rule:3,ignor:[1,3],aperture_macro:3,on_filequit:1,scroll:1},objtypes:{"0":"py:module","1":"py:method","2":"py:class","3":"py:staticmethod","4":"py:attribute"},objnames:{"0":["py","module","Python module"],"1":["py","method","Python method"],"2":["py","class","Python class"],"3":["py","staticmethod","Python static method"],"4":["py","attribute","Python attribute"]},filenames:["index","app","flatcamobj","camlib","devman"],titles:["Welcome to FlatCAM’s documentation!","FlatCAM Application","FlatCAM Objects","Camlib","FlatCAM Developer Manual"],objects:{"":{camlib:[3,0,0,"-"],FlatCAM:[2,0,0,"-"]},"camlib.CNCjob":{scale:[3,1,1,""],polygon2gcode:[3,1,1,""],generate_from_excellon_by_tool:[3,1,1,""],linear2gcode:[3,1,1,""],pre_parse:[3,1,1,""],generate_from_excellon:[3,1,1,""],gcode_parse:[3,1,1,""],generate_from_geometry:[3,1,1,""],offset:[3,1,1,""],plot2:[3,1,1,""]},FlatCAM:{PlotCanvas:[1,2,1,""],FlatCAMGeometry:[2,2,1,""],App:[1,2,1,""],FlatCAMObj:[2,2,1,""],FlatCAMExcellon:[2,2,1,""],FlatCAMGerber:[2,2,1,""],FlatCAMCNCjob:[2,2,1,""]},"FlatCAM.FlatCAMGerber":{convert_units:[2,1,1,""]},"camlib.Geometry":{convert_units:[3,1,1,""],scale:[3,1,1,""],to_dict:[3,1,1,""],bounds:[3,1,1,""],get_empty_area:[3,1,1,""],isolation_geometry:[3,1,1,""],from_dict:[3,1,1,""],clear_polygon:[3,1,1,""],offset:[3,1,1,""],size:[3,1,1,""]},"FlatCAM.App":{on_options_object2app:[1,1,1,""],on_about:[1,1,1,""],on_tree_selection_changed:[1,1,1,""],on_canvas_configure:[1,1,1,""],on_zoom_in:[1,1,1,""],on_delete:[1,1,1,""],on_toggle_units:[1,1,1,""],on_closewindow:[1,1,1,""],on_click_over_plot:[1,1,1,""],on_row_activated:[1,1,1,""],on_fileopengerber:[1,1,1,""],file_chooser_action:[1,1,1,""],on_zoom_out:[1,1,1,""],on_zoom_fit:[1,1,1,""],on_file_savedefaults:[1,1,1,""],on_generate_excellon_cncjob:[1,1,1,""],set_form_item:[1,1,1,""],plot_all:[1,1,1,""],read_form:[1,1,1,""],on_generate_isolation:[1,1,1,""],on_key_over_plot:[1,1,1,""],on_offset_object:[1,1,1,""],on_gerber_generate_noncopper:[1,1,1,""],on_fileopengcode:[1,1,1,""],new_object:[1,1,1,""],on_activate_name:[1,1,1,""],get_eval:[1,1,1,""],on_cb_plot_toggled:[1,1,1,""],on_update_plot:[1,1,1,""],save_project:[1,1,1,""],on_options_object2project:[1,1,1,""],setup_component_editor:[1,1,1,""],get_current:[1,1,1,""],open_project:[1,1,1,""],on_options_update:[1,1,1,""],on_file_new:[1,1,1,""],on_options_app2object:[1,1,1,""],on_options_project2app:[1,1,1,""],read_form_item:[1,1,1,""],versionCheck:[1,1,1,""],on_toolbar_replot:[1,1,1,""],on_entry_eval_activate:[1,1,1,""],on_scale_object:[1,1,1,""],on_options_combo_change:[1,1,1,""],setup_obj_classes:[1,1,1,""],on_file_saveproject:[1,1,1,""],setup_project_list:[1,1,1,""],on_generate_gerber_bounding_box:[1,1,1,""],on_options_project2object:[1,1,1,""],on_eval_update:[1,1,1,""],build_list:[1,1,1,""],on_toggle_pointbox:[1,1,1,""],on_file_saveprojectas:[1,1,1,""],info:[1,1,1,""],on_file_openproject:[1,1,1,""],on_options_app2project:[1,1,1,""],set_progress_bar:[1,1,1,""],on_file_saveprojectcopy:[1,1,1,""],on_create_mirror:[1,1,1,""],file_chooser_save_action:[1,1,1,""],on_excellon_tool_choose:[1,1,1,""],on_generate_cncjob:[1,1,1,""],on_clear_plots:[1,1,1,""],on_mouse_move_over_plot:[1,1,1,""],on_tools_doublesided:[1,1,1,""],on_gerber_generate_cutout:[1,1,1,""],load_defaults:[1,1,1,""],populate_objects_combo:[1,1,1,""],on_create_aligndrill:[1,1,1,""],on_generate_paintarea:[1,1,1,""],get_radio_value:[1,1,1,""],on_filequit:[1,1,1,""],on_cncjob_exportgcode:[1,1,1,""],options2form:[1,1,1,""],set_list_selection:[1,1,1,""],on_fileopenexcellon:[1,1,1,""]},"camlib.Gerber":{parse_lines:[3,1,1,""],scale:[3,1,1,""],frac_digits:[3,4,1,""],buffer_paths:[3,1,1,""],aperture_parse:[3,1,1,""],offset:[3,1,1,""],create_geometry:[3,1,1,""],parse_file:[3,1,1,""],do_flashes:[3,1,1,""],mirror:[3,1,1,""],fix_regions:[3,1,1,""],get_bounding_box:[3,1,1,""],int_digits:[3,4,1,""]},"camlib.ApertureMacro":{make_geometry:[3,1,1,""],default2zero:[3,3,1,""],make_vectorline:[3,3,1,""],make_polygon:[3,3,1,""],make_moire:[3,3,1,""],make_outline:[3,3,1,""],make_circle:[3,3,1,""],parse_content:[3,1,1,""],make_centerline:[3,3,1,""],make_thermal:[3,3,1,""],append:[3,1,1,""],make_lowerleftline:[3,3,1,""]},"FlatCAM.FlatCAMGeometry":{plot:[2,1,1,""],scale:[2,1,1,""],offset:[2,1,1,""]},"FlatCAM.PlotCanvas":{on_mouse_move:[1,1,1,""],on_scroll:[1,1,1,""],adjust_axes:[1,1,1,""],clear:[1,1,1,""],zoom:[1,1,1,""],connect:[1,1,1,""],new_axes:[1,1,1,""],auto_adjust_axes:[1,1,1,""],mpl_connect:[1,1,1,""]},camlib:{Excellon:[3,2,1,""],ApertureMacro:[3,2,1,""],Geometry:[3,2,1,""],CNCjob:[3,2,1,""],Gerber:[3,2,1,""]},"camlib.Excellon":{parse_lines:[3,1,1,""],scale:[3,1,1,""],offset:[3,1,1,""],create_geometry:[3,1,1,""],mirror:[3,1,1,""],parse_file:[3,1,1,""]},"FlatCAM.FlatCAMObj":{read_form:[2,1,1,""],plot:[2,1,1,""],serialize:[2,1,1,""],deserialize:[2,1,1,""],build_ui:[2,1,1,""],to_form:[2,1,1,""],setup_axes:[2,1,1,""],set_form_item:[2,1,1,""],read_form_item:[2,1,1,""]}},titleterms:{cncjob:3,flatcamgerb:2,app:1,indic:0,aperturemacro:3,tabl:0,excellon:3,serial:4,option:4,flatcamgeometri:2,develop:4,welcom:0,flatcamobj:2,gerber:3,camlib:3,document:0,flatcamcncjob:2,applic:1,flatcam:[0,1,2,4],object:2,flatcamexcellon:2,plotcanva:1,manual:4,geometri:3}})
\ No newline at end of file
diff --git a/doc/source/devman.rst b/doc/source/devman.rst
index 0edff32b..1693620e 100644
--- a/doc/source/devman.rst
+++ b/doc/source/devman.rst
@@ -12,4 +12,47 @@ There are **Application Defaults**, **Project Options** and **Object Options** i
**Object Options** for each object are inherited from Project Options upon creation of each new object. They can be modified independently from the Project's options thereafter through the UI, where the widget containing the option is identified by name: ``type + kind + "_" + option``. They are stored in ``object.options``. They are saved along the Project options when saving the project.
-The syntax of UI widget names contain a ``type``, which identifies what *type of widget* it is and how its value is supposed to be fetched, and a ``kind``, which refer to what *kind of FlatCAM Object* it is for.
\ No newline at end of file
+The syntax of UI widget names contain a ``type``, which identifies what *type of widget* it is and how its value is supposed to be fetched, and a ``kind``, which refer to what *kind of FlatCAM Object* it is for.
+
+Serialization
+~~~~~~~~~~~~~
+
+Serialization refers to converting objects into a form that can be saved in a text file and recontructing objects from a text file.
+
+Saving and loading projects require serialization. These are done in ``App.save_project(filename)`` and ``App.open_project(filename)``.
+
+Serialization in FlatCAM takes 2 forms. The first is calling objects' ``to_dict()`` method, which is inherited from ``Geometry.to_dict()``::
+
+ def to_dict(self):
+ """
+ Returns a respresentation of the object as a dictionary.
+ Attributes to include are listed in ``self.ser_attrs``.
+
+ :return: A dictionary-encoded copy of the object.
+ :rtype: dict
+ """
+ d = {}
+ for attr in self.ser_attrs:
+ d[attr] = getattr(self, attr)
+ return d
+
+
+This creates a dictionary with attributes specified in the object's ``ser_attrs`` list. If these are not in a serialized form, they will be processed later by the function ``to_dict()``::
+
+ def to_dict(geo):
+ """
+ Makes a Shapely geometry object into serializeable form.
+
+ :param geo: Shapely geometry.
+ :type geo: BaseGeometry
+ :return: Dictionary with serializable form if ``geo`` was
+ BaseGeometry, otherwise returns ``geo``.
+ """
+ if isinstance(geo, BaseGeometry):
+ return {
+ "__class__": "Shply",
+ "__inst__": sdumps(geo)
+ }
+ return geo
+
+This is used in ``json.dump(d, f, default=to_dict)`` and is applied to objects that json encounters to be in a non-serialized form.
\ No newline at end of file