2 The profile module contains all the settings for Cura.
3 These settings can be globally accessed and modified.
5 from __future__ import division
6 __copyright__ = "Copyright (C) 2013 David Braam - Released under terms of the AGPLv3 License"
8 import os, traceback, math, re, zlib, base64, time, sys, platform, glob, string, stat, types
9 import cPickle as pickle
11 if sys.version_info[0] < 3:
14 import configparser as ConfigParser
16 from Cura.util import resources
17 from Cura.util import version
18 from Cura.util import validators
20 #The settings dictionary contains a key/value reference to all possible settings. With the setting name as key.
21 settingsDictionary = {}
22 #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,
23 # as the dictionary will not contain insertion order.
26 #Currently selected machine (by index) Cura support multiple machines in the same preferences and can switch between them.
27 # Each machine has it's own index and unique name.
28 _selectedMachineIndex = 0
30 class setting(object):
31 #A setting object contains a configuration setting. These are globally accessible trough the quick access functions
32 # and trough the settingsDictionary function.
34 # * profile settings (settings that effect the slicing process and the print result)
35 # * preferences (settings that effect how cura works and acts)
36 # * machine settings (settings that relate to the physical configuration of your machine)
37 # * alterations (bad name copied from Skeinforge. These are the start/end code pieces)
38 # Settings have validators that check if the value is valid, but do not prevent invalid values!
39 # Settings have conditions that enable/disable this setting depending on other settings. (Ex: Dual-extrusion)
40 def __init__(self, name, default, type, category, subcategory):
44 self._default = unicode(default)
47 self._category = category
48 self._subcategory = subcategory
52 if type is types.FloatType:
53 validators.validFloat(self)
54 elif type is types.IntType:
55 validators.validInt(self)
57 global settingsDictionary
58 settingsDictionary[name] = self
60 settingsList.append(self)
62 def setLabel(self, label, tooltip = ''):
64 self._tooltip = tooltip
67 def setRange(self, minValue=None, maxValue=None):
68 if len(self._validators) < 1:
70 self._validators[0].minValue = minValue
71 self._validators[0].maxValue = maxValue
78 return _(self._tooltip)
80 def getCategory(self):
83 def getSubCategory(self):
84 return self._subcategory
86 def isPreference(self):
87 return self._category == 'preference'
89 def isMachineSetting(self):
90 return self._category == 'machine'
92 def isAlteration(self):
93 return self._category == 'alteration'
96 return not self.isAlteration() and not self.isPreference() and not self.isMachineSetting()
104 def getValue(self, index = None):
106 index = self.getValueIndex()
107 if index >= len(self._values):
109 return self._values[index]
111 def getDefault(self):
114 def setValue(self, value, index = None):
116 index = self.getValueIndex()
117 while index >= len(self._values):
118 self._values.append(self._default)
119 self._values[index] = unicode(value)
121 def getValueIndex(self):
122 if self.isMachineSetting():
123 global _selectedMachineIndex
124 return _selectedMachineIndex
128 result = validators.SUCCESS
130 for validator in self._validators:
131 res, err = validator.validate()
132 if res == validators.ERROR:
134 elif res == validators.WARNING and result != validators.ERROR:
136 if res != validators.SUCCESS:
138 return result, '\n'.join(msgs)
140 def addCondition(self, conditionFunction):
141 self._conditions.append(conditionFunction)
143 def checkConditions(self):
144 for condition in self._conditions:
149 #########################################################
151 #########################################################
153 #Define a fake _() function to fake the gettext tools in to generating strings for the profile settings.
157 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. Normal quality prints are 0.1mm, high quality is 0.06mm. You can go up to 0.25mm with an Ultimaker for very fast prints at low quality."))
158 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."))
159 setting('retraction_enable', True, bool, 'basic', _('Quality')).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."))
160 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."))
161 setting('fill_density', 20, float, 'basic', _('Fill')).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 won't affect the outside of the print and only adjusts how strong the part becomes."))
162 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."))
163 setting('print_speed', 50, float, 'basic', _('Speed and Temperature')).setRange(1).setLabel(_("Print speed (mm/s)"), _("Speed at which printing happens. A well adjusted Ultimaker can reach 150mm/s, but for good quality prints you want to print slower. Printing speed depends on a lot of factors. So you will be experimenting with optimal settings for this."))
164 setting('print_temperature', 220, int, 'basic', _('Speed and Temperature')).setRange(0,340).setLabel(_("Printing temperature (C)"), _("Temperature used for printing. Set at 0 to pre-heat yourself.\nFor PLA a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
165 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 a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
166 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 a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
167 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 a value of 210C is usually used.\nFor ABS a value of 230C or higher is required."))
168 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."))
169 setting('support', 'None', [_('None'), _('Touching buildplate'), _('Everywhere')], 'basic', _('Support')).setLabel(_("Support type"), _("Type of support structure build.\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."))
170 setting('platform_adhesion', 'None', [_('None'), _('Brim'), _('Raft')], 'basic', _('Support')).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 the recommended option.\nRaft adds a thick raster at below the object and a thin interface between this and your object.\n(Note that enabling the brim or raft disables the skirt)"))
171 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."))
172 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."))
173 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."))
174 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."))
175 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."))
176 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."))
177 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."))
178 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."))
179 setting('filament_flow', 100., float, 'basic', _('Filament')).setRange(5,300).setLabel(_("Flow (%)"), _("Flow compensation, the amount of material extruded is multiplied by this value"))
180 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."))
181 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 of 4.5mm seems to generate good results."))
182 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."))
183 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. To make sure you do not get a lot of retractions in a small area."))
184 setting('retraction_combing', True, bool, 'expert', _('Retraction')).setLabel(_("Enable combing"), _("Combing is the act of avoiding holes in the print for the head to travel over. If combing is disabled the printer head moves straight from the start point to the end point and it will always retract."))
185 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 retraction a lot on the same piece of filament which flattens the filament and causes grinding issues."))
186 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 good. This feature has a lot of positive effect on delta towers."))
187 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."))
188 setting('object_sink', 0.0, float, 'advanced', _('Quality')).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."))
189 #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."))
190 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 better together."))
191 setting('travel_speed', 150.0, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Travel speed (mm/s)"), _("Speed at which travel moves are done, a high quality build Ultimaker can reach speeds of 250mm/s. But some machines might miss steps then."))
192 setting('bottom_layer_speed', 20, float, 'advanced', _('Speed')).setRange(0.1).setLabel(_("Bottom layer speed (mm/s)"), _("Print speed for the bottom layer, you want to print the first layer slower so it sticks better to the printer bed."))
193 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, but this can negatively effect print quality."))
194 setting('inset0_speed', 0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Outser 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."))
195 setting('insetx_speed', 0.0, float, 'advanced', _('Speed')).setRange(0.0).setLabel(_("Innser 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."))
196 setting('cool_min_layer_time', 5, float, 'advanced', _('Cool')).setRange(0).setLabel(_("Minimal layer time (sec)"), _("Minimum time spend 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 spend at least this amount of seconds printing this layer."))
197 setting('fan_enabled', True, bool, 'advanced', _('Cool')).setLabel(_("Enable cooling fan"), _("Enable the cooling fan during the print. The extra cooling from the cooling fan is essential during faster prints."))
199 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."))
200 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."))
201 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."))
202 #setting('max_z_speed', 3.0, float, 'expert', _('Speed')).setRange(0.1).setLabel(_("Max Z speed (mm/s)"), _("Speed at which Z moves are done. When you Z axis is properly lubricated you can increase this for less Z blob."))
203 #setting('retract_on_jumps_only', True, bool, 'expert', _('Retraction')).setLabel(_('Retract on jumps only'), _('Only retract when we are making a move that is over a hole in the model, else retract on every move. This effects print quality in different ways.'))
204 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 linear with the fan off at layer 0."))
205 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."))
206 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%."))
207 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 slown down it will never be slower than this minimal speed."))
208 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."))
209 #setting('extra_base_wall_thickness', 0.0, float, 'expert', 'Accuracy').setRange(0).setLabel(_("Extra Wall thickness for bottom/top (mm)"), _("Additional wall thickness of the bottom and top layers."))
210 #setting('sequence', 'Loops > Perimeter > Infill', ['Loops > Perimeter > Infill', 'Loops > Infill > Perimeter', 'Infill > Loops > Perimeter', 'Infill > Perimeter > Loops', 'Perimeter > Infill > Loops', 'Perimeter > Loops > Infill'], 'expert', 'Sequence')
211 #setting('force_first_layer_sequence', True, bool, 'expert', 'Sequence').setLabel(_('Force first layer sequence'), _('This setting forces the order of the first layer to be \'Perimeter > Loops > Infill\''))
212 #setting('infill_type', 'Line', ['Line', 'Grid Circular', 'Grid Hexagonal', 'Grid Rectangular'], 'expert', _('Infill')).setLabel(_("Infill pattern"), _("Pattern of the none-solid infill. Line is default, but grids can provide a strong print."))
213 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."))
214 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."))
215 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."))
216 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 0deg being horizontal and 90deg being vertical."))
217 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."))
218 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."))
219 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."))
220 setting('spiralize', False, bool, 'expert', 'Spiralize').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."))
221 #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."))
222 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."))
223 setting('raft_margin', 5, 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 are for your print."))
224 setting('raft_line_spacing', 1.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."))
225 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."))
226 setting('raft_base_linewidth', 0.7, 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."))
227 setting('raft_interface_thickness', 0.2, 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."))
228 setting('raft_interface_linewidth', 0.2, 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."))
229 #setting('hop_on_move', False, bool, 'expert', 'Hop').setLabel(_("Enable hop on move"), _("When moving from print position to print position, raise the printer head 0.2mm so it does not knock off the print (experimental)."))
230 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 depended 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."))
231 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 depended 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."))
232 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 it 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."))
233 setting('fix_horrible_extensive_stitching', False, bool, 'expert', _('Fix horrible')).setLabel(_("Extensive stitching"), _("Extrensive 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."))
235 setting('plugin_config', '', str, 'hidden', 'hidden')
236 setting('object_center_x', -1, float, 'hidden', 'hidden')
237 setting('object_center_y', -1, float, 'hidden', 'hidden')
239 setting('start.gcode', """;Sliced at: {day} {date} {time}
240 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
241 ;Print time: {print_time}
242 ;Filament used: {filament_amount}m {filament_weight}g
243 ;Filament cost: {filament_cost}
244 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
245 ;M109 S{print_temperature} ;Uncomment to add your own temperature line
247 G90 ;absolute positioning
248 M107 ;start with the fan off
250 G28 X0 Y0 ;move X/Y to min endstops
251 G28 Z0 ;move Z to min endstops
253 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
255 G92 E0 ;zero the extruded length
256 G1 F200 E3 ;extrude 3mm of feed stock
257 G92 E0 ;zero the extruded length again
259 ;Put printing message on LCD screen
261 """, str, 'alteration', 'alteration')
262 #######################################################################################
263 setting('end.gcode', """;End GCode
264 M104 S0 ;extruder heater off
265 M140 S0 ;heated bed heater off (if you have it)
267 G91 ;relative positioning
268 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
269 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
270 G28 X0 Y0 ;move X/Y to min endstops, so the head is out of the way
273 G90 ;absolute positioning
274 """, str, 'alteration', 'alteration')
275 #######################################################################################
276 setting('start2.gcode', """;Sliced at: {day} {date} {time}
277 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
278 ;Print time: {print_time}
279 ;Filament used: {filament_amount}m {filament_weight}g
280 ;Filament cost: {filament_cost}
281 ;M190 S{print_bed_temperature} ;Uncomment to add your own bed temperature line
282 ;M104 S{print_temperature} ;Uncomment to add your own temperature line
283 ;M109 T1 S{print_temperature2} ;Uncomment to add your own temperature line
284 ;M109 T0 S{print_temperature} ;Uncomment to add your own temperature line
286 G90 ;absolute positioning
287 M107 ;start with the fan off
289 G28 X0 Y0 ;move X/Y to min endstops
290 G28 Z0 ;move Z to min endstops
292 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
294 T1 ;Switch to the 2nd extruder
295 G92 E0 ;zero the extruded length
296 G1 F200 E10 ;extrude 10mm of feed stock
297 G92 E0 ;zero the extruded length again
298 G1 F200 E-{retraction_dual_amount}
300 T0 ;Switch to the first extruder
301 G92 E0 ;zero the extruded length
302 G1 F200 E10 ;extrude 10mm of feed stock
303 G92 E0 ;zero the extruded length again
305 ;Put printing message on LCD screen
307 """, str, 'alteration', 'alteration')
308 #######################################################################################
309 setting('end2.gcode', """;End GCode
310 M104 T0 S0 ;extruder heater off
311 M104 T1 S0 ;extruder heater off
312 M140 S0 ;heated bed heater off (if you have it)
314 G91 ;relative positioning
315 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
316 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
317 G28 X0 Y0 ;move X/Y to min endstops, so the head is out of the way
320 G90 ;absolute positioning
321 """, str, 'alteration', 'alteration')
322 #######################################################################################
323 setting('support_start.gcode', '', str, 'alteration', 'alteration')
324 setting('support_end.gcode', '', str, 'alteration', 'alteration')
325 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
326 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
327 setting('replace.csv', '', str, 'alteration', 'alteration')
328 #######################################################################################
329 setting('switchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
334 G1 X{new_x} Y{new_y} Z{new_z} F{travel_speed}
337 """, str, 'alteration', 'alteration')
339 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
340 setting('oneAtATime', 'True', bool, 'preference', 'hidden')
341 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'UltimakerRobot_support.stl')), str, 'preference', 'hidden')
342 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."))
343 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."))
344 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."))
345 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."))
346 setting('check_for_updates', 'True', bool, 'preference', 'hidden').setLabel(_("Check for updates"), _("Check for newer versions of Cura on startup"))
347 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel(_("Send usage statistics"), _("Submit anonymous usage information to improve next versions of Cura"))
348 setting('youmagine_token', '', str, 'preference', 'hidden')
349 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."))
350 setting('language', 'English', str, 'preference', 'hidden').setLabel(_('Language'), _('Change the language in which Cura runs. Switching language requires a restart of Cura'))
351 setting('active_machine', '0', int, 'preference', 'hidden')
353 setting('model_colour', '#FFC924', str, 'preference', 'hidden').setLabel(_('Model colour'), _('Display color for first extruder'))
354 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel(_('Model colour (2)'), _('Display color for second extruder'))
355 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel(_('Model colour (3)'), _('Display color for third extruder'))
356 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel(_('Model colour (4)'), _('Display color for forth extruder'))
358 setting('window_maximized', 'True', bool, 'preference', 'hidden')
359 setting('window_pos_x', '-1', float, 'preference', 'hidden')
360 setting('window_pos_y', '-1', float, 'preference', 'hidden')
361 setting('window_width', '-1', float, 'preference', 'hidden')
362 setting('window_height', '-1', float, 'preference', 'hidden')
363 setting('window_normal_sash', '320', float, 'preference', 'hidden')
364 setting('last_run_version', '', str, 'preference', 'hidden')
366 setting('machine_name', '', str, 'machine', 'hidden')
367 setting('machine_type', 'unknown', str, 'machine', 'hidden') #Ultimaker, Ultimaker2, RepRap
368 setting('machine_width', '205', float, 'machine', 'hidden').setLabel(_("Maximum width (mm)"), _("Size of the machine in mm"))
369 setting('machine_depth', '205', float, 'machine', 'hidden').setLabel(_("Maximum depth (mm)"), _("Size of the machine in mm"))
370 setting('machine_height', '200', float, 'machine', 'hidden').setLabel(_("Maximum height (mm)"), _("Size of the machine in mm"))
371 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."))
372 setting('machine_shape', 'Square', ['Square','Circular'], 'machine', 'hidden').setLabel(_("Build area shape"), _("The shape of machine build area."))
373 setting('ultimaker_extruder_upgrade', 'False', bool, 'machine', 'hidden')
374 setting('has_heated_bed', 'False', bool, 'machine', 'hidden').setLabel(_("Heated bed"), _("If you have an heated bed, this enabled heated bed settings (requires restart)"))
375 setting('gcode_flavor', 'RepRap (Marlin/Sprinter)', ['RepRap (Marlin/Sprinter)', 'UltiGCode', 'MakerBot'], '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."))
376 setting('extruder_amount', '1', ['1','2','3','4'], 'machine', 'hidden').setLabel(_("Extruder count"), _("Amount of extruders in your machine."))
377 setting('extruder_offset_x1', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your secondary extruder compared to the primary."))
378 setting('extruder_offset_y1', '21.6', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your secondary extruder compared to the primary."))
379 setting('extruder_offset_x2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your tertiary extruder compared to the primary."))
380 setting('extruder_offset_y2', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your tertiary extruder compared to the primary."))
381 setting('extruder_offset_x3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset X"), _("The offset of your forth extruder compared to the primary."))
382 setting('extruder_offset_y3', '0.0', float, 'machine', 'hidden').setLabel(_("Offset Y"), _("The offset of your forth extruder compared to the primary."))
383 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."))
384 setting('serial_port', 'AUTO', str, 'machine', 'hidden').setLabel(_("Serial port"), _("Serial port to use for communication with the printer"))
385 setting('serial_port_auto', '', str, 'machine', 'hidden')
386 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"))
387 setting('serial_baud_auto', '', int, 'machine', 'hidden')
389 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. 75mm for an Ultimaker if the fan is on the left side."))
390 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. 18mm for an Ultimaker if the fan is on the left side."))
391 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. 18mm for an Ultimaker if the fan is on the left side."))
392 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. 35mm for an Ultimaker if the fan is on the left side."))
393 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. 60mm for an Ultimaker."))
395 validators.warningAbove(settingsDictionary['filament_flow'], 150, _("More flow than 150% is rare and usually not recommended."))
396 validators.warningBelow(settingsDictionary['filament_flow'], 50, _("Less flow than 50% is rare and usually not recommended."))
397 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."))
398 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
399 validators.warningAbove(settingsDictionary['print_speed'], 150.0, _("It is highly unlikely that your machine can achieve a printing speed above 150mm/s"))
400 validators.printSpeedValidator(settingsDictionary['print_speed'])
401 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
402 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
403 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
404 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, _("Temperatures above 260C could damage your machine, be careful!"))
405 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
406 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
407 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
408 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, _("Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm."))
409 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, _("It is highly unlikely that your machine can achieve a travel speed above 300mm/s"))
410 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."))
412 #Conditions for multiple extruders
413 settingsDictionary['print_temperature2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
414 settingsDictionary['print_temperature3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
415 settingsDictionary['print_temperature4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
416 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
417 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 2)
418 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 3)
419 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
420 settingsDictionary['retraction_dual_amount'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
421 settingsDictionary['wipe_tower'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
422 settingsDictionary['wipe_tower_volume'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
423 settingsDictionary['ooze_shield'].addCondition(lambda : int(getMachineSetting('extruder_amount')) > 1)
425 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('has_heated_bed') == 'True')
427 #UltiGCode uses less settings, as these settings are located inside the machine instead of gcode.
428 settingsDictionary['print_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
429 settingsDictionary['print_temperature2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
430 settingsDictionary['print_temperature3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
431 settingsDictionary['print_temperature4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
432 settingsDictionary['filament_diameter'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
433 settingsDictionary['filament_diameter2'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
434 settingsDictionary['filament_diameter3'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
435 settingsDictionary['filament_diameter4'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
436 settingsDictionary['filament_flow'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
437 settingsDictionary['print_bed_temperature'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
438 settingsDictionary['retraction_speed'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
439 settingsDictionary['retraction_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
440 settingsDictionary['retraction_dual_amount'].addCondition(lambda : getMachineSetting('gcode_flavor') != 'UltiGCode')
442 #Remove fake defined _() because later the localization will define a global _()
445 #########################################################
446 ## Profile and preferences functions
447 #########################################################
449 def getSubCategoriesFor(category):
452 for s in settingsList:
453 if s.getCategory() == category and not s.getSubCategory() in done and s.checkConditions():
454 done[s.getSubCategory()] = True
455 ret.append(s.getSubCategory())
458 def getSettingsForCategory(category, subCategory = None):
460 for s in settingsList:
461 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory) and s.checkConditions():
467 if platform.system() == "Windows":
468 basePath = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
469 #If we have a frozen python install, we need to step out of the library.zip
470 if hasattr(sys, 'frozen'):
471 basePath = os.path.normpath(os.path.join(basePath, ".."))
473 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
474 if not os.path.isdir(basePath):
475 os.makedirs(basePath)
478 def getAlternativeBasePaths():
480 basePath = os.path.normpath(os.path.join(getBasePath(), '..'))
481 for subPath in os.listdir(basePath):
482 path = os.path.join(basePath, subPath)
483 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
485 path = os.path.join(basePath, subPath, 'Cura')
486 if os.path.isdir(path) and os.path.isfile(os.path.join(path, 'preferences.ini')) and path != getBasePath():
490 def getDefaultProfilePath():
491 return os.path.join(getBasePath(), 'current_profile.ini')
493 def loadProfile(filename):
494 #Read a configuration file as global config
495 profileParser = ConfigParser.ConfigParser()
497 profileParser.read(filename)
498 except ConfigParser.ParsingError:
501 for set in settingsList:
502 if set.isPreference():
505 if set.isAlteration():
506 section = 'alterations'
507 if profileParser.has_option(section, set.getName()):
508 set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
510 def saveProfile(filename):
511 #Save the current profile to an ini file
512 profileParser = ConfigParser.ConfigParser()
513 profileParser.add_section('profile')
514 profileParser.add_section('alterations')
516 for set in settingsList:
517 if set.isPreference() or set.isMachineSetting():
519 if set.isAlteration():
520 profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
522 profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
524 profileParser.write(open(filename, 'w'))
527 #Read a configuration file as global config
529 for set in settingsList:
530 if not set.isProfile():
532 set.setValue(set.getDefault())
534 if getMachineSetting('machine_type') == 'ultimaker':
535 putProfileSetting('nozzle_size', '0.4')
536 if getMachineSetting('ultimaker_extruder_upgrade') == 'True':
537 putProfileSetting('retraction_enable', 'True')
538 elif getMachineSetting('machine_type') == 'ultimaker2':
539 putProfileSetting('nozzle_size', '0.4')
540 putProfileSetting('retraction_enable', 'True')
542 putProfileSetting('nozzle_size', '0.5')
543 putProfileSetting('retraction_enable', 'True')
545 def setProfileFromString(options):
546 options = base64.b64decode(options)
547 options = zlib.decompress(options)
548 (profileOpts, alt) = options.split('\f', 1)
549 global settingsDictionary
550 for option in profileOpts.split('\b'):
552 (key, value) = option.split('=', 1)
553 if key in settingsDictionary:
554 if settingsDictionary[key].isProfile():
555 settingsDictionary[key].setValue(value)
556 for option in alt.split('\b'):
558 (key, value) = option.split('=', 1)
559 if key in settingsDictionary:
560 if settingsDictionary[key].isAlteration():
561 settingsDictionary[key].setValue(value)
563 def getProfileString():
567 for set in settingsList:
569 if set.getName() in tempOverride:
570 p.append(set.getName() + "=" + tempOverride[set.getName()])
572 p.append(set.getName() + "=" + set.getValue())
573 elif set.isAlteration():
574 if set.getName() in tempOverride:
575 alt.append(set.getName() + "=" + tempOverride[set.getName()])
577 alt.append(set.getName() + "=" + set.getValue())
578 ret = '\b'.join(p) + '\f' + '\b'.join(alt)
579 ret = base64.b64encode(zlib.compress(ret, 9))
582 def insertNewlines(string, every=64): #This should be moved to a better place then profile.
584 for i in xrange(0, len(string), every):
585 lines.append(string[i:i+every])
586 return '\n'.join(lines)
588 def getPreferencesString():
591 for set in settingsList:
592 if set.isPreference():
593 p.append(set.getName() + "=" + set.getValue())
595 ret = base64.b64encode(zlib.compress(ret, 9))
599 def getProfileSetting(name):
600 if name in tempOverride:
601 return tempOverride[name]
602 global settingsDictionary
603 if name in settingsDictionary and settingsDictionary[name].isProfile():
604 return settingsDictionary[name].getValue()
605 traceback.print_stack()
606 sys.stderr.write('Error: "%s" not found in profile settings\n' % (name))
609 def getProfileSettingFloat(name):
611 setting = getProfileSetting(name).replace(',', '.')
612 return float(eval(setting, {}, {}))
616 def putProfileSetting(name, value):
617 #Check if we have a configuration file loaded, else load the default.
618 global settingsDictionary
619 if name in settingsDictionary and settingsDictionary[name].isProfile():
620 settingsDictionary[name].setValue(value)
622 def isProfileSetting(name):
623 global settingsDictionary
624 if name in settingsDictionary and settingsDictionary[name].isProfile():
628 ## Preferences functions
629 def getPreferencePath():
630 return os.path.join(getBasePath(), 'preferences.ini')
632 def getPreferenceFloat(name):
634 setting = getPreference(name).replace(',', '.')
635 return float(eval(setting, {}, {}))
639 def getPreferenceColour(name):
640 colorString = getPreference(name)
641 return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
643 def loadPreferences(filename):
645 #Read a configuration file as global config
646 profileParser = ConfigParser.ConfigParser()
648 profileParser.read(filename)
649 except ConfigParser.ParsingError:
652 for set in settingsList:
653 if set.isPreference():
654 if profileParser.has_option('preference', set.getName()):
655 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
658 while profileParser.has_section('machine_%d' % (n)):
659 for set in settingsList:
660 if set.isMachineSetting():
661 if profileParser.has_option('machine_%d' % (n), set.getName()):
662 set.setValue(unicode(profileParser.get('machine_%d' % (n), set.getName()), 'utf-8', 'replace'), n)
665 setActiveMachine(int(getPreferenceFloat('active_machine')))
667 def loadMachineSettings(filename):
669 #Read a configuration file as global config
670 profileParser = ConfigParser.ConfigParser()
672 profileParser.read(filename)
673 except ConfigParser.ParsingError:
676 for set in settingsList:
677 if set.isMachineSetting():
678 if profileParser.has_option('machine', set.getName()):
679 set.setValue(unicode(profileParser.get('machine', set.getName()), 'utf-8', 'replace'))
680 checkAndUpdateMachineName()
682 def savePreferences(filename):
684 #Save the current profile to an ini file
685 parser = ConfigParser.ConfigParser()
686 parser.add_section('preference')
688 for set in settingsList:
689 if set.isPreference():
690 parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
693 while getMachineSetting('machine_name', n) != '':
694 parser.add_section('machine_%d' % (n))
695 for set in settingsList:
696 if set.isMachineSetting():
697 parser.set('machine_%d' % (n), set.getName(), set.getValue(n).encode('utf-8'))
699 parser.write(open(filename, 'w'))
701 def getPreference(name):
702 if name in tempOverride:
703 return tempOverride[name]
704 global settingsDictionary
705 if name in settingsDictionary and settingsDictionary[name].isPreference():
706 return settingsDictionary[name].getValue()
707 traceback.print_stack()
708 sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
711 def putPreference(name, value):
712 #Check if we have a configuration file loaded, else load the default.
713 global settingsDictionary
714 if name in settingsDictionary and settingsDictionary[name].isPreference():
715 settingsDictionary[name].setValue(value)
716 savePreferences(getPreferencePath())
718 traceback.print_stack()
719 sys.stderr.write('Error: "%s" not found in preferences\n' % (name))
721 def isPreference(name):
722 global settingsDictionary
723 if name in settingsDictionary and settingsDictionary[name].isPreference():
727 def getMachineSettingFloat(name, index = None):
729 setting = getMachineSetting(name, index).replace(',', '.')
730 return float(eval(setting, {}, {}))
734 def getMachineSetting(name, index = None):
735 if name in tempOverride:
736 return tempOverride[name]
737 global settingsDictionary
738 if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
739 return settingsDictionary[name].getValue(index)
740 traceback.print_stack()
741 sys.stderr.write('Error: "%s" not found in machine settings\n' % (name))
744 def putMachineSetting(name, value):
745 #Check if we have a configuration file loaded, else load the default.
746 global settingsDictionary
747 if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
748 settingsDictionary[name].setValue(value)
749 savePreferences(getPreferencePath())
751 def isMachineSetting(name):
752 global settingsDictionary
753 if name in settingsDictionary and settingsDictionary[name].isMachineSetting():
757 def checkAndUpdateMachineName():
758 global _selectedMachineIndex
759 name = getMachineSetting('machine_name')
762 name = getMachineSetting('machine_type')
763 for n in xrange(0, getMachineCount()):
764 if n == _selectedMachineIndex:
767 if name == getMachineSetting('machine_name', n):
770 if '%s (%d)' % (name, index) == getMachineSetting('machine_name', n):
772 if index is not None:
773 name = '%s (%d)' % (name, index)
774 putMachineSetting('machine_name', name)
775 putPreference('active_machine', _selectedMachineIndex)
777 def getMachineCount():
779 while getMachineSetting('machine_name', n) != '':
785 def setActiveMachine(index):
786 global _selectedMachineIndex
787 _selectedMachineIndex = index
788 putPreference('active_machine', _selectedMachineIndex)
790 def removeMachine(index):
791 global _selectedMachineIndex
793 if getMachineCount() < 2:
795 for n in xrange(index, getMachineCount()):
796 for setting in settingsList:
797 if setting.isMachineSetting():
798 setting.setValue(setting.getValue(n+1), n)
800 if _selectedMachineIndex >= index:
801 setActiveMachine(getMachineCount() - 1)
803 ## Temp overrides for multi-extruder slicing and the project planner.
805 def setTempOverride(name, value):
806 tempOverride[name] = unicode(value).encode("utf-8")
807 def clearTempOverride(name):
808 del tempOverride[name]
809 def resetTempOverride():
812 #########################################################
813 ## Utility functions to calculate common profile values
814 #########################################################
815 def calculateEdgeWidth():
816 wallThickness = getProfileSettingFloat('wall_thickness')
817 nozzleSize = getProfileSettingFloat('nozzle_size')
819 if getProfileSetting('spiralize') == 'True':
822 if wallThickness < 0.01:
824 if wallThickness < nozzleSize:
827 lineCount = int(wallThickness / (nozzleSize - 0.0001))
830 lineWidth = wallThickness / lineCount
831 lineWidthAlt = wallThickness / (lineCount + 1)
832 if lineWidth > nozzleSize * 1.5:
836 def calculateLineCount():
837 wallThickness = getProfileSettingFloat('wall_thickness')
838 nozzleSize = getProfileSettingFloat('nozzle_size')
840 if wallThickness < 0.01:
842 if wallThickness < nozzleSize:
844 if getProfileSetting('spiralize') == 'True':
847 lineCount = int(wallThickness / (nozzleSize - 0.0001))
850 lineWidth = wallThickness / lineCount
851 lineWidthAlt = wallThickness / (lineCount + 1)
852 if lineWidth > nozzleSize * 1.5:
856 def calculateSolidLayerCount():
857 layerHeight = getProfileSettingFloat('layer_height')
858 solidThickness = getProfileSettingFloat('solid_layer_thickness')
859 if layerHeight == 0.0:
861 return int(math.ceil(solidThickness / (layerHeight - 0.0001)))
863 def calculateObjectSizeOffsets():
866 if getProfileSetting('platform_adhesion') == 'Brim':
867 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
868 elif getProfileSetting('platform_adhesion') == 'Raft':
871 if getProfileSettingFloat('skirt_line_count') > 0:
872 size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
874 #if getProfileSetting('enable_raft') != 'False':
875 # size += profile.getProfileSettingFloat('raft_margin') * 2
876 #if getProfileSetting('support') != 'None':
877 # extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
878 # extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
881 def getMachineCenterCoords():
882 if getMachineSetting('machine_center_is_zero') == 'True':
884 return [getMachineSettingFloat('machine_width') / 2, getMachineSettingFloat('machine_depth') / 2]
886 #Returns a list of convex polygons, first polygon is the allowed area of the machine,
887 # the rest of the polygons are the dis-allowed areas of the machine.
888 def getMachineSizePolygons():
889 size = numpy.array([getMachineSettingFloat('machine_width'), getMachineSettingFloat('machine_depth'), getMachineSettingFloat('machine_height')], numpy.float32)
891 if getMachineSetting('machine_shape') == 'Circular':
892 # Circle platform for delta printers...
895 for n in xrange(0, steps):
896 circle.append([math.cos(float(n)/steps*2*math.pi) * size[0]/2, math.sin(float(n)/steps*2*math.pi) * size[1]/2])
897 ret.append(numpy.array(circle, numpy.float32))
899 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))
901 if getMachineSetting('machine_type') == 'ultimaker2':
905 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))
906 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))
907 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))
908 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))
911 #returns the number of extruders minimal used. Normally this returns 1, but with dual-extrusion support material it returns 2
912 def minimalExtruderCount():
913 if int(getMachineSetting('extruder_amount')) < 2:
915 if getProfileSetting('support') == 'None':
917 if getProfileSetting('support_dual_extrusion') == 'Second extruder':
921 #########################################################
922 ## Alteration file functions
923 #########################################################
924 def replaceTagMatch(m):
928 return pre + time.strftime('%H:%M:%S')
930 return pre + time.strftime('%d-%m-%Y')
932 return pre + ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'][int(time.strftime('%w'))]
933 if tag == 'print_time':
934 return pre + '#P_TIME#'
935 if tag == 'filament_amount':
936 return pre + '#F_AMNT#'
937 if tag == 'filament_weight':
938 return pre + '#F_WGHT#'
939 if tag == 'filament_cost':
940 return pre + '#F_COST#'
941 if pre == 'F' and tag == 'max_z_speed':
942 f = getProfileSettingFloat('travel_speed') * 60
943 if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
944 f = getProfileSettingFloat(tag) * 60
945 elif isProfileSetting(tag):
946 f = getProfileSettingFloat(tag)
947 elif isPreference(tag):
948 f = getProfileSettingFloat(tag)
950 return '%s?%s?' % (pre, tag)
952 return pre + str(int(f))
955 def replaceGCodeTags(filename, gcodeInt):
956 f = open(filename, 'r+')
958 data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
959 data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
960 data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
961 cost = gcodeInt.calculateCost()
964 data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
969 def replaceGCodeTagsFromSlicer(filename, slicerInt):
970 f = open(filename, 'r+')
972 data = data.replace('#P_TIME#', ('%8.2f' % (int(slicerInt._printTimeSeconds)))[-8:])
973 data = data.replace('#F_AMNT#', ('%8.2f' % (slicerInt._filamentMM[0]))[-8:])
974 data = data.replace('#F_WGHT#', ('%8.2f' % (float(slicerInt.getFilamentWeight()) * 1000))[-8:])
975 cost = slicerInt.getFilamentCost()
978 data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
983 ### Get aleration raw contents. (Used internally in Cura)
984 def getAlterationFile(filename):
985 if filename in tempOverride:
986 return tempOverride[filename]
987 global settingsDictionary
988 if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
989 return settingsDictionary[filename].getValue()
990 traceback.print_stack()
991 sys.stderr.write('Error: "%s" not found in alteration settings\n' % (filename))
994 def setAlterationFile(name, value):
995 #Check if we have a configuration file loaded, else load the default.
996 global settingsDictionary
997 if name in settingsDictionary and settingsDictionary[name].isAlteration():
998 settingsDictionary[name].setValue(value)
999 saveProfile(getDefaultProfilePath())
1001 def isTagIn(tag, contents):
1002 contents = re.sub(';[^\n]*\n', '', contents)
1003 return tag in contents
1005 ### Get the alteration file for output. (Used by Skeinforge)
1006 def getAlterationFileContents(filename, extruderCount = 1):
1009 alterationContents = getAlterationFile(filename)
1010 if getMachineSetting('gcode_flavor') == 'UltiGCode':
1011 if filename == 'end.gcode':
1012 return 'M25 ;Stop reading from this point on.\n;CURA_PROFILE_STRING:%s\n' % (getProfileString())
1014 if filename == 'start.gcode':
1015 if extruderCount > 1:
1016 alterationContents = getAlterationFile("start%d.gcode" % (extruderCount))
1017 #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.
1018 #We also set our steps per E here, if configured.
1019 eSteps = getMachineSettingFloat('steps_per_e')
1021 prefix += 'M92 E%f\n' % (eSteps)
1022 temp = getProfileSettingFloat('print_temperature')
1024 if getMachineSetting('has_heated_bed') == 'True':
1025 bedTemp = getProfileSettingFloat('print_bed_temperature')
1027 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1028 prefix += 'M140 S%f\n' % (bedTemp)
1029 if temp > 0 and not isTagIn('{print_temperature}', alterationContents):
1030 if extruderCount > 0:
1031 for n in xrange(1, extruderCount):
1033 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1034 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1035 prefix += 'M104 T%d S%f\n' % (n, t)
1036 for n in xrange(0, extruderCount):
1038 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
1039 t = getProfileSettingFloat('print_temperature%d' % (n+1))
1040 prefix += 'M109 T%d S%f\n' % (n, t)
1043 prefix += 'M109 S%f\n' % (temp)
1044 if bedTemp > 0 and not isTagIn('{print_bed_temperature}', alterationContents):
1045 prefix += 'M190 S%f\n' % (bedTemp)
1046 elif filename == 'end.gcode':
1047 if extruderCount > 1:
1048 alterationContents = getAlterationFile("end%d.gcode" % (extruderCount))
1049 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
1050 postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
1051 return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'
1055 def getPluginConfig():
1057 return pickle.loads(str(getProfileSetting('plugin_config')))
1061 def setPluginConfig(config):
1062 putProfileSetting('plugin_config', pickle.dumps(config))
1064 def getPluginBasePaths():
1066 if platform.system() != "Windows":
1067 ret.append(os.path.expanduser('~/.cura/plugins/'))
1068 if platform.system() == "Darwin" and hasattr(sys, 'frozen'):
1069 ret.append(os.path.normpath(os.path.join(resources.resourceBasePath, "Cura/plugins")))
1071 ret.append(os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'plugins')))
1074 def getPluginList():
1076 for basePath in getPluginBasePaths():
1077 for filename in glob.glob(os.path.join(basePath, '*.py')):
1078 filename = os.path.basename(filename)
1079 if filename.startswith('_'):
1081 with open(os.path.join(basePath, filename), "r") as f:
1082 item = {'filename': filename, 'name': None, 'info': None, 'type': None, 'params': []}
1085 if not line.startswith('#'):
1087 line = line[1:].split(':', 1)
1090 if line[0].upper() == 'NAME':
1091 item['name'] = line[1].strip()
1092 elif line[0].upper() == 'INFO':
1093 item['info'] = line[1].strip()
1094 elif line[0].upper() == 'TYPE':
1095 item['type'] = line[1].strip()
1096 elif line[0].upper() == 'DEPEND':
1098 elif line[0].upper() == 'PARAM':
1099 m = re.match('([a-zA-Z][a-zA-Z0-9_]*)\(([a-zA-Z_]*)(?::([^\)]*))?\) +(.*)', line[1].strip())
1101 item['params'].append({'name': m.group(1), 'type': m.group(2), 'default': m.group(3), 'description': m.group(4)})
1103 print "Unknown item in effect meta data: %s %s" % (line[0], line[1])
1104 if item['name'] is not None and item['type'] == 'postprocess':
1108 def runPostProcessingPlugins(gcodefilename):
1109 pluginConfigList = getPluginConfig()
1110 pluginList = getPluginList()
1112 for pluginConfig in pluginConfigList:
1114 for pluginTest in pluginList:
1115 if pluginTest['filename'] == pluginConfig['filename']:
1121 for basePath in getPluginBasePaths():
1122 testFilename = os.path.join(basePath, pluginConfig['filename'])
1123 if os.path.isfile(testFilename):
1124 pythonFile = testFilename
1125 if pythonFile is None:
1128 locals = {'filename': gcodefilename}
1129 for param in plugin['params']:
1130 value = param['default']
1131 if param['name'] in pluginConfig['params']:
1132 value = pluginConfig['params'][param['name']]
1134 if param['type'] == 'float':
1136 value = float(value)
1138 value = float(param['default'])
1140 locals[param['name']] = value
1142 execfile(pythonFile, locals)
1144 locationInfo = traceback.extract_tb(sys.exc_info()[2])[-1]
1145 return "%s: '%s' @ %s:%s:%d" % (str(sys.exc_info()[0].__name__), str(sys.exc_info()[1]), os.path.basename(locationInfo[0]), locationInfo[2], locationInfo[1])