Assembly3 ConstraintPointOnLine

From FreeCAD Documentation

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:

Assembly3 ConstraintPointOnLine

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 Lock constraint then the following object is moved to a position where the point elements's origin lies on the line element's z-axis.

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. Straight elements have an origin and a direction which is represented by the ICS's z-axis. A direction of the x- and y-axis is not detectable and so rotation around the z-axis can not be used to reduce DOFs. (It doesn't apply in combination with point elements anyway...)

Related to the first object the following object can still move along the z-axis and spin 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 straight edge element of the other object.
  3. Press the Point on line button.