chiark / gitweb /
Merge tag '15.01-RC1' into upstream
[cura.git] / Cura / util / profile.py
1 """
2 The profile module contains all the settings for Cura.
3 These settings can be globally accessed and modified.
4 """
5 from __future__ import division
6 __copyright__ = "Copyright (C) 2013 David Braam - Released under terms of the AGPLv3 License"
7
8 import os
9 import traceback
10 import math
11 import re
12 import zlib
13 import base64
14 import time
15 import sys
16 import platform
17 import glob
18 import string
19 import stat
20 import types
21 import cPickle as pickle
22 import numpy
23 if sys.version_info[0] < 3:
24         import ConfigParser
25 else:
26         import configparser as ConfigParser
27
28 from Cura.util import version
29 from Cura.util import validators
30
31 #The settings dictionary contains a key/value reference to all possible settings. With the setting name as key.
32 settingsDictionary = {}
33 #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,
34 # as the dictionary will not contain insertion order.
35 settingsList = []
36
37 #Currently selected machine (by index) Cura support multiple machines in the same preferences and can switch between them.
38 # Each machine has it's own index and unique name.
39 _selectedMachineIndex = 0
40
41 class setting(object):
42         """
43                 A setting object contains a configuration setting. These are globally accessible trough the quick access functions
44                 and trough the settingsDictionary function.
45                 Settings can be:
46                 * profile settings (settings that effect the slicing process and the print result)
47                 * preferences (settings that effect how cura works and acts)
48                 * machine settings (settings that relate to the physical configuration of your machine)
49                 * alterations (bad name copied from Skeinforge. These are the start/end code pieces)
50                 Settings have validators that check if the value is valid, but do not prevent invalid values!
51                 Settings have conditions that enable/disable this setting depending on other settings. (Ex: Dual-extrusion)
52         """
53         def __init__(self, name, default, type, category, subcategory):
54                 self._name = name
55                 self._label = name
56                 self._tooltip = ''
57                 self._default = unicode(default)
58                 self._values = []
59                 self._type = type
60                 self._category = category
61                 self._subcategory = subcategory
62                 self._expert_sub_category = None
63                 self._validators = []
64                 self._conditions = []
65
66                 if type is types.FloatType:
67                         validators.validFloat(self)
68                 elif type is types.IntType:
69                         validators.validInt(self)
70
71                 global settingsDictionary
72                 settingsDictionary[name] = self
73                 global settingsList
74                 settingsList.append(self)
75
76         def setLabel(self, label, tooltip = ''):
77                 self._label = label
78                 self._tooltip = tooltip
79                 return self
80
81         def setRange(self, minValue=None, maxValue=None):
82                 if len(self._validators) < 1:
83                         return
84                 self._validators[0].minValue = minValue
85                 self._validators[0].maxValue = maxValue
86                 return self
87
88         def getLabel(self):
89                 return _(self._label)
90
91         def getTooltip(self):
92                 return _(self._tooltip)
93
94         def getCategory(self):
95                 return self._category
96
97         def getSubCategory(self):
98                 return self._subcategory
99
100         def getExpertSubCategory(self):
101                 return self._expert_sub_category
102
103         def setExpertSubCategory(self, expert_sub_category):
104                 self._expert_sub_category = expert_sub_category
105                 return self
106
107         def isPreference(self):
108                 return self._category == 'preference'
109
110         def isMachineSetting(self):
111                 return self._category == 'machine'
112
113         def isAlteration(self):
114                 return self._category == 'alteration'
115
116         def isProfile(self):
117                 return not self.isAlteration() and not self.isPreference() and not self.isMachineSetting()
118
119         def getName(self):
120                 return self._name
121
122         def getType(self):
123                 return self._type
124
125         def getValue(self, index = None):
126                 if index is None:
127                         index = self.getValueIndex()
128                 if index >= len(self._values):
129                         return self._default
130                 return self._values[index]
131
132         def getDefault(self):
133                 return self._default
134
135         def setValue(self, value, index = None):
136                 if index is None:
137                         index = self.getValueIndex()
138                 while index >= len(self._values):
139                         self._values.append(self._default)
140                 self._values[index] = unicode(value)
141
142         def getValueIndex(self):
143                 if self.isMachineSetting() or self.isProfile() or self.isAlteration():
144                         global _selectedMachineIndex
145                         return _selectedMachineIndex
146                 return 0
147
148         def validate(self):
149                 result = validators.SUCCESS
150                 msgs = []
151                 for validator in self._validators:
152                         res, err = validator.validate()
153                         if res == validators.ERROR:
154                                 result = res
155                         elif res == validators.WARNING and result != validators.ERROR:
156                                 result = res
157                         if res != validators.SUCCESS:
158                                 msgs.append(err)
159                 return result, '\n'.join(msgs)
160
161         def addCondition(self, conditionFunction):
162                 self._conditions.append(conditionFunction)
163
164         def checkConditions(self):
165                 for condition in self._conditions:
166                         if not condition():
167                                 return False
168                 return True
169
170 #########################################################
171 ## Settings
172 #########################################################
173
174 #Define a fake _() function to fake the gettext tools in to generating strings for the profile settings.
175 def _(n):
176         return n
177
178 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. Smaller layer heights will give a finer surface but will give longer print time. Larger layer heights will provide fast prints but a rougher surface."))
179 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."))
180 setting('retraction_enable',        True, bool,  'basic',    _('Quality')).setExpertSubCategory('Retraction').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."))
181 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."))
182 setting('fill_density',               20, float, 'basic',    _('Fill')).setExpertSubCategory('Infill').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 will not affect the outside of the print and only adjusts how strong the part becomes."))
183 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."))
184 setting('print_speed',                50, float, 'basic',    _('Speed and Temperature')).setRange(1).setLabel(_("Print speed (mm/s)"), _("Speed at which printing happens. A well adjusted 3D printer can reach high speeds. However, for high quality prints slower speeds are required. Printing speed depends on a lot of factors. You will be experimenting with optimal settings for this."))
185 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 205C is recommended.\nFor ABS and HIPS 240C is recommended."))
186 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 205C is recommended.\nFor ABS and HIPS 240C is recommended."))
187 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 205C is recommended.\nFor ABS and HIPS 240C is recommended."))
188 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 205C is recommended.\nFor ABS and HIPS 240C is recommended."))
189 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.\nFor PLA 60C is recommended.\nFor ABS and HIPS 110C is recommended."))
190 setting('support',                'None', [_('None'), _('Touching buildplate'), _('Everywhere')], 'basic', _('Support')).setExpertSubCategory('Support').setLabel(_("Support type"), _("Type of support structure build.\n\"Support is useful when a model has severe over hangs. Using this option does require some finishing of the print, including removing the support material.\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."))
191 setting('platform_adhesion',      'None', [_('None'), _('Brim'), _('Raft')], 'basic', _('Support')).setExpertSubCategory(['Skirt', 'Brim', 'Raft']).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 it is the recommended option.\nRaft adds a thick raster below the object and a thin interface between this and your object.\n(Note that enabling the brim or raft disables the skirt)"))
192 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."))
193 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."))
194 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."))
195 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."))
196 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."))
197 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."))
198 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."))
199 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."))
200 setting('filament_flow',            100., float, 'basic',    _('Filament')).setRange(5,300).setLabel(_("Flow (%)"), _("Flow compensation, the amount of material extruded is multiplied by this value"))
201 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."))
202 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 between 1 and 2 millimeters provides good results for most materials."))
203 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."))
204 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. This setting is used to prevent from having too many retractions in a small area."))
205 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."))
206 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 retracting a lot on the same piece of filament which flattens the filament and causes grinding issues."))
207 setting('retraction_hop',            0.0, float, 'expert',   _('Retraction')).setRange(0).setLabel(_("Z hop when retracting (mm)"), _("When a retraction is done, the head is lifted by this amount to travel over the print. A value of 0.075 works well. This feature has a lot of positive effect on delta towers."))
208 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."))
209 setting('layer0_width_factor',       100, float, 'advanced', _('Quality')).setRange(50, 300).setLabel(_("Initial layer line width (%)"), _("Extra width factor for the extrusion on the first layer, on some printers it's good to have wider extrusion on the first layer to get better bed adhesion."))
210 setting('object_sink',               0.0, float, 'advanced', _('Quality')).setRange(0).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."))
211 #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."))
212 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 together."))
213 setting('travel_speed',            150.0, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Travel speed (mm/s)"), _("Speed at which travel moves are done. A higher value will provide faster print times. Beware that too fast of a speed can reduce print reliability. Most high quality printers can handle 150mm/s to 200mm/s with no problems."))
214 setting('bottom_layer_speed',         20, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Bottom layer speed (mm/s)"), _("Print speed for the bottom layer. It is generally best to print the first layer slower so it sticks better to the printer bed."))
215 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 time, but this can negatively affect print quality if made too fast."))
216 setting('inset0_speed',              0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Outer 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."))
217 setting('insetx_speed',              0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Inner 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."))
218 setting('cool_min_layer_time',         5, float, 'advanced', _('Cool')).setRange(0).setLabel(_("Minimal layer time (sec)"), _("Minimum time spent 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 spent at least this amount of seconds printing this layer."))
219 setting('fan_enabled',              True, bool,  'advanced', _('Cool')).setExpertSubCategory('Cool').setLabel(_("Enable cooling fan"), _("Enable the cooling fan during the print. The extra cooling from the cooling fan is essential during faster prints and with PLA."))
220
221 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."))
222 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."))
223 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."))
224 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 linearly with the fan off at layer 0."))
225 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."))
226 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%."))
227 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 slowed down it will never be slower than this minimal speed."))
228 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."))
229 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."))
230 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."))
231 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."))
232 setting('support_type', 'Lines', ['Grid', 'Lines'], 'expert', _('Support')).setLabel(_("Structure type"), _("The type of support structure.\nGrid is very strong and can come off in 1 piece, however, sometimes it is too strong.\nLines are single walled lines that break off one at a time. Which is more work to remove, but as it is less strong it does work better on tricky prints."))
233 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 90 degree being horizontal and 0 degree being vertical."))
234 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."))
235 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."))
236 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."))
237 setting('spiralize', False, bool, 'expert', _('Black Magic')).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.\nThis feature used to be called Joris in older versions."))
238 setting('simple_mode', False, bool, 'expert', _('Black Magic')).setLabel(_("Only follow mesh surface"), _("Only follow the mesh surfaces of the 3D model, do not do anything else. No infill, no top/bottom, nothing."))
239 #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."))
240 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."))
241 setting('raft_margin', 5.0, 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 area for your print."))
242 setting('raft_line_spacing', 3.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."))
243 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."))
244 setting('raft_base_linewidth', 1.0, 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."))
245 setting('raft_interface_thickness', 0.27, 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."))
246 setting('raft_interface_linewidth', 0.4, 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."))
247 setting('raft_airgap_all', 0.0, float, 'expert', _('Raft')).setRange(0).setLabel(_("Airgap"), _("Gap between the last layer of the raft the whole print."))
248 setting('raft_airgap', 0.22, float, 'expert', _('Raft')).setRange(0).setLabel(_("First Layer Airgap"), _("Gap between the last layer of the raft and the first printing layer. A small gap of 0.2mm works wonders on PLA and makes the raft easy to remove. This value is added on top of the 'Airgap' setting."))
249 setting('raft_surface_layers', 2, int, 'expert', _('Raft')).setRange(0).setLabel(_("Surface layers"), _("Amount of surface layers put on top of the raft, these are fully filled layers on which the model is printed."))
250 setting('raft_surface_thickness', 0.27, float, 'expert', _('Raft')).setRange(0).setLabel(_("Surface layer thickness (mm)"), _("Thickness of each surface layer."))
251 setting('raft_surface_linewidth', 0.4, float, 'expert', _('Raft')).setRange(0).setLabel(_("Surface layer line width (mm)"), _("Width of the lines for each surface layer."))
252 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 dependent 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."))
253 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 dependent 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."))
254 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 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."))
255 setting('fix_horrible_extensive_stitching', False, bool, 'expert', _('Fix horrible')).setLabel(_("Extensive stitching"), _("Extensive 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."))
256
257 setting('plugin_config', '', str, 'hidden', 'hidden')
258 setting('object_center_x', -1, float, 'hidden', 'hidden')
259 setting('object_center_y', -1, float, 'hidden', 'hidden')
260
261 setting('simpleModeSettings', '', str, 'hidden', 'hidden')
262
263 setting('start.gcode', """;Sliced at: {day} {date} {time}
264 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
265 ;Print time: {print_time}
266 ;Filament used: {filament_amount}m {filament_weight}g
267 ;Filament cost: {filament_cost}
268 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
269 ;M109 S{print_temperature} ;Uncomment to add your own temperature line
270 G21        ;metric values
271 G90        ;absolute positioning
272 M82        ;set extruder to absolute mode
273 M107       ;start with the fan off
274
275 G28 X0 Y0  ;move X/Y to min endstops
276 G28 Z0     ;move Z to min endstops
277
278 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
279
280 G92 E0                  ;zero the extruded length
281 G1 F200 E3              ;extrude 3mm of feed stock
282 G92 E0                  ;zero the extruded length again
283 G1 F{travel_speed}
284 ;Put printing message on LCD screen
285 M117 Printing...
286 """, str, 'alteration', 'alteration')
287 #######################################################################################
288 setting('end.gcode', """;End GCode
289 M104 S0                     ;extruder heater off
290 M140 S0                     ;heated bed heater off (if you have it)
291
292 G91                                    ;relative positioning
293 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
294 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
295 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
296
297 M84                         ;steppers off
298 G90                         ;absolute positioning
299 ;{profile_string}
300 """, str, 'alteration', 'alteration')
301 #######################################################################################
302 setting('start2.gcode', """;Sliced at: {day} {date} {time}
303 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
304 ;Print time: {print_time}
305 ;Filament used: {filament_amount}m {filament_weight}g
306 ;Filament cost: {filament_cost}
307 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
308 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
309 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
310 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
311 G21        ;metric values
312 G90        ;absolute positioning
313 M107       ;start with the fan off
314
315 G28 X0 Y0  ;move X/Y to min endstops
316 G28 Z0     ;move Z to min endstops
317
318 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
319
320 T1                      ;Switch to the 2nd extruder
321 G92 E0                  ;zero the extruded length
322 G1 F200 E10             ;extrude 10mm of feed stock
323 G92 E0                  ;zero the extruded length again
324 G1 F200 E-{retraction_dual_amount}
325
326 T0                      ;Switch to the first extruder
327 G92 E0                  ;zero the extruded length
328 G1 F200 E10             ;extrude 10mm of feed stock
329 G92 E0                  ;zero the extruded length again
330 G1 F{travel_speed}
331 ;Put printing message on LCD screen
332 M117 Printing...
333 """, str, 'alteration', 'alteration')
334 #######################################################################################
335 setting('end2.gcode', """;End GCode
336 M104 T0 S0                     ;extruder heater off
337 M104 T1 S0                     ;extruder heater off
338 M140 S0                     ;heated bed heater off (if you have it)
339
340 G91                                    ;relative positioning
341 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
342 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
343 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
344
345 M84                         ;steppers off
346 G90                         ;absolute positioning
347 ;{profile_string}
348 """, str, 'alteration', 'alteration')
349 #######################################################################################
350 setting('start3.gcode', """;Sliced at: {day} {date} {time}
351 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
352 ;Print time: {print_time}
353 ;Filament used: {filament_amount}m {filament_weight}g
354 ;Filament cost: {filament_cost}
355 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
356 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
357 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
358 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
359 G21        ;metric values
360 G90        ;absolute positioning
361 M107       ;start with the fan off
362
363 G28 X0 Y0  ;move X/Y to min endstops
364 G28 Z0     ;move Z to min endstops
365
366 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
367
368 T2                      ;Switch to the 2nd extruder
369 G92 E0                  ;zero the extruded length
370 G1 F200 E10             ;extrude 10mm of feed stock
371 G92 E0                  ;zero the extruded length again
372 G1 F200 E-{retraction_dual_amount}
373
374 T1                      ;Switch to the 2nd extruder
375 G92 E0                  ;zero the extruded length
376 G1 F200 E10             ;extrude 10mm of feed stock
377 G92 E0                  ;zero the extruded length again
378 G1 F200 E-{retraction_dual_amount}
379
380 T0                      ;Switch to the first extruder
381 G92 E0                  ;zero the extruded length
382 G1 F200 E10             ;extrude 10mm of feed stock
383 G92 E0                  ;zero the extruded length again
384 G1 F{travel_speed}
385 ;Put printing message on LCD screen
386 M117 Printing...
387 """, str, 'alteration', 'alteration')
388 #######################################################################################
389 setting('end3.gcode', """;End GCode
390 M104 T0 S0                     ;extruder heater off
391 M104 T1 S0                     ;extruder heater off
392 M104 T2 S0                     ;extruder heater off
393 M140 S0                     ;heated bed heater off (if you have it)
394
395 G91                                    ;relative positioning
396 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
397 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
398 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
399
400 M84                         ;steppers off
401 G90                         ;absolute positioning
402 ;{profile_string}
403 """, str, 'alteration', 'alteration')
404 setting('start4.gcode', """;Sliced at: {day} {date} {time}
405 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
406 ;Print time: {print_time}
407 ;Filament used: {filament_amount}m {filament_weight}g
408 ;Filament cost: {filament_cost}
409 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
410 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
411 ;M109 T2 S{print_temperature2} ;Uncomment to add your own temperature line
412 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
413 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
414 G21        ;metric values
415 G90        ;absolute positioning
416 M107       ;start with the fan off
417
418 G28 X0 Y0  ;move X/Y to min endstops
419 G28 Z0     ;move Z to min endstops
420
421 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
422
423 T3                      ;Switch to the 4th extruder
424 G92 E0                  ;zero the extruded length
425 G1 F200 E10             ;extrude 10mm of feed stock
426 G92 E0                  ;zero the extruded length again
427 G1 F200 E-{retraction_dual_amount}
428
429 T2                      ;Switch to the 3th extruder
430 G92 E0                  ;zero the extruded length
431 G1 F200 E10             ;extrude 10mm of feed stock
432 G92 E0                  ;zero the extruded length again
433 G1 F200 E-{retraction_dual_amount}
434
435 T1                      ;Switch to the 2nd extruder
436 G92 E0                  ;zero the extruded length
437 G1 F200 E10             ;extrude 10mm of feed stock
438 G92 E0                  ;zero the extruded length again
439 G1 F200 E-{retraction_dual_amount}
440
441 T0                      ;Switch to the first extruder
442 G92 E0                  ;zero the extruded length
443 G1 F200 E10             ;extrude 10mm of feed stock
444 G92 E0                  ;zero the extruded length again
445 G1 F{travel_speed}
446 ;Put printing message on LCD screen
447 M117 Printing...
448 """, str, 'alteration', 'alteration')
449 #######################################################################################
450 setting('end4.gcode', """;End GCode
451 M104 T0 S0                     ;extruder heater off
452 M104 T1 S0                     ;extruder heater off
453 M104 T2 S0                     ;extruder heater off
454 M104 T3 S0                     ;extruder heater off
455 M140 S0                     ;heated bed heater off (if you have it)
456
457 G91                                    ;relative positioning
458 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
459 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
460 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
461
462 M84                         ;steppers off
463 G90                         ;absolute positioning
464 ;{profile_string}
465 """, str, 'alteration', 'alteration')
466 #######################################################################################
467 setting('support_start.gcode', '', str, 'alteration', 'alteration')
468 setting('support_end.gcode', '', str, 'alteration', 'alteration')
469 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
470 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
471 setting('replace.csv', '', str, 'alteration', 'alteration')
472 #######################################################################################
473 setting('preSwitchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
474 ;This code is added before the T(n)
475 """, str, 'alteration', 'alteration')
476 setting('postSwitchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
477 ;This code is added after the T(n)
478 """, str, 'alteration', 'alteration')
479
480 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
481 setting('oneAtATime', 'True', bool, 'preference', 'hidden')
482 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'Rocktopus.stl')), str, 'preference', 'hidden')
483 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."))
484 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."))
485 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."))
486 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."))
487 setting('check_for_updates', 'False', bool, 'preference', 'hidden').setLabel(_("Check for updates"), _("Check for newer versions of Cura on startup"))
488 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel(_("Send usage statistics"), _("Submit anonymous usage information to improve future versions of Cura"))
489 setting('youmagine_token', '', str, 'preference', 'hidden')
490 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."))
491 setting('language', 'Autodetect', str, 'preference', 'hidden').setLabel(_('Language'), _('Change the language in which Cura runs. Switching language requires a restart of Cura'))
492 setting('active_machine', '0', int, 'preference', 'hidden')
493
494 setting('model_colour', '#C9E240', str, 'preference', 'hidden').setLabel(_('Model colour'), _('Display color for first extruder'))
495 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel(_('Model colour (2)'), _('Display color for second extruder'))
496 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel(_('Model colour (3)'), _('Display color for third extruder'))
497 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel(_('Model colour (4)'), _('Display color for forth extruder'))
498 setting('printing_window', 'Pronterface UI', ['Basic'], 'preference', 'hidden').setLabel(_('Printing window type'), _('Select the interface used for USB printing.'))
499
500 setting('window_maximized', 'True', bool, 'preference', 'hidden')
501 setting('window_pos_x', '-1', float, 'preference', 'hidden')
502 setting('window_pos_y', '-1', float, 'preference', 'hidden')
503 setting('window_width', '-1', float, 'preference', 'hidden')
504 setting('window_height', '-1', float, 'preference', 'hidden')
505 setting('window_normal_sash', '320', float, 'preference', 'hidden')
506 setting('last_run_version', '', str, 'preference', 'hidden')
507
508 setting('machine_name', '', str, 'machine', 'hidden')
509 setting('machine_type', 'unknown', str, 'machine', 'hidden') #Ultimaker, Ultimaker2, RepRap
510 setting('machine_width', '205', float, 'machine', 'hidden').setLabel(_("Maximum width (mm)"), _("Maximum width of the machine print area in mm"))
511 setting('machine_depth', '205', float, 'machine', 'hidden').setLabel(_("Maximum depth (mm)"), _("Maximum depth of the machine print area in mm"))
512 setting('machine_height', '200', float, 'machine', 'hidden').setLabel(_("Maximum height (mm)"), _("Maximum height of the machine print area in mm"))
513 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."))
514 setting('machine_shape', 'Square', ['Square','Circular'], 'machine', 'hidden').setLabel(_("Build area shape"), _("The shape of machine build area."))
515 setting('ultimaker_extruder_upgrade', 'False', bool, 'machine', 'hidden')
516 setting('has_heated_bed', 'False', bool, 'machine', 'hidden').setLabel(_("Heated bed"), _("If you have a heated bed, this enabled heated bed settings (requires restart)"))
517 setting('gcode_flavor', 'RepRap (Marlin/Sprinter)', ['RepRap (Marlin/Sprinter)', 'RepRap (Volumetric)', 'UltiGCode', 'MakerBot', 'BFB', 'Mach3'], '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.\nBFB style generates RPM based code.\nMach3 uses A,B,C instead of E for extruders."))
518 setting('extruder_amount', '1', ['1','2','3','4'], 'machine', 'hidden').setLabel(_("Extruder count"), _("Amount of extruders in your machine."))
519 setting('extruder_offset_x1', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your secondary extruder compared to the primary."))
520 setting('extruder_offset_y1', '21.6', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your secondary extruder compared to the primary."))
521 setting('extruder_offset_x2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your tertiary extruder compared to the primary."))
522 setting('extruder_offset_y2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your tertiary extruder compared to the primary."))
523 setting('extruder_offset_x3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your forth extruder compared to the primary."))
524 setting('extruder_offset_y3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your forth extruder compared to the primary."))
525 setting('extruder_z_offset', '0.0', float, 'machine', 'hidden').setLabel(_("Z-Offset (mm)"), _("This value will be added to the Z coordinate of every line in the output G-Code to compensate for a badly calibrate Z height endstop."))
526
527 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."))
528 setting('serial_port', 'AUTO', str, 'machine', 'hidden').setLabel(_("Serial port"), _("Serial port to use for communication with the printer"))
529 setting('serial_port_auto', '', str, 'machine', 'hidden')
530 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"))
531 setting('serial_baud_auto', '', int, 'machine', 'hidden')
532
533 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."))
534 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."))
535 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."))
536 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."))
537 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."))
538
539 validators.warningAbove(settingsDictionary['filament_flow'], 150, _("More flow than 150% is rare and usually not recommended."))
540 validators.warningBelow(settingsDictionary['filament_flow'], 50, _("Less flow than 50% is rare and usually not recommended."))
541 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."))
542 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
543 validators.warningAbove(settingsDictionary['print_speed'], 150.0, _("It is highly unlikely that your machine can achieve a printing speed above 150mm/s"))
544 validators.printSpeedValidator(settingsDictionary['print_speed'])
545 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
546 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
547 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
548 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
549 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
550 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
551 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
552 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
553 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, _("It is highly unlikely that your machine can achieve a travel speed above 300mm/s"))
554 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."))
555
556 #Conditions for multiple extruders
557 settingsDictionary['print_temperature2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
558 settingsDictionary['print_temperature3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
559 settingsDictionary['print_temperature4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
560 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
561 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
562 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
563 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
564 settingsDictionary['retraction_dual_amount'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
565 settingsDictionary['wipe_tower'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
566 settingsDictionary['wipe_tower_volume'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
567 settingsDictionary['ooze_shield'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
568 #Heated bed
569 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('has_heated_bed') == 'True')
570
571 #UltiGCode uses less settings, as these settings are located inside the machine instead of gcode.
572 settingsDictionary['print_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
573 settingsDictionary['print_temperature2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
574 settingsDictionary['print_temperature3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
575 settingsDictionary['print_temperature4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
576 settingsDictionary['filament_diameter'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
577 settingsDictionary['filament_diameter2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
578 settingsDictionary['filament_diameter3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
579 settingsDictionary['filament_diameter4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
580 settingsDictionary['filament_flow'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
581 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
582 settingsDictionary['retraction_speed'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
583 settingsDictionary['retraction_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
584 settingsDictionary['retraction_dual_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
585
586 #Remove fake defined _() because later the localization will define a global _()
587 del _
588
589 #########################################################
590 ## Profile and preferences functions
591 #########################################################
592
593 def getSubCategoriesFor(category):
594         done = {}
595         ret = []
596         for s in settingsList:
597                 if s.getCategory() == category and not s.getSubCategory() in done and s.checkConditions():
598                         done[s.getSubCategory()] = True
599                         ret.append(s.getSubCategory())
600         return ret
601
602 def getSettingsForCategory(category, subCategory = None):
603         ret = []
604         for s in settingsList:
605                 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory) and s.checkConditions():
606                         ret.append(s)
607         return ret
608
609 ## Profile functions
610 def getBasePath():
611         """
612         :return: The path in which the current configuration files are stored. This depends on the used OS.
613         """
614         if platform.system() == "Windows":
615                 basePath = os.path.normpath(os.path.expanduser('~/.cura/%s' % version.getVersion(False)))
616         elif platform.system() == "Darwin":
617                 basePath = os.path.expanduser('~/Library/Application Support/Cura/%s' % version.getVersion(False))
618         else:
619                 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
620         if not os.path.isdir(basePath):
621                 try:
622                         os.makedirs(basePath)
623                 except:
624                         print "Failed to create directory: %s" % (basePath)
625         return basePath
626
627 def getAlternativeBasePaths():
628         """
629         Search for alternative installations of Cura and their preference files. Used to load configuration from older versions of Cura.
630         """
631         paths = []
632         try:
633                 basePath = os.path.normpath(os.path.join(getBasePath(), '..'))
634                 for subPath in os.listdir(basePath):
635                         path = os.path.join(basePath, subPath)
636                         if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
637                                 paths.append(path)
638                         path = os.path.join(basePath, subPath, 'Cura')
639                         if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
640                                 paths.append(path)
641                 paths.sort()
642
643                 if sys.platform.startswith('win'):
644                         extra_list = []
645                         #Check the old base path, which was in the application directory.
646                         basePath = "C:\\program files (x86)\\"
647                         for subPath in os.listdir(basePath):
648                                 path = os.path.join(basePath, subPath)
649                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
650                                         extra_list.append(path)
651                                 path = os.path.join(basePath, subPath, 'Cura')
652                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
653                                         extra_list.append(path)
654                         basePath = "C:\\program files\\"
655                         for subPath in os.listdir(basePath):
656                                 path = os.path.join(basePath, subPath)
657                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
658                                         extra_list.append(path)
659                                 path = os.path.join(basePath, subPath, 'Cura')
660                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
661                                         extra_list.append(path)
662                         extra_list.sort()
663                         paths = extra_list + paths
664         except:
665                 import traceback
666                 print traceback.print_exc()
667
668         return paths
669
670 def getDefaultProfilePath():
671         """
672         :return: The default path where the currently used profile is stored and loaded on open and close of Cura.
673         """
674         return os.path.join(getBasePath(), 'current_profile.ini')
675
676 def loadProfile(filename, allMachines = False):
677         """
678                 Read a profile file as active profile settings.
679         :param filename:    The ini filename to save the profile in.
680         :param allMachines: When False only the current active profile is saved. If True all profiles for all machines are saved.
681         """
682         global settingsList
683         profileParser = ConfigParser.ConfigParser()
684         try:
685                 profileParser.read(filename)
686         except ConfigParser.ParsingError:
687                 return
688         if allMachines:
689                 n = 0
690                 while profileParser.has_section('profile_%d' % (n)):
691                         for set in settingsList:
692                                 if set.isPreference():
693                                         continue
694                                 section = 'profile_%d' % (n)
695                                 if set.isAlteration():
696                                         section = 'alterations_%d' % (n)
697                                 if profileParser.has_option(section, set.getName()):
698                                         set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'), n)
699                         n += 1
700         else:
701                 for set in settingsList:
702                         if set.isPreference():
703                                 continue
704                         section = 'profile'
705                         if set.isAlteration():
706                                 section = 'alterations'
707                         if profileParser.has_option(section, set.getName()):
708                                 set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
709
710 def saveProfile(filename, allMachines = False):
711         """
712                 Save the current profile to an ini file.
713         :param filename:    The ini filename to save the profile in.
714         :param allMachines: When False only the current active profile is saved. If True all profiles for all machines are saved.
715         """
716         global settingsList
717         profileParser = ConfigParser.ConfigParser()
718         if allMachines:
719                 for set in settingsList:
720                         if set.isPreference() or set.isMachineSetting():
721                                 continue
722                         for n in xrange(0, getMachineCount()):
723                                 if set.isAlteration():
724                                         section = 'alterations_%d' % (n)
725                                 else:
726                                         section = 'profile_%d' % (n)
727                                 if not profileParser.has_section(section):
728                                         profileParser.add_section(section)
729                                 profileParser.set(section, set.getName(), set.getValue(n).encode('utf-8'))
730         else:
731                 profileParser.add_section('profile')
732                 profileParser.add_section('alterations')
733                 for set in settingsList:
734                         if set.isPreference() or set.isMachineSetting():
735                                 continue
736                         if set.isAlteration():
737                                 profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
738                         else:
739                                 profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
740
741         try:
742                 profileParser.write(open(filename, 'w'))
743         except:
744                 print "Failed to write profile file: %s" % (filename)
745
746 def resetProfile():
747         """ Reset the profile for the current machine to default. """
748         global settingsList
749         for set in settingsList:
750                 if not set.isProfile():
751                         continue
752                 set.setValue(set.getDefault())
753
754         if getMachineSetting('machine_type') == 'ultimaker':
755                 putProfileSetting('nozzle_size', '0.4')
756                 if getMachineSetting('ultimaker_extruder_upgrade') == 'True':
757                         putProfileSetting('retraction_enable', 'True')
758         elif getMachineSetting('machine_type') == 'ultimaker_plus':
759                 putProfileSetting('nozzle_size', '0.4')
760                 putProfileSetting('retraction_enable', 'True')
761         elif getMachineSetting('machine_type') == 'ultimaker2':
762                 putProfileSetting('nozzle_size', '0.4')
763                 putProfileSetting('retraction_enable', 'True')
764         else:
765                 putProfileSetting('nozzle_size', '0.5')
766                 putProfileSetting('retraction_enable', 'True')
767
768 def setProfileFromString(options):
769         """
770         Parse an encoded string which has all the profile settings stored inside of it.
771         Used in combination with getProfileString to ease sharing of profiles.
772         """
773         options = base64.b64decode(options)
774         options = zlib.decompress(options)
775         (profileOpts, alt) = options.split('\f', 1)
776         global settingsDictionary
777         for option in profileOpts.split('\b'):
778                 if len(option) > 0:
779                         (key, value) = option.split('=', 1)
780                         if key in settingsDictionary:
781                                 if settingsDictionary[key].isProfile():
782                                         settingsDictionary[key].setValue(value)
783         for option in alt.split('\b'):
784                 if len(option) > 0:
785                         (key, value) = option.split('=', 1)
786                         if key in settingsDictionary:
787                                 if settingsDictionary[key].isAlteration():
788                                         settingsDictionary[key].setValue(value)
789
790 def getProfileString():
791         """
792         Get an encoded string which contains all profile settings.
793         Used in combination with setProfileFromString to share settings in files, forums or other text based ways.
794         """
795         p = []
796         alt = []
797         global settingsList
798         for set in settingsList:
799                 if set.isProfile():
800                         if set.getName() in tempOverride:
801                                 p.append(set.getName() + "=" + tempOverride[set.getName()])
802                         else:
803                                 p.append(set.getName() + "=" + set.getValue().encode('utf-8'))
804                 elif set.isAlteration():
805                         if set.getName() in tempOverride:
806                                 alt.append(set.getName() + "=" + tempOverride[set.getName()])
807                         else:
808                                 alt.append(set.getName() + "=" + set.getValue().encode('utf-8'))
809         ret = '\b'.join(p) + '\f' + '\b'.join(alt)
810         ret = base64.b64encode(zlib.compress(ret, 9))
811         return ret
812
813 def insertNewlines(string, every=64): #This should be moved to a better place then profile.
814         lines = []
815         for i in xrange(0, len(string), every):
816                 lines.append(string[i:i+every])
817         return '\n'.join(lines)
818
819 def getPreferencesString():
820         """
821         :return: An encoded string which contains all the current preferences.
822         """
823         p = []
824         global settingsList
825         for set in settingsList:
826                 if (set.isPreference() and set.getName() != 'lastFile' and set.getName() != 'youmagine_token') or set.isMachineSetting():
827                         p.append(set.getName() + "=" + set.getValue().encode('utf-8'))
828         ret = '\b'.join(p)
829         ret = base64.b64encode(zlib.compress(ret, 9))
830         return ret
831
832
833 def getProfileSetting(name):
834         """
835                 Get the value of an profile setting.
836         :param name: Name of the setting to retrieve.
837         :return:     Value of the current setting.
838         """
839         if name in tempOverride:
840                 return tempOverride[name]
841         global settingsDictionary
842         if name in settingsDictionary and settingsDictionary[name].isProfile():
843                 return settingsDictionary[name].getValue()
844         traceback.print_stack()
845         sys.stderr.write('Error: "%s" not found in profile settings\n' % (name))
846         return ''
847
848 def getProfileSettingFloat(name):
849         try:
850                 setting = getProfileSetting(name).replace(',', '.')
851                 return float(eval(setting, {}, {}))
852         except:
853                 return 0.0
854
855 def putProfileSetting(name, value):
856         """ Store a certain value in a profile setting. """
857         global settingsDictionary
858         if name in settingsDictionary and settingsDictionary[name].isProfile():
859                 settingsDictionary[name].setValue(value)
860
861 def isProfileSetting(name):
862         """ Check if a certain key name is actually a profile value. """
863         global settingsDictionary
864         if name in settingsDictionary and settingsDictionary[name].isProfile():
865                 return True
866         return False
867
868 ## Preferences functions
869 def getPreferencePath():
870         """
871         :return: The full path of the preference ini file.
872         """
873         return os.path.join(getBasePath(), 'preferences.ini')
874
875 def getPreferenceFloat(name):
876         """
877         Get the float value of a preference, returns 0.0 if the preference is not a invalid float
878         """
879         try:
880                 setting = getPreference(name).replace(',', '.')
881                 return float(eval(setting, {}, {}))
882         except:
883                 return 0.0
884
885 def getPreferenceColour(name):
886         """
887         Get a preference setting value as a color array. The color is stored as #RRGGBB hex string in the setting.
888         """
889         colorString = getPreference(name)
890         return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
891
892 def loadPreferences(filename):
893         """
894         Read a configuration file as global config
895         """
896         global settingsList
897         profileParser = ConfigParser.ConfigParser()
898         try:
899                 profileParser.read(filename)
900         except ConfigParser.ParsingError:
901                 return
902
903         for set in settingsList:
904                 if set.isPreference():
905                         if profileParser.has_option('preference', set.getName()):
906                                 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
907
908         n = 0
909         while profileParser.has_section('machine_%d' % (n)):
910                 for set in settingsList:
911                         if set.isMachineSetting():
912                                 if profileParser.has_option('machine_%d' % (n), set.getName()):
913                                         set.setValue(unicode(profileParser.get('machine_%d' % (n), set.getName()), 'utf-8', 'replace'), n)
914                 n += 1
915
916         setActiveMachine(int(getPreferenceFloat('active_machine')))
917
918 def loadMachineSettings(filename):
919         global settingsList
920         #Read a configuration file as global config
921         profileParser = ConfigParser.ConfigParser()
922         try:
923                 profileParser.read(filename)
924         except ConfigParser.ParsingError:
925                 return
926
927         for set in settingsList:
928                 if set.isMachineSetting():
929                         if profileParser.has_option('machine', set.getName()):
930                                 set.setValue(unicode(profileParser.get('machine', set.getName()), 'utf-8', 'replace'))
931         checkAndUpdateMachineName()
932
933 def savePreferences(filename):
934         global settingsList
935         #Save the current profile to an ini file
936         parser = ConfigParser.ConfigParser()
937         parser.add_section('preference')
938
939         for set in settingsList:
940                 if set.isPreference():
941                         parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
942
943         n = 0
944         while getMachineSetting('machine_name', n) != '':
945                 parser.add_section('machine_%d' % (n))
946                 for set in settingsList:
947                         if set.isMachineSetting():
948                                 parser.set('machine_%d' % (n), set.getName(), set.getValue(n).encode('utf-8'))
949                 n += 1
950         try:
951                 parser.write(open(filename, 'w'))
952         except:
953                 print "Failed to write preferences file: %s" % (filename)
954
955 def getPreference(name):
956         if name in tempOverride:
957                 return tempOverride[name]
958         global settingsDictionary
959         if name in settingsDictionary and settingsDictionary[name].isPreference():
960                 return settingsDictionary[name].getValue()
961         traceback.print_stack()
962         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
963         return ''
964
965 def putPreference(name, value):
966         #Check if we have a configuration file loaded, else load the default.
967         global settingsDictionary
968         if name in settingsDictionary and settingsDictionary[name].isPreference():
969                 settingsDictionary[name].setValue(value)
970                 savePreferences(getPreferencePath())
971                 return
972         traceback.print_stack()
973         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
974
975 def isPreference(name):
976         global settingsDictionary
977         if name in settingsDictionary and settingsDictionary[name].isPreference():
978                 return True
979         return False
980
981 def getMachineSettingFloat(name, index = None):
982         try:
983                 setting = getMachineSetting(name, index).replace(',', '.')
984                 return float(eval(setting, {}, {}))
985         except:
986                 return 0.0
987
988 def getMachineSetting(name, index = None):
989         if name in tempOverride:
990                 return tempOverride[name]
991         global settingsDictionary
992         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
993                 return settingsDictionary[name].getValue(index)
994         traceback.print_stack()
995         sys.stderr.write('Error: "%s" not found in machine settings\n' % (name))
996         return ''
997
998 def putMachineSetting(name, value, index = None):
999         #Check if we have a configuration file loaded, else load the default.
1000         global settingsDictionary
1001         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
1002                 settingsDictionary[name].setValue(value, index)
1003         savePreferences(getPreferencePath())
1004
1005 def isMachineSetting(name):
1006         global settingsDictionary
1007         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
1008                 return True
1009         return False
1010
1011 def checkAndUpdateMachineName():
1012         global _selectedMachineIndex
1013         name = getMachineSetting('machine_name')
1014         index = None
1015         if name == '':
1016                 name = getMachineSetting('machine_type')
1017         for n in xrange(0, getMachineCount()):
1018                 if n == _selectedMachineIndex:
1019                         continue
1020                 if index is None:
1021                         if name == getMachineSetting('machine_name', n):
1022                                 index = 1
1023                 else:
1024                         if '%s (%d)' % (name, index) == getMachineSetting('machine_name', n):
1025                                 index += 1
1026         if index is not None:
1027                 name = '%s (%d)' % (name, index)
1028         putMachineSetting('machine_name', name)
1029         putPreference('active_machine', _selectedMachineIndex)
1030
1031 def getMachineCount():
1032         n = 0
1033         while getMachineSetting('machine_name', n) != '':
1034                 n += 1
1035         if n < 1:
1036                 return 1
1037         return n
1038
1039 def setActiveMachine(index):
1040         global _selectedMachineIndex
1041         _selectedMachineIndex = index
1042         putPreference('active_machine', _selectedMachineIndex)
1043
1044 def removeMachine(index):
1045         global _selectedMachineIndex
1046         global settingsList
1047         if getMachineCount() < 2:
1048                 return
1049         for n in xrange(index, getMachineCount()):
1050                 for setting in settingsList:
1051                         if setting.isMachineSetting():
1052                                 setting.setValue(setting.getValue(n+1), n)
1053
1054         if _selectedMachineIndex >= index:
1055                 setActiveMachine(getMachineCount() - 1)
1056
1057 ## Temp overrides for multi-extruder slicing and the project planner.
1058 tempOverride = {}
1059 def setTempOverride(name, value):
1060         tempOverride[name] = unicode(value).encode("utf-8")
1061 def clearTempOverride(name):
1062         del tempOverride[name]
1063 def resetTempOverride():
1064         tempOverride.clear()
1065
1066 #########################################################
1067 ## Utility functions to calculate common profile values
1068 #########################################################
1069 def calculateEdgeWidth():
1070         wallThickness = getProfileSettingFloat('wall_thickness')
1071         nozzleSize = getProfileSettingFloat('nozzle_size')
1072
1073         if getProfileSetting('spiralize') == 'True' or getProfileSetting('simple_mode') == 'True':
1074                 return wallThickness
1075
1076         if wallThickness < 0.01:
1077                 return nozzleSize
1078         if wallThickness < nozzleSize:
1079                 return wallThickness
1080
1081         lineCount = int(wallThickness / (nozzleSize - 0.0001))
1082         if lineCount == 0:
1083                 return nozzleSize
1084         lineWidth = wallThickness / lineCount
1085         lineWidthAlt = wallThickness / (lineCount + 1)
1086         if lineWidth > nozzleSize * 1.5:
1087                 return lineWidthAlt
1088         return lineWidth
1089
1090 def calculateLineCount():
1091         wallThickness = getProfileSettingFloat('wall_thickness')
1092         nozzleSize = getProfileSettingFloat('nozzle_size')
1093
1094         if wallThickness < 0.01:
1095                 return 0
1096         if wallThickness < nozzleSize:
1097                 return 1
1098         if getProfileSetting('spiralize') == 'True' or getProfileSetting('simple_mode') == 'True':
1099                 return 1
1100
1101         lineCount = int(wallThickness / (nozzleSize - 0.0001))
1102         if lineCount < 1:
1103                 lineCount = 1
1104         lineWidth = wallThickness / lineCount
1105         lineWidthAlt = wallThickness / (lineCount + 1)
1106         if lineWidth > nozzleSize * 1.5:
1107                 return lineCount + 1
1108         return lineCount
1109
1110 def calculateSolidLayerCount():
1111         layerHeight = getProfileSettingFloat('layer_height')
1112         solidThickness = getProfileSettingFloat('solid_layer_thickness')
1113         if layerHeight == 0.0:
1114                 return 1
1115         return int(math.ceil((solidThickness - 0.0001) / layerHeight))
1116
1117 def calculateObjectSizeOffsets():
1118         size = 0.0
1119
1120         if getProfileSetting('platform_adhesion') == 'Brim':
1121                 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
1122         elif getProfileSetting('platform_adhesion') == 'Raft':
1123                 pass
1124         else:
1125                 if getProfileSettingFloat('skirt_line_count') > 0:
1126                         size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
1127
1128         #if getProfileSetting('enable_raft') != 'False':
1129         #       size += profile.getProfileSettingFloat('raft_margin') * 2
1130         #if getProfileSetting('support') != 'None':
1131         #       extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
1132         #       extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
1133         return [size, size]
1134
1135 def getMachineCenterCoords():
1136         if getMachineSetting('machine_center_is_zero') == 'True':
1137                 return [0, 0]
1138         elif getMachineSetting('machine_type') == 'lulzbot_mini':
1139                 return [(getMachineSettingFloat('machine_width') / 2) + 2.5, (getMachineSettingFloat('machine_width') / 2) + 0.5]
1140         return [getMachineSettingFloat('machine_width') / 2, getMachineSettingFloat('machine_depth') / 2]
1141
1142 #Returns a list of convex polygons, first polygon is the allowed area of the machine,
1143 # the rest of the polygons are the dis-allowed areas of the machine.
1144 def getMachineSizePolygons():
1145         size = numpy.array([getMachineSettingFloat('machine_width'), getMachineSettingFloat('machine_depth'), getMachineSettingFloat('machine_height')], numpy.float32)
1146         ret = []
1147         if getMachineSetting('machine_shape') == 'Circular':
1148                 # Circle platform for delta printers...
1149                 circle = []
1150                 steps = 32
1151                 for n in xrange(0, steps):
1152                         circle.append([math.cos(float(n)/steps*2*math.pi) * size[0]/2, math.sin(float(n)/steps*2*math.pi) * size[1]/2])
1153                 ret.append(numpy.array(circle, numpy.float32))
1154         else:
1155                 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))
1156
1157         if getMachineSetting('machine_type') == 'ultimaker2':
1158                 #UM2 no-go zones
1159                 w = 25
1160                 h = 10
1161                 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))
1162                 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))
1163                 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))
1164                 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))
1165         return ret
1166
1167 #returns the number of extruders minimal used. Normally this returns 1, but with dual-extrusion support material it returns 2
1168 def minimalExtruderCount():
1169         if int(getMachineSetting('extruder_amount')) < 2:
1170                 return 1
1171         if getProfileSetting('support') == 'None':
1172                 return 1
1173         if getProfileSetting('support_dual_extrusion') == 'Second extruder':
1174                 return 2
1175         return 1
1176
1177 def getGCodeExtension():
1178         if getMachineSetting('gcode_flavor') == 'BFB':
1179                 return '.bfb'
1180         return '.gcode'
1181
1182 #########################################################
1183 ## Alteration file functions
1184 #########################################################
1185 def replaceTagMatch(m):
1186         pre = m.group(1)
1187         tag = m.group(2)
1188         if tag == 'time':
1189                 return pre + time.strftime('%H:%M:%S')
1190         if tag == 'date':
1191                 return pre + time.strftime('%d-%m-%Y')
1192         if tag == 'day':
1193                 return pre + ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][int(time.strftime('%w'))]
1194         if tag == 'print_time':
1195                 return pre + '#P_TIME#'
1196         if tag == 'filament_amount':
1197                 return pre + '#F_AMNT#'
1198         if tag == 'filament_weight':
1199                 return pre + '#F_WGHT#'
1200         if tag == 'filament_cost':
1201                 return pre + '#F_COST#'
1202         if tag == 'profile_string':
1203                 return pre + 'CURA_PROFILE_STRING:%s' % (getProfileString())
1204         if pre == 'F' and tag == 'max_z_speed':
1205                 f = getProfileSettingFloat('travel_speed') * 60
1206         if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
1207                 f = getProfileSettingFloat(tag) * 60
1208         elif isProfileSetting(tag):
1209                 f = getProfileSettingFloat(tag)
1210         elif isPreference(tag):
1211                 f = getProfileSettingFloat(tag)
1212         else:
1213                 return '%s?%s?' % (pre, tag)
1214         if (f % 1) == 0:
1215                 return pre + str(int(f))
1216         return pre + str(f)
1217
1218 def replaceGCodeTags(filename, gcodeInt):
1219         f = open(filename, 'r+')
1220         data = f.read(2048)
1221         data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
1222         data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
1223         data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
1224         cost = gcodeInt.calculateCost()
1225         if cost is None:
1226                 cost = 'Unknown'
1227         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
1228         f.seek(0)
1229         f.write(data)
1230         f.close()
1231
1232 def replaceGCodeTagsFromSlicer(filename, slicerInt):
1233         f = open(filename, 'r+')
1234         data = f.read(2048)
1235         data = data.replace('#P_TIME#', ('%8.2f' % (int(slicerInt._printTimeSeconds)))[-8:])
1236         data = data.replace('#F_AMNT#', ('%8.2f' % (slicerInt._filamentMM[0]))[-8:])
1237         data = data.replace('#F_WGHT#', ('%8.2f' % (float(slicerInt.getFilamentWeight()) * 1000))[-8:])
1238         cost = slicerInt.getFilamentCost()
1239         if cost is None:
1240                 cost = 'Unknown'
1241         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
1242         f.seek(0)
1243         f.write(data)
1244         f.close()
1245
1246 ### Get aleration raw contents. (Used internally in Cura)
1247 def getAlterationFile(filename):
1248         if filename in tempOverride:
1249                 return tempOverride[filename]
1250         global settingsDictionary
1251         if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
1252                 return settingsDictionary[filename].getValue()
1253         traceback.print_stack()
1254         sys.stderr.write('Error: "%s" not found in alteration settings\n' % (filename))
1255         return ''
1256
1257 def setAlterationFile(name, value):
1258         #Check if we have a configuration file loaded, else load the default.
1259         global settingsDictionary
1260         if name in settingsDictionary and settingsDictionary[name].isAlteration():
1261                 settingsDictionary[name].setValue(value)
1262         saveProfile(getDefaultProfilePath(), True)
1263
1264 def isTagIn(tag, contents):
1265         contents = re.sub(';[^\n]*\n', '', contents)
1266         return tag in contents
1267
1268 ### Get the alteration file for output. (Used by Skeinforge)
1269 def getAlterationFileContents(filename, extruderCount = 1):
1270         prefix = ''
1271         postfix = ''
1272         alterationContents = getAlterationFile(filename)
1273         if getMachineSetting('gcode_flavor') == 'UltiGCode':
1274                 if filename == 'end.gcode':
1275                         return 'M25 ;Stop reading from this point on.\n;CURA_PROFILE_STRING:%s\n' % (getProfileString())
1276                 return ''
1277         if filename == 'start.gcode':
1278                 if extruderCount > 1:
1279                         alterationContents = getAlterationFile("start%d.gcode" % (extruderCount))
1280                 #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.
1281                 #We also set our steps per E here, if configured.
1282                 eSteps = getMachineSettingFloat('steps_per_e')
1283                 if eSteps > 0:
1284                         prefix += 'M92 E%f\n' % (eSteps)
1285                 temp = getProfileSettingFloat('print_temperature')
1286                 bedTemp = 0
1287                 if getMachineSetting('has_heated_bed') == 'True':
1288                         bedTemp = getProfileSettingFloat('print_bed_temperature')
1289
1290                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1291                         prefix += 'M190 S%f\n' % (bedTemp)
1292                 if temp > 0 and not isTagIn('{print_temperature}', alterationContents):
1293                         if extruderCount > 0:
1294                                 for n in xrange(1, extruderCount):
1295                                         t = temp
1296                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1297                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1298                                         prefix += 'M104 T%d S%f\n' % (n, t)
1299                                 for n in xrange(0, extruderCount):
1300                                         t = temp
1301                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1302                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1303                                         prefix += 'M109 T%d S%f\n' % (n, t)
1304                                 prefix += 'T0\n'
1305                         else:
1306                                 prefix += 'M109 S%f\n' % (temp)
1307         elif filename == 'end.gcode':
1308                 if extruderCount > 1:
1309                         alterationContents = getAlterationFile("end%d.gcode" % (extruderCount))
1310                 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
1311                 #postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
1312         return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'