CAM Tools: Difference between revisions

From FreeCAD Documentation
No edit summary
(Path->CAM)
 
(56 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
{{Page in progress}}
{{UnfinishedDocu{{#translation:}}}}
<translate>


<!--T:1-->
{{Docnav
{{Docnav
|[[CAM_Area_Workplane|Area Workplane]]
<!--
|[[Path_Simulator|Simulator]]
|[[CAM_ToolShape|ToolShape]]
|[[CAM_Workbench|CAM]]
|[[Path_SelectLoop|Complete Loop]]
|IconL=CAM_Area_Workplane.svg
|[[Path_Workbench|Path]]
|IconR=
|IconL=Path_Simulator.png
|IconC=Workbench_Path.svg
|IconC=Workbench_CAM.svg
|IconR=Path_SelectLoop.svg
-->
}}
}}


</translate>
{{GuiCommand
{{TOCright}}
|Name=Path Tools
<translate>
|Workbenches=[[Path Workbench|Path]]
|MenuLocation=Path → Tool Manager
|Shortcut={{KEY|}} {{KEY|}}
|SeeAlso=
}}


== Description == <!--T:2-->


<!--T:3-->
==Description==
This page describes the ToolBit architecture used in the [[CAM_Workbench|CAM Workbench]] which became the default for FreeCAD v 0.19. For the older 'Legacy' tool system see [[CAM_ToolLibraryEdit|CAM ToolLibraryEdit]]. Tools in the CAM workbench are handled differently than in other CAM packages.

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


<!--T:4-->
There are several concepts that the user needs to understand:
There are several concepts that the user needs to understand:


<!--T:5-->
ToolShapes: ToolShapes are templates for creating toolbits. Toolshapes are FreeCAD
documents that model the tool using named constraints. The toolshape is an _abstract_
* [[CAM_ToolShape|CAM 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.

tool template from which tool instances (called toolbits) are created. For example,
<!--T:6-->
all endmills will share the same toolshape file.
* [[CAM_ToolBit|CAM ToolBit]]s: 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 CAM Job through a Tool Controller (TC). The same toolbit can exist in multiple libraries.

<!--T:7-->
* [[CAM_ToolBit_Library|CAM ToolBit Library]]: contains 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.

<!--T:8-->
A [[CAM_ToolController|Tool Controller]] controls how a tool is used in a CAM Job. A controller combines the toolbit with properties for spindle speed, direction and Horizontal/Vertical feed rates.

== Dialogs == <!--T:9-->


<!--T:10-->
ToolBits: Toolbits are instances of a toolshape. A toolbit will have _specific_ values
The user will interact via CAM menu with the tool management system in two different workflows. Each workflow has dedicated GUI elements.
for each of the named constraints in the toolshape. A toolbit is used in a Path Job
through a Tool Controller (TC)


<!--T:11-->
Toolbit Library: A library is an arbitrary collection of toolbits. The specific
* {{Button|[[Image:CAM_ToolBitLibraryOpen.svg|24px]] [[CAM_ToolBitDock|Toolbit Dock]]}} view indicated at the box top as ''Tool selector'', for using tools in a CAM Job by creating Tool Controllers.
tools in a library is entirely up to the user.
* {{Button|[[Image:CAM_ToolBitDock.svg|24px]] [[CAM_ToolBitLibraryOpen|Toolbit Library Manager]]}} for managing the user's Toolbit collection with ''Create Toolbit'', ''Add Existing'' and ''Remove'' buttons.
Possible use cases for libraries:


== Organization == <!--T:12-->
- A hobbyist user may have only one library for all of the tools they own.


<!--T:13-->
- A library may contain all the tools used for a specific material like aluminum or wood
When FreeCAD is installed an example hierarchy of tool libraries and toolbits is created in the installation directory at:


<!--T:14-->
- A library may have toolbits for working on specific material
* On Linux it is usually {{FileName|/usr/lib64/FreeCAD/Mod/CAM/Tools}}
* On Windows it is usually {{FileName|C:\Program Files\FreeCAD\Mod\CAM\Tools}}
* On macOS it is usually {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod/CAM/Tools}}


<!--T:15-->
- A library may hold toolbits from a specific supplier
<pre>
Tools
+ Bit
+ Library
+ Shape
</pre>


<!--T:16-->
- A library may correspond to an automatic tool changer layout.
It is always recommended to store the new created toolbits and libraries in a safe location to avoid them being overwritten on a program upgrade. Even custom toolshapes can be stored in arbitrary locations where they can be backed up. The user is encouraged, however, to use a comparable logical structure as shown above to keep toolbits and libraries well organized. When the Tool library Manager is opened, CAM checks the location of the working directory. If the location is not writeable or is the same as the example/default location, CAM will prompt the user to select or create a new working directory.


== Options == <!--T:17-->


<!--T:18-->
The {{KEY|[[Image:Path Tools.svg|16px]] [[Path Tools|Tool xxxxx]]}}
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.


<!--T:19-->
[[Image:Path-Tooltable.png]]
See [[CAM_Preferences|CAM Preferences]] to choose whether absolute or relative paths are used.


== Migrating from Legacy Tools == <!--T:20-->
==Dialogs==


<!--T:21-->
The user will typically interact with the tool management system in two different
If you have been using FreeCAD CAM 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 [[CAM_Preferences|CAM Preferences]] and disable legacy tools.<br>
workflows. Each workflow has dedicated GUI elements.
You have to restart FreeCAD to make the change valid.


<!--T:22-->
===Toolbit Dock===
[[File:Preferences.png|thumb|Disable Legacy Tools]]


== Getting Started with Tools in FC 0.19 == <!--T:23-->
The ToolBit dock is easily accessible from the main toolbar in the Path workbench.
Pressing the button (button) will toggle the state of the dock. The dock is displayed
in the right position by default but may be moved by the user. The dock can also be
toggled with the Accelerator sequence (p,t)


<!--T:24-->
The purpose of the dock is to display the currently selected library and allow the user to quickly
Read the `Migrating from Legacy Tools` section above. The steps below will walk you through the process of getting a ToolBit into your particular {{KEY|[[Image:CAM_Job.svg|16px]] [[CAM_Job|CAM Job]]}}.
add tool controllers to the Path Job(s).


<!--T:25-->
Double-clicking on a toolbit will create a single tool controller for the toolbit.
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.
Multi-selecting toolbits and pressing the 'Add to Job' button will create tool controllers for all toolbits in the libarary.


=== Verify or create a Tool Shape === <!--T:26-->
The user may also select multiple tools and use the 'add...' button at the bottom to
add tool controllers for the selection.


<!--T:27-->
The top of the panel contains an text field showing the current path and a 'browse' button
Getting a cutter or tool into a CAM Job for use in operations starts with a [[CAM_ToolShape|Tool Shape]]. This step of verification or creation of a Tool Shape is not necessary if you already have an existing ToolBit available.
to choose another path. When a path is selected, all tool libraries from that location
are scanned and shown in the dock. The dock will remember the last selection between uses


==== Verify your desired Tool Shape exists ==== <!--T:28-->
A cog button at the top right allows the user to launch the libarary manager (see below)


<!--T:29-->
===Toolbit Library Manager===
* FreeCAD includes a set of common tool shapes with each distribution. Visit the [[CAM_ToolShape|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 [[CAM_Tools#Organization|organization]] as mentioned above.


==== Create a new Tool Shape ==== <!--T:30-->
The library manager is the dialog for creating, managing, and organize toolbits.
Launching the library manager from either the Path menu or from the 'cog' button
in the dock will display the manager as a modal dialog.


<!--T:31-->
From here the user can perform all task related to toolbit management :
:Follow the instructions outlined in the [[CAM_ToolShape#Usage|Usage]] section of the [[CAM_ToolShape|Tool Shape]] page to create a custom tool shape.


=== Load or create a ToolBit === <!--T:32-->
- Create/edit/delete Toolbits
- Create libraries
- Add toolbits to libraries
- Remove toolbits from libraries
- Export a library to the LinuxCNC tooltable (.tbl) format


<!--T:33-->
Only the creation of new toolshapes cannot be done from the toolmanager.
Once the desired tool shape(profile) exists, you need to create a [[CAM_ToolBit|tool bit]] using the tool shape (profile).
This is an advanced topic. (see toolshape creation)
# In the [[Image:Workbench_CAM.svg|24px]] [[CAM_Workbench|CAM Workbench]] menu bar, navigate to {{MenuCommand|CAM → Create Tool}}.
# In the [[CAM_ToolBit|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.
# A thumbnail of the selected tool shape should appear along with a list of parameters.
# Set the Bit Parameters as desired.
# Click {{KEY|OK}} to save the new tool bit.
# The new Tool Bit will appear in the FreeCAD object tree.


=== Save the new ToolBit === <!--T:34-->


<!--T:35-->
Like the dock, the top of the library manager shows a the current working path and a 'browse' button
# Locate and select the new tool bit in the object tree in the main FreeCAD window.
to choose a different path as the working path. When a path is selected, all tool libraries from that location
# In the [[Image:Workbench_CAM.svg|24px]] [[CAM_Workbench|CAM Workbench]] menu bar, navigate to, and select, {{MenuCommand|CAM → Save Tool as...}}.
are scanned and shown in the manager.
# A pop-up window will appear.
# Navigate to the folder where you wish to save the new tool bit file.
# Enter a file name for the tool bit.
# Click the {{KEY|Save}} button.


=== Register the ToolBit in a Tool Library === <!--T:36-->
The manager will remember the last active tool library and working directory between uses.


<!--T:37-->
# In the [[Image:Workbench_CAM.svg|24px]] [[CAM_Workbench|CAM Workbench]] menu bar, navigate to {{MenuCommand|CAM → Open ToolBit Library editor}}.
# The [[CAM_ToolBitLibraryOpen|ToolBit Library Manager]] window will open.
# 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.
# 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.
# 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 {{KEY|Add ToolBit}} icon.
# In the file navigation window that opens, navigate to your new tool bit, select it, and click the {{KEY|Open}} button. The new tool bit will be added to the active tool library.
# Be sure to click the {{KEY|Save Table}} button at the bottom of the Tool Library window in order to save the changes.
# 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.


=== Add a ToolBit Tool Controller to a Job === <!--T:38-->
==Usage==


<!--T:39-->
# Select a {{KEY|[[Image:Path_Job.svg|16px]] [[Path Job|Path Job]]}}
# In the open Tool Library window, locate and activate the desired tool library.
# Invoke the Tool Manager using several methods:
# Select the desired tool bit(s) to be added to the Job. Select multiple by holding down the CTRL key when selecting.
#* Press the {{KEY|[[Image:Path ToolLibraryEdit.png|16px]] [[Path EditToolsTable|Tool Manager]]}} button in the toolbar.
#* Using the {{KEY|P}} then {{KEY|T}} keyboard shortcut.
# Click the {{KEY|Add Tool Controller(s) to Job}} button.
# Close the ToolBit Library
#* Using the {{MenuCommand|Path → Tool Manager}} entry from the top menu.
# Create new tools or adjust the properties of existing tools.<br>Set at least the diameter, FreeCAD needs it to calculate the radius compensation. As of {{VersionPlus|0.17}} this is the only value used for path creation. However, if you wish to use the simulation tool later, add cutting edge angle and cutting edge height as well.<br>[[Image:Path-ToolAdd.gif]]


== Related == <!--T:40-->
==Options==


<!--
<!--T:41-->
* [[CAM_ToolBit|CAM ToolBit]]
* The tools can be reordered by using the move up/move down buttons
* [[CAM_ToolBitLibraryOpen|CAM ToolBitLibraryOpen]]
* Complete tooltables can be imported from XML files (FreeCAD's own tooltable format) or from HeeksCAD tooltables
-->




<!--T:42-->
{{Docnav
{{Docnav
|[[CAM_Area_Workplane|Area Workplane]]
<!--
|[[Path_Simulator|Simulator]]
|[[CAM_ToolShape|ToolShape]]
|[[CAM_Workbench|CAM]]
|[[Path_SelectLoop|Complete Loop]]
|IconL=CAM_Area_Workplane.svg
|[[Path_Workbench|Path]]
|IconR=
|IconL=Path_Simulator.png
|IconC=Workbench_Path.svg
|IconC=Workbench_CAM.svg
|IconR=Path_SelectLoop.svg
-->
}}
}}


</translate>
{{Path_Tools_navi{{#translation:}}}}
{{CAM_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 11:42, 17 March 2024

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Description

This page describes the ToolBit architecture used in the CAM Workbench which became the default for FreeCAD v 0.19. For the older 'Legacy' tool system see CAM ToolLibraryEdit. Tools in the CAM workbench are handled differently than in other CAM packages.

There are several concepts that the user needs to understand:

  • CAM 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.
  • CAM 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 CAM Job through a Tool Controller (TC). The same toolbit can exist in multiple libraries.
  • CAM ToolBit Library: contains 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 CAM Job. A controller combines the toolbit with properties for spindle speed, direction and Horizontal/Vertical feed rates.

Dialogs

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

  • Toolbit Dock view indicated at the box top as Tool selector, for using tools in a CAM Job by creating Tool Controllers.
  • Toolbit Library Manager for managing the user's Toolbit collection with Create Toolbit, Add Existing and Remove buttons.

Organization

When FreeCAD is installed an example hierarchy of tool libraries and toolbits is created in the installation directory at:

  • On Linux it is usually /usr/lib64/FreeCAD/Mod/CAM/Tools
  • On Windows it is usually C:\Program Files\FreeCAD\Mod\CAM\Tools
  • On macOS it is usually /Applications/FreeCAD.app/Contents/Resources/Mod/CAM/Tools
Tools
  + Bit
  + Library
  + Shape

It is always recommended to store the new created toolbits and libraries in a safe location to avoid them being overwritten on a program upgrade. Even custom toolshapes can be stored in arbitrary locations where they can be backed up. The user is encouraged, however, to use a comparable logical structure as shown above to keep toolbits and libraries well organized. When the Tool library Manager is opened, CAM checks the location of the working directory. If the location is not writeable or is the same as the example/default location, CAM will prompt the user to select or create a new working directory.

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 CAM Preferences to choose whether absolute or relative paths are used.

Migrating from Legacy Tools

If you have been using FreeCAD CAM 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 CAM Preferences and disable legacy tools.
You have to restart FreeCAD to make the change valid.

Disable Legacy Tools

Getting Started with Tools in FC 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 CAM 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 CAM 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 CAM Workbench menu bar, navigate to CAM → 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 CAM Workbench menu bar, navigate to, and select, CAM → 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 CAM Workbench menu bar, navigate to CAM → 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