1 from __future__ import absolute_import
2 from __future__ import division
3 __copyright__ = "Copyright (C) 2013 David Braam - Released under terms of the AGPLv3 License"
5 import os, traceback, math, re, zlib, base64, time, sys, platform, glob, string, stat, types
6 import cPickle as pickle
7 if sys.version_info[0] < 3:
10 import configparser as ConfigParser
12 from Cura.util import resources
13 from Cura.util import version
14 from Cura.util import validators
16 settingsDictionary = {}
18 class setting(object):
19 def __init__(self, name, default, type, category, subcategory):
23 self._default = unicode(default)
24 self._value = self._default
26 self._category = category
27 self._subcategory = subcategory
31 if type is types.FloatType:
32 validators.validFloat(self)
33 elif type is types.IntType:
34 validators.validInt(self)
36 global settingsDictionary
37 settingsDictionary[name] = self
39 settingsList.append(self)
41 def setLabel(self, label, tooltip = ''):
43 self._tooltip = tooltip
46 def setRange(self, minValue = None, maxValue = None):
47 if len(self._validators) < 1:
49 self._validators[0].minValue = minValue
50 self._validators[0].maxValue = maxValue
59 def getCategory(self):
62 def getSubCategory(self):
63 return self._subcategory
65 def isPreference(self):
66 return self._category == 'preference'
68 def isAlteration(self):
69 return self._category == 'alteration'
72 return not self.isAlteration() and not self.isPreference()
86 def setValue(self, value):
87 self._value = unicode(value)
90 result = validators.SUCCESS
92 for validator in self._validators:
93 res, err = validator.validate()
94 if res == validators.ERROR:
96 elif res == validators.WARNING and result != validators.ERROR:
98 if res != validators.SUCCESS:
100 return result, '\n'.join(msgs)
102 def addCondition(self, conditionFunction):
103 self._conditions.append(conditionFunction)
105 def checkConditions(self):
106 for condition in self._conditions:
111 #########################################################
113 #########################################################
114 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 determen 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.')
115 setting('wall_thickness', 0.8, float, 'basic', 'Quality').setRange(0.0001).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.')
116 setting('retraction_enable', False, 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.')
117 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 multiply of the layer thickness makes sense. And keep it near your wall thickness to make an evenly strong part.')
118 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 effect the outside of the print and only adjusts how strong the part becomes.')
119 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.')
120 setting('print_speed', 50, float, 'basic', 'Speed & 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.')
121 setting('print_temperature', 220, int, 'basic', 'Speed & 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.')
122 setting('print_temperature2', 0, int, 'basic', 'Speed & 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.')
123 setting('print_temperature3', 0, int, 'basic', 'Speed & 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.')
124 setting('print_temperature4', 0, int, 'basic', 'Speed & 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.')
125 setting('print_bed_temperature', 70, int, 'basic', 'Speed & Temperature').setRange(0,340).setLabel('Bed temperature (C)', 'Temperature used for the heated printer bed. Set at 0 to pre-heat yourself.')
126 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.')
127 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)')
128 setting('support_dual_extrusion', False, bool, 'basic', 'Support').setLabel('Support dual extrusion', 'Print the support material with the 2nd extruder in a dual extrusion setup. The primary extruder will be used for normal material, while the second extruder is used to print support material.')
129 setting('filament_diameter', 2.89, 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.')
130 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.')
131 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.')
132 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.')
133 setting('filament_flow', 100., float, 'basic', 'Filament').setRange(1,300).setLabel('Flow (%)', 'Flow compensation, the amount of material extruded is multiplied by this value')
134 #setting('retraction_min_travel', 5.0, float, 'advanced', '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')
135 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.')
136 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 2.0mm seems to generate good results.')
137 #setting('retraction_extra', 0.0, float, 'advanced', 'Retraction').setRange(0).setLabel('Extra length on start (mm)', 'Extra extrusion amount when restarting after a retraction, to better "Prime" your extruder after retraction.')
138 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.')
139 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.')
140 #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.')
141 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.')
142 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.')
143 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..')
144 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.')
145 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.')
147 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.')
148 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.')
149 #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.')
150 #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.')
151 setting('fan_layer', 1, int, 'expert', 'Cool').setRange(0).setLabel('Fan on layer number', 'The layer at which the fan is turned on. The first layer is layer 0. The first layer can stick better if you turn on the fan on, on the 2nd layer.')
152 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.')
153 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%.')
154 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.')
155 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.')
156 #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.')
157 #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')
158 #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\'')
159 #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.')
160 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.')
161 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.')
162 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.')
163 setting('support_rate', 75, int, 'expert', 'Support').setRange(0,100).setLabel('Material amount (%)', 'Amount of material used for support, less material gives a weaker support structure which is easier to remove.')
164 #setting('support_distance', 0.5, float, 'expert', 'Support').setRange(0).setLabel('Distance from object (mm)', 'Distance between the support structure and the object. Empty gap in which no support structure is printed.')
165 #setting('joris', False, bool, 'expert', 'Joris').setLabel('Spiralize the outer contour', '[Joris] is a code name for smoothing out the Z move of the outer edge. This will create a steady Z increase over the whole print. It is intended to be used with a single walled wall thickness to make cups/vases.')
166 #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.')
167 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.')
168 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.')
169 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.')
170 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.')
171 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.')
172 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.')
173 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.')
174 #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).')
175 setting('fix_horrible_union_all_type_a', False, 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.')
176 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.')
177 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.')
178 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.')
180 setting('plugin_config', '', str, 'hidden', 'hidden')
181 setting('object_center_x', -1, float, 'hidden', 'hidden')
182 setting('object_center_y', -1, float, 'hidden', 'hidden')
184 setting('start.gcode', """;Sliced at: {day} {date} {time}
185 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
186 ;Print time: {print_time}
187 ;Filament used: {filament_amount}m {filament_weight}g
188 ;Filament cost: {filament_cost}
190 G90 ;absolute positioning
191 M107 ;start with the fan off
193 G28 X0 Y0 ;move X/Y to min endstops
194 G28 Z0 ;move Z to min endstops
196 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
198 G92 E0 ;zero the extruded length
199 G1 F200 E3 ;extrude 3mm of feed stock
200 G92 E0 ;zero the extruded length again
203 """, str, 'alteration', 'alteration')
204 #######################################################################################
205 setting('end.gcode', """;End GCode
206 M104 S0 ;extruder heater off
207 M140 S0 ;heated bed heater off (if you have it)
209 G91 ;relative positioning
210 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
211 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
212 G28 X0 Y0 ;move X/Y to min endstops, so the head is out of the way
215 G90 ;absolute positioning
216 """, str, 'alteration', 'alteration')
217 #######################################################################################
218 setting('support_start.gcode', '', str, 'alteration', 'alteration')
219 setting('support_end.gcode', '', str, 'alteration', 'alteration')
220 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
221 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
222 setting('replace.csv', '', str, 'alteration', 'alteration')
223 #######################################################################################
224 setting('nextobject.gcode', """;Move to next object on the platform. clear_z is the minimal z height we need to make sure we do not hit any objects.
227 G91 ;relative positioning
228 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
229 G1 Z+0.5 E-5 F{travel_speed} ;move Z up a bit and retract filament even more
230 G90 ;absolute positioning
232 G1 Z{clear_z} F{max_z_speed}
234 G1 X{object_center_x} Y{object_center_y} F{travel_speed}
237 """, str, 'alteration', 'alteration')
238 #######################################################################################
239 setting('switchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
244 G1 X{new_x} Y{new_y} Z{new_z} F{travel_speed}
247 """, str, 'alteration', 'alteration')
249 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
250 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'UltimakerRobot_support.stl')), str, 'preference', 'hidden')
251 setting('machine_width', '205', float, 'preference', 'hidden').setLabel('Maximum width (mm)', 'Size of the machine in mm')
252 setting('machine_depth', '205', float, 'preference', 'hidden').setLabel('Maximum depth (mm)', 'Size of the machine in mm')
253 setting('machine_height', '200', float, 'preference', 'hidden').setLabel('Maximum height (mm)', 'Size of the machine in mm')
254 setting('machine_type', 'unknown', str, 'preference', 'hidden')
255 setting('machine_center_is_zero', 'False', bool, 'preference', 'hidden')
256 setting('ultimaker_extruder_upgrade', 'False', bool, 'preference', 'hidden')
257 setting('has_heated_bed', 'False', bool, 'preference', 'hidden').setLabel('Heated bed', 'If you have an heated bed, this enabled heated bed settings (requires restart)')
258 setting('reprap_name', 'RepRap', str, 'preference', 'hidden')
259 setting('extruder_amount', '1', ['1','2','3','4'], 'preference', 'hidden').setLabel('Extruder count', 'Amount of extruders in your machine.')
260 setting('extruder_offset_x1', '-21.6', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
261 setting('extruder_offset_y1', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
262 setting('extruder_offset_x2', '0.0', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
263 setting('extruder_offset_y2', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
264 setting('extruder_offset_x3', '0.0', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
265 setting('extruder_offset_y3', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
266 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.')
267 setting('steps_per_e', '0', float, 'preference', 'hidden').setLabel('E-Steps per 1mm filament', 'Amount of steps per mm filament extrusion')
268 setting('serial_port', 'AUTO', str, 'preference', 'hidden').setLabel('Serial port', 'Serial port to use for communication with the printer')
269 setting('serial_port_auto', '', str, 'preference', 'hidden')
270 setting('serial_baud', 'AUTO', str, 'preference', 'hidden').setLabel('Baudrate', 'Speed of the serial port communication\nNeeds to match your firmware settings\nCommon values are 250000, 115200, 57600')
271 setting('serial_baud_auto', '', int, 'preference', 'hidden')
272 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.')
273 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.')
274 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.')
275 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.')
276 setting('check_for_updates', 'True', bool, 'preference', 'hidden').setLabel('Check for updates', 'Check for newer versions of Cura on startup')
277 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel('Send usage statistics', 'Submit anonymous usage information to improve next versions of Cura')
279 setting('extruder_head_size_min_x', '0.0', float, 'preference', '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.')
280 setting('extruder_head_size_min_y', '0.0', float, 'preference', '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.')
281 setting('extruder_head_size_max_x', '0.0', float, 'preference', '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.')
282 setting('extruder_head_size_max_y', '0.0', float, 'preference', '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.')
283 setting('extruder_head_size_height', '0.0', float, 'preference', '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. XXmm for an Ultimaker.')
285 setting('model_colour', '#7AB645', str, 'preference', 'hidden').setLabel('Model colour')
286 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel('Model colour (2)')
287 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel('Model colour (3)')
288 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel('Model colour (4)')
290 setting('window_maximized', 'True', bool, 'preference', 'hidden')
291 setting('window_pos_x', '-1', float, 'preference', 'hidden')
292 setting('window_pos_y', '-1', float, 'preference', 'hidden')
293 setting('window_width', '-1', float, 'preference', 'hidden')
294 setting('window_height', '-1', float, 'preference', 'hidden')
295 setting('window_normal_sash', '320', float, 'preference', 'hidden')
297 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.")
298 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
299 validators.warningAbove(settingsDictionary['print_speed'], 150.0, "It is highly unlikely that your machine can achieve a printing speed above 150mm/s")
300 validators.printSpeedValidator(settingsDictionary['print_speed'])
301 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
302 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
303 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
304 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
305 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
306 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
307 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
308 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
309 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, "It is highly unlikely that your machine can achieve a travel speed above 300mm/s")
310 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.")
312 #Conditions for multiple extruders
313 settingsDictionary['print_temperature2'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
314 settingsDictionary['print_temperature3'].addCondition(lambda : int(getPreference('extruder_amount')) > 2)
315 settingsDictionary['print_temperature4'].addCondition(lambda : int(getPreference('extruder_amount')) > 3)
316 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
317 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getPreference('extruder_amount')) > 2)
318 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getPreference('extruder_amount')) > 3)
319 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
321 settingsDictionary['print_bed_temperature'].addCondition(lambda : getPreference('has_heated_bed') == 'True')
323 #########################################################
324 ## Profile and preferences functions
325 #########################################################
327 def getSubCategoriesFor(category):
330 for s in settingsList:
331 if s.getCategory() == category and not s.getSubCategory() in done:
332 done[s.getSubCategory()] = True
333 ret.append(s.getSubCategory())
336 def getSettingsForCategory(category, subCategory = None):
338 for s in settingsList:
339 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory):
345 if platform.system() == "Windows":
346 basePath = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
347 #If we have a frozen python install, we need to step out of the library.zip
348 if hasattr(sys, 'frozen'):
349 basePath = os.path.normpath(os.path.join(basePath, ".."))
351 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
352 if not os.path.isdir(basePath):
353 os.makedirs(basePath)
356 def getDefaultProfilePath():
357 return os.path.join(getBasePath(), 'current_profile.ini')
359 def loadProfile(filename):
360 #Read a configuration file as global config
361 profileParser = ConfigParser.ConfigParser()
363 profileParser.read(filename)
364 except ConfigParser.ParsingError:
367 for set in settingsList:
368 if set.isPreference():
371 if set.isAlteration():
372 section = 'alterations'
373 if profileParser.has_option(section, set.getName()):
374 set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
376 def saveProfile(filename):
377 #Save the current profile to an ini file
378 profileParser = ConfigParser.ConfigParser()
379 profileParser.add_section('profile')
380 profileParser.add_section('alterations')
382 for set in settingsList:
383 if set.isPreference():
385 if set.isAlteration():
386 profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
388 profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
390 profileParser.write(open(filename, 'w'))
393 #Read a configuration file as global config
395 for set in settingsList:
396 if set.isPreference():
398 set.setValue(set.getDefault())
400 if getPreference('machine_type') == 'ultimaker':
401 putProfileSetting('nozzle_size', '0.4')
402 if getPreference('ultimaker_extruder_upgrade') == 'True':
403 putProfileSetting('retraction_enable', 'True')
405 putProfileSetting('nozzle_size', '0.5')
407 def loadProfileFromString(options):
408 options = base64.b64decode(options)
409 options = zlib.decompress(options)
410 (profileOpts, alt) = options.split('\f', 1)
411 global settingsDictionary
412 for option in profileOpts.split('\b'):
414 (key, value) = option.split('=', 1)
415 if key in settingsDictionary:
416 if settingsDictionary[key].isProfile():
417 settingsDictionary[key].setValue(value)
418 for option in alt.split('\b'):
420 (key, value) = option.split('=', 1)
421 if key in settingsDictionary:
422 if settingsDictionary[key].isAlteration():
423 settingsDictionary[key].setValue(value)
425 def getProfileString():
429 for set in settingsList:
431 if set.getName() in tempOverride:
432 p.append(set.getName() + "=" + tempOverride[set.getName()])
434 p.append(set.getName() + "=" + set.getValue())
435 if set.isAlteration():
436 if set.getName() in tempOverride:
437 alt.append(set.getName() + "=" + tempOverride[set.getName()])
439 alt.append(set.getName() + "=" + set.getValue())
440 ret = '\b'.join(p) + '\f' + '\b'.join(alt)
441 ret = base64.b64encode(zlib.compress(ret, 9))
444 def getGlobalPreferencesString():
447 for set in settingsList:
448 if set.isPreference():
449 p.append(set.getName() + "=" + set.getValue())
451 ret = base64.b64encode(zlib.compress(ret, 9))
455 def getProfileSetting(name):
456 if name in tempOverride:
457 return tempOverride[name]
458 global settingsDictionary
459 if name in settingsDictionary and settingsDictionary[name].isProfile():
460 return settingsDictionary[name].getValue()
461 print 'Error: "%s" not found in profile settings' % (name)
464 def getProfileSettingFloat(name):
466 setting = getProfileSetting(name).replace(',', '.')
467 return float(eval(setting, {}, {}))
471 def putProfileSetting(name, value):
472 #Check if we have a configuration file loaded, else load the default.
473 global settingsDictionary
474 if name in settingsDictionary and settingsDictionary[name].isProfile():
475 settingsDictionary[name].setValue(value)
477 def isProfileSetting(name):
478 global settingsDictionary
479 if name in settingsDictionary and settingsDictionary[name].isProfile():
483 ## Preferences functions
484 def getPreferencePath():
485 return os.path.join(getBasePath(), 'preferences.ini')
487 def getPreferenceFloat(name):
489 setting = getPreference(name).replace(',', '.')
490 return float(eval(setting, {}, {}))
494 def getPreferenceColour(name):
495 colorString = getPreference(name)
496 return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
498 def loadPreferences(filename):
499 #Read a configuration file as global config
500 profileParser = ConfigParser.ConfigParser()
502 profileParser.read(filename)
503 except ConfigParser.ParsingError:
506 for set in settingsList:
507 if set.isPreference():
508 if profileParser.has_option('preference', set.getName()):
509 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
511 def savePreferences(filename):
512 #Save the current profile to an ini file
513 parser = ConfigParser.ConfigParser()
514 parser.add_section('preference')
516 for set in settingsList:
517 if set.isPreference():
518 parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
519 parser.write(open(filename, 'w'))
521 def getPreference(name):
522 if name in tempOverride:
523 return tempOverride[name]
524 global settingsDictionary
525 if name in settingsDictionary and settingsDictionary[name].isPreference():
526 return settingsDictionary[name].getValue()
527 print 'Error: "%s" not found in profile settings' % (name)
530 def putPreference(name, value):
531 #Check if we have a configuration file loaded, else load the default.
532 global settingsDictionary
533 if name in settingsDictionary and settingsDictionary[name].isPreference():
534 settingsDictionary[name].setValue(value)
535 savePreferences(getPreferencePath())
537 def isPreference(name):
538 global settingsDictionary
539 if name in settingsDictionary and settingsDictionary[name].isPreference():
543 ## Temp overrides for multi-extruder slicing and the project planner.
545 def setTempOverride(name, value):
546 tempOverride[name] = unicode(value).encode("utf-8")
547 def clearTempOverride(name):
548 del tempOverride[name]
549 def resetTempOverride():
552 #########################################################
553 ## Utility functions to calculate common profile values
554 #########################################################
555 def calculateEdgeWidth():
556 wallThickness = getProfileSettingFloat('wall_thickness')
557 nozzleSize = getProfileSettingFloat('nozzle_size')
559 if wallThickness < 0.01:
561 if wallThickness < nozzleSize:
564 lineCount = int(wallThickness / nozzleSize + 0.0001)
565 lineWidth = wallThickness / lineCount
566 lineWidthAlt = wallThickness / (lineCount + 1)
567 if lineWidth > nozzleSize * 1.5:
571 def calculateLineCount():
572 wallThickness = getProfileSettingFloat('wall_thickness')
573 nozzleSize = getProfileSettingFloat('nozzle_size')
575 if wallThickness < nozzleSize:
578 lineCount = int(wallThickness / nozzleSize + 0.0001)
579 lineWidth = wallThickness / lineCount
580 lineWidthAlt = wallThickness / (lineCount + 1)
581 if lineWidth > nozzleSize * 1.5:
585 def calculateSolidLayerCount():
586 layerHeight = getProfileSettingFloat('layer_height')
587 solidThickness = getProfileSettingFloat('solid_layer_thickness')
588 if layerHeight == 0.0:
590 return int(math.ceil(solidThickness / layerHeight - 0.0001))
592 def calculateObjectSizeOffsets():
595 if getProfileSetting('platform_adhesion') == 'Brim':
596 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
597 elif getProfileSetting('platform_adhesion') == 'Raft':
600 if getProfileSettingFloat('skirt_line_count') > 0:
601 size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
603 #if getProfileSetting('enable_raft') != 'False':
604 # size += profile.getProfileSettingFloat('raft_margin') * 2
605 #if getProfileSetting('support') != 'None':
606 # extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
607 # extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
610 def getMachineCenterCoords():
611 if getPreference('machine_center_is_zero') == 'True':
613 return [getPreferenceFloat('machine_width') / 2, getPreferenceFloat('machine_depth') / 2]
615 #########################################################
616 ## Alteration file functions
617 #########################################################
618 def replaceTagMatch(m):
622 return pre + time.strftime('%H:%M:%S').encode('utf-8', 'replace')
624 return pre + time.strftime('%d %b %Y').encode('utf-8', 'replace')
626 return pre + time.strftime('%a').encode('utf-8', 'replace')
627 if tag == 'print_time':
628 return pre + '#P_TIME#'
629 if tag == 'filament_amount':
630 return pre + '#F_AMNT#'
631 if tag == 'filament_weight':
632 return pre + '#F_WGHT#'
633 if tag == 'filament_cost':
634 return pre + '#F_COST#'
635 if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'max_z_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
636 f = getProfileSettingFloat(tag) * 60
637 elif isProfileSetting(tag):
638 f = getProfileSettingFloat(tag)
639 elif isPreference(tag):
640 f = getProfileSettingFloat(tag)
642 return '%s?%s?' % (pre, tag)
644 return pre + str(int(f))
647 def replaceGCodeTags(filename, gcodeInt):
648 f = open(filename, 'r+')
650 data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
651 data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
652 data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
653 cost = gcodeInt.calculateCost()
656 data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
661 ### Get aleration raw contents. (Used internally in Cura)
662 def getAlterationFile(filename):
663 if filename in tempOverride:
664 return tempOverride[filename]
665 global settingsDictionary
666 if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
667 return settingsDictionary[filename].getValue()
668 print 'Error: "%s" not found in profile settings' % (filename)
671 def setAlterationFile(name, value):
672 #Check if we have a configuration file loaded, else load the default.
673 global settingsDictionary
674 if name in settingsDictionary and settingsDictionary[name].isAlteration():
675 settingsDictionary[name].setValue(value)
676 saveProfile(getDefaultProfilePath())
678 ### Get the alteration file for output. (Used by Skeinforge)
679 def getAlterationFileContents(filename, extruderCount = 1):
682 alterationContents = getAlterationFile(filename)
683 if filename == 'start.gcode':
684 #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.
685 #We also set our steps per E here, if configured.
686 eSteps = getPreferenceFloat('steps_per_e')
688 prefix += 'M92 E%f\n' % (eSteps)
689 temp = getProfileSettingFloat('print_temperature')
691 if getPreference('has_heated_bed') == 'True':
692 bedTemp = getProfileSettingFloat('print_bed_temperature')
694 if bedTemp > 0 and not '{print_bed_temperature}' in alterationContents:
695 prefix += 'M140 S%f\n' % (bedTemp)
696 if temp > 0 and not '{print_temperature}' in alterationContents:
697 if extruderCount > 0:
698 for n in xrange(1, extruderCount):
700 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
701 t = getProfileSettingFloat('print_temperature%d' % (n+1))
702 prefix += 'M104 T%d S%f\n' % (n, t)
703 for n in xrange(0, extruderCount):
705 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
706 t = getProfileSettingFloat('print_temperature%d' % (n+1))
707 prefix += 'M109 T%d S%f\n' % (n, t)
710 prefix += 'M109 S%f\n' % (temp)
711 if bedTemp > 0 and not '{print_bed_temperature}' in alterationContents:
712 prefix += 'M190 S%f\n' % (bedTemp)
713 elif filename == 'end.gcode':
714 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
715 postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
716 elif filename == 'replace.csv':
717 #Always remove the extruder on/off M codes. These are no longer needed in 5D printing.
718 prefix = 'M101\nM103\n'
719 elif filename == 'support_start.gcode' or filename == 'support_end.gcode':
720 #Add support start/end code
721 if getProfileSetting('support_dual_extrusion') == 'True' and int(getPreference('extruder_amount')) > 1:
722 if filename == 'support_start.gcode':
723 setTempOverride('extruder', '1')
725 setTempOverride('extruder', '0')
726 alterationContents = getAlterationFileContents('switchExtruder.gcode')
727 clearTempOverride('extruder')
729 alterationContents = ''
730 return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'
734 def getPluginConfig():
736 return pickle.loads(getProfileSetting('plugin_config'))
740 def setPluginConfig(config):
741 putProfileSetting('plugin_config', pickle.dumps(config))
743 def getPluginBasePaths():
745 if platform.system() != "Windows":
746 ret.append(os.path.expanduser('~/.cura/plugins/'))
747 if platform.system() == "Darwin" and hasattr(sys, 'frozen'):
748 ret.append(os.path.normpath(os.path.join(resources.resourceBasePath, "Cura/plugins")))
750 ret.append(os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'plugins')))
755 for basePath in getPluginBasePaths():
756 for filename in glob.glob(os.path.join(basePath, '*.py')):
757 filename = os.path.basename(filename)
758 if filename.startswith('_'):
760 with open(os.path.join(basePath, filename), "r") as f:
761 item = {'filename': filename, 'name': None, 'info': None, 'type': None, 'params': []}
764 if not line.startswith('#'):
766 line = line[1:].split(':', 1)
769 if line[0].upper() == 'NAME':
770 item['name'] = line[1].strip()
771 elif line[0].upper() == 'INFO':
772 item['info'] = line[1].strip()
773 elif line[0].upper() == 'TYPE':
774 item['type'] = line[1].strip()
775 elif line[0].upper() == 'DEPEND':
777 elif line[0].upper() == 'PARAM':
778 m = re.match('([a-zA-Z][a-zA-Z0-9_]*)\(([a-zA-Z_]*)(?::([^\)]*))?\) +(.*)', line[1].strip())
780 item['params'].append({'name': m.group(1), 'type': m.group(2), 'default': m.group(3), 'description': m.group(4)})
782 print "Unknown item in effect meta data: %s %s" % (line[0], line[1])
783 if item['name'] is not None and item['type'] == 'postprocess':
787 def runPostProcessingPlugins(gcodefilename):
788 pluginConfigList = getPluginConfig()
789 pluginList = getPluginList()
791 for pluginConfig in pluginConfigList:
793 for pluginTest in pluginList:
794 if pluginTest['filename'] == pluginConfig['filename']:
800 for basePath in getPluginBasePaths():
801 testFilename = os.path.join(basePath, pluginConfig['filename'])
802 if os.path.isfile(testFilename):
803 pythonFile = testFilename
804 if pythonFile is None:
807 locals = {'filename': gcodefilename}
808 for param in plugin['params']:
809 value = param['default']
810 if param['name'] in pluginConfig['params']:
811 value = pluginConfig['params'][param['name']]
813 if param['type'] == 'float':
817 value = float(param['default'])
819 locals[param['name']] = value
821 execfile(pythonFile, locals)
823 locationInfo = traceback.extract_tb(sys.exc_info()[2])[-1]
824 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])