chiark / gitweb /
Allow opening of expert settings sub-categories from the basic settings.
[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([None, '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 0 degree being horizontal and 90 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('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."))
251 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."))
252 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."))
253 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."))
254
255 setting('plugin_config', '', str, 'hidden', 'hidden')
256 setting('object_center_x', -1, float, 'hidden', 'hidden')
257 setting('object_center_y', -1, float, 'hidden', 'hidden')
258
259 setting('start.gcode', """;Sliced at: {day} {date} {time}
260 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
261 ;Print time: {print_time}
262 ;Filament used: {filament_amount}m {filament_weight}g
263 ;Filament cost: {filament_cost}
264 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
265 ;M109 S{print_temperature} ;Uncomment to add your own temperature line
266 G21        ;metric values
267 G90        ;absolute positioning
268 M82        ;set extruder to absolute mode
269 M107       ;start with the fan off
270
271 G28 X0 Y0  ;move X/Y to min endstops
272 G28 Z0     ;move Z to min endstops
273
274 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
275
276 G92 E0                  ;zero the extruded length
277 G1 F200 E3              ;extrude 3mm of feed stock
278 G92 E0                  ;zero the extruded length again
279 G1 F{travel_speed}
280 ;Put printing message on LCD screen
281 M117 Printing...
282 """, str, 'alteration', 'alteration')
283 #######################################################################################
284 setting('end.gcode', """;End GCode
285 M104 S0                     ;extruder heater off
286 M140 S0                     ;heated bed heater off (if you have it)
287
288 G91                                    ;relative positioning
289 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
290 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
291 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
292
293 M84                         ;steppers off
294 G90                         ;absolute positioning
295 ;{profile_string}
296 """, str, 'alteration', 'alteration')
297 #######################################################################################
298 setting('start2.gcode', """;Sliced at: {day} {date} {time}
299 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
300 ;Print time: {print_time}
301 ;Filament used: {filament_amount}m {filament_weight}g
302 ;Filament cost: {filament_cost}
303 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
304 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
305 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
306 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
307 G21        ;metric values
308 G90        ;absolute positioning
309 M107       ;start with the fan off
310
311 G28 X0 Y0  ;move X/Y to min endstops
312 G28 Z0     ;move Z to min endstops
313
314 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
315
316 T1                      ;Switch to the 2nd extruder
317 G92 E0                  ;zero the extruded length
318 G1 F200 E10             ;extrude 10mm of feed stock
319 G92 E0                  ;zero the extruded length again
320 G1 F200 E-{retraction_dual_amount}
321
322 T0                      ;Switch to the first extruder
323 G92 E0                  ;zero the extruded length
324 G1 F200 E10             ;extrude 10mm of feed stock
325 G92 E0                  ;zero the extruded length again
326 G1 F{travel_speed}
327 ;Put printing message on LCD screen
328 M117 Printing...
329 """, str, 'alteration', 'alteration')
330 #######################################################################################
331 setting('end2.gcode', """;End GCode
332 M104 T0 S0                     ;extruder heater off
333 M104 T1 S0                     ;extruder heater off
334 M140 S0                     ;heated bed heater off (if you have it)
335
336 G91                                    ;relative positioning
337 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
338 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
339 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
340
341 M84                         ;steppers off
342 G90                         ;absolute positioning
343 ;{profile_string}
344 """, str, 'alteration', 'alteration')
345 #######################################################################################
346 setting('start3.gcode', """;Sliced at: {day} {date} {time}
347 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
348 ;Print time: {print_time}
349 ;Filament used: {filament_amount}m {filament_weight}g
350 ;Filament cost: {filament_cost}
351 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
352 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
353 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
354 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
355 G21        ;metric values
356 G90        ;absolute positioning
357 M107       ;start with the fan off
358
359 G28 X0 Y0  ;move X/Y to min endstops
360 G28 Z0     ;move Z to min endstops
361
362 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
363
364 T2                      ;Switch to the 2nd extruder
365 G92 E0                  ;zero the extruded length
366 G1 F200 E10             ;extrude 10mm of feed stock
367 G92 E0                  ;zero the extruded length again
368 G1 F200 E-{retraction_dual_amount}
369
370 T1                      ;Switch to the 2nd extruder
371 G92 E0                  ;zero the extruded length
372 G1 F200 E10             ;extrude 10mm of feed stock
373 G92 E0                  ;zero the extruded length again
374 G1 F200 E-{retraction_dual_amount}
375
376 T0                      ;Switch to the first extruder
377 G92 E0                  ;zero the extruded length
378 G1 F200 E10             ;extrude 10mm of feed stock
379 G92 E0                  ;zero the extruded length again
380 G1 F{travel_speed}
381 ;Put printing message on LCD screen
382 M117 Printing...
383 """, str, 'alteration', 'alteration')
384 #######################################################################################
385 setting('end3.gcode', """;End GCode
386 M104 T0 S0                     ;extruder heater off
387 M104 T1 S0                     ;extruder heater off
388 M104 T2 S0                     ;extruder heater off
389 M140 S0                     ;heated bed heater off (if you have it)
390
391 G91                                    ;relative positioning
392 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
393 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
394 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
395
396 M84                         ;steppers off
397 G90                         ;absolute positioning
398 ;{profile_string}
399 """, str, 'alteration', 'alteration')
400 setting('start4.gcode', """;Sliced at: {day} {date} {time}
401 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
402 ;Print time: {print_time}
403 ;Filament used: {filament_amount}m {filament_weight}g
404 ;Filament cost: {filament_cost}
405 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
406 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
407 ;M109 T2 S{print_temperature2} ;Uncomment to add your own temperature line
408 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
409 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
410 G21        ;metric values
411 G90        ;absolute positioning
412 M107       ;start with the fan off
413
414 G28 X0 Y0  ;move X/Y to min endstops
415 G28 Z0     ;move Z to min endstops
416
417 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
418
419 T3                      ;Switch to the 4th extruder
420 G92 E0                  ;zero the extruded length
421 G1 F200 E10             ;extrude 10mm of feed stock
422 G92 E0                  ;zero the extruded length again
423 G1 F200 E-{retraction_dual_amount}
424
425 T2                      ;Switch to the 3th extruder
426 G92 E0                  ;zero the extruded length
427 G1 F200 E10             ;extrude 10mm of feed stock
428 G92 E0                  ;zero the extruded length again
429 G1 F200 E-{retraction_dual_amount}
430
431 T1                      ;Switch to the 2nd extruder
432 G92 E0                  ;zero the extruded length
433 G1 F200 E10             ;extrude 10mm of feed stock
434 G92 E0                  ;zero the extruded length again
435 G1 F200 E-{retraction_dual_amount}
436
437 T0                      ;Switch to the first extruder
438 G92 E0                  ;zero the extruded length
439 G1 F200 E10             ;extrude 10mm of feed stock
440 G92 E0                  ;zero the extruded length again
441 G1 F{travel_speed}
442 ;Put printing message on LCD screen
443 M117 Printing...
444 """, str, 'alteration', 'alteration')
445 #######################################################################################
446 setting('end4.gcode', """;End GCode
447 M104 T0 S0                     ;extruder heater off
448 M104 T1 S0                     ;extruder heater off
449 M104 T2 S0                     ;extruder heater off
450 M104 T3 S0                     ;extruder heater off
451 M140 S0                     ;heated bed heater off (if you have it)
452
453 G91                                    ;relative positioning
454 G1 E-1 F300                            ;retract the filament a bit before lifting the nozzle, to release some of the pressure
455 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
456 G28 X0 Y0                              ;move X/Y to min endstops, so the head is out of the way
457
458 M84                         ;steppers off
459 G90                         ;absolute positioning
460 ;{profile_string}
461 """, str, 'alteration', 'alteration')
462 #######################################################################################
463 setting('support_start.gcode', '', str, 'alteration', 'alteration')
464 setting('support_end.gcode', '', str, 'alteration', 'alteration')
465 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
466 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
467 setting('replace.csv', '', str, 'alteration', 'alteration')
468 #######################################################################################
469 setting('preSwitchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
470 ;This code is added before the T(n)
471 """, str, 'alteration', 'alteration')
472 setting('postSwitchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
473 ;This code is added after the T(n)
474 """, str, 'alteration', 'alteration')
475
476 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
477 setting('oneAtATime', 'True', bool, 'preference', 'hidden')
478 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'Rocktopus.stl')), str, 'preference', 'hidden')
479 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."))
480 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."))
481 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."))
482 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."))
483 setting('check_for_updates', 'False', bool, 'preference', 'hidden').setLabel(_("Check for updates"), _("Check for newer versions of Cura on startup"))
484 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel(_("Send usage statistics"), _("Submit anonymous usage information to improve future versions of Cura"))
485 setting('youmagine_token', '', str, 'preference', 'hidden')
486 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."))
487 setting('language', 'English', str, 'preference', 'hidden').setLabel(_('Language'), _('Change the language in which Cura runs. Switching language requires a restart of Cura'))
488 setting('active_machine', '0', int, 'preference', 'hidden')
489
490 setting('model_colour', '#C9E240', str, 'preference', 'hidden').setLabel(_('Model colour'), _('Display color for first extruder'))
491 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel(_('Model colour (2)'), _('Display color for second extruder'))
492 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel(_('Model colour (3)'), _('Display color for third extruder'))
493 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel(_('Model colour (4)'), _('Display color for forth extruder'))
494 setting('printing_window', 'Pronterface UI', ['Basic'], 'preference', 'hidden').setLabel(_('Printing window type'), _('Select the interface used for USB printing.'))
495
496 setting('window_maximized', 'True', bool, 'preference', 'hidden')
497 setting('window_pos_x', '-1', float, 'preference', 'hidden')
498 setting('window_pos_y', '-1', float, 'preference', 'hidden')
499 setting('window_width', '-1', float, 'preference', 'hidden')
500 setting('window_height', '-1', float, 'preference', 'hidden')
501 setting('window_normal_sash', '320', float, 'preference', 'hidden')
502 setting('last_run_version', '', str, 'preference', 'hidden')
503
504 setting('machine_name', '', str, 'machine', 'hidden')
505 setting('machine_type', 'unknown', str, 'machine', 'hidden') #Ultimaker, Ultimaker2, RepRap
506 setting('machine_width', '205', float, 'machine', 'hidden').setLabel(_("Maximum width (mm)"), _("Maximum width of the machine print area in mm"))
507 setting('machine_depth', '205', float, 'machine', 'hidden').setLabel(_("Maximum depth (mm)"), _("Maximum depth of the machine print area in mm"))
508 setting('machine_height', '200', float, 'machine', 'hidden').setLabel(_("Maximum height (mm)"), _("Maximum height of the machine print area in mm"))
509 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."))
510 setting('machine_shape', 'Square', ['Square','Circular'], 'machine', 'hidden').setLabel(_("Build area shape"), _("The shape of machine build area."))
511 setting('ultimaker_extruder_upgrade', 'False', bool, 'machine', 'hidden')
512 setting('has_heated_bed', 'False', bool, 'machine', 'hidden').setLabel(_("Heated bed"), _("If you have a heated bed, this enabled heated bed settings (requires restart)"))
513 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."))
514 setting('extruder_amount', '1', ['1','2','3','4'], 'machine', 'hidden').setLabel(_("Extruder count"), _("Amount of extruders in your machine."))
515 setting('extruder_offset_x1', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your secondary extruder compared to the primary."))
516 setting('extruder_offset_y1', '21.6', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your secondary extruder compared to the primary."))
517 setting('extruder_offset_x2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your tertiary extruder compared to the primary."))
518 setting('extruder_offset_y2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your tertiary extruder compared to the primary."))
519 setting('extruder_offset_x3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your forth extruder compared to the primary."))
520 setting('extruder_offset_y3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your forth extruder compared to the primary."))
521 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."))
522 setting('serial_port', 'AUTO', str, 'machine', 'hidden').setLabel(_("Serial port"), _("Serial port to use for communication with the printer"))
523 setting('serial_port_auto', '', str, 'machine', 'hidden')
524 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"))
525 setting('serial_baud_auto', '', int, 'machine', 'hidden')
526
527 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."))
528 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."))
529 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."))
530 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."))
531 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."))
532
533 validators.warningAbove(settingsDictionary['filament_flow'], 150, _("More flow than 150% is rare and usually not recommended."))
534 validators.warningBelow(settingsDictionary['filament_flow'], 50, _("Less flow than 50% is rare and usually not recommended."))
535 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."))
536 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
537 validators.warningAbove(settingsDictionary['print_speed'], 150.0, _("It is highly unlikely that your machine can achieve a printing speed above 150mm/s"))
538 validators.printSpeedValidator(settingsDictionary['print_speed'])
539 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
540 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
541 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
542 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
543 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
544 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
545 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
546 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
547 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, _("It is highly unlikely that your machine can achieve a travel speed above 300mm/s"))
548 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."))
549
550 #Conditions for multiple extruders
551 settingsDictionary['print_temperature2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
552 settingsDictionary['print_temperature3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
553 settingsDictionary['print_temperature4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
554 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
555 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
556 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
557 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
558 settingsDictionary['retraction_dual_amount'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
559 settingsDictionary['wipe_tower'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
560 settingsDictionary['wipe_tower_volume'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
561 settingsDictionary['ooze_shield'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
562 #Heated bed
563 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('has_heated_bed') == 'True')
564
565 #UltiGCode uses less settings, as these settings are located inside the machine instead of gcode.
566 settingsDictionary['print_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
567 settingsDictionary['print_temperature2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
568 settingsDictionary['print_temperature3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
569 settingsDictionary['print_temperature4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
570 settingsDictionary['filament_diameter'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
571 settingsDictionary['filament_diameter2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
572 settingsDictionary['filament_diameter3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
573 settingsDictionary['filament_diameter4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
574 settingsDictionary['filament_flow'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
575 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
576 settingsDictionary['retraction_speed'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
577 settingsDictionary['retraction_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
578 settingsDictionary['retraction_dual_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
579
580 #Remove fake defined _() because later the localization will define a global _()
581 del _
582
583 #########################################################
584 ## Profile and preferences functions
585 #########################################################
586
587 def getSubCategoriesFor(category):
588         done = {}
589         ret = []
590         for s in settingsList:
591                 if s.getCategory() == category and not s.getSubCategory() in done and s.checkConditions():
592                         done[s.getSubCategory()] = True
593                         ret.append(s.getSubCategory())
594         return ret
595
596 def getSettingsForCategory(category, subCategory = None):
597         ret = []
598         for s in settingsList:
599                 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory) and s.checkConditions():
600                         ret.append(s)
601         return ret
602
603 ## Profile functions
604 def getBasePath():
605         """
606         :return: The path in which the current configuration files are stored. This depends on the used OS.
607         """
608         if platform.system() == "Windows":
609                 basePath = os.path.normpath(os.path.expanduser('~/.cura/%s' % version.getVersion(False)))
610         elif platform.system() == "Darwin":
611                 basePath = os.path.expanduser('~/Library/Application Support/Cura/%s' % version.getVersion(False))
612         else:
613                 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
614         if not os.path.isdir(basePath):
615                 try:
616                         os.makedirs(basePath)
617                 except:
618                         print "Failed to create directory: %s" % (basePath)
619         return basePath
620
621 def getAlternativeBasePaths():
622         """
623         Search for alternative installations of Cura and their preference files. Used to load configuration from older versions of Cura.
624         """
625         paths = []
626         try:
627                 basePath = os.path.normpath(os.path.join(getBasePath(), '..'))
628                 for subPath in os.listdir(basePath):
629                         path = os.path.join(basePath, subPath)
630                         if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
631                                 paths.append(path)
632                         path = os.path.join(basePath, subPath, 'Cura')
633                         if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
634                                 paths.append(path)
635                 paths.sort()
636
637                 if sys.platform.startswith('win'):
638                         extra_list = []
639                         #Check the old base path, which was in the application directory.
640                         basePath = "C:\\program files (x86)\\"
641                         for subPath in os.listdir(basePath):
642                                 path = os.path.join(basePath, subPath)
643                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
644                                         extra_list.append(path)
645                                 path = os.path.join(basePath, subPath, 'Cura')
646                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
647                                         extra_list.append(path)
648                         basePath = "C:\\program files\\"
649                         for subPath in os.listdir(basePath):
650                                 path = os.path.join(basePath, subPath)
651                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
652                                         extra_list.append(path)
653                                 path = os.path.join(basePath, subPath, 'Cura')
654                                 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')):
655                                         extra_list.append(path)
656                         extra_list.sort()
657                         paths = extra_list + paths
658         except:
659                 import traceback
660                 print traceback.print_exc()
661
662         return paths
663
664 def getDefaultProfilePath():
665         """
666         :return: The default path where the currently used profile is stored and loaded on open and close of Cura.
667         """
668         return os.path.join(getBasePath(), 'current_profile.ini')
669
670 def loadProfile(filename, allMachines = False):
671         """
672                 Read a profile file as active profile settings.
673         :param filename:    The ini filename to save the profile in.
674         :param allMachines: When False only the current active profile is saved. If True all profiles for all machines are saved.
675         """
676         global settingsList
677         profileParser = ConfigParser.ConfigParser()
678         try:
679                 profileParser.read(filename)
680         except ConfigParser.ParsingError:
681                 return
682         if allMachines:
683                 n = 0
684                 while profileParser.has_section('profile_%d' % (n)):
685                         for set in settingsList:
686                                 if set.isPreference():
687                                         continue
688                                 section = 'profile_%d' % (n)
689                                 if set.isAlteration():
690                                         section = 'alterations_%d' % (n)
691                                 if profileParser.has_option(section, set.getName()):
692                                         set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'), n)
693                         n += 1
694         else:
695                 for set in settingsList:
696                         if set.isPreference():
697                                 continue
698                         section = 'profile'
699                         if set.isAlteration():
700                                 section = 'alterations'
701                         if profileParser.has_option(section, set.getName()):
702                                 set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
703
704 def saveProfile(filename, allMachines = False):
705         """
706                 Save the current profile to an ini file.
707         :param filename:    The ini filename to save the profile in.
708         :param allMachines: When False only the current active profile is saved. If True all profiles for all machines are saved.
709         """
710         global settingsList
711         profileParser = ConfigParser.ConfigParser()
712         if allMachines:
713                 for set in settingsList:
714                         if set.isPreference() or set.isMachineSetting():
715                                 continue
716                         for n in xrange(0, getMachineCount()):
717                                 if set.isAlteration():
718                                         section = 'alterations_%d' % (n)
719                                 else:
720                                         section = 'profile_%d' % (n)
721                                 if not profileParser.has_section(section):
722                                         profileParser.add_section(section)
723                                 profileParser.set(section, set.getName(), set.getValue(n).encode('utf-8'))
724         else:
725                 profileParser.add_section('profile')
726                 profileParser.add_section('alterations')
727                 for set in settingsList:
728                         if set.isPreference() or set.isMachineSetting():
729                                 continue
730                         if set.isAlteration():
731                                 profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
732                         else:
733                                 profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
734
735         try:
736                 profileParser.write(open(filename, 'w'))
737         except:
738                 print "Failed to write profile file: %s" % (filename)
739
740 def resetProfile():
741         """ Reset the profile for the current machine to default. """
742         global settingsList
743         for set in settingsList:
744                 if not set.isProfile():
745                         continue
746                 set.setValue(set.getDefault())
747
748         if getMachineSetting('machine_type') == 'ultimaker':
749                 putProfileSetting('nozzle_size', '0.4')
750                 if getMachineSetting('ultimaker_extruder_upgrade') == 'True':
751                         putProfileSetting('retraction_enable', 'True')
752         elif getMachineSetting('machine_type') == 'ultimaker_plus':
753                 putProfileSetting('nozzle_size', '0.4')
754                 putProfileSetting('retraction_enable', 'True')
755         elif getMachineSetting('machine_type') == 'ultimaker2':
756                 putProfileSetting('nozzle_size', '0.4')
757                 putProfileSetting('retraction_enable', 'True')
758         else:
759                 putProfileSetting('nozzle_size', '0.5')
760                 putProfileSetting('retraction_enable', 'True')
761
762 def setProfileFromString(options):
763         """
764         Parse an encoded string which has all the profile settings stored inside of it.
765         Used in combination with getProfileString to ease sharing of profiles.
766         """
767         options = base64.b64decode(options)
768         options = zlib.decompress(options)
769         (profileOpts, alt) = options.split('\f', 1)
770         global settingsDictionary
771         for option in profileOpts.split('\b'):
772                 if len(option) > 0:
773                         (key, value) = option.split('=', 1)
774                         if key in settingsDictionary:
775                                 if settingsDictionary[key].isProfile():
776                                         settingsDictionary[key].setValue(value)
777         for option in alt.split('\b'):
778                 if len(option) > 0:
779                         (key, value) = option.split('=', 1)
780                         if key in settingsDictionary:
781                                 if settingsDictionary[key].isAlteration():
782                                         settingsDictionary[key].setValue(value)
783
784 def getProfileString():
785         """
786         Get an encoded string which contains all profile settings.
787         Used in combination with setProfileFromString to share settings in files, forums or other text based ways.
788         """
789         p = []
790         alt = []
791         global settingsList
792         for set in settingsList:
793                 if set.isProfile():
794                         if set.getName() in tempOverride:
795                                 p.append(set.getName() + "=" + tempOverride[set.getName()])
796                         else:
797                                 p.append(set.getName() + "=" + set.getValue().encode('utf-8'))
798                 elif set.isAlteration():
799                         if set.getName() in tempOverride:
800                                 alt.append(set.getName() + "=" + tempOverride[set.getName()])
801                         else:
802                                 alt.append(set.getName() + "=" + set.getValue().encode('utf-8'))
803         ret = '\b'.join(p) + '\f' + '\b'.join(alt)
804         ret = base64.b64encode(zlib.compress(ret, 9))
805         return ret
806
807 def insertNewlines(string, every=64): #This should be moved to a better place then profile.
808         lines = []
809         for i in xrange(0, len(string), every):
810                 lines.append(string[i:i+every])
811         return '\n'.join(lines)
812
813 def getPreferencesString():
814         """
815         :return: An encoded string which contains all the current preferences.
816         """
817         p = []
818         global settingsList
819         for set in settingsList:
820                 if set.isPreference():
821                         p.append(set.getName() + "=" + set.getValue().encode('utf-8'))
822         ret = '\b'.join(p)
823         ret = base64.b64encode(zlib.compress(ret, 9))
824         return ret
825
826
827 def getProfileSetting(name):
828         """
829                 Get the value of an profile setting.
830         :param name: Name of the setting to retrieve.
831         :return:     Value of the current setting.
832         """
833         if name in tempOverride:
834                 return tempOverride[name]
835         global settingsDictionary
836         if name in settingsDictionary and settingsDictionary[name].isProfile():
837                 return settingsDictionary[name].getValue()
838         traceback.print_stack()
839         sys.stderr.write('Error: "%s" not found in profile settings\n' % (name))
840         return ''
841
842 def getProfileSettingFloat(name):
843         try:
844                 setting = getProfileSetting(name).replace(',', '.')
845                 return float(eval(setting, {}, {}))
846         except:
847                 return 0.0
848
849 def putProfileSetting(name, value):
850         """ Store a certain value in a profile setting. """
851         global settingsDictionary
852         if name in settingsDictionary and settingsDictionary[name].isProfile():
853                 settingsDictionary[name].setValue(value)
854
855 def isProfileSetting(name):
856         """ Check if a certain key name is actually a profile value. """
857         global settingsDictionary
858         if name in settingsDictionary and settingsDictionary[name].isProfile():
859                 return True
860         return False
861
862 ## Preferences functions
863 def getPreferencePath():
864         """
865         :return: The full path of the preference ini file.
866         """
867         return os.path.join(getBasePath(), 'preferences.ini')
868
869 def getPreferenceFloat(name):
870         """
871         Get the float value of a preference, returns 0.0 if the preference is not a invalid float
872         """
873         try:
874                 setting = getPreference(name).replace(',', '.')
875                 return float(eval(setting, {}, {}))
876         except:
877                 return 0.0
878
879 def getPreferenceColour(name):
880         """
881         Get a preference setting value as a color array. The color is stored as #RRGGBB hex string in the setting.
882         """
883         colorString = getPreference(name)
884         return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
885
886 def loadPreferences(filename):
887         """
888         Read a configuration file as global config
889         """
890         global settingsList
891         profileParser = ConfigParser.ConfigParser()
892         try:
893                 profileParser.read(filename)
894         except ConfigParser.ParsingError:
895                 return
896
897         for set in settingsList:
898                 if set.isPreference():
899                         if profileParser.has_option('preference', set.getName()):
900                                 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
901
902         n = 0
903         while profileParser.has_section('machine_%d' % (n)):
904                 for set in settingsList:
905                         if set.isMachineSetting():
906                                 if profileParser.has_option('machine_%d' % (n), set.getName()):
907                                         set.setValue(unicode(profileParser.get('machine_%d' % (n), set.getName()), 'utf-8', 'replace'), n)
908                 n += 1
909
910         setActiveMachine(int(getPreferenceFloat('active_machine')))
911
912 def loadMachineSettings(filename):
913         global settingsList
914         #Read a configuration file as global config
915         profileParser = ConfigParser.ConfigParser()
916         try:
917                 profileParser.read(filename)
918         except ConfigParser.ParsingError:
919                 return
920
921         for set in settingsList:
922                 if set.isMachineSetting():
923                         if profileParser.has_option('machine', set.getName()):
924                                 set.setValue(unicode(profileParser.get('machine', set.getName()), 'utf-8', 'replace'))
925         checkAndUpdateMachineName()
926
927 def savePreferences(filename):
928         global settingsList
929         #Save the current profile to an ini file
930         parser = ConfigParser.ConfigParser()
931         parser.add_section('preference')
932
933         for set in settingsList:
934                 if set.isPreference():
935                         parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
936
937         n = 0
938         while getMachineSetting('machine_name', n) != '':
939                 parser.add_section('machine_%d' % (n))
940                 for set in settingsList:
941                         if set.isMachineSetting():
942                                 parser.set('machine_%d' % (n), set.getName(), set.getValue(n).encode('utf-8'))
943                 n += 1
944         try:
945                 parser.write(open(filename, 'w'))
946         except:
947                 print "Failed to write preferences file: %s" % (filename)
948
949 def getPreference(name):
950         if name in tempOverride:
951                 return tempOverride[name]
952         global settingsDictionary
953         if name in settingsDictionary and settingsDictionary[name].isPreference():
954                 return settingsDictionary[name].getValue()
955         traceback.print_stack()
956         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
957         return ''
958
959 def putPreference(name, value):
960         #Check if we have a configuration file loaded, else load the default.
961         global settingsDictionary
962         if name in settingsDictionary and settingsDictionary[name].isPreference():
963                 settingsDictionary[name].setValue(value)
964                 savePreferences(getPreferencePath())
965                 return
966         traceback.print_stack()
967         sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
968
969 def isPreference(name):
970         global settingsDictionary
971         if name in settingsDictionary and settingsDictionary[name].isPreference():
972                 return True
973         return False
974
975 def getMachineSettingFloat(name, index = None):
976         try:
977                 setting = getMachineSetting(name, index).replace(',', '.')
978                 return float(eval(setting, {}, {}))
979         except:
980                 return 0.0
981
982 def getMachineSetting(name, index = None):
983         if name in tempOverride:
984                 return tempOverride[name]
985         global settingsDictionary
986         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
987                 return settingsDictionary[name].getValue(index)
988         traceback.print_stack()
989         sys.stderr.write('Error: "%s" not found in machine settings\n' % (name))
990         return ''
991
992 def putMachineSetting(name, value, index = None):
993         #Check if we have a configuration file loaded, else load the default.
994         global settingsDictionary
995         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
996                 settingsDictionary[name].setValue(value, index)
997         savePreferences(getPreferencePath())
998
999 def isMachineSetting(name):
1000         global settingsDictionary
1001         if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
1002                 return True
1003         return False
1004
1005 def checkAndUpdateMachineName():
1006         global _selectedMachineIndex
1007         name = getMachineSetting('machine_name')
1008         index = None
1009         if name == '':
1010                 name = getMachineSetting('machine_type')
1011         for n in xrange(0, getMachineCount()):
1012                 if n == _selectedMachineIndex:
1013                         continue
1014                 if index is None:
1015                         if name == getMachineSetting('machine_name', n):
1016                                 index = 1
1017                 else:
1018                         if '%s (%d)' % (name, index) == getMachineSetting('machine_name', n):
1019                                 index += 1
1020         if index is not None:
1021                 name = '%s (%d)' % (name, index)
1022         putMachineSetting('machine_name', name)
1023         putPreference('active_machine', _selectedMachineIndex)
1024
1025 def getMachineCount():
1026         n = 0
1027         while getMachineSetting('machine_name', n) != '':
1028                 n += 1
1029         if n < 1:
1030                 return 1
1031         return n
1032
1033 def setActiveMachine(index):
1034         global _selectedMachineIndex
1035         _selectedMachineIndex = index
1036         putPreference('active_machine', _selectedMachineIndex)
1037
1038 def removeMachine(index):
1039         global _selectedMachineIndex
1040         global settingsList
1041         if getMachineCount() < 2:
1042                 return
1043         for n in xrange(index, getMachineCount()):
1044                 for setting in settingsList:
1045                         if setting.isMachineSetting():
1046                                 setting.setValue(setting.getValue(n+1), n)
1047
1048         if _selectedMachineIndex >= index:
1049                 setActiveMachine(getMachineCount() - 1)
1050
1051 ## Temp overrides for multi-extruder slicing and the project planner.
1052 tempOverride = {}
1053 def setTempOverride(name, value):
1054         tempOverride[name] = unicode(value).encode("utf-8")
1055 def clearTempOverride(name):
1056         del tempOverride[name]
1057 def resetTempOverride():
1058         tempOverride.clear()
1059
1060 #########################################################
1061 ## Utility functions to calculate common profile values
1062 #########################################################
1063 def calculateEdgeWidth():
1064         wallThickness = getProfileSettingFloat('wall_thickness')
1065         nozzleSize = getProfileSettingFloat('nozzle_size')
1066
1067         if getProfileSetting('spiralize') == 'True' or getProfileSetting('simple_mode') == 'True':
1068                 return wallThickness
1069
1070         if wallThickness < 0.01:
1071                 return nozzleSize
1072         if wallThickness < nozzleSize:
1073                 return wallThickness
1074
1075         lineCount = int(wallThickness / (nozzleSize - 0.0001))
1076         if lineCount == 0:
1077                 return nozzleSize
1078         lineWidth = wallThickness / lineCount
1079         lineWidthAlt = wallThickness / (lineCount + 1)
1080         if lineWidth > nozzleSize * 1.5:
1081                 return lineWidthAlt
1082         return lineWidth
1083
1084 def calculateLineCount():
1085         wallThickness = getProfileSettingFloat('wall_thickness')
1086         nozzleSize = getProfileSettingFloat('nozzle_size')
1087
1088         if wallThickness < 0.01:
1089                 return 0
1090         if wallThickness < nozzleSize:
1091                 return 1
1092         if getProfileSetting('spiralize') == 'True' or getProfileSetting('simple_mode') == 'True':
1093                 return 1
1094
1095         lineCount = int(wallThickness / (nozzleSize - 0.0001))
1096         if lineCount < 1:
1097                 lineCount = 1
1098         lineWidth = wallThickness / lineCount
1099         lineWidthAlt = wallThickness / (lineCount + 1)
1100         if lineWidth > nozzleSize * 1.5:
1101                 return lineCount + 1
1102         return lineCount
1103
1104 def calculateSolidLayerCount():
1105         layerHeight = getProfileSettingFloat('layer_height')
1106         solidThickness = getProfileSettingFloat('solid_layer_thickness')
1107         if layerHeight == 0.0:
1108                 return 1
1109         return int(math.ceil(solidThickness / (layerHeight - 0.0001)))
1110
1111 def calculateObjectSizeOffsets():
1112         size = 0.0
1113
1114         if getProfileSetting('platform_adhesion') == 'Brim':
1115                 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
1116         elif getProfileSetting('platform_adhesion') == 'Raft':
1117                 pass
1118         else:
1119                 if getProfileSettingFloat('skirt_line_count') > 0:
1120                         size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
1121
1122         #if getProfileSetting('enable_raft') != 'False':
1123         #       size += profile.getProfileSettingFloat('raft_margin') * 2
1124         #if getProfileSetting('support') != 'None':
1125         #       extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
1126         #       extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
1127         return [size, size]
1128
1129 def getMachineCenterCoords():
1130         if getMachineSetting('machine_center_is_zero') == 'True':
1131                 return [0, 0]
1132         elif getMachineSetting('machine_type') == 'lulzbot_mini':
1133                 return [(getMachineSettingFloat('machine_width') / 2) + 2.5, (getMachineSettingFloat('machine_width') / 2) + 0.5]
1134         return [getMachineSettingFloat('machine_width') / 2, getMachineSettingFloat('machine_depth') / 2]
1135
1136 #Returns a list of convex polygons, first polygon is the allowed area of the machine,
1137 # the rest of the polygons are the dis-allowed areas of the machine.
1138 def getMachineSizePolygons():
1139         size = numpy.array([getMachineSettingFloat('machine_width'), getMachineSettingFloat('machine_depth'), getMachineSettingFloat('machine_height')], numpy.float32)
1140         ret = []
1141         if getMachineSetting('machine_shape') == 'Circular':
1142                 # Circle platform for delta printers...
1143                 circle = []
1144                 steps = 32
1145                 for n in xrange(0, steps):
1146                         circle.append([math.cos(float(n)/steps*2*math.pi) * size[0]/2, math.sin(float(n)/steps*2*math.pi) * size[1]/2])
1147                 ret.append(numpy.array(circle, numpy.float32))
1148         else:
1149                 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))
1150
1151         if getMachineSetting('machine_type') == 'ultimaker2':
1152                 #UM2 no-go zones
1153                 w = 25
1154                 h = 10
1155                 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))
1156                 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))
1157                 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))
1158                 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))
1159         return ret
1160
1161 #returns the number of extruders minimal used. Normally this returns 1, but with dual-extrusion support material it returns 2
1162 def minimalExtruderCount():
1163         if int(getMachineSetting('extruder_amount')) < 2:
1164                 return 1
1165         if getProfileSetting('support') == 'None':
1166                 return 1
1167         if getProfileSetting('support_dual_extrusion') == 'Second extruder':
1168                 return 2
1169         return 1
1170
1171 def getGCodeExtension():
1172         if getMachineSetting('gcode_flavor') == 'BFB':
1173                 return '.bfb'
1174         return '.gcode'
1175
1176 #########################################################
1177 ## Alteration file functions
1178 #########################################################
1179 def replaceTagMatch(m):
1180         pre = m.group(1)
1181         tag = m.group(2)
1182         if tag == 'time':
1183                 return pre + time.strftime('%H:%M:%S')
1184         if tag == 'date':
1185                 return pre + time.strftime('%d-%m-%Y')
1186         if tag == 'day':
1187                 return pre + ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][int(time.strftime('%w'))]
1188         if tag == 'print_time':
1189                 return pre + '#P_TIME#'
1190         if tag == 'filament_amount':
1191                 return pre + '#F_AMNT#'
1192         if tag == 'filament_weight':
1193                 return pre + '#F_WGHT#'
1194         if tag == 'filament_cost':
1195                 return pre + '#F_COST#'
1196         if tag == 'profile_string':
1197                 return pre + 'CURA_PROFILE_STRING:%s' % (getProfileString())
1198         if pre == 'F' and tag == 'max_z_speed':
1199                 f = getProfileSettingFloat('travel_speed') * 60
1200         if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
1201                 f = getProfileSettingFloat(tag) * 60
1202         elif isProfileSetting(tag):
1203                 f = getProfileSettingFloat(tag)
1204         elif isPreference(tag):
1205                 f = getProfileSettingFloat(tag)
1206         else:
1207                 return '%s?%s?' % (pre, tag)
1208         if (f % 1) == 0:
1209                 return pre + str(int(f))
1210         return pre + str(f)
1211
1212 def replaceGCodeTags(filename, gcodeInt):
1213         f = open(filename, 'r+')
1214         data = f.read(2048)
1215         data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
1216         data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
1217         data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
1218         cost = gcodeInt.calculateCost()
1219         if cost is None:
1220                 cost = 'Unknown'
1221         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
1222         f.seek(0)
1223         f.write(data)
1224         f.close()
1225
1226 def replaceGCodeTagsFromSlicer(filename, slicerInt):
1227         f = open(filename, 'r+')
1228         data = f.read(2048)
1229         data = data.replace('#P_TIME#', ('%8.2f' % (int(slicerInt._printTimeSeconds)))[-8:])
1230         data = data.replace('#F_AMNT#', ('%8.2f' % (slicerInt._filamentMM[0]))[-8:])
1231         data = data.replace('#F_WGHT#', ('%8.2f' % (float(slicerInt.getFilamentWeight()) * 1000))[-8:])
1232         cost = slicerInt.getFilamentCost()
1233         if cost is None:
1234                 cost = 'Unknown'
1235         data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
1236         f.seek(0)
1237         f.write(data)
1238         f.close()
1239
1240 ### Get aleration raw contents. (Used internally in Cura)
1241 def getAlterationFile(filename):
1242         if filename in tempOverride:
1243                 return tempOverride[filename]
1244         global settingsDictionary
1245         if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
1246                 return settingsDictionary[filename].getValue()
1247         traceback.print_stack()
1248         sys.stderr.write('Error: "%s" not found in alteration settings\n' % (filename))
1249         return ''
1250
1251 def setAlterationFile(name, value):
1252         #Check if we have a configuration file loaded, else load the default.
1253         global settingsDictionary
1254         if name in settingsDictionary and settingsDictionary[name].isAlteration():
1255                 settingsDictionary[name].setValue(value)
1256         saveProfile(getDefaultProfilePath(), True)
1257
1258 def isTagIn(tag, contents):
1259         contents = re.sub(';[^\n]*\n', '', contents)
1260         return tag in contents
1261
1262 ### Get the alteration file for output. (Used by Skeinforge)
1263 def getAlterationFileContents(filename, extruderCount = 1):
1264         prefix = ''
1265         postfix = ''
1266         alterationContents = getAlterationFile(filename)
1267         if getMachineSetting('gcode_flavor') == 'UltiGCode':
1268                 if filename == 'end.gcode':
1269                         return 'M25 ;Stop reading from this point on.\n;CURA_PROFILE_STRING:%s\n' % (getProfileString())
1270                 return ''
1271         if filename == 'start.gcode':
1272                 if extruderCount > 1:
1273                         alterationContents = getAlterationFile("start%d.gcode" % (extruderCount))
1274                 #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.
1275                 #We also set our steps per E here, if configured.
1276                 eSteps = getMachineSettingFloat('steps_per_e')
1277                 if eSteps > 0:
1278                         prefix += 'M92 E%f\n' % (eSteps)
1279                 temp = getProfileSettingFloat('print_temperature')
1280                 bedTemp = 0
1281                 if getMachineSetting('has_heated_bed') == 'True':
1282                         bedTemp = getProfileSettingFloat('print_bed_temperature')
1283
1284                 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1285                         prefix += 'M190 S%f\n' % (bedTemp)
1286                 if temp > 0 and not isTagIn('{print_temperature}', alterationContents):
1287                         if extruderCount > 0:
1288                                 for n in xrange(1, extruderCount):
1289                                         t = temp
1290                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1291                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1292                                         prefix += 'M104 T%d S%f\n' % (n, t)
1293                                 for n in xrange(0, extruderCount):
1294                                         t = temp
1295                                         if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1296                                                 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1297                                         prefix += 'M109 T%d S%f\n' % (n, t)
1298                                 prefix += 'T0\n'
1299                         else:
1300                                 prefix += 'M109 S%f\n' % (temp)
1301         elif filename == 'end.gcode':
1302                 if extruderCount > 1:
1303                         alterationContents = getAlterationFile("end%d.gcode" % (extruderCount))
1304                 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
1305                 #postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
1306         return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'