Path Tools

Note: This page describes the ToolBit architecture which became the default in v 0.19. For the older 'Legacy' tool system see Path_ToolLibraryEdit

Description
Tools in the Path workbench are handled differently than in other CAM packages

There are several concepts that the user needs to understand:

ToolShapes: ToolShapes are templates for creating toolbits. Toolshapes are FreeCAD documents that model the tool using named constraints. The toolshape is an _abstract_ tool template from which tool instances (called toolbits) are created. For example, all endmills will share the same toolshape file.

ToolBit: Toolbits are instances of a toolshape. A toolbit will have _specific_ values for each of the named constraints in the toolshape. A toolbit is used in a Path Job through a Tool Controller (TC). The same toolbit can exist in multiple libraries.

Toolbit Library: A library is an arbitrary collection of toolbits. The specific tools in a library is entirely up to the user. Possible use cases for libraries:

* A hobbyist user may have only one library for all of the tools they own. * A library may contain all the tools used for a specific material like aluminum or wood * A library may have toolbits for working on specific material * A library may hold toolbits from a specific supplier * A library may correspond to an automatic tool changer layout.

A Tool Controller controls how a tool is used in a Path Job. A controller combines the toolbit with properties for spindle speed, direction and Horizontal/Vertical feed rates.

Dialogs
The user will interact with the tool management system in two different workflows. Each workflow has dedicated GUI elements.


 * Toolbit Dock For using tools in a Path Job by creating Tool Controllers
 * Toolbit Library Manager For managing the user's Toolbit collection

Organization
When FreeCAD is installed a default hierarchy of tool libraries and toolbits is created in the installation directory (Mod/Path/)

Tools + Bit + Library + Shape

The user, however, is free to store their toolbits and libraries anywhere they wish. Even custom toolshapes can be stored in arbitrary locations where they can be backed up. The user is encouraged, however, to use a logical structure as shown above to keep toolbits and libraries organized.

Options
References to Tool Bits and their shapes can either be stored with an absolute path or with a relative path to the search path. Generally it is recommended to use relative paths due to their flexibility and robustness to layout changes. Should multiple tools or tool shapes with the same name exist in different directories it can be required to use absolute paths.

See Path Preferences to choose whether absolute or relative paths are used

Migrating from Legacy Tools
If you have been using FreeCAD Path workbench for a while, you may need to adjust your preferences before you can use the Toolbit system. If pressing the Tool Library button on the toolbar shows the legacy dialog, Go to the page below in Path preferences and disable legacy tools