Macros

Macros are snippets of saved code which can be called with the click of a button instead of having to be typed repeatedly.

The Macros of the Controls pane section is where the user creates and stores these macros.

To learn more about G-Code and its utility in 3D printing, check out this resource: http://reprap.org/wiki/G-code

Macros Pane

Macros pane containing example macros for the Rostock MAX V2

Once macros have been created, they will appear under the Macros title.

The screenshot to the right shows an example of several macro buttons for the Rostock MAX V2.

Macro Editor

By default, the Macros section has no buttons.

To access the Macro Editor, click the pencil icon (

) next to the word Macros. This will open the Macro Presets window.

Macro Presets Window

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

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:

; host.:

Then add a command and any applicable parameters.

; command([parameters])"

The result should look something like this:

; host.show_message(title:"Waiting for extruder to heat to [temperature].")

Commands

ding()

Play a bell sound.

show_message()

Shows the specified message.

Optional parameter variables (content must be in quotes):

title	Main text to show	title:"Trim Filament"
markdown	The contents of the message in Markdown formatted text. May contain images from the internet. Use for line breaks	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."
Example	Example	Example
Example	Example	Example
Example	Example	Example
Example	Example	Example
Example	Example	Example

[the contents of the message in Markdown formatted text]
image: [a url of the image you wish to show]
wait_ok: [script execution will wait for the user to click 'ok']
repeat_gcode: [gcode to repeat until expire time reached (separate lines with a |)]
expire: [the max amount of time to run repeate_gcode or show this message]
count_down: [show a timer counting down from this time]

choose_material

Shows the choose material window.