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