Known limits
Known limits and roadmap
NativeCAM is version 0.1. This is what doesn't work yet, mirrored from the repository's known limits.
Testing on real machines
- Only Avid Mach4 output has run on a real machine. Every other controller's output follows its documentation (and, for Centroid, Avid's EX posts) and should be treated as unverified: run the acceptance test in check mode where there is one, then air-cut.
- Run-time estimates use each controller's planner model and look-ahead, with acceleration from your controller's settings when you import them and labelled class defaults otherwise. They haven't been timed against a real machine yet.
- NativeCAM was written almost entirely by an AI coding assistant and hasn't had a line-by-line human review. Until it has more hours on real routers, treat every program it makes as unproven: check the toolpaths in the simulator, read the G-code, and air-cut before cutting material.
Toolpaths
- 3D finishing's waterline, steep-and-shallow, pencil and cross-hatch passes (tutorial) haven't been cut on a real machine yet. The steep-and-shallow split reads the slope of the cutter-location surface, which for a ball nose is the model's own slope and for other bits only close to it. Pencil cleanup needs a ball nose, makes one pass per crease (no parallel passes either side of it), and doesn't look at what an earlier, larger ball left: there's no 3D rest machining yet. Waterline loops are always climb milled. Links keep the tool centre inside the boundary, so rows that end on the boundary still link along it rather than on an arc. There's no constant-scallop (3D offset), spiral or radial finishing.
- Tapered ball noses aren't a bit shape yet (tool libraries skip them on import), though the exact drop-cutter can already drop one. A flat end mill's 3D allowance is added straight up rather than square to the surface, so on steep slopes it leaves less than asked for; every other bit leaves it square to the surface.
- No nesting or plasma (THC) support yet.
- Feeds that follow the load (tutorial) aren't calibrated on a machine. The rule (the chip held at the usual cut's, the extra force split evenly between a thinner chip and a higher load, a 55% floor) is reasoned from chip-load geometry, not measured. Whether Mach4 keeps its constant-velocity blending through a change of F hasn't been timed, which is why it's off unless you turn it on. Earlier toolpaths' cuts are known only to the job's material model (0.5–1 mm cells), so a light pass after another toolpath is measured roughly. Inside-arc compensation needs fitted arcs: with arc output off, curves are short lines and slow only for their engagement. Depth of cut doesn't change the feed (a pass deeper than the bit's diameter isn't derated), the spindle speed never changes with the feed, and wrapped rotary toolpaths keep their feed.
- Toolpath templates (tutorial) find vectors by layer or by kind, not by size (Vectric's circle-diameter filter), and there's no step that creates missing layers: a toolpath whose layer is missing is added empty. DXF, SVG, PDF and Illustrator layers are read on import (an SVG's from Inkscape layers or the named groups straight under its root); a DXF layer that's turned off or frozen in your CAD program is imported like any other. Layered SVG files from Illustrator, Affinity and Inkscape haven't been tried yet, only hand-written test files. A toolpath bound to a layer or kind picks up new vectors on Recalculate All, on a layer change and on import, but not when a shape is drawn with Add Shape until you recalculate. A template's job setup leaves out the material's width and height and any rotary blank (a rotary template's index angles are kept). On a rotary job the sheet's thickness is the blank's radius, so a Through depth there reaches past the axis, as a new profile's depth always has.
- Tiling (tutorial) hasn't been cut on a real machine yet. Registration holes are drilled for feed-through tiling only, two at a time. Where a profile breaks at a tile line, the bit comes back onto the wall with a plunge or a ramp rather than a lead. Clamps are checked where they're drawn on the design, which moves with the material. Near tile lines, start depths and leads don't count on earlier toolpaths' cuts (the tiles cut in a different order there), so a toolpath can cut some air there. The run-time estimate leaves out moving the material between tiles. Rotary jobs can't be tiled.
- Chamfers, flutes and prisms (tutorial) haven't been cut on a real machine yet. Chamfers and prisms need a V-bit or engraving bit: there's no angled chamfer with a round-nose bit, and no Overcut (Vectric's offset that keeps a V-bit's tip off the bevel). A top-edge chamfer leaves the bevel uncut where shapes are closer together, or narrower, than twice its width, rather than carving the narrow part as a V-carve would. A prism's bit cuts past the outline; the area round it isn't cleared for you. Flutes follow the material top (or a start depth): they aren't projected onto a 3D model. Projects with any of them are saved as format 8, which older builds refuse to open.
- Rest machining covers 2.5D pockets cleared with a larger end mill in the same toolpath (tutorial). A pocket can't yet take its rest from earlier toolpaths (cutting only what an earlier pocket on the same shapes left), and there's no 3D rest machining (a smaller bit after 3D roughing). Rest machining hasn't been cut on a real machine yet.
- A corner's own relief choice is tied to its place on the shape: change the shape so that corner moves (resize a rectangle, say) and the choice no longer applies, and Checks says so.
- Leads and corner reliefs keep clear of the parts other profile, pocket, V-carve, drill, chamfer, fluting and prism toolpaths cut (how), but not of 3D toolpaths' models, and on an indexed rotary job only of parts cut at the same angle.
V-carve inlays
- Not cut on a machine yet. No inlay pair has been cut on a real machine. The fit has only been checked in the simulator, so cut a small test pair in scrap before a real piece (tutorial).
- An inlay is two V-carve toolpaths, a pocket and a plug, rather than one operation that makes both. The plug stays where the design is, so cut the two sides one at a time.
- The plug is always mirrored left to right. Its boundary is a selected vector or a margin round the design; for the whole board, draw a rectangle the size of the board.
- A V-bit with a flat tip leaves narrow parts of the plug taller than the pocket's grooves. Checks warns, but the plug isn't adjusted for it.
- When the V-bit clears flat areas itself it cuts offset rings only, which is slow over large areas.
Rotary
- Not verified on a machine. Mach4's
G93inverse-time feeds haven't been tested on a machine yet. Not yet checked on Avid's rotary: which way positive A turns, and whether its M6 macro in rotary mode re-zeroes Z on the axis. - On faces (indexed): profile, pocket, drill, V-carve, chamfer, fluting and prism operations repeat at a list of angles on a round blank, or on a square bar at multiples of 90°. The posts turn the blank with
G00 Aat safe Z for Avid Mach4, LinuxCNC, grblHAL, Centroid and Buildbotics. Grbl, FluidNC, Carbide Motion and Masso can only run indexed jobs turned by hand, with a pause (M0) for each turn. ShopBot and RichAuto files can't turn the blank at all. - Wrapped around: profile, pocket, V-carve, drill, chamfer, fluting and prism operations and spirals wrap around a round blank (or a square bar rounded first), fed in inverse time (
G93) for Avid Mach4, LinuxCNC and grblHAL, on a driven axis only. Rounding turns a blank round on either layout, on a driven axis. Rounding hasn't been cut on a machine yet: for a first try, use softwood, a shallow layer depth and a lowered feed override. - 3D rotary finishing follows a model laid along the axis on either layout, on a driven axis with
G93, exactly with ball noses, flat end mills, bull noses, V-bits, engraving bits and drills. There's no 3D rotary roughing yet (stage R4): where the model is deeper than the pass depth, the finish cuts down in layers that follow the whole pattern, which is slow next to clearing each layer as an area; round the blank first. The tool always points at the axis (no ball-nose offset in Y), the reach check takes the deepest cut against the stickout rather than modelling the collet nut, and undercuts are reported but not shaded on the model. 3D rotary finishing hasn't been cut or air-cut on a machine (tutorial). - Only an A axis along X is supported.
- Turn times use the machine's turn speed, or a nominal 90° a second until it's set, and 30 seconds for each turn by hand; none has been timed on a real machine. Wrapped cuts are timed by the tool tip's path. Rounding, wrapped toolpaths, spirals and 3D rotary finishing all lower their feed where A would have to turn faster than the turn speed, and Checks says how far. Whether Mach4 runs those slowed
G93moves at the posted times hasn't been tested. - A wrapped wall cut straight along the blank shows very slightly radial in the simulation, because it keeps one surface height per angle.
- Rotary projects are saved as format 3, format 4 when the blank is turned by hand, format 5 when designs wrap around it or it has a spiral or a rounding toolpath, and format 7 with a 3D model on the blank or a 3D rotary finish, and format 8 with a chamfer, fluting or prism toolpath.
- Imported G-code with A words is simulated as if the part never turned, with a warning; its
G93moves are timed by their F words.
Files
- EPS isn't supported. A PDF clipping mask made from live text isn't applied; convert the text to outlines first.
- Vectric's older
.toollibraries aren't supported. Tapered ball nose, form, dovetail, roundover and thread bits in imported libraries are listed as not imported. - Tapping and boring cycles in imported G-code are simulated only for controllers whose documentation describes them: Avid Mach4, Centroid and LinuxCNC (which cycles). For others, and for a cycle a controller means something else by (
G76threads on LinuxCNC), they're skipped with a warning and their holes don't show. A back bore (G87) is carved as a hole right through, the width of the tool. Taps are cut in one pass: aQword isn't read as a peck depth. The spindle reversing at the bottom of a tap, orienting forG76andG87, and aG88stop to retract by hand are timed at 0.5 s, 0.5 s and 10 s. None of this has been compared with a real controller. - Mach3 profiles and Masso's
.htgfiles are refused by the controller-settings import, with the reason. - Projects with a V-carve start depth or an inlay plug are saved as format 6. Older builds refuse to open a format they don't know rather than write the wrong G-code. An inlay pocket on its own doesn't raise the format, since older builds cut it the same.
- Tiled jobs are saved as format 9, and projects with waterline, steep-and-shallow or pencil 3D finishing, or a cross-hatched raster, as format 10.
Changes that affect existing projects
- The command line's
template applykeeps the project. Without-oit used to overwrite the project it was given. It now writesproject + template.nativecambeside it (then… 2,… 3) and leaves the project alone; pass--in-placeto overwrite it. Scripts that relied on the old behaviour need--in-place. - Layered drawings import as one shape per layer. A DXF, SVG, PDF or Illustrator file with several layers now comes in as several shapes, one per layer, each named file – layer and on that layer; pieces on different layers are never joined. A file with one layer imports as before.
- Post 3D finishes over steep walls again. Where a 3D finishing row rolled off the top edge of a steep wall, the straight move between two drop-cutter samples could clip the edge: about 0.25 mm into a vertical wall with a ¼ inch ball nose, up to 0.63 mm on a medallion, and 0.02 mm on the demo relief. Any move whose middle dips below the surface, or that steps steeply off it, is now split until no piece does, so at a wall the tool goes straight up or down at the foot of the step. If you posted a 3D finish over steep walls with an earlier build, post it again.
- Rounding and wrapped jobs run slower, at feeds the rotary can reach. Rounding, wrapped profiles, pockets, V-carves, drilling, chamfers, flutes, prisms and spirals now lower their feed wherever the blank would have to turn faster than the rotary's Turn speed (90° a second until it's set), as 3D rotary finishing already did, and Checks says how far each one comes down. Posted again, these jobs get lower F words and longer run times, but no move asks the axis to turn faster than it can. With no turn speed set, the demo pawn goes from 19:49 to 22:08 and the barley-twist leg from about 17 minutes to 55; set your rotary's turn speed to get your machine's real figure. Rotary work hasn't been cut on a machine yet.
- Post 3D rotary finishes again. A finishing move that turned the blank more than a quarter turn while coming in toward the axis could ask the rotary to turn faster than its Turn speed near the axis. Each piece of such a move is now held to the turn speed, so the posted file changes. Rotary work hasn't been cut on a machine yet.
- Post jobs with cuts outside the drawn material again. A plunge more than a bit's radius outside the drawn material was treated as if it were over a floor already cut, so the tool could rapid (
G00) straight down to cut depth there and feed sideways at depth: into the spoilboard for a deep hole, or into real wood when the board is bigger than the one drawn. Now nothing past the edge of the drawn material counts as cut: the tool feeds down from the plunge height, and links don't stay down across it (fix). If you exported a job with cuts outside the drawn material, holes drilled into the spoilboard or a board bigger than drawn, say, post it again and check it forG00moves below Z 0. - Leads and reliefs keep clear of other toolpaths' parts. Leads now keep clear of parts cut by other toolpaths, not just their own shapes, clamps and the material edge, and a corner relief that would cut into another toolpath's part is left off and flagged (Corners ▸ Leave off reliefs that cut into other parts, on by default). Leads and reliefs next to another toolpath's part may move or be left off, so re-posting such a job can change its G-code: simulate it again before you cut.
- New starter speeds and a ½ inch end mill. The starter ¼ inch upcut, downcut and compression end mills now run at 13,000 RPM instead of 18,000, and the ¼ inch ball nose at 15,000, with the same feeds, so the chip load is inside the chart for plywood and hardwood. There's a new T10, a ½ inch upcut end mill at 6,500 RPM and 250 in/min, which rest machining picks for ¼ inch pockets; that speed is near the bottom of a VFD spindle's range, so if yours won't run that slow, raise the speed and the feed together. A tool library you've saved isn't changed: Tool Library ▸ ⋯ ▸ Add Missing Starter Tools adds T10 (and any other starter bit you don't have) without touching your own tools, but the new speeds for bits you already have are yours to enter. Reset to Starter Library… replaces the whole library after asking, and keeps the old one as
tools.json.bak. Projects keep the bits they were made with; the demo sign and relief now postS13000for their ¼ inch bit, and the relief's ¼ inch bit feeds at 220 instead of 315 in/min. - Post deep jobs again. A link over a floor cut deeper than the safe distance (0.2 inch by default) could rapid sideways below the top of the material. It happened on deep V-carve inlay plugs (a pocket depth of about 0.22 inch or more), deep pockets with islands, and V-carves with a start depth inside a deep pocket. Links now go over at the safe distance above the top and drop straight down (fix). If you posted a job like that with an earlier build, post it again before you cut it.
- The command line stops on job-check errors.
nativecam-cli postnow refuses to write a file when the job's own checks find an error, as well as the checks on the file, and exits with status 1 unless you pass--force(details). Scripts that relied on it writing anyway need--force. - V-carve flat bottoms without a clearance tool. A flat-bottomed V-carve with no tool under Clear flat area with now has its flat cleared by the V-bit, as Vectric VCarve does. Before, the middle of the flat was left standing. Re-exporting such a project gives different G-code, so simulate it again before you cut. V-carves with a clearance tool, or without a flat bottom, post the same as before.
Packaging
- There's no packaged or notarised download yet. Build it from source.
- NativeCAM needs Apple silicon and macOS 14 or later.
Bug reports, results from your own machine and code reviews are all very welcome: open an issue, or see Develop to contribute.