Path Profile

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
English • ‎français • ‎italiano • ‎română • ‎русский
Arrow-left.svg Previous: Path Engrave.svg Engrave
Next: Helix Path Helix.svg Arrow-right.svg

Path Profile.svg Path Profile

Menu location
Path → New Operation → Profile
Default shortcut
Introduced in version
See also


The Contour tool creates a simple external contour cut of complex 3D Part-based objects. The entire Job Model serves as the input for the Operation--regardless of whether any Body Geometry is selected when the Contour command is invoked. A Start point can be enabled from the Operation editor, using a location defined in the Property view → Start Points

Path profile example.jpg


  1. Select a face on a Part-based object. Alternatively, also select a starting edge on that face.
  2. Invoke the command several ways:
    • Press the Path Profile.png Profile button
    • Use the P P keyboard shortcut
    • Use the Path → New Operation → Profile entry in the Path menu
  3. Adjust the desired properties


  • The Path Profile object is made to be part of a Path Job. To correctly configure the profiling, a tool table must be present in the project's machine object, and a Tool Change command must be placed before the profile.


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.


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.

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


  • DataClearance Height: The height needed to clear clamps and obstructions
  • DataFinal Depth: Final Depth of Tool- lowest value in Z
  • DataSafe Height: The above which Rapid motions are allowed.
  • DataStart Depth: Starting Depth of Tool- first cut depth in Z
  • DataStep Down: Incremental Step Down of Tool


  • DataActive: make False, to prevent operation from generating code
  • DataComment: An optional comment for this Operation
  • DataUser Label: User assigned label
  • DataTool Controller: Defines the Tool controller used in the Operation


  • DataDirection: The direction that the toolpath should go around the part: Clockwise[CW] or Counterclockwise[CCW]
  • DataJoin Type: Controls how tool moves around corners.
  • DataOffsetExtra: Extra value to stay away from final profile- good for roughing toolpath
  • DataSide: (Cut Side) Side of edge that tool should cut. This only matters if `Use Compensation` is True(checked).
  • DataUse Compensation: If checked, the Profile Operation is offset by the tool radius. The offset direction is determined by the Cut Side.
  • DataProcess Circles: Check if you want this Profile Operation to also be applied to cylindrical holes, which normally get drilled.
  • DataProcess Holes: Check if this Profile Operation should also process holes in the base geometry. Note that this does not include cylindrical holes.
  • DataProcess Perimeter: Check if this Profile Operation should also process the outside perimeter of the base geometry shapes


  • DataAttempt Inverse Angle: Automatically attempt Inverse Angle if initial rotation is incorrect.
  • DataB_Axis Error Override: Visually orient B(y) rotations to model (error in FreeCAD rendering).
  • DataEnable Rotation: Enable rotation to gain access to pockets or areas not normal to Z axis.
  • DataInverse Angle: Inverse the angle of the rotation. Example: change a rotation from -22.5 to 22.5 degrees.
  • DataReverse Direction: Reverse orientation of Operation by 180 degrees.

Start Point

  • DataStart Point: The start point of this path
  • DataUse Start Point: make True, if manually specifying a Start Point, then enter Start Points in the property data Start Points field
  • DataExtend At Start: extra length of tool path before start of part edge
  • DataLeadIn Line Len: length of straight segment of toolpath that comes in at angle to first part edge

End Point

  • DataUse End Point: make True, if specifying an End Point
  • DataExtend At End: extra length of tool path after end of part edge
  • DataLeadOut LineLen: length of straight segment of toolpath that comes in at angle to last part edge
  • DataEnd Point: The end point of this path

Extras, Not-in-use, or Degraded

  • DataUse Placements: make True, if using the profile operation placement properties to transform toolpath in post processor
  • DataSegLen: Tesselation value for tool paths made from beziers, bsplines, and ellipses

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


  • DataStart Depth
  • DataFinal Depth
  • DataStep Down


  • DataSafe Height
  • DataClearance Height


  • DataTool Controller
  • DataCut Side
  • DataDirection
  • DataExtra Offset
  • DataUse Start Point
  • DataUse Compensation
  • DataProcess Holes
  • DataProcess Circles
  • DataProcess Perimeter
Arrow-left.svg Previous: Path Engrave.svg Engrave
Next: Helix Path Helix.svg Arrow-right.svg