CAM ToolBitLibraryOpen: Difference between revisions

Revision as of 12:31, 20 February 2022

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.

OpActiveToggle

ToolBitDock

Path

Menu location
Path ToolBitLibraryOpen
Path → ToolBit Library editor
Workbenches
Path
Default shortcut
None
Introduced in version
0.19
See also
Path ToolBitDock, Path Tools, Path ToolBit

Description

The ToolBit Library editor:

The library manager (shown above) is the dialog for creating, managing, and organize toolbits. Launching the library manager from either the Path menu or from the 'manager' button in the dock will display the manager as a modal dialog.

From here the user can perform all task related to toolbit management :

Select a default library
Create/edit/delete Toolbits
Create libraries
Modify libraries by adding and removing toolbits
Save a library to a new name
Export a library to the LinuxCNC tooltable (.tbl) format

Only the creation of new toolshapes cannot be done from the toolbit library manager. This is an advanced topic. (see Path ToolShape creation).

The left pane (1) shows a list of all libraries in the current working directory. The current library is highlighted.

The current working directory path is shown in the window title bar (2). A file selector (3) can be used to select a different working directory.

The right side pane (4) shows all toolbits in the currently selected library. Doubleclicking in the left column allows you to change the default tool number for this toolbit. The toolnumber will be used when creating a tool controller. The number is an attribute of the library. This means the same toolbit can exist in multiple tool libraries and have different default toolnumbers in each.

Tools at the top (5) are used to create/add/remove toolbits from the current library.

The save as button (6) can be used to write the library to a new file or export to a valid tooltable format. Currently only LinuxCNC format is supported.

The manager will remember the last active tool library and working directory between uses.

The close button (7) at bottom right will dismiss the tool library manager. Any changes to the current library are persisted to disk. Pressing the Escape key will dismiss the manager but not make any changes to the current library. Whichever library is selected when the manager is dismissed will become the new default and will be shown in the Toolbit Dock.

Usage

Manage Toolbits

There are several ways to open the Toolbit Library Manager:
- Select the Path → ToolBit Library editor option from the menu.
- Open the Toolbit dock as described above and press the button to open the Library manager.
Select a library from the list.
Create/Add/Remove toolbits from the library.
Double-click a row to edit the toolbit.
Close the manager.
The selected library will become the default library for the dock.

Editing Toolbits

There are several ways to edit the toolbits and library:

A. By clicking the column headers of the library you can sort the toolbit library. The library will retain the sort and use it in the dock.

Sort the toolbit library via the column headers

B. By doubleclicking in the first column you can edit the toolbit number. This will be the default tool number used when creating a new tool controller. It is possible to use the same number for multiple toolbits.

Double click first column to edit toolbit number

C. Double clicking anywhere else in the row will open the toolbit editing panel. From here you can edit other properties of the toolbit.

Open toolbit editing panel by clicking anywhere else in the row.

@@ Line 1: / Line 1: @@
+<languages/>
-{{Page in progress}}
+{{UnfinishedDocu{{#translation:}}}}
+<translate>
+<!--T:1-->
 {{Docnav
+|[[Path_OpActiveToggle|OpActiveToggle]]
-<!--
+|[[Path_ToolBitDock|ToolBitDock]]
-|[[Path_Simulator|Simulator]]
-|[[Path_SelectLoop|Complete Loop]]
 |[[Path_Workbench|Path]]
-|IconL=Path_Simulator.png
+|IconL=Path_OpActiveToggle.svg
+|IconR=Path_ToolBitDock.svg
 |IconC=Workbench_Path.svg
-|IconR=Path_SelectLoop.svg
--->
 }}
+<!--T:2-->
 {{GuiCommand
-|Name=Path Tools
+|Name=Path ToolBitLibraryOpen
+|MenuLocation=Path → ToolBit Library editor
-|Workbenches=[[Path Workbench|Path]]
+|Workbenches=[[Path_Workbench|Path]]
-|MenuLocation=Path → Tool Manager
-|Shortcut={{KEY|}} {{KEY|}}
 |Version=0.19
+|SeeAlso=[[Path_ToolBitDock|Path ToolBitDock]], [[Path_Tools|Path Tools]], [[Path_ToolBit|Path ToolBit]]
-|SeeAlso=[[Path ToolBit]]
 }}
+== Description == <!--T:3-->
+<!--T:4-->
-==Description==
+The {{KEY|[[Image:Path_ToolBitLibraryOpen.svg|16px]] [[Path_ToolBitLibraryOpen|ToolBit Library editor]]}}:
-The {{KEY|[[Image:Path Tools.svg|16px]] [[Path Tools|Tool xxxxx]]}}
+</translate>
 [[Image:Toolbitmanager.png]]
+<translate>
+<!--T:5-->
+The library manager (shown above) is the dialog for creating, managing, and organize toolbits. Launching the library manager from either the Path menu or from the 'manager' button in the dock will display the manager as a modal dialog.
+<!--T:6-->
-The library manager (shown above) is the dialog for creating, managing, and organize toolbits.
-Launching the library manager from either the Path menu or from the 'manager' button
-in the dock will display the manager as a modal dialog.
 From here the user can perform all task related to toolbit management :
+<!--T:7-->
- * Select a default library
+* Select a default library
- * Create/edit/delete Toolbits
- * Create libraries
+* Create/edit/delete Toolbits
- * Modify libraries by adding and removing toolbits
+* Create libraries
+* Modify libraries by adding and removing toolbits
- * Save a library to a new name
- * Export a library to the LinuxCNC tooltable (.tbl) format
+* Save a library to a new name
+* Export a library to the LinuxCNC tooltable (.tbl) format
-Only the creation of new toolshapes cannot be done from the toolbit library manager.
+Only the creation of new toolshapes cannot be done from the toolbit library manager. This is an advanced topic. (see [[Path_ToolShape|Path ToolShape]] creation).
-This is an advanced topic. (see toolshape creation)
+<!--T:8-->
-The left pane (1) shows a list of all libraries in the current working directory. The current library is highlighted
+The left pane (1) shows a list of all libraries in the current working directory. The current library is highlighted.
+<!--T:9-->
-The current working directory path is shown in the window title bar (2).  A file selector (3) can be used to select a different working directory.
+The current working directory path is shown in the window title bar (2). A file selector (3) can be used to select a different working directory.
+<!--T:10-->
-The right side pane (4) shows all toolbits in the currently selected library.  Doubleclicking in the left column allows you to change the default tool number for this toolbit.
-The toolnumber will be used when creating a tool controller.  The number is an attribute of the library. This means the same toolbit can exist in multiple tool libraries and have different default toolnumbers in each.
+The right side pane (4) shows all toolbits in the currently selected library. Doubleclicking in the left column allows you to change the default tool number for this toolbit. The toolnumber will be used when creating a tool controller. The number is an attribute of the library. This means the same toolbit can exist in multiple tool libraries and have different default toolnumbers in each.
+<!--T:11-->
 Tools at the top (5) are used to create/add/remove toolbits from the current library.
+<!--T:12-->
-The save as button (6) can be used to write the library to a new file or export to a valid tooltable format.  Currently only LinuxCNC format is supported.
+The save as button (6) can be used to write the library to a new file or export to a valid tooltable format. Currently only LinuxCNC format is supported.
+<!--T:13-->
 The manager will remember the last active tool library and working directory between uses.
+<!--T:14-->
-The close button (7) at bottom right will dismiss the tool library manager.  Any changes to the current library are persisted to disk.  Pressing the Escape key will dismiss the manager but not make any changes to the current library.  Whichever library is selected when the manager is dismissed will become the new default and will be shown in the Toolbit Dock.
+The close button (7) at bottom right will dismiss the tool library manager. Any changes to the current library are persisted to disk. Pressing the Escape key will dismiss the manager but not make any changes to the current library. Whichever library is selected when the manager is dismissed will become the new default and will be shown in the Toolbit Dock.
-==Usage==
+== Usage == <!--T:15-->
+=== Manage Toolbits === <!--T:16-->
+<!--T:17-->
-===Manage Toolbits===
-# open the Toolbit Library Manager using several methods:
+# There are several ways to open the Toolbit Library Manager:
-#* Using the {{MenuCommand|Path → Toolbit Library Manager}} entry from the top menu
+#* Select the {{MenuCommand|Path → [[Image:Path_ToolBitLibraryOpen.svg|16px]] ToolBit Library editor}} option from the menu.
-#* Open the Toolbit dock as described above, then press the Library button to open the Library manager
+#* Open the Toolbit dock as described above and press the {{Button|[[Image:Path_ToolBitLibraryOpen.svg|16px]]}} button to open the Library manager.
-# Select a library from the list
+# Select a library from the list.
-# Create/Add/Remove toolbits from the library
+# Create/Add/Remove toolbits from the library.
-# Double-click a row to edit the toolbit
+# Double-click a row to edit the toolbit.
-# Close the manager
+# Close the manager.
-# The selected library will become the default library for the dock
+# The selected library will become the default library for the dock.
+== Editing Toolbits == <!--T:18-->
+<!--T:19-->
-==Editing Toolbits==
+There are several ways to edit the toolbits and library:
+<!--T:20-->
-There are several ways to edit the toolbits and library.
-# By clicking the column headers of the library you can sort the toolbit library.  The library will retain the sort and use it in the dock
+A. By clicking the column headers of the library you can sort the toolbit library. The library will retain the sort and use it in the dock.
+: [[Image:Librarysort.png]]
+: {{Caption|Sort the toolbit library via the column headers}}
+B. By doubleclicking in the first column you can edit the toolbit number. This will be the default tool number used when creating a new tool controller. It is possible to use the same number for multiple toolbits.
+: [[Image:Edittoolnumber.png]]
+: {{Caption|Double click first column to edit toolbit number}}
+C. Double clicking anywhere else in the row will open the toolbit editing panel. From here you can edit other properties of the toolbit.
+: [[Image:Editingpanel.png]]
+:: {{Caption|Open toolbit editing panel by clicking anywhere else in the row.}}
+== Related == <!--T:21-->
-[[Image:Librarysort.png]]
-# By doubleclicking in the first column you can edit the toolbit number.  This will be the default tool number used when creating a new tool controller. It is possible to use the same number for multiple toolbits.
+<!--T:22-->
-[[Image:Edittoolnumber.png]]
+* [[Path_Tools|Path Tools]]
-#Double clicking anywhere else in the row will open the toolbit editing panel. From here you can edit other properties of the toolbit
+* [[Path_ToolBit|Path ToolBit]]
-[[Image:Editingpanel.png]]
+<!--T:23-->
 {{Docnav
+|[[Path_OpActiveToggle|OpActiveToggle]]
-<!--
+|[[Path_ToolBitDock|ToolBitDock]]
-|[[Path_Simulator|Simulator]]
-|[[Path_SelectLoop|Complete Loop]]
 |[[Path_Workbench|Path]]
-|IconL=Path_Simulator.png
+|IconL=Path_OpActiveToggle.svg
+|IconR=Path_ToolBitDock.svg
 |IconC=Workbench_Path.svg
-|IconR=Path_SelectLoop.svg
--->
 }}
+</translate>
 {{Path_Tools_navi{{#translation:}}}}
 {{Userdocnavi{{#translation:}}}}