CAM Tools: Difference between revisions

From FreeCAD Documentation
(Fixed Path_ToolBitLibraryOpen link(s))
mNo edit summary
Line 1: Line 1:
{{Page in progress}}
{{Page in progress}}
{{TOCright}}
{{TOCright}}

Note: This page describes the ToolBit architecture which became the default in v 0.19. For the older 'Legacy' tool system see [[Path_ToolLibraryEdit]]
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==
== Description ==


Tools in the Path workbench are handled differently than in other CAM packages
Tools in the Path workbench are handled differently than in other CAM packages
Line 30: Line 31:
A [[Path_Tool_Controller|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.
A [[Path_Tool_Controller|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 ==


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


Line 37: Line 38:
* [[Path_ToolBitLibraryOpen|Toolbit Library Manager]] For managing the user's Toolbit collection
* [[Path_ToolBitLibraryOpen|Toolbit Library Manager]] For managing the user's Toolbit collection


⚫
== Organization ==

⚫
==Organization==


When FreeCAD is installed an example hierarchy of tool libraries and toolbits is created in the installation directory (Mod/Path/)
When FreeCAD is installed an example hierarchy of tool libraries and toolbits is created in the installation directory (Mod/Path/)
Line 51: Line 51:
When the Tool library Manager is opened, Path checks the working directory. If the location is not writable or is the same as the example/default locaton, Path will prompt the user to select or create a new one.
When the Tool library Manager is opened, Path checks the working directory. If the location is not writable or is the same as the example/default locaton, Path will prompt the user to select or create a new one.


⚫
== Options ==


⚫
==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.
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.
Generally it is recommended to use relative paths due to their flexibility and robustness to layout changes.
Line 59: Line 59:
See Path Preferences to choose whether absolute or relative paths are used
See Path Preferences to choose whether absolute or relative paths are used


==Migrating from Legacy Tools==
== 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 you have been using FreeCAD Path workbench for a while, you may need to adjust your preferences before you can use the Toolbit system.
Line 66: Line 66:


[[File:Preferences.png|thumb|Disable Legacy Tools]]
[[File:Preferences.png|thumb|Disable Legacy Tools]]


==Getting Started with Tools in 0.19==
== Getting Started with Tools in 0.19 ==

Read the `Migrating from Legacy Tools` section above. The steps below will walk you through the process of getting a ToolBit into your particular Path {{KEY|[[Image:Path_Job.svg|16px]] [[Path Job|Job]]}}.
Read the `Migrating from Legacy Tools` section above. The steps below will walk you through the process of getting a ToolBit into your particular Path {{KEY|[[Image:Path_Job.svg|16px]] [[Path Job|Job]]}}.

In short, the process begins with a Tool Shape (profile) file that contains only a FreeCAD sketch of half the tool's physical shape (profile). This tool shape file is then used as the basis to create a ToolBit file containing the 3D representation of the ToolBit or cutter. One or more ToolBits are assigned to any number of Tool Libraries as needed by the user. This structure and workflow allows for sharing of Tool Shapes, ToolBits, and entire Tool Libraries - a giant leap forward from the Legacy tool management system in place prior to version 0.19.
In short, the process begins with a Tool Shape (profile) file that contains only a FreeCAD sketch of half the tool's physical shape (profile). This tool shape file is then used as the basis to create a ToolBit file containing the 3D representation of the ToolBit or cutter. One or more ToolBits are assigned to any number of Tool Libraries as needed by the user. This structure and workflow allows for sharing of Tool Shapes, ToolBits, and entire Tool Libraries - a giant leap forward from the Legacy tool management system in place prior to version 0.19.

===Verify or create a [[Path_ToolShape|Tool Shape]]===
=== Verify or create a [[Path_ToolShape|Tool Shape]] ===

Getting a cutter or tool into a Path Job for use in operations starts with a [[Path_ToolShape|Tool Shape]]. This step of verification or creation of a Tool Shape is not necessary if you already have an existing ToolBit available.
Getting a cutter or tool into a Path Job for use in operations starts with a [[Path_ToolShape|Tool Shape]]. This step of verification or creation of a Tool Shape is not necessary if you already have an existing ToolBit available.

====Verify your desired [[Path_ToolShape|Tool Shape]] exists====
==== Verify your desired [[Path_ToolShape|Tool Shape]] exists ====

* FreeCAD includes a set of common tool shapes with each distribution. Visit the [[Path_ToolShape|ToolShapes]] page to see the list of included, common tool shapes.
* FreeCAD includes a set of common tool shapes with each distribution. Visit the [[Path_ToolShape|ToolShapes]] page to see the list of included, common tool shapes.
* You might have additional tool shape files available in your personal files.
* You might have additional tool shape files available in your personal files.
* Be mindful of the greater ToolBit system [[Path Tools#Organization|organization]] as mentioned above.
* Be mindful of the greater ToolBit system [[Path Tools#Organization|organization]] as mentioned above.

====Create a new [[Path_ToolShape|Tool Shape]]====
==== Create a new [[Path_ToolShape|Tool Shape]] ====

:Follow the instructions outlined in the [[Path_ToolShape#Usage|Usage]] section of the [[Path_ToolShape|Tool Shape]] page to create a custom tool shape.
:Follow the instructions outlined in the [[Path_ToolShape#Usage|Usage]] section of the [[Path_ToolShape|Tool Shape]] page to create a custom tool shape.

⚫
=== Load or create a [[Path_ToolBit|ToolBit]] ===

⚫
===Load or create a [[Path_ToolBit|ToolBit]]===
Once the desired tool shape(profile) exists, you need to create a [[Path_ToolBit|tool bit]] using the tool shape(profile).
Once the desired tool shape(profile) exists, you need to create a [[Path_ToolBit|tool bit]] using the tool shape(profile).
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to {{MenuCommand|Path → Create Tool}}.
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to {{MenuCommand|Path → Create Tool}}.
Line 91: Line 96:
# Click {{KEY|OK}} to save the new tool bit.
# Click {{KEY|OK}} to save the new tool bit.
# The new Tool Bit will appear in the FreeCAD object tree.
# The new Tool Bit will appear in the FreeCAD object tree.

⚫
=== Save the new [[Path_ToolBit|ToolBit]] ===

⚫
===Save the new [[Path_ToolBit|ToolBit]]===
# Locate and select the new tool bit in the object tree in the main FreeCAD window.
# Locate and select the new tool bit in the object tree in the main FreeCAD window.
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to, and select, {{MenuCommand|Path → Save Tool as...}}.
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to, and select, {{MenuCommand|Path → Save Tool as...}}.
Line 100: Line 105:
# Enter a file name for the tool bit.
# Enter a file name for the tool bit.
# Click the {{KEY|Save}} button.
# Click the {{KEY|Save}} button.

⚫
=== Register the [[Path_ToolBit|ToolBit]] in a [[Path_ToolBit_Library|Tool Library]] ===

⚫
===Register the [[Path_ToolBit|ToolBit]] in a [[Path_ToolBit_Library|Tool Library]]===
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to {{MenuCommand|Path → Open ToolBit Library editor}}.
# In the [[Image:Workbench_Path.svg|24px]] [[Path_Workbench|Path Workbench]] menu bar, navigate to {{MenuCommand|Path → Open ToolBit Library editor}}.
# The [[Path_ToolBitLibraryOpen|ToolBit Library Manager]] window will open.
# The [[Path_ToolBitLibraryOpen|ToolBit Library Manager]] window will open.
Line 112: Line 117:
# Leave this ToolBit Library window open for the next step.
# Leave this ToolBit Library window open for the next step.
# Once your ToolBits are created and saved in a ToolBit Library, you may reuse them.
# Once your ToolBits are created and saved in a ToolBit Library, you may reuse them.

⚫
=== Add a [[Path_ToolBit|ToolBit]] Tool Controller to a Job ===

⚫
===Add a [[Path_ToolBit|ToolBit]] Tool Controller to a Job===
# In the open Tool Library window, locate and activate the desired tool library.
# In the open Tool Library window, locate and activate the desired tool library.
# Select the desired tool bit(s) to be added to the Job. Select multiple by holding down the CTRL key when selecting.
# Select the desired tool bit(s) to be added to the Job. Select multiple by holding down the CTRL key when selecting.
Line 124: Line 129:
* [[Path_ToolBit|Path ToolBit]]
* [[Path_ToolBit|Path ToolBit]]
* [[Path_ToolBitLibraryOpen|Path ToolBitLibraryOpen]]
* [[Path_ToolBitLibraryOpen|Path ToolBitLibraryOpen]]



{{Docnav
{{Docnav
Line 131: Line 137:
|[[Path_Workbench|Path]]
|[[Path_Workbench|Path]]
|IconL=Path_Simulator.png
|IconL=Path_Simulator.png
⚫
|IconC=Workbench_Path.svg
|IconR=Path_SelectLoop.svg
|IconR=Path_SelectLoop.svg
⚫
|IconC=Workbench_Path.svg
-->
-->
}}
}}

Revision as of 09:36, 16 May 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

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.

Organization

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

 Tools
   + Bit
   + Library
   + Shape

The user, however, should store their toolbits and libraries in a safe location to avoid them being overwritten on an upgrade. 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. When the Tool library Manager is opened, Path checks the working directory. If the location is not writable or is the same as the example/default locaton, Path will prompt the user to select or create a new one.

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.
You have to restart FreeCAD to make the change valid.

Disable Legacy Tools

Getting Started with Tools in 0.19

Read the `Migrating from Legacy Tools` section above. The steps below will walk you through the process of getting a ToolBit into your particular Path Job.

In short, the process begins with a Tool Shape (profile) file that contains only a FreeCAD sketch of half the tool's physical shape (profile). This tool shape file is then used as the basis to create a ToolBit file containing the 3D representation of the ToolBit or cutter. One or more ToolBits are assigned to any number of Tool Libraries as needed by the user. This structure and workflow allows for sharing of Tool Shapes, ToolBits, and entire Tool Libraries - a giant leap forward from the Legacy tool management system in place prior to version 0.19.

Verify or create a Tool Shape

Getting a cutter or tool into a Path Job for use in operations starts with a Tool Shape. This step of verification or creation of a Tool Shape is not necessary if you already have an existing ToolBit available.

Verify your desired Tool Shape exists

  • FreeCAD includes a set of common tool shapes with each distribution. Visit the ToolShapes page to see the list of included, common tool shapes.
  • You might have additional tool shape files available in your personal files.
  • Be mindful of the greater ToolBit system organization as mentioned above.

Create a new Tool Shape

Follow the instructions outlined in the Usage section of the Tool Shape page to create a custom tool shape.

Load or create a ToolBit

Once the desired tool shape(profile) exists, you need to create a tool bit using the tool shape(profile).

  1. In the Path Workbench menu bar, navigate to Path → Create Tool.
  2. In the Tool Bit creation task panel that appears, give the new tool bit a name and select the corresponding tool shape file as the basis for this new tool bit.
  3. A thumbnail of the selected tool shape should appear along with a list of parameters.
  4. Set the Bit Parameters as desired.
  5. Click OK to save the new tool bit.
  6. The new Tool Bit will appear in the FreeCAD object tree.

Save the new ToolBit

  1. Locate and select the new tool bit in the object tree in the main FreeCAD window.
  2. In the Path Workbench menu bar, navigate to, and select, Path → Save Tool as....
  3. A pop-up window will appear.
  4. Navigate to the folder where you wish to save the new tool bit file.
  5. Enter a file name for the tool bit.
  6. Click the Save button.

Register the ToolBit in a Tool Library

  1. In the Path Workbench menu bar, navigate to Path → Open ToolBit Library editor.
  2. The ToolBit Library Manager window will open.
  3. At the top of this window, verify or set the path to the folder containing your existing tool libraries, or the location you want to store your tool libraries.
  4. Under the path entry, on the left is the Tool Libraries list area. Click on an existing tool library you wish to use as the destination for your new tool bit, or click the green plus icon to create new Tool Library in the folder identified above.
  5. On the right side of the Tool Library editor window is the Tool Bit list and action buttons for the currently selected tool library. Click the Add ToolBit icon.
  6. In the file navigation window that opens, navigate to your new tool bit, select it, and click the Open button. The new tool bit will be added to the active tool library.
  7. Be sure to click the Save Table button at the bottom of the Tool Library window in order to save the changes.
  8. Leave this ToolBit Library window open for the next step.
  9. Once your ToolBits are created and saved in a ToolBit Library, you may reuse them.

Add a ToolBit Tool Controller to a Job

  1. In the open Tool Library window, locate and activate the desired tool library.
  2. Select the desired tool bit(s) to be added to the Job. Select multiple by holding down the CTRL key when selecting.
  3. Click the Add Tool Controller(s) to Job button.
  4. Close the ToolBit Library

Related


Template:Path Tools navi

User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=CAM_Tools&oldid=891576"