chiark / gitweb /
Add inset speeds.
[cura.git] / Cura / util / profile.py
1 from __future__ import absolute_import
2 from __future__ import division
3 __copyright__ = "Copyright (C) 2013 David Braam - Released under terms of the AGPLv3 License"
4
5 import os, traceback, math, re, zlib, base64, time, sys, platform, glob, string, stat, types
6 import cPickle as pickle
7 import numpy
8 if sys.version_info[0] < 3:
9         import ConfigParser
10 else:
11         import configparser as ConfigParser
12
13 from Cura.util import resources
14 from Cura.util import version
15 from Cura.util import validators
16
17 #The settings dictionary contains a key/value reference to all possible settings. With the setting name as key.
18 settingsDictionary = {}
19 #The settings list is used to keep a full list of all the settings. This is needed to keep the settings in the proper order,
20 # as the dictionary will not contain insertion order.
21 settingsList = []
22
23 #Currently selected machine (by index) Cura support multiple machines in the same preferences and can switch between them.
24 # Each machine has it's own index and unique name.
25 _selectedMachineIndex = 0
26
27 class setting(object):
28         #A setting object contains a configuration setting. These are globally accessible trough the quick access functions
29         # and trough the settingsDictionary function.
30         # Settings can be:
31         # * profile settings (settings that effect the slicing process and the print result)
32         # * preferences (settings that effect how cura works and acts)
33         # * machine settings (settings that relate to the physical configuration of your machine)
34         # * alterations (bad name copied from Skeinforge. These are the start/end code pieces)
35         # Settings have validators that check if the value is valid, but do not prevent invalid values!
36         # Settings have conditions that enable/disable this setting depending on other settings. (Ex: Dual-extrusion)
37         def __init__(self, name, default, type, category, subcategory):
38                 self._name = name
39                 self._label = name
40                 self._tooltip = ''
41                 self._default = unicode(default)
42                 self._values = []
43                 self._type = type
44                 self._category = category
45                 self._subcategory = subcategory
46                 self._validators = []
47                 self._conditions = []
48
49                 if type is types.FloatType:
50                         validators.validFloat(self)
51                 elif type is types.IntType:
52                         validators.validInt(self)
53
54                 global settingsDictionary
55                 settingsDictionary[name] = self
56                 global settingsList
57                 settingsList.append(self)
58
59         def setLabel(self, label, tooltip = ''):
60                 self._label = label
61                 self._tooltip = tooltip
62                 return self
63
64         def setRange(self, minValue=None, maxValue=None):
65                 if len(self._validators) < 1:
66                         return
67                 self._validators[0].minValue = minValue
68                 self._validators[0].maxValue = maxValue
69                 return self
70
71         def getLabel(self):
72                 return _(self._label)
73
74         def getTooltip(self):
75                 return _(self._tooltip)
76
77         def getCategory(self):
78                 return self._category
79
80         def getSubCategory(self):
81                 return self._subcategory
82
83         def isPreference(self):
84                 return self._category == 'preference'
85
86         def isMachineSetting(self):
87                 return self._category == 'machine'
88
89         def isAlteration(self):
90                 return self._category == 'alteration'
91
92         def isProfile(self):
93                 return not self.isAlteration() and not self.isPreference() and not self.isMachineSetting()
94
95         def getName(self):
96                 return self._name
97
98         def getType(self):
99                 return self._type
100
101         def getValue(self, index = None):
102                 if index is None:
103                         index = self.getValueIndex()
104                 if index >= len(self._values):
105                         return self._default
106                 return self._values[index]
107
108         def getDefault(self):
109                 return self._default
110
111         def setValue(self, value, index = None):
112                 if index is None:
113                         index = self.getValueIndex()
114                 while index >= len(self._values):
115                         self._values.append(self._default)
116                 self._values[index] = unicode(value)
117
118         def getValueIndex(self):
119                 if self.isMachineSetting():
120                         global _selectedMachineIndex
121                         return _selectedMachineIndex
122                 return 0
123
124         def validate(self):
125                 result = validators.SUCCESS
126                 msgs = []
127                 for validator in self._validators:
128                         res, err = validator.validate()
129                         if res == validators.ERROR:
130                                 result = res
131                         elif res == validators.WARNING and result != validators.ERROR:
132                                 result = res
133                         if res != validators.SUCCESS:
134                                 msgs.append(err)
135                 return result, '\n'.join(msgs)
136
137         def addCondition(self, conditionFunction):
138                 self._conditions.append(conditionFunction)
139
140         def checkConditions(self):
141                 for condition in self._conditions:
142                         if not condition():
143                                 return False
144                 return True
145
146 #########################################################
147 ## Settings
148 #########################################################
149
150 #Define a fake _() function to fake the gettext tools in to generating strings for the profile settings.
151 def _(n):
152         return n
153
154 setting('layer_height',              0.1, float, 'basic',    _('Quality')).setRange(0.0001).setLabel(_("Layer height (mm)"), _("Layer height in millimeters.\nThis is the most important setting to determine the quality of your print. Normal quality prints are 0.1mm, high quality is 0.06mm. You can go up to 0.25mm with an Ultimaker for very fast prints at low quality."))
155 setting('wall_thickness',            0.8, float, 'basic',    _('Quality')).setRange(0.0).setLabel(_("Shell thickness (mm)"), _("Thickness of the outside shell in the horizontal direction.\nThis is used in combination with the nozzle size to define the number\nof perimeter lines and the thickness of those perimeter lines."))
156 setting('retraction_enable',        True, bool,  'basic',    _('Quality')).setLabel(_("Enable retraction"), _("Retract the filament when the nozzle is moving over a none-printed area. Details about the retraction can be configured in the advanced tab."))
157 setting('solid_layer_thickness',     0.6, float, 'basic',    _('Fill')).setRange(0).setLabel(_("Bottom/Top thickness (mm)"), _("This controls the thickness of the bottom and top layers, the amount of solid layers put down is calculated by the layer thickness and this value.\nHaving this value a multiple of the layer thickness makes sense. And keep it near your wall thickness to make an evenly strong part."))
158 setting('fill_density',               20, float, 'basic',    _('Fill')).setRange(0, 100).setLabel(_("Fill Density (%)"), _("This controls how densely filled the insides of your print will be. For a solid part use 100%, for an empty part use 0%. A value around 20% is usually enough.\nThis won't affect the outside of the print and only adjusts how strong the part becomes."))
159 setting('nozzle_size',               0.4, float, 'advanced', _('Machine')).setRange(0.1,10).setLabel(_("Nozzle size (mm)"), _("The nozzle size is very important, this is used to calculate the line width of the infill, and used to calculate the amount of outside wall lines and thickness for the wall thickness you entered in the print settings."))
160 setting('print_speed',                50, float, 'basic',    _('Speed and Temperature')).setRange(1).setLabel(_("Print speed (mm/s)"), _("Speed at which printing happens. A well adjusted Ultimaker can reach 150mm/s, but for good quality prints you want to print slower. Printing speed depends on a lot of factors. So you will be experimenting with optimal settings for this."))
161 setting('print_temperature',         220, int,   'basic',    _('Speed and Temperature')).setRange(0,340).setLabel(_("Printing temperature (C)"), _("Temperature used for printing. Set at 0 to pre-heat yourself.\nFor PLA a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
162 setting('print_temperature2',          0, int,   'basic',    _('Speed and Temperature')).setRange(0,340).setLabel(_("2nd nozzle temperature (C)"), _("Temperature used for printing. Set at 0 to pre-heat yourself.\nFor PLA a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
163 setting('print_temperature3',          0, int,   'basic',    _('Speed and Temperature')).setRange(0,340).setLabel(_("3th nozzle temperature (C)"), _("Temperature used for printing. Set at 0 to pre-heat yourself.\nFor PLA a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
164 setting('print_temperature4',          0, int,   'basic',    _('Speed and Temperature')).setRange(0,340).setLabel(_("4th nozzle temperature (C)"), _("Temperature used for printing. Set at 0 to pre-heat yourself.\nFor PLA a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
165 setting('print_bed_temperature',      70, int,   'basic',    _('Speed and Temperature')).setRange(0,340).setLabel(_("Bed temperature (C)"), _("Temperature used for the heated printer bed. Set at 0 to pre-heat yourself."))
166 setting('support',                'None', [_('None'), _('Touching buildplate'), _('Everywhere')], 'basic', _('Support')).setLabel(_("Support type"), _("Type of support structure build.\n\"Touching buildplate\" is the most commonly used support setting.\n\nNone does not do any support.\nTouching buildplate only creates support where the support structure will touch the build platform.\nEverywhere creates support even on top of parts of the model."))
167 setting('platform_adhesion',      'None', [_('None'), _('Brim'), _('Raft')], 'basic', _('Support')).setLabel(_("Platform adhesion type"), _("Different options that help in preventing corners from lifting due to warping.\nBrim adds a single layer thick flat area around your object which is easy to cut off afterwards, and the recommended option.\nRaft adds a thick raster at below the object and a thin interface between this and your object.\n(Note that enabling the brim or raft disables the skirt)"))
168 setting('support_dual_extrusion',  'Both', [_('Both'), _('First extruder'), _('Second extruder')], 'basic', _('Support')).setLabel(_("Support dual extrusion"), _("Which extruder to use for support material, for break-away support you can use both extruders.\nBut if one of the materials is more expensive then the other you could select an extruder to use for support material. This causes more extruder switches.\nYou can also use the 2nd extruder for soluble support materials."))
169 setting('wipe_tower',              False, bool,  'basic',    _('Dual extrusion')).setLabel(_("Wipe&prime tower"), _("The wipe-tower is a tower printed on every layer when switching between nozzles.\nThe old nozzle is wiped off on the tower before the new nozzle is used to print the 2nd color."))
170 setting('wipe_tower_volume',          15, float, 'expert',   _('Dual extrusion')).setLabel(_("Wipe&prime tower volume per layer (mm3)"), _("The amount of material put in the wipe/prime tower.\nThis is done in volume because in general you want to extrude a\ncertain amount of volume to get the extruder going, independent on the layer height.\nThis means that with thinner layers, your tower gets bigger."))
171 setting('ooze_shield',             False, bool,  'basic',    _('Dual extrusion')).setLabel(_("Ooze shield"), _("The ooze shield is a 1 line thick shell around the object which stands a few mm from the object.\nThis shield catches any oozing from the unused nozzle in dual-extrusion."))
172 setting('filament_diameter',        2.85, float, 'basic',    _('Filament')).setRange(1).setLabel(_("Diameter (mm)"), _("Diameter of your filament, as accurately as possible.\nIf you cannot measure this value you will have to calibrate it, a higher number means less extrusion, a smaller number generates more extrusion."))
173 setting('filament_diameter2',          0, float, 'basic',    _('Filament')).setRange(0).setLabel(_("Diameter2 (mm)"), _("Diameter of your filament for the 2nd nozzle. Use 0 to use the same diameter as for nozzle 1."))
174 setting('filament_diameter3',          0, float, 'basic',    _('Filament')).setRange(0).setLabel(_("Diameter3 (mm)"), _("Diameter of your filament for the 3th nozzle. Use 0 to use the same diameter as for nozzle 1."))
175 setting('filament_diameter4',          0, float, 'basic',    _('Filament')).setRange(0).setLabel(_("Diameter4 (mm)"), _("Diameter of your filament for the 4th nozzle. Use 0 to use the same diameter as for nozzle 1."))
176 setting('filament_flow',            100., float, 'basic',    _('Filament')).setRange(5,300).setLabel(_("Flow (%)"), _("Flow compensation, the amount of material extruded is multiplied by this value"))
177 setting('retraction_speed',         40.0, float, 'advanced', _('Retraction')).setRange(0.1).setLabel(_("Speed (mm/s)"), _("Speed at which the filament is retracted, a higher retraction speed works better. But a very high retraction speed can lead to filament grinding."))
178 setting('retraction_amount',         4.5, float, 'advanced', _('Retraction')).setRange(0).setLabel(_("Distance (mm)"), _("Amount of retraction, set at 0 for no retraction at all. A value of 4.5mm seems to generate good results."))
179 setting('retraction_dual_amount',   16.5, float, 'advanced', _('Retraction')).setRange(0).setLabel(_("Dual extrusion switch amount (mm)"), _("Amount of retraction when switching nozzle with dual-extrusion, set at 0 for no retraction at all. A value of 16.0mm seems to generate good results."))
180 setting('retraction_min_travel',     1.5, float, 'expert',   _('Retraction')).setRange(0).setLabel(_("Minimum travel (mm)"), _("Minimum amount of travel needed for a retraction to happen at all. To make sure you do not get a lot of retractions in a small area."))
181 setting('retraction_combing',       True, bool,  'expert',   _('Retraction')).setLabel(_("Enable combing"), _("Combing is the act of avoiding holes in the print for the head to travel over. If combing is disabled the printer head moves straight from the start point to the end point and it will always retract."))
182 setting('retraction_minimal_extrusion',0.02, float,'expert',  _('Retraction')).setRange(0).setLabel(_("Minimal extrusion before retracting (mm)"), _("The minimal amount of extrusion that needs to be done before retracting again if a retraction needs to happen before this minimal is reached the retraction is ignored.\nThis avoids retraction a lot on the same piece of filament which flattens the filament and causes grinding issues."))
183 setting('bottom_thickness',          0.3, float, 'advanced', _('Quality')).setRange(0).setLabel(_("Initial layer thickness (mm)"), _("Layer thickness of the bottom layer. A thicker bottom layer makes sticking to the bed easier. Set to 0.0 to have the bottom layer thickness the same as the other layers."))
184 setting('object_sink',               0.0, float, 'advanced', _('Quality')).setLabel(_("Cut off object bottom (mm)"), _("Sinks the object into the platform, this can be used for objects that do not have a flat bottom and thus create a too small first layer."))
185 #setting('enable_skin',             False, bool,  'advanced', _('Quality')).setLabel(_("Duplicate outlines"), _("Skin prints the outer lines of the prints twice, each time with half the thickness. This gives the illusion of a higher print quality."))
186 setting('overlap_dual',             0.15, float, 'advanced', _('Quality')).setLabel(_("Dual extrusion overlap (mm)"), _("Add a certain amount of overlapping extrusion on dual-extrusion prints. This bonds the different colors better together."))
187 setting('travel_speed',            150.0, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Travel speed (mm/s)"), _("Speed at which travel moves are done, a high quality build Ultimaker can reach speeds of 250mm/s. But some machines might miss steps then."))
188 setting('bottom_layer_speed',         20, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Bottom layer speed (mm/s)"), _("Print speed for the bottom layer, you want to print the first layer slower so it sticks better to the printer bed."))
189 setting('infill_speed',              0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Infill speed (mm/s)"), _("Speed at which infill parts are printed. If set to 0 then the print speed is used for the infill. Printing the infill faster can greatly reduce printing, but this can negatively effect print quality."))
190 setting('inset0_speed',              0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Outser shell speed (mm/s)"), _("Speed at which outer shell is printed. If set to 0 then the print speed is used. Printing the outer shell at a lower speed improves the final skin quality. However, having a large difference between the inner shell speed and the outer shell speed will effect quality in a negative way."))
191 setting('insetx_speed',              0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Innser shell speed (mm/s)"), _("Speed at which inner shells are printed. If set to 0 then the print speed is used. Printing the inner shell faster then the outer shell will reduce printing time. It is good to set this somewhere in between the outer shell speed and the infill/printing speed."))
192 setting('cool_min_layer_time',         5, float, 'advanced', _('Cool')).setRange(0).setLabel(_("Minimal layer time (sec)"), _("Minimum time spend in a layer, gives the layer time to cool down before the next layer is put on top. If the layer will be placed down too fast the printer will slow down to make sure it has spend at least this amount of seconds printing this layer."))
193 setting('fan_enabled',              True, bool,  'advanced', _('Cool')).setLabel(_("Enable cooling fan"), _("Enable the cooling fan during the print. The extra cooling from the cooling fan is essential during faster prints."))
194
195 setting('skirt_line_count',            1, int,   'expert', 'Skirt').setRange(0).setLabel(_("Line count"), _("The skirt is a line drawn around the object at the first layer. This helps to prime your extruder, and to see if the object fits on your platform.\nSetting this to 0 will disable the skirt. Multiple skirt lines can help priming your extruder better for small objects."))
196 setting('skirt_gap',                 3.0, float, 'expert', 'Skirt').setRange(0).setLabel(_("Start distance (mm)"), _("The distance between the skirt and the first layer.\nThis is the minimal distance, multiple skirt lines will be put outwards from this distance."))
197 setting('skirt_minimal_length',    150.0, float, 'expert', 'Skirt').setRange(0).setLabel(_("Minimal length (mm)"), _("The minimal length of the skirt, if this minimal length is not reached it will add more skirt lines to reach this minimal lenght.\nNote: If the line count is set to 0 this is ignored."))
198 #setting('max_z_speed',               3.0, float, 'expert',   _('Speed')).setRange(0.1).setLabel(_("Max Z speed (mm/s)"), _("Speed at which Z moves are done. When you Z axis is properly lubricated you can increase this for less Z blob."))
199 #setting('retract_on_jumps_only',    True, bool,  'expert',   _('Retraction')).setLabel(_('Retract on jumps only'), _('Only retract when we are making a move that is over a hole in the model, else retract on every move. This effects print quality in different ways.'))
200 setting('fan_full_height',           0.5, float, 'expert',   _('Cool')).setRange(0).setLabel(_("Fan full on at height (mm)"), _("The height at which the fan is turned on completely. For the layers below this the fan speed is scaled linear with the fan off at layer 0."))
201 setting('fan_speed',                 100, int,   'expert',   _('Cool')).setRange(0,100).setLabel(_("Fan speed min (%)"), _("When the fan is turned on, it is enabled at this speed setting. If cool slows down the layer, the fan is adjusted between the min and max speed. Minimal fan speed is used if the layer is not slowed down due to cooling."))
202 setting('fan_speed_max',             100, int,   'expert',   _('Cool')).setRange(0,100).setLabel(_("Fan speed max (%)"), _("When the fan is turned on, it is enabled at this speed setting. If cool slows down the layer, the fan is adjusted between the min and max speed. Maximal fan speed is used if the layer is slowed down due to cooling by more than 200%."))
203 setting('cool_min_feedrate',          10, float, 'expert',   _('Cool')).setRange(0).setLabel(_("Minimum speed (mm/s)"), _("The minimal layer time can cause the print to slow down so much it starts to ooze. The minimal feedrate protects against this. Even if a print gets slown down it will never be slower than this minimal speed."))
204 setting('cool_head_lift',          False, bool,  'expert',   _('Cool')).setLabel(_("Cool head lift"), _("Lift the head if the minimal speed is hit because of cool slowdown, and wait the extra time so the minimal layer time is always hit."))
205 #setting('extra_base_wall_thickness', 0.0, float, 'expert',   'Accuracy').setRange(0).setLabel(_("Extra Wall thickness for bottom/top (mm)"), _("Additional wall thickness of the bottom and top layers."))
206 #setting('sequence', 'Loops > Perimeter > Infill', ['Loops > Perimeter > Infill', 'Loops > Infill > Perimeter', 'Infill > Loops > Perimeter', 'Infill > Perimeter > Loops', 'Perimeter > Infill > Loops', 'Perimeter > Loops > Infill'], 'expert', 'Sequence')
207 #setting('force_first_layer_sequence', True, bool, 'expert', 'Sequence').setLabel(_('Force first layer sequence'), _('This setting forces the order of the first layer to be \'Perimeter > Loops > Infill\''))
208 #setting('infill_type', 'Line', ['Line', 'Grid Circular', 'Grid Hexagonal', 'Grid Rectangular'], 'expert', _('Infill')).setLabel(_("Infill pattern"), _("Pattern of the none-solid infill. Line is default, but grids can provide a strong print."))
209 setting('solid_top', True, bool, 'expert', _('Infill')).setLabel(_("Solid infill top"), _("Create a solid top surface, if set to false the top is filled with the fill percentage. Useful for cups/vases."))
210 setting('solid_bottom', True, bool, 'expert', _('Infill')).setLabel(_("Solid infill bottom"), _("Create a solid bottom surface, if set to false the bottom is filled with the fill percentage. Useful for buildings."))
211 setting('fill_overlap', 15, int, 'expert', _('Infill')).setRange(0,100).setLabel(_("Infill overlap (%)"), _("Amount of overlap between the infill and the walls. There is a slight overlap with the walls and the infill so the walls connect firmly to the infill."))
212 setting('support_angle', 60, float, 'expert', _('Support')).setRange(0,90).setLabel(_("Overhang angle for support (deg)"), _("The minimal angle that overhangs need to have to get support. With 0deg being horizontal and 90deg being vertical."))
213 setting('support_fill_rate', 15, int, 'expert', _('Support')).setRange(0,100).setLabel(_("Fill amount (%)"), _("Amount of infill structure in the support material, less material gives weaker support which is easier to remove. 15% seems to be a good average."))
214 setting('support_xy_distance', 0.7, float, 'expert', _('Support')).setRange(0,10).setLabel(_("Distance X/Y (mm)"), _("Distance of the support material from the print, in the X/Y directions.\n0.7mm gives a nice distance from the print so the support does not stick to the print."))
215 setting('support_z_distance', 0.15, float, 'expert', _('Support')).setRange(0,10).setLabel(_("Distance Z (mm)"), _("Distance from the top/bottom of the support to the print. A small gap here makes it easier to remove the support but makes the print a bit uglier.\n0.15mm gives a good seperation of the support material."))
216 setting('spiralize', False, bool, 'expert', 'Spiralize').setLabel(_("Spiralize the outer contour"), _("Spiralize is smoothing out the Z move of the outer edge. This will create a steady Z increase over the whole print. This feature turns a solid object into a single walled print with a solid bottom."))
217 #setting('bridge_speed', 100, int, 'expert', 'Bridge').setRange(0,100).setLabel(_("Bridge speed (%)"), _("Speed at which layers with bridges are printed, compared to normal printing speed."))
218 setting('brim_line_count', 20, int, 'expert', _('Brim')).setRange(1,100).setLabel(_("Brim line amount"), _("The amount of lines used for a brim, more lines means a larger brim which sticks better, but this also makes your effective print area smaller."))
219 setting('raft_margin', 5, float, 'expert', _('Raft')).setRange(0).setLabel(_("Extra margin (mm)"), _("If the raft is enabled, this is the extra raft area around the object which is also rafted. Increasing this margin will create a stronger raft while using more material and leaving less are for your print."))
220 setting('raft_line_spacing', 1.0, float, 'expert', _('Raft')).setRange(0).setLabel(_("Line spacing (mm)"), _("When you are using the raft this is the distance between the centerlines of the raft line."))
221 setting('raft_base_thickness', 0.3, float, 'expert', _('Raft')).setRange(0).setLabel(_("Base thickness (mm)"), _("When you are using the raft this is the thickness of the base layer which is put down."))
222 setting('raft_base_linewidth', 0.7, float, 'expert', _('Raft')).setRange(0).setLabel(_("Base line width (mm)"), _("When you are using the raft this is the width of the base layer lines which are put down."))
223 setting('raft_interface_thickness', 0.2, float, 'expert', _('Raft')).setRange(0).setLabel(_("Interface thickness (mm)"), _("When you are using the raft this is the thickness of the interface layer which is put down."))
224 setting('raft_interface_linewidth', 0.2, float, 'expert', _('Raft')).setRange(0).setLabel(_("Interface line width (mm)"), _("When you are using the raft this is the width of the interface layer lines which are put down."))
225 #setting('hop_on_move', False, bool, 'expert', 'Hop').setLabel(_("Enable hop on move"), _("When moving from print position to print position, raise the printer head 0.2mm so it does not knock off the print (experimental)."))
226 setting('fix_horrible_union_all_type_a', True,  bool, 'expert', _('Fix horrible')).setLabel(_("Combine everything (Type-A)"), _("This expert option adds all parts of the model together. The result is usually that internal cavities disappear. Depending on the model this can be intended or not. Enabling this option is at your own risk. Type-A is depended on the model normals and tries to keep some internal holes intact. Type-B ignores all internal holes and only keeps the outside shape per layer."))
227 setting('fix_horrible_union_all_type_b', False, bool, 'expert', _('Fix horrible')).setLabel(_("Combine everything (Type-B)"), _("This expert option adds all parts of the model together. The result is usually that internal cavities disappear. Depending on the model this can be intended or not. Enabling this option is at your own risk. Type-A is depended on the model normals and tries to keep some internal holes intact. Type-B ignores all internal holes and only keeps the outside shape per layer."))
228 setting('fix_horrible_use_open_bits', False, bool, 'expert', _('Fix horrible')).setLabel(_("Keep open faces"), _("This expert option keeps all the open bits of the model intact. Normally Cura tries to stitch up small holes and remove everything with big holes, but this option keeps bits that are not properly part of anything and just goes with whatever it is left. This option is usually not what you want, but it might enable you to slice models otherwise failing to produce proper paths.\nAs with all \"Fix horrible\" options, results may vary and use at your own risk."))
229 setting('fix_horrible_extensive_stitching', False, bool, 'expert', _('Fix horrible')).setLabel(_("Extensive stitching"), _("Extrensive stitching tries to fix up open holes in the model by closing the hole with touching polygons. This algorthm is quite expensive and could introduce a lot of processing time.\nAs with all \"Fix horrible\" options, results may vary and use at your own risk."))
230
231 setting('plugin_config', '', str, 'hidden', 'hidden')
232 setting('object_center_x', -1, float, 'hidden', 'hidden')
233 setting('object_center_y', -1, float, 'hidden', 'hidden')
234
235 setting('start.gcode', """;Sliced at: {day} {date} {time}
236 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
237 ;Print time: {print_time}
238 ;Filament used: {filament_amount}m {filament_weight}g
239 ;Filament cost: {filament_cost}
240 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
241 ;M109 S{print_temperature} ;Uncomment to add your own temperature line
242 G21        ;metric values
243 G90        ;absolute positioning
244 M107       ;start with the fan off
245
246 G28 X0 Y0  ;move X/Y to min endstops
247 G28 Z0     ;move Z to min endstops
248
249 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
250
251 G92 E0                  ;zero the extruded length
252 G1 F200 E3              ;extrude 3mm of feed stock
253 G92 E0                  ;zero the extruded length again
254 G1 F{travel_speed}
255 ;Put printing message on LCD screen
256 M117 Printing...
257 """, str, 'alteration', 'alteration')
258 #######################################################################################
259 setting('end.gcode', """;End GCode
260 M104 S0                     ;extruder heater off
261 M140 S0                     ;heated bed heater off (if you have it)
262
263 G91                                    ;relative positioning
264 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
265 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
266 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
267
268 M84                         ;steppers off
269 G90                         ;absolute positioning
270 """, str, 'alteration', 'alteration')
271 #######################################################################################
272 setting('start2.gcode', """;Sliced at: {day} {date} {time}
273 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
274 ;Print time: {print_time}
275 ;Filament used: {filament_amount}m {filament_weight}g
276 ;Filament cost: {filament_cost}
277 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
278 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
279 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
280 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
281 G21        ;metric values
282 G90        ;absolute positioning
283 M107       ;start with the fan off
284
285 G28 X0 Y0  ;move X/Y to min endstops
286 G28 Z0     ;move Z to min endstops
287
288 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
289
290 T1                      ;Switch to the 2nd extruder
291 G92 E0                  ;zero the extruded length
292 G1 F200 E10             ;extrude 10mm of feed stock
293 G92 E0                  ;zero the extruded length again
294 G1 F200 E-{retraction_dual_amount}
295
296 T0                      ;Switch to the first extruder
297 G92 E0                  ;zero the extruded length
298 G1 F200 E10             ;extrude 10mm of feed stock
299 G92 E0                  ;zero the extruded length again
300 G1 F{travel_speed}
301 ;Put printing message on LCD screen
302 M117 Printing...
303 """, str, 'alteration', 'alteration')
304 #######################################################################################
305 setting('end2.gcode', """;End GCode
306 M104 T0 S0                     ;extruder heater off
307 M104 T1 S0                     ;extruder heater off
308 M140 S0                     ;heated bed heater off (if you have it)
309
310 G91                                    ;relative positioning
311 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
312 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
313 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
314
315 M84                         ;steppers off
316 G90                         ;absolute positioning
317 """, str, 'alteration', 'alteration')
318 #######################################################################################
319 setting('support_start.gcode', '', str, 'alteration', 'alteration')
320 setting('support_end.gcode', '', str, 'alteration', 'alteration')
321 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
322 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
323 setting('replace.csv', '', str, 'alteration', 'alteration')
324 #######################################################################################
325 setting('switchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
326 G92 E0
327 G1 E-36 F5000
328 G92 E0
329 T{extruder}
330 G1 X{new_x} Y{new_y} Z{new_z} F{travel_speed}
331 G1 E36 F5000
332 G92 E0
333 """, str, 'alteration', 'alteration')
334
335 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
336 setting('oneAtATime', 'True', bool, 'preference', 'hidden')
337 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'UltimakerRobot_support.stl')), str, 'preference', 'hidden')
338 setting('save_profile', 'False', bool, 'preference', 'hidden').setLabel(_("Save profile on slice"), _("When slicing save the profile as [stl_file]_profile.ini next to the model."))
339 setting('filament_cost_kg', '0', float, 'preference', 'hidden').setLabel(_("Cost (price/kg)"), _("Cost of your filament per kg, to estimate the cost of the final print."))
340 setting('filament_cost_meter', '0', float, 'preference', 'hidden').setLabel(_("Cost (price/m)"), _("Cost of your filament per meter, to estimate the cost of the final print."))
341 setting('auto_detect_sd', 'True', bool, 'preference', 'hidden').setLabel(_("Auto detect SD card drive"), _("Auto detect the SD card. You can disable this because on some systems external hard-drives or USB sticks are detected as SD card."))
342 setting('check_for_updates', 'True', bool, 'preference', 'hidden').setLabel(_("Check for updates"), _("Check for newer versions of Cura on startup"))
343 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel(_("Send usage statistics"), _("Submit anonymous usage information to improve next versions of Cura"))
344 setting('youmagine_token', '', str, 'preference', 'hidden')
345 setting('filament_physical_density', '1240', float, 'preference', 'hidden').setRange(500.0, 3000.0).setLabel(_("Density (kg/m3)"), _("Weight of the filament per m3. Around 1240 for PLA. And around 1040 for ABS. This value is used to estimate the weight if the filament used for the print."))
346 setting('language', 'English', str, 'preference', 'hidden').setLabel(_('Language'), _('Change the language in which Cura runs. Switching language requires a restart of Cura'))
347 setting('active_machine', '0', int, 'preference', 'hidden')
348
349 setting('model_colour', '#FFC924', str, 'preference', 'hidden').setLabel(_('Model colour'), _('Display color for first extruder'))
350 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel(_('Model colour (2)'), _('Display color for second extruder'))
351 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel(_('Model colour (3)'), _('Display color for third extruder'))
352 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel(_('Model colour (4)'), _('Display color for forth extruder'))
353
354 setting('window_maximized', 'True', bool, 'preference', 'hidden')
355 setting('window_pos_x', '-1', float, 'preference', 'hidden')
356 setting('window_pos_y', '-1', float, 'preference', 'hidden')
357 setting('window_width', '-1', float, 'preference', 'hidden')
358 setting('window_height', '-1', float, 'preference', 'hidden')
359 setting('window_normal_sash', '320', float, 'preference', 'hidden')
360 setting('last_run_version', '', str, 'preference', 'hidden')
361
362 setting('machine_name', '', str, 'machine', 'hidden')
363 setting('machine_type', 'unknown', str, 'machine', 'hidden') #Ultimaker, Ultimaker2, RepRap
364 setting('machine_width', '205', float, 'machine', 'hidden').setLabel(_("Maximum width (mm)"), _("Size of the machine in mm"))
365 setting('machine_depth', '205', float, 'machine', 'hidden').setLabel(_("Maximum depth (mm)"), _("Size of the machine in mm"))
366 setting('machine_height', '200', float, 'machine', 'hidden').setLabel(_("Maximum height (mm)"), _("Size of the machine in mm"))
367 setting('machine_center_is_zero', 'False', bool, 'machine', 'hidden').setLabel(_("Machine center 0,0"), _("Machines firmware defines the center of the bed as 0,0 instead of the front left corner."))
368 setting('machine_shape', 'Square', ['Square','Circular'], 'machine', 'hidden').setLabel(_("Build area shape"), _("The shape of machine build area."))
369 setting('ultimaker_extruder_upgrade', 'False', bool, 'machine', 'hidden')
370 setting('has_heated_bed', 'False', bool, 'machine', 'hidden').setLabel(_("Heated bed"), _("If you have an heated bed, this enabled heated bed settings (requires restart)"))
371 setting('gcode_flavor', 'RepRap (Marlin/Sprinter)', ['RepRap (Marlin/Sprinter)', 'UltiGCode', 'MakerBot'], 'machine', 'hidden').setLabel(_("GCode Flavor"), _("Flavor of generated GCode.\nRepRap is normal 5D GCode which works on Marlin/Sprinter based firmwares.\nUltiGCode is a variation of the RepRap GCode which puts more settings in the machine instead of the slicer.\nMakerBot GCode has a few changes in the way GCode is generated, but still requires MakerWare to generate to X3G."))
372 setting('extruder_amount', '1', ['1','2','3','4'], 'machine', 'hidden').setLabel(_("Extruder count"), _("Amount of extruders in your machine."))
373 setting('extruder_offset_x1', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your secondary extruder compared to the primary."))
374 setting('extruder_offset_y1', '21.6', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your secondary extruder compared to the primary."))
375 setting('extruder_offset_x2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your tertiary extruder compared to the primary."))
376 setting('extruder_offset_y2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your tertiary extruder compared to the primary."))
377 setting('extruder_offset_x3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your forth extruder compared to the primary."))
378 setting('extruder_offset_y3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your forth extruder compared to the primary."))
379 setting('steps_per_e', '0', float, 'machine', 'hidden').setLabel(_("E-Steps per 1mm filament"), _("Amount of steps per mm filament extrusion. If set to 0 then this value is ignored and the value in your firmware is used."))
380 setting('serial_port', 'AUTO', str, 'machine', 'hidden').setLabel(_("Serial port"), _("Serial port to use for communication with the printer"))
381 setting('serial_port_auto', '', str, 'machine', 'hidden')
382 setting('serial_baud', 'AUTO', str, 'machine', 'hidden').setLabel(_("Baudrate"), _("Speed of the serial port communication\nNeeds to match your firmware settings\nCommon values are 250000, 115200, 57600"))
383 setting('serial_baud_auto', '', int, 'machine', 'hidden')
384
385 setting('extruder_head_size_min_x', '0.0', float, 'machine', 'hidden').setLabel(_("Head size towards X min (mm)"), _("The head size when printing multiple objects, measured from the tip of the nozzle towards the outer part of the head. 75mm for an Ultimaker if the fan is on the left side."))
386 setting('extruder_head_size_min_y', '0.0', float, 'machine', 'hidden').setLabel(_("Head size towards Y min (mm)"), _("The head size when printing multiple objects, measured from the tip of the nozzle towards the outer part of the head. 18mm for an Ultimaker if the fan is on the left side."))
387 setting('extruder_head_size_max_x', '0.0', float, 'machine', 'hidden').setLabel(_("Head size towards X max (mm)"), _("The head size when printing multiple objects, measured from the tip of the nozzle towards the outer part of the head. 18mm for an Ultimaker if the fan is on the left side."))
388 setting('extruder_head_size_max_y', '0.0', float, 'machine', 'hidden').setLabel(_("Head size towards Y max (mm)"), _("The head size when printing multiple objects, measured from the tip of the nozzle towards the outer part of the head. 35mm for an Ultimaker if the fan is on the left side."))
389 setting('extruder_head_size_height', '0.0', float, 'machine', 'hidden').setLabel(_("Printer gantry height (mm)"), _("The height of the gantry holding up the printer head. If an object is higher then this then you cannot print multiple objects one for one. 60mm for an Ultimaker."))
390
391 validators.warningAbove(settingsDictionary['filament_flow'], 150, _("More flow than 150% is rare and usually not recommended."))
392 validators.warningBelow(settingsDictionary['filament_flow'], 50, _("Less flow than 50% is rare and usually not recommended."))
393 validators.warningAbove(settingsDictionary['layer_height'], lambda : (float(getProfileSetting('nozzle_size')) * 80.0 / 100.0), _("Thicker layers then %.2fmm (80%% nozzle size) usually give bad results and are not recommended."))
394 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
395 validators.warningAbove(settingsDictionary['print_speed'], 150.0, _("It is highly unlikely that your machine can achieve a printing speed above 150mm/s"))
396 validators.printSpeedValidator(settingsDictionary['print_speed'])
397 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
398 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
399 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
400 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
401 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
402 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
403 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
404 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
405 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, _("It is highly unlikely that your machine can achieve a travel speed above 300mm/s"))
406 validators.warningAbove(settingsDictionary['bottom_thickness'], lambda : (float(getProfileSetting('nozzle_size')) * 3.0 / 4.0), _("A bottom layer of more then %.2fmm (3/4 nozzle size) usually give bad results and is not recommended."))
407
408 #Conditions for multiple extruders
409 settingsDictionary['print_temperature2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
410 settingsDictionary['print_temperature3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
411 settingsDictionary['print_temperature4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
412 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
413 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
414 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
415 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
416 settingsDictionary['retraction_dual_amount'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
417 settingsDictionary['wipe_tower'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
418 settingsDictionary['wipe_tower_volume'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
419 settingsDictionary['ooze_shield'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
420 #Heated bed
421 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('has_heated_bed') == 'True')
422
423 #UltiGCode uses less settings, as these settings are located inside the machine instead of gcode.
424 settingsDictionary['print_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
425 settingsDictionary['print_temperature2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
426 settingsDictionary['print_temperature3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
427 settingsDictionary['print_temperature4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
428 settingsDictionary['filament_diameter'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
429 settingsDictionary['filament_diameter2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
430 settingsDictionary['filament_diameter3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
431 settingsDictionary['filament_diameter4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
432 settingsDictionary['filament_flow'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
433 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
434 settingsDictionary['retraction_speed'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
435 settingsDictionary['retraction_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
436 settingsDictionary['retraction_dual_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
437
438 #Remove fake defined _() because later the localization will define a global _()
439 del _
440
441 #########################################################
442 ## Profile and preferences functions
443 #########################################################
444
445 def getSubCategoriesFor(category):
446         done = {}
447         ret = []
448         for s in settingsList:
449                 if s.getCategory() == category and not s.getSubCategory() in done and s.checkConditions():
450                         done[s.getSubCategory()] = True
451                         ret.append(s.getSubCategory())
452         return ret
453
454 def getSettingsForCategory(category, subCategory = None):
455         ret = []
456         for s in settingsList:
457                 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory) and s.checkConditions():
458                         ret.append(s)
459         return ret
460
461 ## Profile functions
462 def getBasePath():
463         if platform.system() == "Windows":
464                 basePath = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
465                 #If we have a frozen python install, we need to step out of the library.zip
466                 if hasattr(sys, 'frozen'):
467                         basePath = os.path.normpath(os.path.join(basePath, ".."))
468         else:
469                 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
470         if not os.path.isdir(basePath):
471                 os.makedirs(basePath)
472         return basePath
473
474 def getAlternativeBasePaths():
475         paths = []
476         basePath = os.path.normpath(os.path.join(getBasePath(), '..'))
477         for subPath in os.listdir(basePath):
478                 path = os.path.join(basePath, subPath)
479                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
480                         paths.append(path)
481                 path = os.path.join(basePath, subPath, 'Cura')
482                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
483                         paths.append(path)
484         return paths
485
486 def getDefaultProfilePath():
487         return os.path.join(getBasePath(), 'current_profile.ini')
488
489 def loadProfile(filename):
490         #Read a configuration file as global config
491         profileParser = ConfigParser.ConfigParser()
492         try:
493                 profileParser.read(filename)
494         except ConfigParser.ParsingError:
495                 return
496         global settingsList
497         for set in settingsList:
498                 if set.isPreference():
499                         continue
500                 section = 'profile'
501                 if set.isAlteration():
502                         section = 'alterations'
503                 if profileParser.has_option(section, set.getName()):
504                         set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
505
506 def saveProfile(filename):
507         #Save the current profile to an ini file
508         profileParser = ConfigParser.ConfigParser()
509         profileParser.add_section('profile')
510         profileParser.add_section('alterations')
511         global settingsList
512         for set in settingsList:
513                 if set.isPreference() or set.isMachineSetting():
514                         continue
515                 if set.isAlteration():
516                         profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
517                 else:
518                         profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
519
520         profileParser.write(open(filename, 'w'))
521
522 def resetProfile():
523         #Read a configuration file as global config
524         global settingsList
525         for set in settingsList:
526                 if not set.isProfile():
527                         continue
528                 set.setValue(set.getDefault())
529
530         if getMachineSetting('machine_type') == 'ultimaker':
531                 putProfileSetting('nozzle_size', '0.4')
532                 if getMachineSetting('ultimaker_extruder_upgrade') == 'True':
533                         putProfileSetting('retraction_enable', 'True')
534         elif getMachineSetting('machine_type') == 'ultimaker2':
535                 putProfileSetting('nozzle_size', '0.4')
536                 putProfileSetting('retraction_enable', 'True')
537         else:
538                 putProfileSetting('nozzle_size', '0.5')
539                 putProfileSetting('retraction_enable', 'True')
540
541 def setProfileFromString(options):
542         options = base64.b64decode(options)
543         options = zlib.decompress(options)
544         (profileOpts, alt) = options.split('\f', 1)
545         global settingsDictionary
546         for option in profileOpts.split('\b'):
547                 if len(option) > 0:
548                         (key, value) = option.split('=', 1)
549                         if key in settingsDictionary:
550                                 if settingsDictionary[key].isProfile():
551                                         settingsDictionary[key].setValue(value)
552         for option in alt.split('\b'):
553                 if len(option) > 0:
554                         (key, value) = option.split('=', 1)
555                         if key in settingsDictionary:
556                                 if settingsDictionary[key].isAlteration():
557                                         settingsDictionary[key].setValue(value)
558
559 def getProfileString():
560         p = []
561         alt = []
562         global settingsList
563         for set in settingsList:
564                 if set.isProfile():
565                         if set.getName() in tempOverride:
566                                 p.append(set.getName() + "=" + tempOverride[set.getName()])
567                         else:
568                                 p.append(set.getName() + "=" + set.getValue())
569                 elif set.isAlteration():
570                         if set.getName() in tempOverride:
571                                 alt.append(set.getName() + "=" + tempOverride[set.getName()])
572                         else:
573                                 alt.append(set.getName() + "=" + set.getValue())
574         ret = '\b'.join(p) + '\f' + '\b'.join(alt)
575         ret = base64.b64encode(zlib.compress(ret, 9))
576         return ret
577
578 def insertNewlines(string, every=64): #This should be moved to a better place then profile.
579         lines = []
580         for i in xrange(0, len(string), every):
581                 lines.append(string[i:i+every])
582         return '\n'.join(lines)
583
584 def getPreferencesString():
585         p = []
586         global settingsList
587         for set in settingsList:
588                 if set.isPreference():
589                         p.append(set.getName() + "=" + set.getValue())
590         ret = '\b'.join(p)
591         ret = base64.b64encode(zlib.compress(ret, 9))
592         return ret
593
594
595 def getProfileSetting(name):
596         if name in tempOverride:
597                 return tempOverride[name]
598         global settingsDictionary
599         if name in settingsDictionary and settingsDictionary[name].isProfile():
600                 return settingsDictionary[name].getValue()
601         traceback.print_stack()
602         sys.stderr.write('Error: "%s" not found in profile settings\n' % (name))
603         return ''
604
605 def getProfileSettingFloat(name):
606         try:
607                 setting = getProfileSetting(name).replace(',', '.')
608                 return float(eval(setting, {}, {}))
609         except:
610                 return 0.0
611
612 def putProfileSetting(name, value):
613         #Check if we have a configuration file loaded, else load the default.
614         global settingsDictionary
615         if name in settingsDictionary and settingsDictionary[name].isProfile():
616                 settingsDictionary[name].setValue(value)
617
618 def isProfileSetting(name):
619         global settingsDictionary
620         if name in settingsDictionary and settingsDictionary[name].isProfile():
621                 return True
622         return False
623
624 ## Preferences functions
625 def getPreferencePath():
626         return os.path.join(getBasePath(), 'preferences.ini')
627
628 def getPreferenceFloat(name):
629         try:
630                 setting = getPreference(name).replace(',', '.')
631                 return float(eval(setting, {}, {}))
632         except:
633                 return 0.0
634
635 def getPreferenceColour(name):
636         colorString = getPreference(name)
637         return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
638
639 def loadPreferences(filename):
640         global settingsList
641         #Read a configuration file as global config
642         profileParser = ConfigParser.ConfigParser()
643         try:
644                 profileParser.read(filename)
645         except ConfigParser.ParsingError:
646                 return
647
648         for set in settingsList:
649                 if set.isPreference():
650                         if profileParser.has_option('preference', set.getName()):
651                                 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
652
653         n = 0
654         while profileParser.has_section('machine_%d' % (n)):
655                 for set in settingsList:
656                         if set.isMachineSetting():
657                                 if profileParser.has_option('machine_%d' % (n), set.getName()):
658                                         set.setValue(unicode(profileParser.get('machine_%d' % (n), set.getName()), 'utf-8', 'replace'), n)
659                 n += 1
660
661         setActiveMachine(int(getPreferenceFloat('active_machine')))
662
663 def loadMachineSettings(filename):
664         global settingsList
665         #Read a configuration file as global config
666         profileParser = ConfigParser.ConfigParser()
667         try:
668                 profileParser.read(filename)
669         except ConfigParser.ParsingError:
670                 return
671
672         for set in settingsList:
673                 if set.isMachineSetting():
674                         if profileParser.has_option('machine', set.getName()):
675                                 set.setValue(unicode(profileParser.get('machine', set.getName()), 'utf-8', 'replace'))
676         checkAndUpdateMachineName()
677
678 def savePreferences(filename):
679         global settingsList
680         #Save the current profile to an ini file
681         parser = ConfigParser.ConfigParser()
682         parser.add_section('preference')
683
684         for set in settingsList:
685                 if set.isPreference():
686                         parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
687
688         n = 0
689         while getMachineSetting('machine_name', n) != '':
690                 parser.add_section('machine_%d' % (n))
691                 for set in settingsList:
692                         if set.isMachineSetting():
693                                 parser.set('machine_%d' % (n), set.getName(), set.getValue(n).encode('utf-8'))
694                 n += 1
695         parser.write(open(filename, 'w'))
696
697 def getPreference(name):
698         if name in tempOverride:
699                 return tempOverride[name]
700         global settingsDictionary
701         if name in settingsDictionary and settingsDictionary[name].isPreference():
702                 return settingsDictionary[name].getValue()
703         traceback.print_stack()
704         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
705         return ''
706
707 def putPreference(name, value):
708         #Check if we have a configuration file loaded, else load the default.
709         global settingsDictionary
710         if name in settingsDictionary and settingsDictionary[name].isPreference():
711                 settingsDictionary[name].setValue(value)
712                 savePreferences(getPreferencePath())
713                 return
714         traceback.print_stack()
715         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
716
717 def isPreference(name):
718         global settingsDictionary
719         if name in settingsDictionary and settingsDictionary[name].isPreference():
720                 return True
721         return False
722
723 def getMachineSettingFloat(name, index = None):
724         try:
725                 setting = getMachineSetting(name, index).replace(',', '.')
726                 return float(eval(setting, {}, {}))
727         except:
728                 return 0.0
729
730 def getMachineSetting(name, index = None):
731         if name in tempOverride:
732                 return tempOverride[name]
733         global settingsDictionary
734         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
735                 return settingsDictionary[name].getValue(index)
736         traceback.print_stack()
737         sys.stderr.write('Error: "%s" not found in machine settings\n' % (name))
738         return ''
739
740 def putMachineSetting(name, value):
741         #Check if we have a configuration file loaded, else load the default.
742         global settingsDictionary
743         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
744                 settingsDictionary[name].setValue(value)
745         savePreferences(getPreferencePath())
746
747 def isMachineSetting(name):
748         global settingsDictionary
749         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
750                 return True
751         return False
752
753 def checkAndUpdateMachineName():
754         global _selectedMachineIndex
755         name = getMachineSetting('machine_name')
756         index = None
757         if name == '':
758                 name = getMachineSetting('machine_type')
759         for n in xrange(0, getMachineCount()):
760                 if n == _selectedMachineIndex:
761                         continue
762                 if index is None:
763                         if name == getMachineSetting('machine_name', n):
764                                 index = 1
765                 else:
766                         if '%s (%d)' % (name, index) == getMachineSetting('machine_name', n):
767                                 index += 1
768         if index is not None:
769                 name = '%s (%d)' % (name, index)
770         putMachineSetting('machine_name', name)
771         putPreference('active_machine', _selectedMachineIndex)
772
773 def getMachineCount():
774         n = 0
775         while getMachineSetting('machine_name', n) != '':
776                 n += 1
777         if n < 1:
778                 return 1
779         return n
780
781 def setActiveMachine(index):
782         global _selectedMachineIndex
783         _selectedMachineIndex = index
784         putPreference('active_machine', _selectedMachineIndex)
785
786 def removeMachine(index):
787         global _selectedMachineIndex
788         global settingsList
789         if getMachineCount() < 2:
790                 return
791         for n in xrange(index, getMachineCount()):
792                 for setting in settingsList:
793                         if setting.isMachineSetting():
794                                 setting.setValue(setting.getValue(n+1), n)
795
796         if _selectedMachineIndex >= index:
797                 setActiveMachine(getMachineCount() - 1)
798
799 ## Temp overrides for multi-extruder slicing and the project planner.
800 tempOverride = {}
801 def setTempOverride(name, value):
802         tempOverride[name] = unicode(value).encode("utf-8")
803 def clearTempOverride(name):
804         del tempOverride[name]
805 def resetTempOverride():
806         tempOverride.clear()
807
808 #########################################################
809 ## Utility functions to calculate common profile values
810 #########################################################
811 def calculateEdgeWidth():
812         wallThickness = getProfileSettingFloat('wall_thickness')
813         nozzleSize = getProfileSettingFloat('nozzle_size')
814
815         if getProfileSetting('spiralize') == 'True':
816                 return wallThickness
817
818         if wallThickness < 0.01:
819                 return nozzleSize
820         if wallThickness < nozzleSize:
821                 return wallThickness
822
823         lineCount = int(wallThickness / (nozzleSize - 0.0001))
824         if lineCount == 0:
825                 return nozzleSize
826         lineWidth = wallThickness / lineCount
827         lineWidthAlt = wallThickness / (lineCount + 1)
828         if lineWidth > nozzleSize * 1.5:
829                 return lineWidthAlt
830         return lineWidth
831
832 def calculateLineCount():
833         wallThickness = getProfileSettingFloat('wall_thickness')
834         nozzleSize = getProfileSettingFloat('nozzle_size')
835
836         if wallThickness < 0.01:
837                 return 0
838         if wallThickness < nozzleSize:
839                 return 1
840         if getProfileSetting('spiralize') == 'True':
841                 return 1
842
843         lineCount = int(wallThickness / (nozzleSize - 0.0001))
844         if lineCount < 1:
845                 lineCount = 1
846         lineWidth = wallThickness / lineCount
847         lineWidthAlt = wallThickness / (lineCount + 1)
848         if lineWidth > nozzleSize * 1.5:
849                 return lineCount + 1
850         return lineCount
851
852 def calculateSolidLayerCount():
853         layerHeight = getProfileSettingFloat('layer_height')
854         solidThickness = getProfileSettingFloat('solid_layer_thickness')
855         if layerHeight == 0.0:
856                 return 1
857         return int(math.ceil(solidThickness / (layerHeight - 0.0001)))
858
859 def calculateObjectSizeOffsets():
860         size = 0.0
861
862         if getProfileSetting('platform_adhesion') == 'Brim':
863                 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
864         elif getProfileSetting('platform_adhesion') == 'Raft':
865                 pass
866         else:
867                 if getProfileSettingFloat('skirt_line_count') > 0:
868                         size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
869
870         #if getProfileSetting('enable_raft') != 'False':
871         #       size += profile.getProfileSettingFloat('raft_margin') * 2
872         #if getProfileSetting('support') != 'None':
873         #       extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
874         #       extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
875         return [size, size]
876
877 def getMachineCenterCoords():
878         if getMachineSetting('machine_center_is_zero') == 'True':
879                 return [0, 0]
880         return [getMachineSettingFloat('machine_width') / 2, getMachineSettingFloat('machine_depth') / 2]
881
882 #Returns a list of convex polygons, first polygon is the allowed area of the machine,
883 # the rest of the polygons are the dis-allowed areas of the machine.
884 def getMachineSizePolygons():
885         size = numpy.array([getMachineSettingFloat('machine_width'), getMachineSettingFloat('machine_depth'), getMachineSettingFloat('machine_height')], numpy.float32)
886         ret = []
887         if getMachineSetting('machine_shape') == 'Circular':
888                 # Circle platform for delta printers...
889                 circle = []
890                 steps = 32
891                 for n in xrange(0, steps):
892                         circle.append([math.cos(float(n)/steps*2*math.pi) * size[0]/2, math.sin(float(n)/steps*2*math.pi) * size[1]/2])
893                 ret.append(numpy.array(circle, numpy.float32))
894         else:
895                 ret.append(numpy.array([[-size[0]/2,-size[1]/2],[size[0]/2,-size[1]/2],[size[0]/2, size[1]/2], [-size[0]/2, size[1]/2]], numpy.float32))
896
897         if getMachineSetting('machine_type') == 'ultimaker2':
898                 #UM2 no-go zones
899                 w = 25
900                 h = 10
901                 ret.append(numpy.array([[-size[0]/2,-size[1]/2],[-size[0]/2+w+2,-size[1]/2], [-size[0]/2+w,-size[1]/2+h], [-size[0]/2,-size[1]/2+h]], numpy.float32))
902                 ret.append(numpy.array([[ size[0]/2-w-2,-size[1]/2],[ size[0]/2,-size[1]/2], [ size[0]/2,-size[1]/2+h],[ size[0]/2-w,-size[1]/2+h]], numpy.float32))
903                 ret.append(numpy.array([[-size[0]/2+w+2, size[1]/2],[-size[0]/2, size[1]/2], [-size[0]/2, size[1]/2-h],[-size[0]/2+w, size[1]/2-h]], numpy.float32))
904                 ret.append(numpy.array([[ size[0]/2, size[1]/2],[ size[0]/2-w-2, size[1]/2], [ size[0]/2-w, size[1]/2-h],[ size[0]/2, size[1]/2-h]], numpy.float32))
905         return ret
906
907 #returns the number of extruders minimal used. Normally this returns 1, but with dual-extrusion support material it returns 2
908 def minimalExtruderCount():
909         if int(getMachineSetting('extruder_amount')) < 2:
910                 return 1
911         if getProfileSetting('support') == 'None':
912                 return 1
913         if getProfileSetting('support_dual_extrusion') == 'Second extruder':
914                 return 2
915         return 1
916
917 #########################################################
918 ## Alteration file functions
919 #########################################################
920 def replaceTagMatch(m):
921         pre = m.group(1)
922         tag = m.group(2)
923         if tag == 'time':
924                 return pre + time.strftime('%H:%M:%S')
925         if tag == 'date':
926                 return pre + time.strftime('%d-%m-%Y')
927         if tag == 'day':
928                 return pre + ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][int(time.strftime('%w'))]
929         if tag == 'print_time':
930                 return pre + '#P_TIME#'
931         if tag == 'filament_amount':
932                 return pre + '#F_AMNT#'
933         if tag == 'filament_weight':
934                 return pre + '#F_WGHT#'
935         if tag == 'filament_cost':
936                 return pre + '#F_COST#'
937         if pre == 'F' and tag == 'max_z_speed':
938                 f = getProfileSettingFloat('travel_speed') * 60
939         if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
940                 f = getProfileSettingFloat(tag) * 60
941         elif isProfileSetting(tag):
942                 f = getProfileSettingFloat(tag)
943         elif isPreference(tag):
944                 f = getProfileSettingFloat(tag)
945         else:
946                 return '%s?%s?' % (pre, tag)
947         if (f % 1) == 0:
948                 return pre + str(int(f))
949         return pre + str(f)
950
951 def replaceGCodeTags(filename, gcodeInt):
952         f = open(filename, 'r+')
953         data = f.read(2048)
954         data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
955         data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
956         data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
957         cost = gcodeInt.calculateCost()
958         if cost is None:
959                 cost = 'Unknown'
960         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
961         f.seek(0)
962         f.write(data)
963         f.close()
964
965 def replaceGCodeTagsFromSlicer(filename, slicerInt):
966         f = open(filename, 'r+')
967         data = f.read(2048)
968         data = data.replace('#P_TIME#', ('%8.2f' % (int(slicerInt._printTimeSeconds)))[-8:])
969         data = data.replace('#F_AMNT#', ('%8.2f' % (slicerInt._filamentMM[0]))[-8:])
970         data = data.replace('#F_WGHT#', ('%8.2f' % (float(slicerInt.getFilamentWeight()) * 1000))[-8:])
971         cost = slicerInt.getFilamentCost()
972         if cost is None:
973                 cost = 'Unknown'
974         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
975         f.seek(0)
976         f.write(data)
977         f.close()
978
979 ### Get aleration raw contents. (Used internally in Cura)
980 def getAlterationFile(filename):
981         if filename in tempOverride:
982                 return tempOverride[filename]
983         global settingsDictionary
984         if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
985                 return settingsDictionary[filename].getValue()
986         traceback.print_stack()
987         sys.stderr.write('Error: "%s" not found in alteration settings\n' % (filename))
988         return ''
989
990 def setAlterationFile(name, value):
991         #Check if we have a configuration file loaded, else load the default.
992         global settingsDictionary
993         if name in settingsDictionary and settingsDictionary[name].isAlteration():
994                 settingsDictionary[name].setValue(value)
995         saveProfile(getDefaultProfilePath())
996
997 def isTagIn(tag, contents):
998         contents = re.sub(';[^\n]*\n', '', contents)
999         return tag in contents
1000
1001 ### Get the alteration file for output. (Used by Skeinforge)
1002 def getAlterationFileContents(filename, extruderCount = 1):
1003         prefix = ''
1004         postfix = ''
1005         alterationContents = getAlterationFile(filename)
1006         if getMachineSetting('gcode_flavor') == 'UltiGCode':
1007                 if filename == 'end.gcode':
1008                         return 'M25 ;Stop reading from this point on.\n;CURA_PROFILE_STRING:%s\n' % (getProfileString())
1009                 return ''
1010         if filename == 'start.gcode':
1011                 if extruderCount > 1:
1012                         alterationContents = getAlterationFile("start%d.gcode" % (extruderCount))
1013                 #For the start code, hack the temperature and the steps per E value into it. So the temperature is reached before the start code extrusion.
1014                 #We also set our steps per E here, if configured.
1015                 eSteps = getMachineSettingFloat('steps_per_e')
1016                 if eSteps > 0:
1017                         prefix += 'M92 E%f\n' % (eSteps)
1018                 temp = getProfileSettingFloat('print_temperature')
1019                 bedTemp = 0
1020                 if getMachineSetting('has_heated_bed') == 'True':
1021                         bedTemp = getProfileSettingFloat('print_bed_temperature')
1022
1023                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1024                         prefix += 'M140 S%f\n' % (bedTemp)
1025                 if temp > 0 and not isTagIn('{print_temperature}', alterationContents):
1026                         if extruderCount > 0:
1027                                 for n in xrange(1, extruderCount):
1028                                         t = temp
1029                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1030                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1031                                         prefix += 'M104 T%d S%f\n' % (n, t)
1032                                 for n in xrange(0, extruderCount):
1033                                         t = temp
1034                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1035                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1036                                         prefix += 'M109 T%d S%f\n' % (n, t)
1037                                 prefix += 'T0\n'
1038                         else:
1039                                 prefix += 'M109 S%f\n' % (temp)
1040                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1041                         prefix += 'M190 S%f\n' % (bedTemp)
1042         elif filename == 'end.gcode':
1043                 if extruderCount > 1:
1044                         alterationContents = getAlterationFile("end%d.gcode" % (extruderCount))
1045                 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
1046                 postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
1047         return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'
1048
1049 ###### PLUGIN #####
1050
1051 def getPluginConfig():
1052         try:
1053                 return pickle.loads(str(getProfileSetting('plugin_config')))
1054         except:
1055                 return []
1056
1057 def setPluginConfig(config):
1058         putProfileSetting('plugin_config', pickle.dumps(config))
1059
1060 def getPluginBasePaths():
1061         ret = []
1062         if platform.system() != "Windows":
1063                 ret.append(os.path.expanduser('~/.cura/plugins/'))
1064         if platform.system() == "Darwin" and hasattr(sys, 'frozen'):
1065                 ret.append(os.path.normpath(os.path.join(resources.resourceBasePath, "Cura/plugins")))
1066         else:
1067                 ret.append(os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'plugins')))
1068         return ret
1069
1070 def getPluginList():
1071         ret = []
1072         for basePath in getPluginBasePaths():
1073                 for filename in glob.glob(os.path.join(basePath, '*.py')):
1074                         filename = os.path.basename(filename)
1075                         if filename.startswith('_'):
1076                                 continue
1077                         with open(os.path.join(basePath, filename), "r") as f:
1078                                 item = {'filename': filename, 'name': None, 'info': None, 'type': None, 'params': []}
1079                                 for line in f:
1080                                         line = line.strip()
1081                                         if not line.startswith('#'):
1082                                                 break
1083                                         line = line[1:].split(':', 1)
1084                                         if len(line) != 2:
1085                                                 continue
1086                                         if line[0].upper() == 'NAME':
1087                                                 item['name'] = line[1].strip()
1088                                         elif line[0].upper() == 'INFO':
1089                                                 item['info'] = line[1].strip()
1090                                         elif line[0].upper() == 'TYPE':
1091                                                 item['type'] = line[1].strip()
1092                                         elif line[0].upper() == 'DEPEND':
1093                                                 pass
1094                                         elif line[0].upper() == 'PARAM':
1095                                                 m = re.match('([a-zA-Z][a-zA-Z0-9_]*)\(([a-zA-Z_]*)(?::([^\)]*))?\) +(.*)', line[1].strip())
1096                                                 if m is not None:
1097                                                         item['params'].append({'name': m.group(1), 'type': m.group(2), 'default': m.group(3), 'description': m.group(4)})
1098                                         else:
1099                                                 print "Unknown item in effect meta data: %s %s" % (line[0], line[1])
1100                                 if item['name'] is not None and item['type'] == 'postprocess':
1101                                         ret.append(item)
1102         return ret
1103
1104 def runPostProcessingPlugins(gcodefilename):
1105         pluginConfigList = getPluginConfig()
1106         pluginList = getPluginList()
1107
1108         for pluginConfig in pluginConfigList:
1109                 plugin = None
1110                 for pluginTest in pluginList:
1111                         if pluginTest['filename'] == pluginConfig['filename']:
1112                                 plugin = pluginTest
1113                 if plugin is None:
1114                         continue
1115
1116                 pythonFile = None
1117                 for basePath in getPluginBasePaths():
1118                         testFilename = os.path.join(basePath, pluginConfig['filename'])
1119                         if os.path.isfile(testFilename):
1120                                 pythonFile = testFilename
1121                 if pythonFile is None:
1122                         continue
1123
1124                 locals = {'filename': gcodefilename}
1125                 for param in plugin['params']:
1126                         value = param['default']
1127                         if param['name'] in pluginConfig['params']:
1128                                 value = pluginConfig['params'][param['name']]
1129
1130                         if param['type'] == 'float':
1131                                 try:
1132                                         value = float(value)
1133                                 except:
1134                                         value = float(param['default'])
1135
1136                         locals[param['name']] = value
1137                 try:
1138                         execfile(pythonFile, locals)
1139                 except:
1140                         locationInfo = traceback.extract_tb(sys.exc_info()[2])[-1]
1141                         return "%s: '%s' @ %s:%s:%d" % (str(sys.exc_info()[0].__name__), str(sys.exc_info()[1]), os.path.basename(locationInfo[0]), locationInfo[2], locationInfo[1])
1142         return None