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