Skip to content

Warning

MillMage is in active development and in a prerelease state. Many operations and functions are not feature complete. Please report any unexpected behavior by searching for and reporting the issue or question in the MillMage Beta User Forum. Please include screenshots and as much detail as possible.

Beta Users: Finding Help

Find help and download the latest release candidate of MillMage in the MillMage Beta User Forum.

Users new to MillMage should follow the Getting Started guide.

Warning

This documentation is in active development and in a prerelease state. These documents are not complete and may include missing pages, broken links, and placeholders. Content is being updated as feedback is reviewed. Your patience is appreciated.

Project Setup

Define your device-specific setup and the project material stock — or workpiece — dimensions in the Project Setup window. MillMage customizes the workspace and user interface based on your project parameters and the CNC machines added to the devices list. The Workspace displayed in MillMage is a representation of the stock material used in the project — not the size of your CNC machine cutting area.

Click within the image below for additional details.

Accessing the Project Setup Window

The Project Setup window will be presented on every relaunch of MillMage. Open the Project Setup window by selecting either:

Device Setup

Define several project-specific parameters in the Device Setup section of the Project Setup window.

1. Choose Your Machine

Choose Device

Select the desired CNC machine from the list of added Devices in the Machine dropdown, choosing the Generic GCode or a placeholder machine previously created if your CNC machine is not yet setup and listed.

Refer back to the Adding Your Machine guide for a step-by-step walkthrough on adding a CNC machine to your list of devices in MillMage.

Refer to Devices for more information.

2. Measure and Set Safe Clearance Height

Carefully measure the distance between the highest point on any workholding clamps within the work area and the surface of the CNC machine wasteboard or work area. Use the height of the material stock if using countersunk screws or toe clamps.

Safe Clearance Gif

Safe clearance height is the measured distance above all elements of the stock material, high enough for the CNC router tooling — bits — to freely move within the work area without colliding with workholding clamps, fixtures, and fasteners.

Collision Warning

Workholding fixtures are NOT included by default in the Safe Clearance Height. Account for workholding fixture height and add their values into calculations to prevent collisions.

View the Workholding Guide for workholding examples.

3. Set Fast Retraction Height

Fast Retraction Gif

Fast retraction height is the distance above the material stock to lift the router tooling up when moving between features.

This feature is on by default.

Collision Warning

To prevent collisions, only enable fast retraction if the inner area of the material stock is free of clamps, fasteners, and other obstructions.

4. Set Pocket Lift Height

Pocket Lift Gif

Pocket Lift Height is the distance to lift above the pocket surface when moving within that pocket, and is used to help clear chips and debris.

5. Set Project Units of Measure

Units of Measure

Set the project units to Millimeters (mm) or Inches (in).

Change the project units of measure at any time by pressing the mm or in button found between the Numeric Edits toolbar and the Text Tools toolbar.

Switch Units of Measure button

6. Measure and Set Stock Dimensions

Stock Dimensions

Accurately measure the material stock — also known as the workpiece — and enter the dimensions in the Width, Depth, and Thickness fields.

An accurate material thickness measurement will help prevent cutting through the workpiece into the waste board or the CNC machine itself.

Ensure that the material stock is securely fastened within the machine workspace before operating the machine.

7. Set Project Origin/Work Offset

Project Origin Choices

The project origin corresponds to the physical X, and Y axis point you will home the tip of the router tooling against.

Choose the project origin — also known as the work offset — to set the (0,0) point for the X (left/right), and Y (up/down) axis on the material stock in relation to the first imported or drawn artwork.

Select Bottom Left or Center for most projects.

8. Set Z Axis Zero Point

The workpiece Zero Point is the point along the Z (up/down) axis where the tip of the tooling is physically touching either the top of the material stock, or at the bottom of the CNC machine work area touching the wasteboard or work area surface.

Workpiece Zero Point

Setting the Workpiece Zero Point tells MillMage how to translate the desired cut depths and directions set in the Operations window into the GCode commands needed to perform the final machining operations.

Choosing between Top & Bottom Zero Points

Tip

keep the Z axis zero point consistent through all operations within each project.

Z Axis Zero Point: Top

Pros Cons
Can use full cutting volume Easier to cut through wasteboard or machine surface
One X, Y, and Z axis zero point Can machine away initial Z axis zero point
Jig & fixture friendly
Engraving & Inlay friendly

Z Axis Zero Point: Bottom

Pros Cons
Preferred when cutting through material Workpiece must be smaller than wasteboard
More exact thickness in end product Requires two different zero points: X & Y, and Z
Preserves wasteboard surface Material thickness variance can lead to chip overload

9. Close Project Setup Window

Select OK to save the project settings and close the Project Setup window.


For more help using MillMage, please visit our forum to talk with MillMage staff and users, or email support.