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