On this page

D6Joint QML Type

A configurable joint with up to 6 degrees of freedom (3 linear, 3 angular). More...

Import Statement: import QtQuick3D.Physics
Since: Qt 6.13

Properties

Detailed Description

The D6Joint allows custom configuration for each axis of movement and rotation. Each degree of freedom can be set to Locked, Limited, or Free using the Motion enum. Soft limits with spring stiffness and damping can be configured for linear and angular constraints.

See also DistanceJoint, FixedJoint, PrismaticJoint, RevoluteJoint, and SphericalJoint.

Property Documentation

angularDamping : real [default: 0.0, since 6.13]

This property holds the spring damping for angular motion constraints.

Range: [0, \inf)

This property was introduced in Qt 6.13.

angularStiffness : real [default: 0.0, since 6.13]

This property holds the spring stiffness for angular motion constraints. When set to a value greater than 0, angular limits act as soft constraints (springs).

Range: [0, \inf)

This property was introduced in Qt 6.13.

linearDamping : real [default: 0.0, since 6.13]

This property holds the spring damping for linear motion constraints.

Range: [0, \inf)

This property was introduced in Qt 6.13.

linearLimitXLower : real [default: -1.0, since 6.13]

This property holds the lower limit of movement along the X axis. The value must be less than or equal to linearLimitXUpper.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearLimitXUpper : real [default: 1.0, since 6.13]

This property holds the upper limit of movement along the X axis. The value must be greater than or equal to linearLimitXLower.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearLimitYLower : real [default: -1.0, since 6.13]

This property holds the lower limit of movement along the Y axis. The value must be less than or equal to linearLimitYUpper.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearLimitYUpper : real [default: 1.0, since 6.13]

This property holds the upper limit of movement along the Y axis. The value must be greater than or equal to linearLimitYLower.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearLimitZLower : real [default: -1.0, since 6.13]

This property holds the lower limit of movement along the Z axis. The value must be less than or equal to linearLimitZUpper.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearLimitZUpper : real [default: 1.0, since 6.13]

This property holds the upper limit of movement along the Z axis. The value must be greater than or equal to linearLimitZLower.

Range: (-\inf, \inf)

This property was introduced in Qt 6.13.

linearStiffness : real [default: 0.0, since 6.13]

This property holds the spring stiffness for linear motion constraints. When set to a value greater than 0, linear limits act as soft constraints (springs).

Range: [0, \inf)

This property was introduced in Qt 6.13.

swingLimitAngleY : real [default: pi/4, since 6.13]

This property holds the maximum swing angle limit (in radians) around the Y axis.

Range: (0, pi)

This property was introduced in Qt 6.13.

swingLimitAngleZ : real [default: pi/4, since 6.13]

This property holds the maximum swing angle limit (in radians) around the Z axis.

Range: (0, pi)

This property was introduced in Qt 6.13.

swingMotionY : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the rotational constraint around the Y axis (swing Y).

This property was introduced in Qt 6.13.

swingMotionZ : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the rotational constraint around the Z axis (swing Z).

This property was introduced in Qt 6.13.

twistLimitLower : real [default: -pi/4, since 6.13]

This property holds the lower angular limit (in radians) around the X axis. The value must be less than or equal to twistLimitUpper.

Range: (-2pi, 2pi)

This property was introduced in Qt 6.13.

twistLimitUpper : real [default: pi/4, since 6.13]

This property holds the upper angular limit (in radians) around the X axis. The value must be greater than or equal to twistLimitLower.

Range: (-2pi, 2pi)

This property was introduced in Qt 6.13.

twistMotion : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the rotational constraint around the X axis (twist).

This property was introduced in Qt 6.13.

xMotion : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the motion constraint along the X axis.

This property was introduced in Qt 6.13.

yMotion : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the motion constraint along the Y axis.

This property was introduced in Qt 6.13.

zMotion : enumeration [default: D6Joint.Locked, since 6.13]

Available options:

ConstantDescription
D6Joint.LockedThe degree of freedom is completely restricted and cannot move.
D6Joint.LimitedThe degree of freedom is constrained within specified lower and upper limits.
D6Joint.FreeThe degree of freedom is unconstrained and moves freely.

This property holds the motion constraint along the Z axis.

This property was introduced in Qt 6.13.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.