Development goes fast, documentation may be outdated. Proceed with some caution.
EasyShape5000 Routing Workflow Guide
From SVG or STL to G-code for your CNC router
Interface Overview
A central canvas with a sidebar either side. On the left, the Operations panel sits above Imported Objects, the scene tree. On the right, Stock Setup, then Machine Settings, then Operation Settings for whatever you have selected. The footer carries status, the log and the display options.
Operation Settings changes with your selection. Select a shape and you get its transform fields plus the operation tabs. Select a stage inside an operation and you get that stage's parameters, with its button underneath.
2D and 3D
The canvas starts in 2D. Selecting a Toolpaths stage switches to the 3D view, because that is where a toolpath is worth looking at. 3D operations switch earlier: V-Carve, Relief and Rotary draw in 3D from their first stage, since there is nothing flat to show. A mesh selected under the Rotary tab is drawn on the rotary axis, where it will be cut.
The view button on the right of the toolbar - or F2 - flips between 2D and 3D. A scene with no 2D geometry stays in 3D.
Buckets and Stages
You assign operations per shape. Select shapes and drop them into an operation bucket - the bucket owns those shapes and their parameters, and you can have as many as you like.
Each bucket is then generated in stages. A stage is what the big button acts on: set that stage's parameters, run it, and you get a layer you can show, hide and redo on its own. Re-running a stage replaces its own layer and clears the ones after it, never the ones before.
Change something an earlier stage depends on - the tool diameter, a shape's position, the rotary axis - and the bucket is invalidated: the stages after it are cleared and the message names the one to go back to. Changing a feed rate cannot cost you your geometry.
The Toolpaths stage is a preview of the program
What it draws is what gets exported: the same motion, the same order, the same depths. Only the preamble, the postamble and the moves between operations are added later, when the Export Manager puts the job together. A bucket that has not been through Calculate Toolpaths does not appear there.
While a stage runs, the rest of the page waits under a progress overlay. Cancel, or Esc, stops a generation.
The Workflow
Import a design, select shapes, assign operations, take each bucket through its stages, export.
1. Importing Files
Drag and drop an SVG or an STL onto the canvas, or use Actions → Import Files…. An SVG keeps its group structure: groups become groups in the scene tree, paths and shapes become selectable items. An STL arrives as a group holding one mesh per solid in the file.
Nothing is modified on import. Move, rotate and scale as much as you like - the original geometry is kept and your transforms are applied on top, so you can always get back to where you started. A mesh is a scene object like any shape, with a Z offset and two more rotations of its own (see Shape Transforms).
2. The Scene Tree
Imported Objects (left sidebar, lower panel) lists every shape and group in your workspace. Each row has three controls:
- Visibility (eye icon)
- Hides the shape from the canvas. Hidden shapes are skipped by marquee selection and left out of the export.
- Lock (padlock icon)
- Stops the shape being moved, rotated or deleted. You can still select it, so you can unlock it again.
- Delete (trash icon)
- Removes it from the scene. Undo with Ctrl+Z.
Groups can be collapsed, and locking a group locks everything in it. Group and Ungroup are in the tree's toolbar (Ctrl+G and Ctrl+Shift+G). Ungrouping never moves anything - children keep the position they had.
3. Assigning Operations
Select one or more shapes, then pick an operation from the tabs on the right. The shapes drop into a new bucket, and the parameters appear with sensible defaults for the tool that operation suggests.
A bucket owns its shapes and its own parameters. The same shape can belong to more than one - a pocket and a profile on the same outline is the normal case - and each generates independently. Relief and Rotary take exactly one mesh per bucket; a selection holding more is refused.
4. Generating Geometry
Run the bucket's first stage. For flat operations this is XY Geometry: tool, cut side, step-over, and whatever else that operation needs.
The result appears as an Offsets layer - thin centrelines on the canvas showing where the tool will travel. Curves stay curves, so an offset circle exports as a real arc rather than a hundred short lines.
Change a geometry parameter afterwards and the bucket is invalidated until you regenerate.
5. Depth and the Preview
Flat operations only. With offsets generated, select the Offsets layer and set the depth parameters: cut depth, multi-depth and depth per pass, entry, holding tabs on a profile, a finishing pass on a pocket.
Click Generate Preview for the Preview layer - the paths redrawn at the real tool diameter, so you can see the material that will actually be removed rather than the line the spindle centre follows. It is the last chance to catch a cutter that is too wide for the detail in your design.
6. Calculating Toolpaths
Select the Preview layer (the 3D Paths layer on a 3D operation) and set the machine parameters: feed rate, plunge rate, spindle speed and dwell, the tool number, and whether to optimize.
Click Calculate Toolpaths. The canvas switches to the 3D view so you can look over the result - depth passes, entries, retracts and rapids. The toolbar view button, or F2, takes you back to 2D.
7. Exporting G-code
Select the Toolpaths layer for a summary, then open the Export Manager from its Output stage or with Actions → Export Files….
Working in 3D
V-Carve, Relief and Rotary cut at a different depth at every point rather than at a flat depth per pass. They skip the depth stage - the height is part of the path, decided while the geometry is generated.
Relief and Rotary take a mesh from the scene. Resolution, blank and depth are operation parameters; where the model sits and how it is turned is its Shape Transform. Change either and generate again - the model is sliced afresh every time, so there is no need to import it again.
The 3D view draws the stock, the model and the toolpaths. It does not animate them yet.
Stock, Z zero and coordinates
This is the part worth getting right before you generate anything. Geometry is placed where your file and your transforms put it, and machined where your stock says it is - nothing realigns it for you.
Two Stock Setup settings decide where the cutter thinks the material is:
- Stock thickness
- How thick the blank is. Depth is measured against it, and the maximum-depth check uses it to stop an operation cutting into your bed.
- Z-zero reference
- Whether Z0 is the material surface or the machine bed. Whichever you pick has to be the one you actually zero the machine on, because every depth in the program is measured from it.
Flat operations then work in the usual way: X and Y come from where the shape sits in the scene, Z from the depth you set against that datum.
A flat relief sits with the model's top on the stock surface. Its Z offset moves it from there: negative sinks it into the stock for a deeper carve, positive raises it, and whatever rises above the surface is left flat at the surface. Start Depth lowers the whole carve the same way.
Changing the stock thickness or the Z-zero reference leaves generated geometry alone but makes calculated toolpaths stale: calculate them again before exporting. The stock's width and length only change what the view draws.
The rotary frame
Rotary and indexed operations do not use the flat picture at all. X runs along the rotary axis (Y with a B-axis rotary), and by default Z0 is the rotation centreline - so negative Z below the centreline is correct output, not a mistake. Two settings move that zero:
- Absolute Z0
- On posts that support it, Z0 is the machine bed: every 4th-axis program is lifted by the Rotary Axis Height you enter, nothing may run below Z0, and a program that mixes flat and 4th-axis work, or uses axis replacement, is refused.
- 4th-Axis Route
- The axis-replacement route (Y carries arc length) measures from the top of the blank.
Workspace rotation, mirroring and origin have no effect on rotary operations, and the maximum-depth check does not apply either, because it assumes flat stock and a rotary job legitimately cuts past it.
The mesh is centred on the axis across it. Along the axis, the Shape Transform's Chuck puts the end the chuck holds on the origin, Center its middle, and Reset its file's own position; X, Y and Z then move it from there. Chuck Side in Machine Settings says which end the chuck holds: each operation's chuck-end settings apply there and its tail-end ones at the other end.
The 3D view draws the axis, a ground grid at the program's Z0, and the chuck - with the tailstock when the workholding is between centres - standing past each end of the cut. Both can be turned off under 4th Axis in Machine Settings. The Operation Guide covers the workholding and end settings.
Set the blank to match how the part is actually mounted, then check your A-axis setup and travel limits on the controller before running. Changing the rotary axis or the chuck side invalidates rotary operations; changing the post invalidates indexed ones.
Scene Management
The scene is a tree of groups and shapes with full undo and redo. Every structural change can be reversed.
- Grouping
- Select two or more items and use Group (or Ctrl+G). The new group appears where the first selected item was, and nothing moves.
- Ungrouping
- Select a group and use Ungroup (or Ctrl+Shift+G). Children move up to the group's parent and keep their exact positions.
- Drag-move
- Click and drag on the canvas to move the selection. Shapes follow the direction you dragged on screen, even inside a rotated or scaled group. The move is committed when you release.
- Multi-selection
- Shift-click to toggle, Ctrl-click to add, or drag a marquee. Alt-click picks the individual shape inside a group instead of the group.
Shape Transforms
Shape Transform, at the top of Operation Settings, edits the selection. Its grid is absolute: it shows where the selection is, and Apply - or Enter in a field - writes what you typed. Reset returns to the file's own placement. Nothing here alters your original file.
- Offset X / Y
- How far the selection sits from where its file put it, in millimetres.
- Offset Z
- Meshes only: how far a flat relief model is raised from its seat on the stock surface (negative sinks it). In the rotary frame X, Y and Z move the mesh from its place on the axis.
- Rotation X / Y
- Meshes only: tilts the model about its own X axis, then its Y axis, in degrees.
- Rotation Z
- Absolute, in degrees, about the shape's centre, independent of scale.
- Bot-Left / Chuck / Center
- In the flat scene, Bot-Left and Center move the selection so its bottom-left corner, or its centre, lands on the origin. In the rotary frame, Chuck and Center place the mesh along the axis (above).
- Scale and Mirror
- Scale is an absolute factor - 1.0 is the original size - with its own Apply and Reset. The mirror checkboxes flip X or Y independently and apply at once.
A field that does not apply to the selection - Z and the X/Y rotations on 2D geometry, Bot-Left in the rotary frame, Chuck in the flat one - stays in place, disabled. With the 3D view open, focusing an offset or rotation field draws an arrow on the model showing what a positive value does.
What you see on the canvas, what appears in the 3D view and what gets cut are all the same numbers.
Stock Setup and Machine Settings
Stock Setup holds the blank: thickness, width and length, material, the Z-zero reference, and the origin. Set the origin by offset, or with Center and Bottom-Left, which put it on the selection - or on everything, with nothing selected. Fit to Object sizes the stock around the selection; a mesh sets the thickness as well. From the canvas, B and C do the same as the two origin buttons.
Machine Settings apply to every operation: the post-processor, units and line numbers, tool length offset, Absolute Z0, the safe and travel heights, rapid feed, coolant and vacuum, and the 4th axis - which machine axis the rotary turns about, which end the chuck holds, the route, the index dwell and what the 3D view draws. Every field, its values and its default are listed on the Parameter Guide.
- Post-Processor
- The G-code dialect your controller expects. Set it first: its setup decides which other settings appear and what they start at, and it can lock some of them while it is selected.
- Tool Length Offset
- Shown when the post offers more than one mode. Controller tool table tells the control which offset to use after each swap; H from T lets the control take the offset from the tool number itself; Measured at change time leaves it to the post's macro, because the machine measures the tool during the change. Pick whichever your controller is set up for.
- Line Numbers
- Any program can carry
Nline numbers, with a step you choose. Each post has its own default - some controllers and file senders want them, most do not care.
Some settings invalidate operations
Indexed 3+1 needs a post that can drive the A or B axis, so changing the post invalidates generated indexed operations. Changing the rotary axis or the chuck side invalidates every rotary operation. Any other machine setting makes calculated toolpaths stale until you calculate them again.
The parameters worth understanding first
Full ranges and defaults for every field are on the Parameter Guide. These four come up in every job:
- Tool
- Picks the cutter from the tool library; its diameter drives every offset. For a V-bit, the tool diameter is the flat at the tip, not the width it cuts at the surface.
- Tool Number
- The number your controller receives. Nothing is guessed - which slot a cutter sits in is something only you know, and a wrong number is a crash. An operation without one does not generate. If your machine has no changer, 1 on every operation is correct.
- Cut Depth and Depth per Pass
- Total depth into the stock, and the most to remove in one pass. As many passes as needed are generated for you.
- Feed, Plunge and Spindle
- Cutting speed, descent speed and spindle RPM. Plunge is usually 30-50% of feed. Spindle dwell holds the program until the spindle is up to speed.
The Export Manager
The Export Manager is where the whole job comes together: the order operations run in, tool changes between them, split files, and the moves from one operation to the next. Open it from any operation's Output stage, or with Actions → Export Files….
- Review buckets. Everything that has been through Calculate Toolpaths is listed with its type, tool and pass count. Check the ones you want.
- Order them. Drag them into the order you want to run them - the order you set is treated as deliberate. (The list also reorders from the keyboard: Space to grab, arrows to move, Space to drop.)
- Set the output options (below).
- Calculate Toolpaths to build the program and review the G-code, with line count, operation count, estimated time and distance.
- Export Files to download.
Output Options
An option that does not apply to the current job is greyed out, with the reason beside it.
- Base Name
- Every file starts with it, followed by the operation it holds. Left empty, it is the first operation's name. The extension comes from the post-processor.
- Export as single file
- Combines the operations into one program, cut in list order.
- Split drill files by bit
- Multi-file mode, for drill jobs that use more than one bit: one program per bit, so each file loads exactly one cutter.
- Bundle files into one .zip
- On by default: more than one file downloads as one archive named after the base name.
- Include operation comments
- A comment block naming each operation at the top of the program. G-code comments are always in English, folded to plain ASCII, so any control reads them.
- Verbose comments
- Adds each operation's tool, feeds, depths, step-over and deepest Z to that block, so an old file reads without the project.
- Insert tool change commands
- Emits T and M6, plus the tool length offset, wherever a file switches tools - a combined file, or a multi-tool drill. Needs a post with tool changes.
- Group operations by tool
- Reorders the combined file so operations that share a tool run back to back. This overrides the order you dragged, so it is never applied unless you ask for it.
- Optimize path order (whole job)
- Reorders paths to shorten travel between cuts. On by default; turn it off to keep the generated order when tracking down an unexpected move.
Multi-tool jobs
With Insert tool change commands on and a post that supports them, a multi-tool job exports as one program with the swaps inline. Without that, turn off Export as single file and you get one program per operation to load in sequence.
Tool numbers are yours to manage
Nothing here can know which slot a cutter is physically in, and it will not pretend to. Assign the numbers, keep them matched to the machine, and check them before you run. When one number carries two different sizes, the Export Manager says so.
Tips & Troubleshooting
SVG Preparation
- Convert text to paths before export.
- Close any path you plan to profile, pocket or V-carve. Engraving and drilling do not care.
- Use circles and obrounds - not ellipses - for drill holes and slots.
- Set document units to millimetres.
- Avoid clipping masks and SVG clones; neither is imported.
- Flatten transforms in Inkscape if shapes import at unexpected positions.
Best Practices
Start with a built-in example
Load an example from the welcome screen and take it all the way through before processing your own files. The flatpack coffee table covers the 2.5D route; the V-carve sign, the flat relief tile and the rotary pawn cover the 3D ones.
Check tool diameter against shape size
If a pocket or profile produces nothing, the tool is too large for the shape. Pick a smaller cutter or scale the design up. On a pocket this is expected rather than an error - a pocket is meant to run out of material to remove.
Order operations for the job, not the list
Pockets and internal features first while the stock is rigid, then drilling, then profile cuts last so parts do not shift once they are cut free. Set that order in the Export Manager; the order the buckets sit in does not affect the output.
Common Issues
Canvas is blank or black
Cause: browser graphics compositing, common on laptops with two GPUs. Fix: restart the browser; it renders correctly on reload.
"Open paths detected" warning
Cause: profile, pocket and V-carve need closed shapes, and your SVG has paths that do not close. Fix: close them in your vector editor and re-import, or use Engrave, which accepts open paths by design.
Shapes import at the wrong position
Cause: transforms on parent elements in the SVG. Fix: flatten transforms in your editor before export, or just move the shapes in the scene - nothing is destructive.
Generation is slow
Cause: complex geometry, or a very fine resolution on a large mesh. Fix (flat): fewer passes, a larger step-over, or a simpler SVG. Fix (3D): use a coarser resolution first, confirm the result looks right, then tighten it for the final run. On a rotary job, an explicit carve depth avoids the slow auto depth near the axis.
A bucket is invalidated
Cause: a parameter an earlier stage depends on was changed, a shape in it moved, or a setting it reads changed (the post on an indexed job, the rotary axis or chuck side on any rotary job). Fix: regenerate from the stage named in the message. Only the layers after your change are cleared.