1 from __future__ import absolute_import
2 from __future__ import division
4 import os, traceback, math, re, zlib, base64, time, sys, platform, glob, string, stat, types
5 import cPickle as pickle
6 if sys.version_info[0] < 3:
9 import configparser as ConfigParser
11 from Cura.util import resources
12 from Cura.util import version
13 from Cura.util import validators
15 settingsDictionary = {}
17 class setting(object):
18 def __init__(self, name, default, type, category, subcategory):
22 self._default = unicode(default)
23 self._value = self._default
25 self._category = category
26 self._subcategory = subcategory
30 if type is types.FloatType:
31 validators.validFloat(self)
32 elif type is types.IntType:
33 validators.validInt(self)
35 global settingsDictionary
36 settingsDictionary[name] = self
38 settingsList.append(self)
40 def setLabel(self, label, tooltip = ''):
42 self._tooltip = tooltip
45 def setRange(self, minValue = None, maxValue = None):
46 if len(self._validators) < 1:
48 self._validators[0].minValue = minValue
49 self._validators[0].maxValue = maxValue
58 def getCategory(self):
61 def getSubCategory(self):
62 return self._subcategory
64 def isPreference(self):
65 return self._category == 'preference'
67 def isAlteration(self):
68 return self._category == 'alteration'
71 return not self.isAlteration() and not self.isPreference()
85 def setValue(self, value):
86 self._value = unicode(value)
89 result = validators.SUCCESS
91 for validator in self._validators:
92 res, err = validator.validate()
93 if res == validators.ERROR:
95 elif res == validators.WARNING and result != validators.ERROR:
97 if res != validators.SUCCESS:
99 return result, '\n'.join(msgs)
101 def addCondition(self, conditionFunction):
102 self._conditions.append(conditionFunction)
104 def checkConditions(self):
105 for condition in self._conditions:
110 #########################################################
112 #########################################################
113 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.')
114 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.')
115 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.')
116 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.')
117 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.')
118 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.')
119 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.')
120 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.')
121 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.')
122 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.')
123 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.')
124 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.')
125 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.')
126 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)')
127 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.')
128 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.')
129 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.')
130 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.')
131 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.')
132 setting('filament_flow', 100., float, 'basic', 'Filament').setRange(1,300).setLabel('Flow (%)', 'Flow compensation, the amount of material extruded is multiplied by this value')
133 #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')
134 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.')
135 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.')
136 #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.')
137 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.')
138 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.')
139 #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.')
140 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.')
141 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.')
142 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..')
143 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.')
144 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.')
146 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.')
147 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.')
148 #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.')
149 #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.')
150 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.')
151 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.')
152 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%.')
153 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.')
154 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.')
155 #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.')
156 #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')
157 #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\'')
158 #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.')
159 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.')
160 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.')
161 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.')
162 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.')
163 #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.')
164 #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.')
165 #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.')
166 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.')
167 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.')
168 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.')
169 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.')
170 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.')
171 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.')
172 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.')
173 #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('plugin_config', '', str, 'hidden', 'hidden')
176 setting('object_center_x', -1, float, 'hidden', 'hidden')
177 setting('object_center_y', -1, float, 'hidden', 'hidden')
179 setting('start.gcode', """;Sliced at: {day} {date} {time}
180 ;Basic settings: Layer height: {layer_height} Walls: {wall_thickness} Fill: {fill_density}
181 ;Print time: {print_time}
182 ;Filament used: {filament_amount}m {filament_weight}g
183 ;Filament cost: {filament_cost}
185 G90 ;absolute positioning
186 M107 ;start with the fan off
188 G28 X0 Y0 ;move X/Y to min endstops
189 G28 Z0 ;move Z to min endstops
191 G1 Z15.0 F{travel_speed} ;move the platform down 15mm
193 G92 E0 ;zero the extruded length
194 G1 F200 E3 ;extrude 3mm of feed stock
195 G92 E0 ;zero the extruded length again
198 """, str, 'alteration', 'alteration')
199 #######################################################################################
200 setting('end.gcode', """;End GCode
201 M104 S0 ;extruder heater off
202 M140 S0 ;heated bed heater off (if you have it)
204 G91 ;relative positioning
205 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
206 G1 Z+0.5 E-5 X-20 Y-20 F{travel_speed} ;move Z up a bit and retract filament even more
207 G28 X0 Y0 ;move X/Y to min endstops, so the head is out of the way
210 G90 ;absolute positioning
211 """, str, 'alteration', 'alteration')
212 #######################################################################################
213 setting('support_start.gcode', '', str, 'alteration', 'alteration')
214 setting('support_end.gcode', '', str, 'alteration', 'alteration')
215 setting('cool_start.gcode', '', str, 'alteration', 'alteration')
216 setting('cool_end.gcode', '', str, 'alteration', 'alteration')
217 setting('replace.csv', '', str, 'alteration', 'alteration')
218 #######################################################################################
219 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.
222 G91 ;relative positioning
223 G1 E-1 F300 ;retract the filament a bit before lifting the nozzle, to release some of the pressure
224 G1 Z+0.5 E-5 F{travel_speed} ;move Z up a bit and retract filament even more
225 G90 ;absolute positioning
227 G1 Z{clear_z} F{max_z_speed}
229 G1 X{object_center_x} Y{object_center_y} F{travel_speed}
232 """, str, 'alteration', 'alteration')
233 #######################################################################################
234 setting('switchExtruder.gcode', """;Switch between the current extruder and the next extruder, when printing with multiple extruders.
239 G1 X{new_x} Y{new_y} Z{new_z} F{travel_speed}
242 """, str, 'alteration', 'alteration')
244 setting('startMode', 'Simple', ['Simple', 'Normal'], 'preference', 'hidden')
245 setting('lastFile', os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'resources', 'example', 'UltimakerRobot_support.stl')), str, 'preference', 'hidden')
246 setting('machine_width', '205', float, 'preference', 'hidden').setLabel('Maximum width (mm)', 'Size of the machine in mm')
247 setting('machine_depth', '205', float, 'preference', 'hidden').setLabel('Maximum depth (mm)', 'Size of the machine in mm')
248 setting('machine_height', '200', float, 'preference', 'hidden').setLabel('Maximum height (mm)', 'Size of the machine in mm')
249 setting('machine_type', 'unknown', str, 'preference', 'hidden')
250 setting('machine_center_is_zero', 'False', bool, 'preference', 'hidden')
251 setting('ultimaker_extruder_upgrade', 'False', bool, 'preference', 'hidden')
252 setting('has_heated_bed', 'False', bool, 'preference', 'hidden').setLabel('Heated bed', 'If you have an heated bed, this enabled heated bed settings (requires restart)')
253 setting('reprap_name', 'RepRap', str, 'preference', 'hidden')
254 setting('extruder_amount', '1', ['1','2','3','4'], 'preference', 'hidden').setLabel('Extruder count', 'Amount of extruders in your machine.')
255 setting('extruder_offset_x1', '-21.6', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
256 setting('extruder_offset_y1', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
257 setting('extruder_offset_x2', '0.0', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
258 setting('extruder_offset_y2', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
259 setting('extruder_offset_x3', '0.0', float, 'preference', 'hidden').setLabel('Offset X', 'The offset of your secondary extruder compared to the primary.')
260 setting('extruder_offset_y3', '0.0', float, 'preference', 'hidden').setLabel('Offset Y', 'The offset of your secondary extruder compared to the primary.')
261 setting('filament_physical_density', '1300', float, 'preference', 'hidden').setRange(500.0, 3000.0).setLabel('Density (kg/m3)', 'Weight of the filament per m3. Around 1300 for PLA. And around 1040 for ABS. This value is used to estimate the weight if the filament used for the print.')
262 setting('steps_per_e', '0', float, 'preference', 'hidden').setLabel('E-Steps per 1mm filament', 'Amount of steps per mm filament extrusion')
263 setting('serial_port', 'AUTO', str, 'preference', 'hidden').setLabel('Serial port', 'Serial port to use for communication with the printer')
264 setting('serial_port_auto', '', str, 'preference', 'hidden')
265 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')
266 setting('serial_baud_auto', '', int, 'preference', 'hidden')
267 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.')
268 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.')
269 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.')
270 setting('sdpath', '', str, 'preference', 'hidden').setLabel('SD card drive', 'Location of your SD card, when using the copy to SD feature.')
271 setting('check_for_updates', 'True', bool, 'preference', 'hidden').setLabel('Check for updates', 'Check for newer versions of Cura on startup')
272 setting('submit_slice_information', 'False', bool, 'preference', 'hidden').setLabel('Send usage statistics', 'Submit anonymous usage information to improve next versions of Cura')
274 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.')
275 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.')
276 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.')
277 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.')
278 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.')
280 setting('model_colour', '#7AB645', str, 'preference', 'hidden').setLabel('Model colour')
281 setting('model_colour2', '#CB3030', str, 'preference', 'hidden').setLabel('Model colour (2)')
282 setting('model_colour3', '#DDD93C', str, 'preference', 'hidden').setLabel('Model colour (3)')
283 setting('model_colour4', '#4550D3', str, 'preference', 'hidden').setLabel('Model colour (4)')
285 setting('window_maximized', 'True', bool, 'preference', 'hidden')
286 setting('window_pos_x', '-1', float, 'preference', 'hidden')
287 setting('window_pos_y', '-1', float, 'preference', 'hidden')
288 setting('window_width', '-1', float, 'preference', 'hidden')
289 setting('window_height', '-1', float, 'preference', 'hidden')
290 setting('window_normal_sash', '320', float, 'preference', 'hidden')
292 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.")
293 validators.wallThicknessValidator(settingsDictionary['wall_thickness'])
294 validators.warningAbove(settingsDictionary['print_speed'], 150.0, "It is highly unlikely that your machine can achieve a printing speed above 150mm/s")
295 validators.printSpeedValidator(settingsDictionary['print_speed'])
296 validators.warningAbove(settingsDictionary['print_temperature'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
297 validators.warningAbove(settingsDictionary['print_temperature2'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
298 validators.warningAbove(settingsDictionary['print_temperature3'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
299 validators.warningAbove(settingsDictionary['print_temperature4'], 260.0, "Temperatures above 260C could damage your machine, be careful!")
300 validators.warningAbove(settingsDictionary['filament_diameter'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
301 validators.warningAbove(settingsDictionary['filament_diameter2'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
302 validators.warningAbove(settingsDictionary['filament_diameter3'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
303 validators.warningAbove(settingsDictionary['filament_diameter4'], 3.5, "Are you sure your filament is that thick? Normal filament is around 3mm or 1.75mm.")
304 validators.warningAbove(settingsDictionary['travel_speed'], 300.0, "It is highly unlikely that your machine can achieve a travel speed above 300mm/s")
305 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.")
307 #Conditions for multiple extruders
308 settingsDictionary['print_temperature2'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
309 settingsDictionary['print_temperature3'].addCondition(lambda : int(getPreference('extruder_amount')) > 2)
310 settingsDictionary['print_temperature4'].addCondition(lambda : int(getPreference('extruder_amount')) > 3)
311 settingsDictionary['filament_diameter2'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
312 settingsDictionary['filament_diameter3'].addCondition(lambda : int(getPreference('extruder_amount')) > 2)
313 settingsDictionary['filament_diameter4'].addCondition(lambda : int(getPreference('extruder_amount')) > 3)
314 settingsDictionary['support_dual_extrusion'].addCondition(lambda : int(getPreference('extruder_amount')) > 1)
316 settingsDictionary['print_bed_temperature'].addCondition(lambda : getPreference('has_heated_bed') == 'True')
318 #########################################################
319 ## Profile and preferences functions
320 #########################################################
322 def getSubCategoriesFor(category):
325 for s in settingsList:
326 if s.getCategory() == category and not s.getSubCategory() in done:
327 done[s.getSubCategory()] = True
328 ret.append(s.getSubCategory())
331 def getSettingsForCategory(category, subCategory = None):
333 for s in settingsList:
334 if s.getCategory() == category and (subCategory is None or s.getSubCategory() == subCategory):
340 if platform.system() == "Windows":
341 basePath = os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".."))
342 #If we have a frozen python install, we need to step out of the library.zip
343 if hasattr(sys, 'frozen'):
344 basePath = os.path.normpath(os.path.join(basePath, ".."))
346 basePath = os.path.expanduser('~/.cura/%s' % version.getVersion(False))
347 if not os.path.isdir(basePath):
348 os.makedirs(basePath)
351 def getDefaultProfilePath():
352 return os.path.join(getBasePath(), 'current_profile.ini')
354 def loadProfile(filename):
355 #Read a configuration file as global config
356 profileParser = ConfigParser.ConfigParser()
358 profileParser.read(filename)
359 except ConfigParser.ParsingError:
362 for set in settingsList:
363 if set.isPreference():
366 if set.isAlteration():
367 section = 'alterations'
368 if profileParser.has_option(section, set.getName()):
369 set.setValue(unicode(profileParser.get(section, set.getName()), 'utf-8', 'replace'))
371 def saveProfile(filename):
372 #Save the current profile to an ini file
373 profileParser = ConfigParser.ConfigParser()
374 profileParser.add_section('profile')
375 profileParser.add_section('alterations')
377 for set in settingsList:
378 if set.isPreference():
380 if set.isAlteration():
381 profileParser.set('alterations', set.getName(), set.getValue().encode('utf-8'))
383 profileParser.set('profile', set.getName(), set.getValue().encode('utf-8'))
385 profileParser.write(open(filename, 'w'))
388 #Read a configuration file as global config
390 for set in settingsList:
391 if set.isPreference():
393 set.setValue(set.getDefault())
395 if getPreference('machine_type') == 'ultimaker':
396 putProfileSetting('nozzle_size', '0.4')
397 if getPreference('ultimaker_extruder_upgrade') == 'True':
398 putProfileSetting('retraction_enable', 'True')
400 putProfileSetting('nozzle_size', '0.5')
402 def loadProfileFromString(options):
403 options = base64.b64decode(options)
404 options = zlib.decompress(options)
405 (profileOpts, alt) = options.split('\f', 1)
406 global settingsDictionary
407 for option in profileOpts.split('\b'):
409 (key, value) = option.split('=', 1)
410 if key in settingsDictionary:
411 if settingsDictionary[key].isProfile():
412 settingsDictionary[key].setValue(value)
413 for option in alt.split('\b'):
415 (key, value) = option.split('=', 1)
416 if key in settingsDictionary:
417 if settingsDictionary[key].isAlteration():
418 settingsDictionary[key].setValue(value)
420 def getProfileString():
424 for set in settingsList:
426 if set.getName() in tempOverride:
427 p.append(set.getName() + "=" + tempOverride[set.getName()])
429 p.append(set.getName() + "=" + set.getValue())
430 if set.isAlteration():
431 if set.getName() in tempOverride:
432 alt.append(set.getName() + "=" + tempOverride[set.getName()])
434 alt.append(set.getName() + "=" + set.getValue())
435 ret = '\b'.join(p) + '\f' + '\b'.join(alt)
436 ret = base64.b64encode(zlib.compress(ret, 9))
439 def getGlobalPreferencesString():
442 for set in settingsList:
443 if set.isPreference():
444 p.append(set.getName() + "=" + set.getValue())
446 ret = base64.b64encode(zlib.compress(ret, 9))
450 def getProfileSetting(name):
451 if name in tempOverride:
452 return tempOverride[name]
453 global settingsDictionary
454 if name in settingsDictionary and settingsDictionary[name].isProfile():
455 return settingsDictionary[name].getValue()
456 print 'Error: "%s" not found in profile settings' % (name)
459 def getProfileSettingFloat(name):
461 setting = getProfileSetting(name).replace(',', '.')
462 return float(eval(setting, {}, {}))
466 def putProfileSetting(name, value):
467 #Check if we have a configuration file loaded, else load the default.
468 global settingsDictionary
469 if name in settingsDictionary and settingsDictionary[name].isProfile():
470 settingsDictionary[name].setValue(value)
472 def isProfileSetting(name):
473 global settingsDictionary
474 if name in settingsDictionary and settingsDictionary[name].isProfile():
478 ## Preferences functions
479 def getPreferencePath():
480 return os.path.join(getBasePath(), 'preferences.ini')
482 def getPreferenceFloat(name):
484 setting = getPreference(name).replace(',', '.')
485 return float(eval(setting, {}, {}))
489 def getPreferenceColour(name):
490 colorString = getPreference(name)
491 return [float(int(colorString[1:3], 16)) / 255, float(int(colorString[3:5], 16)) / 255, float(int(colorString[5:7], 16)) / 255, 1.0]
493 def loadPreferences(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():
503 if profileParser.has_option('preference', set.getName()):
504 set.setValue(unicode(profileParser.get('preference', set.getName()), 'utf-8', 'replace'))
506 def savePreferences(filename):
507 #Save the current profile to an ini file
508 parser = ConfigParser.ConfigParser()
509 parser.add_section('preference')
511 for set in settingsList:
512 if set.isPreference():
513 parser.set('preference', set.getName(), set.getValue().encode('utf-8'))
514 parser.write(open(filename, 'w'))
516 def getPreference(name):
517 if name in tempOverride:
518 return tempOverride[name]
519 global settingsDictionary
520 if name in settingsDictionary and settingsDictionary[name].isPreference():
521 return settingsDictionary[name].getValue()
522 print 'Error: "%s" not found in profile settings' % (name)
525 def putPreference(name, value):
526 #Check if we have a configuration file loaded, else load the default.
527 global settingsDictionary
528 if name in settingsDictionary and settingsDictionary[name].isPreference():
529 settingsDictionary[name].setValue(value)
530 savePreferences(getPreferencePath())
532 def isPreference(name):
533 global settingsDictionary
534 if name in settingsDictionary and settingsDictionary[name].isPreference():
538 ## Temp overrides for multi-extruder slicing and the project planner.
540 def setTempOverride(name, value):
541 tempOverride[name] = unicode(value).encode("utf-8")
542 def clearTempOverride(name):
543 del tempOverride[name]
544 def resetTempOverride():
547 #########################################################
548 ## Utility functions to calculate common profile values
549 #########################################################
550 def calculateEdgeWidth():
551 wallThickness = getProfileSettingFloat('wall_thickness')
552 nozzleSize = getProfileSettingFloat('nozzle_size')
554 if wallThickness < 0.01:
556 if wallThickness < nozzleSize:
559 lineCount = int(wallThickness / nozzleSize + 0.0001)
560 lineWidth = wallThickness / lineCount
561 lineWidthAlt = wallThickness / (lineCount + 1)
562 if lineWidth > nozzleSize * 1.5:
566 def calculateLineCount():
567 wallThickness = getProfileSettingFloat('wall_thickness')
568 nozzleSize = getProfileSettingFloat('nozzle_size')
570 if wallThickness < nozzleSize:
573 lineCount = int(wallThickness / nozzleSize + 0.0001)
574 lineWidth = wallThickness / lineCount
575 lineWidthAlt = wallThickness / (lineCount + 1)
576 if lineWidth > nozzleSize * 1.5:
580 def calculateSolidLayerCount():
581 layerHeight = getProfileSettingFloat('layer_height')
582 solidThickness = getProfileSettingFloat('solid_layer_thickness')
583 if layerHeight == 0.0:
585 return int(math.ceil(solidThickness / layerHeight - 0.0001))
587 def calculateObjectSizeOffsets():
590 if getProfileSetting('platform_adhesion') == 'Brim':
591 size += getProfileSettingFloat('brim_line_count') * calculateEdgeWidth()
592 elif getProfileSetting('platform_adhesion') == 'Raft':
595 if getProfileSettingFloat('skirt_line_count') > 0:
596 size += getProfileSettingFloat('skirt_line_count') * calculateEdgeWidth() + getProfileSettingFloat('skirt_gap')
598 #if getProfileSetting('enable_raft') != 'False':
599 # size += profile.getProfileSettingFloat('raft_margin') * 2
600 #if getProfileSetting('support') != 'None':
601 # extraSizeMin = extraSizeMin + numpy.array([3.0, 0, 0])
602 # extraSizeMax = extraSizeMax + numpy.array([3.0, 0, 0])
605 def getMachineCenterCoords():
606 if getPreference('machine_center_is_zero') == 'True':
608 return [getPreferenceFloat('machine_width') / 2, getPreferenceFloat('machine_depth') / 2]
610 #########################################################
611 ## Alteration file functions
612 #########################################################
613 def replaceTagMatch(m):
617 return pre + time.strftime('%H:%M:%S').encode('utf-8', 'replace')
619 return pre + time.strftime('%d %b %Y').encode('utf-8', 'replace')
621 return pre + time.strftime('%a').encode('utf-8', 'replace')
622 if tag == 'print_time':
623 return pre + '#P_TIME#'
624 if tag == 'filament_amount':
625 return pre + '#F_AMNT#'
626 if tag == 'filament_weight':
627 return pre + '#F_WGHT#'
628 if tag == 'filament_cost':
629 return pre + '#F_COST#'
630 if pre == 'F' and tag in ['print_speed', 'retraction_speed', 'travel_speed', 'max_z_speed', 'bottom_layer_speed', 'cool_min_feedrate']:
631 f = getProfileSettingFloat(tag) * 60
632 elif isProfileSetting(tag):
633 f = getProfileSettingFloat(tag)
634 elif isPreference(tag):
635 f = getProfileSettingFloat(tag)
637 return '%s?%s?' % (pre, tag)
639 return pre + str(int(f))
642 def replaceGCodeTags(filename, gcodeInt):
643 f = open(filename, 'r+')
645 data = data.replace('#P_TIME#', ('%5d:%02d' % (int(gcodeInt.totalMoveTimeMinute / 60), int(gcodeInt.totalMoveTimeMinute % 60)))[-8:])
646 data = data.replace('#F_AMNT#', ('%8.2f' % (gcodeInt.extrusionAmount / 1000))[-8:])
647 data = data.replace('#F_WGHT#', ('%8.2f' % (gcodeInt.calculateWeight() * 1000))[-8:])
648 cost = gcodeInt.calculateCost()
651 data = data.replace('#F_COST#', ('%8s' % (cost.split(' ')[0]))[-8:])
656 ### Get aleration raw contents. (Used internally in Cura)
657 def getAlterationFile(filename):
658 if filename in tempOverride:
659 return tempOverride[filename]
660 global settingsDictionary
661 if filename in settingsDictionary and settingsDictionary[filename].isAlteration():
662 return settingsDictionary[filename].getValue()
663 print 'Error: "%s" not found in profile settings' % (filename)
666 def setAlterationFile(name, value):
667 #Check if we have a configuration file loaded, else load the default.
668 global settingsDictionary
669 if name in settingsDictionary and settingsDictionary[name].isAlteration():
670 settingsDictionary[name].setValue(value)
671 saveProfile(getDefaultProfilePath())
673 ### Get the alteration file for output. (Used by Skeinforge)
674 def getAlterationFileContents(filename, extruderCount = 1):
677 alterationContents = getAlterationFile(filename)
678 if filename == 'start.gcode':
679 #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.
680 #We also set our steps per E here, if configured.
681 eSteps = getPreferenceFloat('steps_per_e')
683 prefix += 'M92 E%f\n' % (eSteps)
684 temp = getProfileSettingFloat('print_temperature')
686 if getPreference('has_heated_bed') == 'True':
687 bedTemp = getProfileSettingFloat('print_bed_temperature')
689 if bedTemp > 0 and not '{print_bed_temperature}' in alterationContents:
690 prefix += 'M140 S%f\n' % (bedTemp)
691 if temp > 0 and not '{print_temperature}' in alterationContents:
692 if extruderCount > 0:
693 for n in xrange(1, extruderCount):
695 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
696 t = getProfileSettingFloat('print_temperature%d' % (n+1))
697 prefix += 'M104 T%d S%f\n' % (n, t)
698 for n in xrange(0, extruderCount):
700 if n > 0 and getProfileSettingFloat('print_temperature%d' % (n+1)) > 0:
701 t = getProfileSettingFloat('print_temperature%d' % (n+1))
702 prefix += 'M109 T%d S%f\n' % (n, t)
705 prefix += 'M109 S%f\n' % (temp)
706 if bedTemp > 0 and not '{print_bed_temperature}' in alterationContents:
707 prefix += 'M190 S%f\n' % (bedTemp)
708 elif filename == 'end.gcode':
709 #Append the profile string to the end of the GCode, so we can load it from the GCode file later.
710 postfix = ';CURA_PROFILE_STRING:%s\n' % (getProfileString())
711 elif filename == 'replace.csv':
712 #Always remove the extruder on/off M codes. These are no longer needed in 5D printing.
713 prefix = 'M101\nM103\n'
714 elif filename == 'support_start.gcode' or filename == 'support_end.gcode':
715 #Add support start/end code
716 if getProfileSetting('support_dual_extrusion') == 'True' and int(getPreference('extruder_amount')) > 1:
717 if filename == 'support_start.gcode':
718 setTempOverride('extruder', '1')
720 setTempOverride('extruder', '0')
721 alterationContents = getAlterationFileContents('switchExtruder.gcode')
722 clearTempOverride('extruder')
724 alterationContents = ''
725 return unicode(prefix + re.sub("(.)\{([^\}]*)\}", replaceTagMatch, alterationContents).rstrip() + '\n' + postfix).strip().encode('utf-8') + '\n'
729 def getPluginConfig():
731 return pickle.loads(getProfileSetting('plugin_config'))
735 def setPluginConfig(config):
736 putProfileSetting('plugin_config', pickle.dumps(config))
738 def getPluginBasePaths():
740 if platform.system() != "Windows":
741 ret.append(os.path.expanduser('~/.cura/plugins/'))
742 if platform.system() == "Darwin" and hasattr(sys, 'frozen'):
743 ret.append(os.path.normpath(os.path.join(resources.resourceBasePath, "Cura/plugins")))
745 ret.append(os.path.normpath(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'plugins')))
750 for basePath in getPluginBasePaths():
751 for filename in glob.glob(os.path.join(basePath, '*.py')):
752 filename = os.path.basename(filename)
753 if filename.startswith('_'):
755 with open(os.path.join(basePath, filename), "r") as f:
756 item = {'filename': filename, 'name': None, 'info': None, 'type': None, 'params': []}
759 if not line.startswith('#'):
761 line = line[1:].split(':', 1)
764 if line[0].upper() == 'NAME':
765 item['name'] = line[1].strip()
766 elif line[0].upper() == 'INFO':
767 item['info'] = line[1].strip()
768 elif line[0].upper() == 'TYPE':
769 item['type'] = line[1].strip()
770 elif line[0].upper() == 'DEPEND':
772 elif line[0].upper() == 'PARAM':
773 m = re.match('([a-zA-Z][a-zA-Z0-9_]*)\(([a-zA-Z_]*)(?::([^\)]*))?\) +(.*)', line[1].strip())
775 item['params'].append({'name': m.group(1), 'type': m.group(2), 'default': m.group(3), 'description': m.group(4)})
777 print "Unknown item in effect meta data: %s %s" % (line[0], line[1])
778 if item['name'] is not None and item['type'] == 'postprocess':
782 def runPostProcessingPlugins(gcodefilename):
783 pluginConfigList = getPluginConfig()
784 pluginList = getPluginList()
786 for pluginConfig in pluginConfigList:
788 for pluginTest in pluginList:
789 if pluginTest['filename'] == pluginConfig['filename']:
795 for basePath in getPluginBasePaths():
796 testFilename = os.path.join(basePath, pluginConfig['filename'])
797 if os.path.isfile(testFilename):
798 pythonFile = testFilename
799 if pythonFile is None:
802 locals = {'filename': gcodefilename}
803 for param in plugin['params']:
804 value = param['default']
805 if param['name'] in pluginConfig['params']:
806 value = pluginConfig['params'][param['name']]
808 if param['type'] == 'float':
812 value = float(param['default'])
814 locals[param['name']] = value
816 execfile(pythonFile, locals)
818 locationInfo = traceback.extract_tb(sys.exc_info()[2])[-1]
819 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])