chiark / gitweb /
Merge branch 'SteamEngine' of github.com:daid/Cura into SteamEngine
[cura.git] / Cura / util / profile.py
1 from __future__ import division
2 __copyright__ = "Copyright (C) 2013 David Braam - Released under terms of the AGPLv3 License"
3
4 import os, traceback, math, re, zlib, base64, time, sys, platform, glob, string, stat, types
5 import cPickle as pickle
6 import numpy
7 if sys.version_info[0] < 3:
8         import ConfigParser
9 else:
10         import configparser as ConfigParser
11
12 from Cura.util import resources
13 from Cura.util import version
14 from Cura.util import validators
15
16 #The settings dictionary contains a key/value reference to all possible settings. With the setting name as key.
17 settingsDictionary = {}
18 #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,
19 # as the dictionary will not contain insertion order.
20 settingsList = []
21
22 #Currently selected machine (by index) Cura support multiple machines in the same preferences and can switch between them.
23 # Each machine has it's own index and unique name.
24 _selectedMachineIndex = 0
25
26 class setting(object):
27         #A setting object contains a configuration setting. These are globally accessible trough the quick access functions
28         # and trough the settingsDictionary function.
29         # Settings can be:
30         # * profile settings (settings that effect the slicing process and the print result)
31         # * preferences (settings that effect how cura works and acts)
32         # * machine settings (settings that relate to the physical configuration of your machine)
33         # * alterations (bad name copied from Skeinforge. These are the start/end code pieces)
34         # Settings have validators that check if the value is valid, but do not prevent invalid values!
35         # Settings have conditions that enable/disable this setting depending on other settings. (Ex: Dual-extrusion)
36         def __init__(self, name, default, type, category, subcategory):
37                 self._name = name
38                 self._label = name
39                 self._tooltip = ''
40                 self._default = unicode(default)
41                 self._values = []
42                 self._type = type
43                 self._category = category
44                 self._subcategory = subcategory
45                 self._validators = []
46                 self._conditions = []
47
48                 if type is types.FloatType:
49                         validators.validFloat(self)
50                 elif type is types.IntType:
51                         validators.validInt(self)
52
53                 global settingsDictionary
54                 settingsDictionary[name] = self
55                 global settingsList
56                 settingsList.append(self)
57
58         def setLabel(self, label, tooltip = ''):
59                 self._label = label
60                 self._tooltip = tooltip
61                 return self
62
63         def setRange(self, minValue=None, maxValue=None):
64                 if len(self._validators) < 1:
65                         return
66                 self._validators[0].minValue = minValue
67                 self._validators[0].maxValue = maxValue
68                 return self
69
70         def getLabel(self):
71                 return _(self._label)
72
73         def getTooltip(self):
74                 return _(self._tooltip)
75
76         def getCategory(self):
77                 return self._category
78
79         def getSubCategory(self):
80                 return self._subcategory
81
82         def isPreference(self):
83                 return self._category == 'preference'
84
85         def isMachineSetting(self):
86                 return self._category == 'machine'
87
88         def isAlteration(self):
89                 return self._category == 'alteration'
90
91         def isProfile(self):
92                 return not self.isAlteration() and not self.isPreference() and not self.isMachineSetting()
93
94         def getName(self):
95                 return self._name
96
97         def getType(self):
98                 return self._type
99
100         def getValue(self, index = None):
101                 if index is None:
102                         index = self.getValueIndex()
103                 if index >= len(self._values):
104                         return self._default
105                 return self._values[index]
106
107         def getDefault(self):
108                 return self._default
109
110         def setValue(self, value, index = None):
111                 if index is None:
112                         index = self.getValueIndex()
113                 while index >= len(self._values):
114                         self._values.append(self._default)
115                 self._values[index] = unicode(value)
116
117         def getValueIndex(self):
118                 if self.isMachineSetting():
119                         global _selectedMachineIndex
120                         return _selectedMachineIndex
121                 return 0
122
123         def validate(self):
124                 result = validators.SUCCESS
125                 msgs = []
126                 for validator in self._validators:
127                         res, err = validator.validate()
128                         if res == validators.ERROR:
129                                 result = res
130                         elif res == validators.WARNING and result != validators.ERROR:
131                                 result = res
132                         if res != validators.SUCCESS:
133                                 msgs.append(err)
134                 return result, '\n'.join(msgs)
135
136         def addCondition(self, conditionFunction):
137                 self._conditions.append(conditionFunction)
138
139         def checkConditions(self):
140                 for condition in self._conditions:
141                         if not condition():
142                                 return False
143                 return True
144
145 #########################################################
146 ## Settings
147 #########################################################
148
149 #Define a fake _() function to fake the gettext tools in to generating strings for the profile settings.
150 def _(n):
151         return n
152
153 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."))
154 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."))
155 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."))
156 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."))
157 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."))
158 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."))
159 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."))
160 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."))
161 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."))
162 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."))
163 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."))
164 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."))
165 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."))
166 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)"))
167 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."))
168 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."))
169 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."))
170 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."))
171 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."))
172 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."))
173 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."))
174 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."))
175 setting('filament_flow',            100., float, 'basic',    _('Filament')).setRange(5,300).setLabel(_("Flow (%)"), _("Flow compensation, the amount of material extruded is multiplied by this value"))
176 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."))
177 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."))
178 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."))
179 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."))
180 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."))
181 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."))
182 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."))
183 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."))
184 #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."))
185 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."))
186 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."))
187 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."))
188 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."))
189 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."))
190 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."))
191 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."))
192 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."))
193
194 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."))
195 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."))
196 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."))
197 #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."))
198 #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.'))
199 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."))
200 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."))
201 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%."))
202 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."))
203 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."))
204 #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."))
205 #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')
206 #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\''))
207 #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."))
208 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."))
209 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."))
210 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."))
211 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."))
212 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."))
213 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."))
214 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."))
215 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."))
216 #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."))
217 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."))
218 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."))
219 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."))
220 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."))
221 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."))
222 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."))
223 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."))
224 #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)."))
225 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."))
226 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."))
227 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."))
228 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."))
229
230 setting('plugin_config', '', str, 'hidden', 'hidden')
231 setting('object_center_x', -1, float, 'hidden', 'hidden')
232 setting('object_center_y', -1, float, 'hidden', 'hidden')
233
234 setting('start.gcode', """;Sliced at: {day} {date} {time}
235 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
236 ;Print time: {print_time}
237 ;Filament used: {filament_amount}m {filament_weight}g
238 ;Filament cost: {filament_cost}
239 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
240 ;M109 S{print_temperature} ;Uncomment to add your own temperature line
241 G21        ;metric values
242 G90        ;absolute positioning
243 M107       ;start with the fan off
244
245 G28 X0 Y0  ;move X/Y to min endstops
246 G28 Z0     ;move Z to min endstops
247
248 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
249
250 G92 E0                  ;zero the extruded length
251 G1 F200 E3              ;extrude 3mm of feed stock
252 G92 E0                  ;zero the extruded length again
253 G1 F{travel_speed}
254 ;Put printing message on LCD screen
255 M117 Printing...
256 """, str, 'alteration', 'alteration')
257 #######################################################################################
258 setting('end.gcode', """;End GCode
259 M104 S0                     ;extruder heater off
260 M140 S0                     ;heated bed heater off (if you have it)
261
262 G91                                    ;relative positioning
263 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
264 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
265 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
266
267 M84                         ;steppers off
268 G90                         ;absolute positioning
269 """, str, 'alteration', 'alteration')
270 #######################################################################################
271 setting('start2.gcode', """;Sliced at: {day} {date} {time}
272 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
273 ;Print time: {print_time}
274 ;Filament used: {filament_amount}m {filament_weight}g
275 ;Filament cost: {filament_cost}
276 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
277 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
278 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
279 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
280 G21        ;metric values
281 G90        ;absolute positioning
282 M107       ;start with the fan off
283
284 G28 X0 Y0  ;move X/Y to min endstops
285 G28 Z0     ;move Z to min endstops
286
287 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
288
289 T1                      ;Switch to the 2nd extruder
290 G92 E0                  ;zero the extruded length
291 G1 F200 E10             ;extrude 10mm of feed stock
292 G92 E0                  ;zero the extruded length again
293 G1 F200 E-{retraction_dual_amount}
294
295 T0                      ;Switch to the first extruder
296 G92 E0                  ;zero the extruded length
297 G1 F200 E10             ;extrude 10mm of feed stock
298 G92 E0                  ;zero the extruded length again
299 G1 F{travel_speed}
300 ;Put printing message on LCD screen
301 M117 Printing...
302 """, str, 'alteration', 'alteration')
303 #######################################################################################
304 setting('end2.gcode', """;End GCode
305 M104 T0 S0                     ;extruder heater off
306 M104 T1 S0                     ;extruder heater off
307 M140 S0                     ;heated bed heater off (if you have it)
308
309 G91                                    ;relative positioning
310 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
311 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
312 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
313
314 M84                         ;steppers off
315 G90                         ;absolute positioning
316 """, str, 'alteration', 'alteration')
317 #######################################################################################
318 setting('support_start.gcode', '', str, 'alteration', 'alteration')
319 setting('support_end.gcode', '', str, 'alteration', 'alteration')
320 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
321 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
322 setting('replace.csv', '', str, 'alteration', 'alteration')
323 #######################################################################################
324 setting('switchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
325 G92 E0
326 G1 E-36 F5000
327 G92 E0
328 T{extruder}
329 G1 X{new_x} Y{new_y} Z{new_z} F{travel_speed}
330 G1 E36 F5000
331 G92 E0
332 """, str, 'alteration', 'alteration')
333
334 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
335 setting('oneAtATime', 'True', bool, 'preference', 'hidden')
336 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'UltimakerRobot_support.stl')), str, 'preference', 'hidden')
337 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."))
338 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."))
339 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."))
340 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."))
341 setting('check_for_updates', 'True', bool, 'preference', 'hidden').setLabel(_("Check for updates"), _("Check for newer versions of Cura on startup"))
342 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel(_("Send usage statistics"), _("Submit anonymous usage information to improve next versions of Cura"))
343 setting('youmagine_token', '', str, 'preference', 'hidden')
344 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."))
345 setting('language', 'English', str, 'preference', 'hidden').setLabel(_('Language'), _('Change the language in which Cura runs. Switching language requires a restart of Cura'))
346 setting('active_machine', '0', int, 'preference', 'hidden')
347
348 setting('model_colour', '#FFC924', str, 'preference', 'hidden').setLabel(_('Model colour'), _('Display color for first extruder'))
349 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel(_('Model colour (2)'), _('Display color for second extruder'))
350 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel(_('Model colour (3)'), _('Display color for third extruder'))
351 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel(_('Model colour (4)'), _('Display color for forth extruder'))
352
353 setting('window_maximized', 'True', bool, 'preference', 'hidden')
354 setting('window_pos_x', '-1', float, 'preference', 'hidden')
355 setting('window_pos_y', '-1', float, 'preference', 'hidden')
356 setting('window_width', '-1', float, 'preference', 'hidden')
357 setting('window_height', '-1', float, 'preference', 'hidden')
358 setting('window_normal_sash', '320', float, 'preference', 'hidden')
359 setting('last_run_version', '', str, 'preference', 'hidden')
360
361 setting('machine_name', '', str, 'machine', 'hidden')
362 setting('machine_type', 'unknown', str, 'machine', 'hidden') #Ultimaker, Ultimaker2, RepRap
363 setting('machine_width', '205', float, 'machine', 'hidden').setLabel(_("Maximum width (mm)"), _("Size of the machine in mm"))
364 setting('machine_depth', '205', float, 'machine', 'hidden').setLabel(_("Maximum depth (mm)"), _("Size of the machine in mm"))
365 setting('machine_height', '200', float, 'machine', 'hidden').setLabel(_("Maximum height (mm)"), _("Size of the machine in mm"))
366 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."))
367 setting('machine_shape', 'Square', ['Square','Circular'], 'machine', 'hidden').setLabel(_("Build area shape"), _("The shape of machine build area."))
368 setting('ultimaker_extruder_upgrade', 'False', bool, 'machine', 'hidden')
369 setting('has_heated_bed', 'False', bool, 'machine', 'hidden').setLabel(_("Heated bed"), _("If you have an heated bed, this enabled heated bed settings (requires restart)"))
370 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."))
371 setting('extruder_amount', '1', ['1','2','3','4'], 'machine', 'hidden').setLabel(_("Extruder count"), _("Amount of extruders in your machine."))
372 setting('extruder_offset_x1', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your secondary extruder compared to the primary."))
373 setting('extruder_offset_y1', '21.6', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your secondary extruder compared to the primary."))
374 setting('extruder_offset_x2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your tertiary extruder compared to the primary."))
375 setting('extruder_offset_y2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your tertiary extruder compared to the primary."))
376 setting('extruder_offset_x3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your forth extruder compared to the primary."))
377 setting('extruder_offset_y3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your forth extruder compared to the primary."))
378 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."))
379 setting('serial_port', 'AUTO', str, 'machine', 'hidden').setLabel(_("Serial port"), _("Serial port to use for communication with the printer"))
380 setting('serial_port_auto', '', str, 'machine', 'hidden')
381 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"))
382 setting('serial_baud_auto', '', int, 'machine', 'hidden')
383
384 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."))
385 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."))
386 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."))
387 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."))
388 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."))
389
390 validators.warningAbove(settingsDictionary['filament_flow'], 150, _("More flow than 150% is rare and usually not recommended."))
391 validators.warningBelow(settingsDictionary['filament_flow'], 50, _("Less flow than 50% is rare and usually not recommended."))
392 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."))
393 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
394 validators.warningAbove(settingsDictionary['print_speed'], 150.0, _("It is highly unlikely that your machine can achieve a printing speed above 150mm/s"))
395 validators.printSpeedValidator(settingsDictionary['print_speed'])
396 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
397 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
398 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
399 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
400 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
401 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
402 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
403 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
404 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, _("It is highly unlikely that your machine can achieve a travel speed above 300mm/s"))
405 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."))
406
407 #Conditions for multiple extruders
408 settingsDictionary['print_temperature2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
409 settingsDictionary['print_temperature3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
410 settingsDictionary['print_temperature4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
411 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
412 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
413 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
414 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
415 settingsDictionary['retraction_dual_amount'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
416 settingsDictionary['wipe_tower'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
417 settingsDictionary['wipe_tower_volume'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
418 settingsDictionary['ooze_shield'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
419 #Heated bed
420 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('has_heated_bed') == 'True')
421
422 #UltiGCode uses less settings, as these settings are located inside the machine instead of gcode.
423 settingsDictionary['print_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
424 settingsDictionary['print_temperature2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
425 settingsDictionary['print_temperature3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
426 settingsDictionary['print_temperature4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
427 settingsDictionary['filament_diameter'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
428 settingsDictionary['filament_diameter2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
429 settingsDictionary['filament_diameter3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
430 settingsDictionary['filament_diameter4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
431 settingsDictionary['filament_flow'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
432 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
433 settingsDictionary['retraction_speed'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
434 settingsDictionary['retraction_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
435 settingsDictionary['retraction_dual_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
436
437 #Remove fake defined _() because later the localization will define a global _()
438 del _
439
440 #########################################################
441 ## Profile and preferences functions
442 #########################################################
443
444 def getSubCategoriesFor(category):
445         done = {}
446         ret = []
447         for s in settingsList:
448                 if s.getCategory() == category and not s.getSubCategory() in done and s.checkConditions():
449                         done[s.getSubCategory()] = True
450                         ret.append(s.getSubCategory())
451         return ret
452
453 def getSettingsForCategory(category, subCategory = None):
454         ret = []
455         for s in settingsList:
456                 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory) and s.checkConditions():
457                         ret.append(s)
458         return ret
459
460 ## Profile functions
461 def getBasePath():
462         if platform.system() == "Windows":
463                 basePath = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
464                 #If we have a frozen python install, we need to step out of the library.zip
465                 if hasattr(sys, 'frozen'):
466                         basePath = os.path.normpath(os.path.join(basePath, ".."))
467         else:
468                 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
469         if not os.path.isdir(basePath):
470                 os.makedirs(basePath)
471         return basePath
472
473 def getAlternativeBasePaths():
474         paths = []
475         basePath = os.path.normpath(os.path.join(getBasePath(), '..'))
476         for subPath in os.listdir(basePath):
477                 path = os.path.join(basePath, subPath)
478                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
479                         paths.append(path)
480                 path = os.path.join(basePath, subPath, 'Cura')
481                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
482                         paths.append(path)
483         return paths
484
485 def getDefaultProfilePath():
486         return os.path.join(getBasePath(), 'current_profile.ini')
487
488 def loadProfile(filename):
489         #Read a configuration file as global config
490         profileParser = ConfigParser.ConfigParser()
491         try:
492                 profileParser.read(filename)
493         except ConfigParser.ParsingError:
494                 return
495         global settingsList
496         for set in settingsList:
497                 if set.isPreference():
498                         continue
499                 section = 'profile'
500                 if set.isAlteration():
501                         section = 'alterations'
502                 if profileParser.has_option(section, set.getName()):
503                         set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
504
505 def saveProfile(filename):
506         #Save the current profile to an ini file
507         profileParser = ConfigParser.ConfigParser()
508         profileParser.add_section('profile')
509         profileParser.add_section('alterations')
510         global settingsList
511         for set in settingsList:
512                 if set.isPreference() or set.isMachineSetting():
513                         continue
514                 if set.isAlteration():
515                         profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
516                 else:
517                         profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
518
519         profileParser.write(open(filename, 'w'))
520
521 def resetProfile():
522         #Read a configuration file as global config
523         global settingsList
524         for set in settingsList:
525                 if not set.isProfile():
526                         continue
527                 set.setValue(set.getDefault())
528
529         if getMachineSetting('machine_type') == 'ultimaker':
530                 putProfileSetting('nozzle_size', '0.4')
531                 if getMachineSetting('ultimaker_extruder_upgrade') == 'True':
532                         putProfileSetting('retraction_enable', 'True')
533         elif getMachineSetting('machine_type') == 'ultimaker2':
534                 putProfileSetting('nozzle_size', '0.4')
535                 putProfileSetting('retraction_enable', 'True')
536         else:
537                 putProfileSetting('nozzle_size', '0.5')
538                 putProfileSetting('retraction_enable', 'True')
539
540 def setProfileFromString(options):
541         options = base64.b64decode(options)
542         options = zlib.decompress(options)
543         (profileOpts, alt) = options.split('\f', 1)
544         global settingsDictionary
545         for option in profileOpts.split('\b'):
546                 if len(option) > 0:
547                         (key, value) = option.split('=', 1)
548                         if key in settingsDictionary:
549                                 if settingsDictionary[key].isProfile():
550                                         settingsDictionary[key].setValue(value)
551         for option in alt.split('\b'):
552                 if len(option) > 0:
553                         (key, value) = option.split('=', 1)
554                         if key in settingsDictionary:
555                                 if settingsDictionary[key].isAlteration():
556                                         settingsDictionary[key].setValue(value)
557
558 def getProfileString():
559         p = []
560         alt = []
561         global settingsList
562         for set in settingsList:
563                 if set.isProfile():
564                         if set.getName() in tempOverride:
565                                 p.append(set.getName() + "=" + tempOverride[set.getName()])
566                         else:
567                                 p.append(set.getName() + "=" + set.getValue())
568                 elif set.isAlteration():
569                         if set.getName() in tempOverride:
570                                 alt.append(set.getName() + "=" + tempOverride[set.getName()])
571                         else:
572                                 alt.append(set.getName() + "=" + set.getValue())
573         ret = '\b'.join(p) + '\f' + '\b'.join(alt)
574         ret = base64.b64encode(zlib.compress(ret, 9))
575         return ret
576
577 def insertNewlines(string, every=64): #This should be moved to a better place then profile.
578         lines = []
579         for i in xrange(0, len(string), every):
580                 lines.append(string[i:i+every])
581         return '\n'.join(lines)
582
583 def getPreferencesString():
584         p = []
585         global settingsList
586         for set in settingsList:
587                 if set.isPreference():
588                         p.append(set.getName() + "=" + set.getValue())
589         ret = '\b'.join(p)
590         ret = base64.b64encode(zlib.compress(ret, 9))
591         return ret
592
593
594 def getProfileSetting(name):
595         if name in tempOverride:
596                 return tempOverride[name]
597         global settingsDictionary
598         if name in settingsDictionary and settingsDictionary[name].isProfile():
599                 return settingsDictionary[name].getValue()
600         traceback.print_stack()
601         sys.stderr.write('Error: "%s" not found in profile settings\n' % (name))
602         return ''
603
604 def getProfileSettingFloat(name):
605         try:
606                 setting = getProfileSetting(name).replace(',', '.')
607                 return float(eval(setting, {}, {}))
608         except:
609                 return 0.0
610
611 def putProfileSetting(name, value):
612         #Check if we have a configuration file loaded, else load the default.
613         global settingsDictionary
614         if name in settingsDictionary and settingsDictionary[name].isProfile():
615                 settingsDictionary[name].setValue(value)
616
617 def isProfileSetting(name):
618         global settingsDictionary
619         if name in settingsDictionary and settingsDictionary[name].isProfile():
620                 return True
621         return False
622
623 ## Preferences functions
624 def getPreferencePath():
625         return os.path.join(getBasePath(), 'preferences.ini')
626
627 def getPreferenceFloat(name):
628         try:
629                 setting = getPreference(name).replace(',', '.')
630                 return float(eval(setting, {}, {}))
631         except:
632                 return 0.0
633
634 def getPreferenceColour(name):
635         colorString = getPreference(name)
636         return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
637
638 def loadPreferences(filename):
639         global settingsList
640         #Read a configuration file as global config
641         profileParser = ConfigParser.ConfigParser()
642         try:
643                 profileParser.read(filename)
644         except ConfigParser.ParsingError:
645                 return
646
647         for set in settingsList:
648                 if set.isPreference():
649                         if profileParser.has_option('preference', set.getName()):
650                                 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
651
652         n = 0
653         while profileParser.has_section('machine_%d' % (n)):
654                 for set in settingsList:
655                         if set.isMachineSetting():
656                                 if profileParser.has_option('machine_%d' % (n), set.getName()):
657                                         set.setValue(unicode(profileParser.get('machine_%d' % (n), set.getName()), 'utf-8', 'replace'), n)
658                 n += 1
659
660         setActiveMachine(int(getPreferenceFloat('active_machine')))
661
662 def loadMachineSettings(filename):
663         global settingsList
664         #Read a configuration file as global config
665         profileParser = ConfigParser.ConfigParser()
666         try:
667                 profileParser.read(filename)
668         except ConfigParser.ParsingError:
669                 return
670
671         for set in settingsList:
672                 if set.isMachineSetting():
673                         if profileParser.has_option('machine', set.getName()):
674                                 set.setValue(unicode(profileParser.get('machine', set.getName()), 'utf-8', 'replace'))
675         checkAndUpdateMachineName()
676
677 def savePreferences(filename):
678         global settingsList
679         #Save the current profile to an ini file
680         parser = ConfigParser.ConfigParser()
681         parser.add_section('preference')
682
683         for set in settingsList:
684                 if set.isPreference():
685                         parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
686
687         n = 0
688         while getMachineSetting('machine_name', n) != '':
689                 parser.add_section('machine_%d' % (n))
690                 for set in settingsList:
691                         if set.isMachineSetting():
692                                 parser.set('machine_%d' % (n), set.getName(), set.getValue(n).encode('utf-8'))
693                 n += 1
694         parser.write(open(filename, 'w'))
695
696 def getPreference(name):
697         if name in tempOverride:
698                 return tempOverride[name]
699         global settingsDictionary
700         if name in settingsDictionary and settingsDictionary[name].isPreference():
701                 return settingsDictionary[name].getValue()
702         traceback.print_stack()
703         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
704         return ''
705
706 def putPreference(name, value):
707         #Check if we have a configuration file loaded, else load the default.
708         global settingsDictionary
709         if name in settingsDictionary and settingsDictionary[name].isPreference():
710                 settingsDictionary[name].setValue(value)
711                 savePreferences(getPreferencePath())
712                 return
713         traceback.print_stack()
714         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
715
716 def isPreference(name):
717         global settingsDictionary
718         if name in settingsDictionary and settingsDictionary[name].isPreference():
719                 return True
720         return False
721
722 def getMachineSettingFloat(name, index = None):
723         try:
724                 setting = getMachineSetting(name, index).replace(',', '.')
725                 return float(eval(setting, {}, {}))
726         except:
727                 return 0.0
728
729 def getMachineSetting(name, index = None):
730         if name in tempOverride:
731                 return tempOverride[name]
732         global settingsDictionary
733         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
734                 return settingsDictionary[name].getValue(index)
735         traceback.print_stack()
736         sys.stderr.write('Error: "%s" not found in machine settings\n' % (name))
737         return ''
738
739 def putMachineSetting(name, value):
740         #Check if we have a configuration file loaded, else load the default.
741         global settingsDictionary
742         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
743                 settingsDictionary[name].setValue(value)
744         savePreferences(getPreferencePath())
745
746 def isMachineSetting(name):
747         global settingsDictionary
748         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
749                 return True
750         return False
751
752 def checkAndUpdateMachineName():
753         global _selectedMachineIndex
754         name = getMachineSetting('machine_name')
755         index = None
756         if name == '':
757                 name = getMachineSetting('machine_type')
758         for n in xrange(0, getMachineCount()):
759                 if n == _selectedMachineIndex:
760                         continue
761                 if index is None:
762                         if name == getMachineSetting('machine_name', n):
763                                 index = 1
764                 else:
765                         if '%s (%d)' % (name, index) == getMachineSetting('machine_name', n):
766                                 index += 1
767         if index is not None:
768                 name = '%s (%d)' % (name, index)
769         putMachineSetting('machine_name', name)
770         putPreference('active_machine', _selectedMachineIndex)
771
772 def getMachineCount():
773         n = 0
774         while getMachineSetting('machine_name', n) != '':
775                 n += 1
776         if n < 1:
777                 return 1
778         return n
779
780 def setActiveMachine(index):
781         global _selectedMachineIndex
782         _selectedMachineIndex = index
783         putPreference('active_machine', _selectedMachineIndex)
784
785 def removeMachine(index):
786         global _selectedMachineIndex
787         global settingsList
788         if getMachineCount() < 2:
789                 return
790         for n in xrange(index, getMachineCount()):
791                 for setting in settingsList:
792                         if setting.isMachineSetting():
793                                 setting.setValue(setting.getValue(n+1), n)
794
795         if _selectedMachineIndex >= index:
796                 setActiveMachine(getMachineCount() - 1)
797
798 ## Temp overrides for multi-extruder slicing and the project planner.
799 tempOverride = {}
800 def setTempOverride(name, value):
801         tempOverride[name] = unicode(value).encode("utf-8")
802 def clearTempOverride(name):
803         del tempOverride[name]
804 def resetTempOverride():
805         tempOverride.clear()
806
807 #########################################################
808 ## Utility functions to calculate common profile values
809 #########################################################
810 def calculateEdgeWidth():
811         wallThickness = getProfileSettingFloat('wall_thickness')
812         nozzleSize = getProfileSettingFloat('nozzle_size')
813
814         if getProfileSetting('spiralize') == 'True':
815                 return wallThickness
816
817         if wallThickness < 0.01:
818                 return nozzleSize
819         if wallThickness < nozzleSize:
820                 return wallThickness
821
822         lineCount = int(wallThickness / (nozzleSize - 0.0001))
823         if lineCount == 0:
824                 return nozzleSize
825         lineWidth = wallThickness / lineCount
826         lineWidthAlt = wallThickness / (lineCount + 1)
827         if lineWidth > nozzleSize * 1.5:
828                 return lineWidthAlt
829         return lineWidth
830
831 def calculateLineCount():
832         wallThickness = getProfileSettingFloat('wall_thickness')
833         nozzleSize = getProfileSettingFloat('nozzle_size')
834
835         if wallThickness < 0.01:
836                 return 0
837         if wallThickness < nozzleSize:
838                 return 1
839         if getProfileSetting('spiralize') == 'True':
840                 return 1
841
842         lineCount = int(wallThickness / (nozzleSize - 0.0001))
843         if lineCount < 1:
844                 lineCount = 1
845         lineWidth = wallThickness / lineCount
846         lineWidthAlt = wallThickness / (lineCount + 1)
847         if lineWidth > nozzleSize * 1.5:
848                 return lineCount + 1
849         return lineCount
850
851 def calculateSolidLayerCount():
852         layerHeight = getProfileSettingFloat('layer_height')
853         solidThickness = getProfileSettingFloat('solid_layer_thickness')
854         if layerHeight == 0.0:
855                 return 1
856         return int(math.ceil(solidThickness / (layerHeight - 0.0001)))
857
858 def calculateObjectSizeOffsets():
859         size = 0.0
860
861         if getProfileSetting('platform_adhesion') == 'Brim':
862                 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
863         elif getProfileSetting('platform_adhesion') == 'Raft':
864                 pass
865         else:
866                 if getProfileSettingFloat('skirt_line_count') > 0:
867                         size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
868
869         #if getProfileSetting('enable_raft') != 'False':
870         #       size += profile.getProfileSettingFloat('raft_margin') * 2
871         #if getProfileSetting('support') != 'None':
872         #       extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
873         #       extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
874         return [size, size]
875
876 def getMachineCenterCoords():
877         if getMachineSetting('machine_center_is_zero') == 'True':
878                 return [0, 0]
879         return [getMachineSettingFloat('machine_width') / 2, getMachineSettingFloat('machine_depth') / 2]
880
881 #Returns a list of convex polygons, first polygon is the allowed area of the machine,
882 # the rest of the polygons are the dis-allowed areas of the machine.
883 def getMachineSizePolygons():
884         size = numpy.array([getMachineSettingFloat('machine_width'), getMachineSettingFloat('machine_depth'), getMachineSettingFloat('machine_height')], numpy.float32)
885         ret = []
886         if getMachineSetting('machine_shape') == 'Circular':
887                 # Circle platform for delta printers...
888                 circle = []
889                 steps = 32
890                 for n in xrange(0, steps):
891                         circle.append([math.cos(float(n)/steps*2*math.pi) * size[0]/2, math.sin(float(n)/steps*2*math.pi) * size[1]/2])
892                 ret.append(numpy.array(circle, numpy.float32))
893         else:
894                 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))
895
896         if getMachineSetting('machine_type') == 'ultimaker2':
897                 #UM2 no-go zones
898                 w = 25
899                 h = 10
900                 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))
901                 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))
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, 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))
904         return ret
905
906 #returns the number of extruders minimal used. Normally this returns 1, but with dual-extrusion support material it returns 2
907 def minimalExtruderCount():
908         if int(getMachineSetting('extruder_amount')) < 2:
909                 return 1
910         if getProfileSetting('support') == 'None':
911                 return 1
912         if getProfileSetting('support_dual_extrusion') == 'Second extruder':
913                 return 2
914         return 1
915
916 #########################################################
917 ## Alteration file functions
918 #########################################################
919 def replaceTagMatch(m):
920         pre = m.group(1)
921         tag = m.group(2)
922         if tag == 'time':
923                 return pre + time.strftime('%H:%M:%S')
924         if tag == 'date':
925                 return pre + time.strftime('%d-%m-%Y')
926         if tag == 'day':
927                 return pre + ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][int(time.strftime('%w'))]
928         if tag == 'print_time':
929                 return pre + '#P_TIME#'
930         if tag == 'filament_amount':
931                 return pre + '#F_AMNT#'
932         if tag == 'filament_weight':
933                 return pre + '#F_WGHT#'
934         if tag == 'filament_cost':
935                 return pre + '#F_COST#'
936         if pre == 'F' and tag == 'max_z_speed':
937                 f = getProfileSettingFloat('travel_speed') * 60
938         if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
939                 f = getProfileSettingFloat(tag) * 60
940         elif isProfileSetting(tag):
941                 f = getProfileSettingFloat(tag)
942         elif isPreference(tag):
943                 f = getProfileSettingFloat(tag)
944         else:
945                 return '%s?%s?' % (pre, tag)
946         if (f % 1) == 0:
947                 return pre + str(int(f))
948         return pre + str(f)
949
950 def replaceGCodeTags(filename, gcodeInt):
951         f = open(filename, 'r+')
952         data = f.read(2048)
953         data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
954         data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
955         data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
956         cost = gcodeInt.calculateCost()
957         if cost is None:
958                 cost = 'Unknown'
959         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
960         f.seek(0)
961         f.write(data)
962         f.close()
963
964 def replaceGCodeTagsFromSlicer(filename, slicerInt):
965         f = open(filename, 'r+')
966         data = f.read(2048)
967         data = data.replace('#P_TIME#', ('%8.2f' % (int(slicerInt._printTimeSeconds)))[-8:])
968         data = data.replace('#F_AMNT#', ('%8.2f' % (slicerInt._filamentMM[0]))[-8:])
969         data = data.replace('#F_WGHT#', ('%8.2f' % (float(slicerInt.getFilamentWeight()) * 1000))[-8:])
970         cost = slicerInt.getFilamentCost()
971         if cost is None:
972                 cost = 'Unknown'
973         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
974         f.seek(0)
975         f.write(data)
976         f.close()
977
978 ### Get aleration raw contents. (Used internally in Cura)
979 def getAlterationFile(filename):
980         if filename in tempOverride:
981                 return tempOverride[filename]
982         global settingsDictionary
983         if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
984                 return settingsDictionary[filename].getValue()
985         traceback.print_stack()
986         sys.stderr.write('Error: "%s" not found in alteration settings\n' % (filename))
987         return ''
988
989 def setAlterationFile(name, value):
990         #Check if we have a configuration file loaded, else load the default.
991         global settingsDictionary
992         if name in settingsDictionary and settingsDictionary[name].isAlteration():
993                 settingsDictionary[name].setValue(value)
994         saveProfile(getDefaultProfilePath())
995
996 def isTagIn(tag, contents):
997         contents = re.sub(';[^\n]*\n', '', contents)
998         return tag in contents
999
1000 ### Get the alteration file for output. (Used by Skeinforge)
1001 def getAlterationFileContents(filename, extruderCount = 1):
1002         prefix = ''
1003         postfix = ''
1004         alterationContents = getAlterationFile(filename)
1005         if getMachineSetting('gcode_flavor') == 'UltiGCode':
1006                 if filename == 'end.gcode':
1007                         return 'M25 ;Stop reading from this point on.\n;CURA_PROFILE_STRING:%s\n' % (getProfileString())
1008                 return ''
1009         if filename == 'start.gcode':
1010                 if extruderCount > 1:
1011                         alterationContents = getAlterationFile("start%d.gcode" % (extruderCount))
1012                 #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.
1013                 #We also set our steps per E here, if configured.
1014                 eSteps = getMachineSettingFloat('steps_per_e')
1015                 if eSteps > 0:
1016                         prefix += 'M92 E%f\n' % (eSteps)
1017                 temp = getProfileSettingFloat('print_temperature')
1018                 bedTemp = 0
1019                 if getMachineSetting('has_heated_bed') == 'True':
1020                         bedTemp = getProfileSettingFloat('print_bed_temperature')
1021
1022                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1023                         prefix += 'M140 S%f\n' % (bedTemp)
1024                 if temp > 0 and not isTagIn('{print_temperature}', alterationContents):
1025                         if extruderCount > 0:
1026                                 for n in xrange(1, extruderCount):
1027                                         t = temp
1028                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1029                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1030                                         prefix += 'M104 T%d S%f\n' % (n, t)
1031                                 for n in xrange(0, extruderCount):
1032                                         t = temp
1033                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1034                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1035                                         prefix += 'M109 T%d S%f\n' % (n, t)
1036                                 prefix += 'T0\n'
1037                         else:
1038                                 prefix += 'M109 S%f\n' % (temp)
1039                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1040                         prefix += 'M190 S%f\n' % (bedTemp)
1041         elif filename == 'end.gcode':
1042                 if extruderCount > 1:
1043                         alterationContents = getAlterationFile("end%d.gcode" % (extruderCount))
1044                 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
1045                 postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
1046         return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'
1047
1048 ###### PLUGIN #####
1049
1050 def getPluginConfig():
1051         try:
1052                 return pickle.loads(str(getProfileSetting('plugin_config')))
1053         except:
1054                 return []
1055
1056 def setPluginConfig(config):
1057         putProfileSetting('plugin_config', pickle.dumps(config))
1058
1059 def getPluginBasePaths():
1060         ret = []
1061         if platform.system() != "Windows":
1062                 ret.append(os.path.expanduser('~/.cura/plugins/'))
1063         if platform.system() == "Darwin" and hasattr(sys, 'frozen'):
1064                 ret.append(os.path.normpath(os.path.join(resources.resourceBasePath, "Cura/plugins")))
1065         else:
1066                 ret.append(os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'plugins')))
1067         return ret
1068
1069 def getPluginList():
1070         ret = []
1071         for basePath in getPluginBasePaths():
1072                 for filename in glob.glob(os.path.join(basePath, '*.py')):
1073                         filename = os.path.basename(filename)
1074                         if filename.startswith('_'):
1075                                 continue
1076                         with open(os.path.join(basePath, filename), "r") as f:
1077                                 item = {'filename': filename, 'name': None, 'info': None, 'type': None, 'params': []}
1078                                 for line in f:
1079                                         line = line.strip()
1080                                         if not line.startswith('#'):
1081                                                 break
1082                                         line = line[1:].split(':', 1)
1083                                         if len(line) != 2:
1084                                                 continue
1085                                         if line[0].upper() == 'NAME':
1086                                                 item['name'] = line[1].strip()
1087                                         elif line[0].upper() == 'INFO':
1088                                                 item['info'] = line[1].strip()
1089                                         elif line[0].upper() == 'TYPE':
1090                                                 item['type'] = line[1].strip()
1091                                         elif line[0].upper() == 'DEPEND':
1092                                                 pass
1093                                         elif line[0].upper() == 'PARAM':
1094                                                 m = re.match('([a-zA-Z][a-zA-Z0-9_]*)\(([a-zA-Z_]*)(?::([^\)]*))?\) +(.*)', line[1].strip())
1095                                                 if m is not None:
1096                                                         item['params'].append({'name': m.group(1), 'type': m.group(2), 'default': m.group(3), 'description': m.group(4)})
1097                                         else:
1098                                                 print "Unknown item in effect meta data: %s %s" % (line[0], line[1])
1099                                 if item['name'] is not None and item['type'] == 'postprocess':
1100                                         ret.append(item)
1101         return ret
1102
1103 def runPostProcessingPlugins(gcodefilename):
1104         pluginConfigList = getPluginConfig()
1105         pluginList = getPluginList()
1106
1107         for pluginConfig in pluginConfigList:
1108                 plugin = None
1109                 for pluginTest in pluginList:
1110                         if pluginTest['filename'] == pluginConfig['filename']:
1111                                 plugin = pluginTest
1112                 if plugin is None:
1113                         continue
1114
1115                 pythonFile = None
1116                 for basePath in getPluginBasePaths():
1117                         testFilename = os.path.join(basePath, pluginConfig['filename'])
1118                         if os.path.isfile(testFilename):
1119                                 pythonFile = testFilename
1120                 if pythonFile is None:
1121                         continue
1122
1123                 locals = {'filename': gcodefilename}
1124                 for param in plugin['params']:
1125                         value = param['default']
1126                         if param['name'] in pluginConfig['params']:
1127                                 value = pluginConfig['params'][param['name']]
1128
1129                         if param['type'] == 'float':
1130                                 try:
1131                                         value = float(value)
1132                                 except:
1133                                         value = float(param['default'])
1134
1135                         locals[param['name']] = value
1136                 try:
1137                         execfile(pythonFile, locals)
1138                 except:
1139                         locationInfo = traceback.extract_tb(sys.exc_info()[2])[-1]
1140                         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])
1141         return None