Assembly3 ConstraintPointOnCircle

From FreeCAD Documentation
Jump to navigation Jump to search

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.

Other languages:
Deutsch • ‎English • ‎français • ‎polski

Assembly ConstraintPointOnCircle.svg Assembly3 ConstraintPointOnCircle

Menu location
Default shortcut
Introduced in version
See also


This tool builds a link between two objects of an assembly and fixes the distance between them and the orientation to each other. The selected elements of each object or more precisely their implicit coordinate systems (ICS) are used to position one object to another.

Assuming the first object is already locked in place by the Assembly ConstraintLock.svg Lock constraint then the following object is moved to a position where the point element's origin lies on the circular element's xy-plane with an offset from the z-axis (matching x and y values according to the radius).

Point elements have no stretch in any direction (zero length) and so there's no orientation detectable i.e. their ICS are only to match other elements' settings. The orientation of the ICSs always stays the same as the global coordinate system's orientation and can not be used to reduce any degrees of freedom related to rotation.

The position on the circular element (arc length from the start point) is not defined. Related to the first object the following object can still spin around the origin (around all three axes). This is leaving 4 degrees of freedom (DOFs) for each link unconstrained.


  1. Place two objects into an assembly.
  2. Select one point element of one object and one circular face or edge element of the other object.
  3. Press the Assembly ConstraintPointOnCircle.svg Point on circle button.