Path Slot/it

Description
This tool creates a simple slotting operation using various methods of input. Inputs include:
 * selecting one or more faces or edges.
 * selecting two vertices.
 * entering two custom points.

The Path Slot object is made to be part of a Path Job.

Usage

 * 1) Select the reference geometry on the model:.
 * 2) * one or more faces or edges.
 * 3) * two vertices.
 * 4) *  nothing  to use two custom points entered in the Property View of the Data tab: Custom Point1 and Custom Point2.
 * 5) Invoke the Slot command using several methods:
 * 6) * Pressing the button in the toolbar.


 * 1) * Using the →   entry from the top menu.
 * 2) Adjust the desired properties. Descriptions of available properties are found below.

Usage Notes

 * All slots:
 * Both the beginning and end of a slot path can be extended or shortened. Use the `Extend Path Start` and `Extend Path End` properties.
 * Use the `Layer Mode` property to cut the slot in `Single-pass` mode at final depth, or in `Multi-pass` mode using the available `Step Down` property.
 * Toggle the `Reverse Direction` property to reverse the direction of the cut path.
 * Linear slots:
 * Currently there is no capability to offset linear slots laterally (parallel to path of travel).  Example:  Say you have a tool diameter smaller than the width of the slot area you are clearing. Current behavior of this operation is to create a single slot path down the center of the designated slot, which will result in the slot area not being fully cleared. Some users would want the operation to create multiple paths that are offset laterally to clear the entire slot area; this operation is not intended to due so - use the Pocket operation for such clearing.
 * Create a custom linear slot using the `Custom Point1` and `Custom Point2` properties with no geometry selection.  Example:  Initiate a Slot operation in the GUI and click `OK` to save. Now locate and edit the `Custom Point1` and `Custom Point2` properties in the Data tab of the newly created Slot operation.  Recompute the operation to update the path.
 * Arc/Circular slots:
 * Creating arc/circular slots
 * You will need to select one bottom arc of the slot. This will produce a path directly on the arc edge you selected.
 * You will then need to edit the `Extend Radius` property in the Data tab of the operation. Using the expression editor, set it to either `OpToolDiameter / 2.0` or the negative version `OpToolDiameter / -2.0` as needed, depending on whether you selected the inside or outside arc of the slot.
 * Recompute the operation.
 * Keep in mind that if the toolbit diameter is not equal to the slot width, the path will not be in the correct location. In this case, adjust the value in the `Extend Radius` property mentioned above.
 * Currently users are unable to create a custom arc/circular path. A third `Custom Center` property will need to be added, along with additional modifications to the code base.

Properties
 Note : Not all of these Properties are available in the Task Window Editor. Some are only accessible in the Data tab of the Properties View panel for this Operation.

Base
Note: It is suggested that you do not edit the Placement property of path operations. Rather, move or rotate the Path Job model as needed.


 * : Overall placement[position and rotation] of the object - with respect to the origin (or origin of parent object container)
 * : Angle in degrees applied to rotation of the object around Axis property value
 * : Axis(one or multiple) around which to rotate the object, set in sub-properties: x, y, z
 * : x axis value
 * : y axis value
 * : z axis value
 * : Position of the object, set in sub-properties: x, y, z - with respect to the origin (or origin of parent object container)
 * : x distance value
 * : y distance value
 * : z distance value
 * : User-provided name of the object (UTF-8)

Depth

 * : The height needed to clear clamps and obstructions
 * : Final Depth of Tool- lowest value in Z
 * : Maximum material removed on final pass. The height (thickness) of the last cutting level - set for a better finish.
 * : The height above which Rapid motions are allowed. (Rapid safety height between locations)
 * : Starting depth of Tool - first cut depth in Z
 * : Incremental step down of Tool during operation



Path

 * : make False, to prevent operation from generating code
 * : The base geometry for this operation
 * : An optional comment for this Operation
 * : The coolant mode for this operation.
 * : The cycle time estimation for this operation.
 * : Defines the Tool controller used in the Operation
 * : User assigned label

Slot

 * : Enter custom start point for slot path.
 * : Enter custom end point for slot path.
 * : Set the geometric clearing pattern to use for the operation.
 * : Positive extends the end of the path, negative shortens.
 * : Positive extends the beginning of the path, negative shortens.
 * : For arcs/circlular edges, offset the radius for the path.
 * : Complete the operation in a single pass at depth, or mulitiple passes to final depth.
 * : Choose the path orientation with regard to the feature(s) selected.
 * : Choose what point to use on the first selected feature.
 * : Choose what point to use on the second selected feature.
 * : Enable to reverse the cut direction of the slot path.

Start Point

 * : The custom start point for the path of this operation.
 * : x distance value
 * : y distance value
 * : z distance value
 * : Make True, if manually specifying a Start Point. Set the start point in the property data Start Point field.

Tasks Window Editor Layout
Descriptions for the settings are provided in the Properties list above. This section is simply a layout map of the settings in the window editor for the Operation.

Base Geometry

 * Add: adds selected element(s) which should be the base(s) for the path(s)
 * Delete: delete the selected item(s) in the Base Geometry list
 * Clear: clear all items in the Base Geometry list

Operation
 **  Visibility changes depending on Base Geometry selected.
 * : The tool and its settings to be used for this operation.
 * : Coolant mode for this operation.
 * : Choose what point to use on the first selected feature.
 * : Choose what point to use on the second selected feature.
 * : Positive extends the end of the path, negative shortens.
 * : Positive extends the beginning of the path, negative shortens.
 * : Complete the operation in a single pass at depth, or mulitiple passes to final depth.
 * : Choose the path orientation with regard to the feature(s) selected.
 * : Enable to reverse the cut direction of the slot path.

Scripting
FreeCAD Scripting Basics.

Example:


 * 1) Place code example here.