Open main menu

Changes

CONTROLS/Macros

4,608 bytes added, 18:55, 4 September 2018
no edit summary
MatterControl allows you to easily create custom GCode {{Migrated|printer-controls/macros. If you want }}__NOTOC__{{DISPLAYTITLE:Macros}}Macros are snippets of saved code which can be called with the click of a button instead of having to learn more about Gcode and its utility in 3D printing, check out this resource on [http://reprapbe typed repeatedly.org/wiki/G-code G-code]
== How It Works ==The Macros of the Controls pane section is where the user creates and stores these macros.
Navigate to '''Settings & Controls'''To learn more about G-Code and its utility in 3D printing, check out this resource: http://reprap.org/wiki/G-code
[[File:Gcodemacros1.jpg|none|frame|]]== Macros Pane ==
Select [[File:Macros-example.png|right|framed|<center>Macros pane containing example macros for the Rostock MAX V2</center>]]Once macros have been created, they will appear under the '''ControlsMacros''' tab to find the Macros configuration icontitle.
[[File:Gcodemacros2The screenshot to the right shows an example of several macro buttons for the Rostock MAX V2.jpg|none|frame|]]<br clear=all>== Macro Editor ==
[[File:Macros-blank-ss.png|right|framed|<center>By default, the Macros section has no buttons.</center>]]To access the Macro Editor, click the pencil icon ([[File:Pencil-edit.png]]) next to the word '''Macros'''. This will open the Macro Presets window.<br clear=all>== Macros = Macro Presets Window ===
Selecting the [[File:Macros configuration icon brings up a new window for Macro -Presets-blank-ss. When a user clicks Add, the window provides two text boxes for a name and command(s).png|none]]
[[File:Gcodemacros3.png|none|frame|]]==== Add ====
To add a new Macro, click the '''Add''' button. This will open the '''Edit Macro''' window.
 
==== Close ====
 
Click the '''Close''' button to close the window and return to the main screen.
 
=== Edit Macro Window ===
 
[[File:Macros-Editor-ss.png|none]]
 
==== Macro Name ====
 
Enter a unique name for the macro.
 
==== Macro Commands ====
 
Enter [[G-Code]] command(s) in this field.
 
Can be multiple lines long.
 
==== Save ====
 
Click the '''Save''' button to add the button to the Macros section.
 
==== Cancel ====
 
Click the '''Cancel''' button to discard changes.
 
== Macro Scripting (Starting in version 1.7) ==
 
Macro Scripting allows for the use of advanced functions in macros. These functions are called by using commands.
 
=== Syntax ===
 
To use a macro scripting command, begin the line with the following function:
 
<code>; host.:</code>
 
Then add a command and any applicable parameters.
 
<code>; command([parameters])"</code>
 
The result should look something like this:
 
<code>; host.show_message(title:"Waiting for extruder to heat to [temperature].")</code>
 
=== Commands ===
 
<code>ding()</code>
 
Play a bell sound.
 
<code>show_message()</code>
 
Shows the specified message.
 
Optional parameter variables (content must be in quotes):
{| class="wikitable"
|-
! Parameter || Description || Example
|-
| title || Main text to show || <pre>title:"Trim Filament"</pre>
|-
| markdown || The contents of the message in Markdown formatted text. May contain images from the internet. Use <br> for line breaks || <pre>markdown:"Trim the end of the filament to ensure a good load.<br>![](https://www.matterhackers.com/r/c3zLyf)<br>Make sure you trim it at a slight angle."</pre>
|-
| wait_ok || Script execution will wait for the user to click 'Continue' || <pre>wait_ok:"true"</pre>
|-
| repeat_gcode || G-Code to repeat until expire time reached. Lines can be separated with a <nowiki>|</nowiki>. || <pre>repeat_gcode:"G1 E.1 F150|G4 P10"</pre>
|-
| expire || The max amount of time to run repeate_gcode or show this message (seconds) || <pre>expire:"300"</pre>
|-
| count_down || Show a timer counting down from this time || <pre>count_down:"28"</pre>
|}
 
<code>choose_material</code>
 
Shows the choose material window.
 
Optional parameter variables (content must be in quotes):
 
*title: [main text to show]
 
=== Example Script ===
 
The following is an example of a script used for loading filament:
 
<pre>; host.choose_material(title:"Choose the material that you are loading.")
 
M104 S[temperature] ; start heating up the extruder
 
; host.show_message(title:"Trim the end of the filament to ensure a good load.", image:"https://cdn.instructables.com/FSW/FEGA/HN4ZL57T/FSWFEGAHN4ZL57T.MEDIUM.jpg", wait_ok:"true")
 
M302 S0 ; Allow extrusion at any temperature
G91 ; Relative positioning
; host.show_message(title:"Put filament into extruder and click Continue.", repeat_gcode:"G1 E.1 F150|G4 P10", expire:"90", image:"https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/5035400628/original/20150903_115628.jpg?1441307271")
G90 ; Absolute positioning
; host.show_message(title:"Loading filament...", count_down:"28")
G92 E0 ; reset the extruder position to 0
G91 ; Relative positioning
G1 E100 F1200 ; extrude the filament
G1 E100 F1200 ; extrude the filament
G1 E100 F1200 ; extrude the filament
G1 E100 F1200 ; extrude the filament
G1 E100 F1200 ; extrude the filament
G4 S1 ; wait for move to finish
 
M302 S150 ; Set cold extrude temp back to reasonable
; host.show_message(title:"Waiting for extruder to heat to [temperature].")
M109 S[temperature] ; heat up the extruder
 
; extrude slowly so that we can prime the extruder
; host.show_message(title:"Click 'Continue' when filament is running cleanly.", repeat_gcode:"G1 E1 F300|G4 P10", expire:"90")
 
G4 S1 ; wait for move to finish
G90 ; Absolute positioning
G92 E0 ; reset the extruder position to 0
 
M104 S0 ; turn the extruder temperature off
</pre>
 
[[Category:Controls]]
[[Category:Features]]