Up to date

This page is up to date for Godot 4.0. If you still find outdated information, please open an issue.

ConeTwistJoint3D

Inherits: Joint3D < Node3D < Node < Object

A twist joint between two 3D PhysicsBodies.

Description

The joint can rotate the bodies across an axis defined by the local x-axes of the Joint3D.

The twist axis is initiated as the X axis of the Joint3D.

Once the Bodies swing, the twist axis is calculated as the middle of the x-axes of the Joint3D in the local space of the two Bodies. See also Generic6DOFJoint3D.

Properties

float

bias

0.3

float

relaxation

1.0

float

softness

0.8

float

swing_span

0.785398

float

twist_span

3.14159

Methods

float

get_param ( Param param ) const

void

set_param ( Param param, float value )


Enumerations

enum Param:

Param PARAM_SWING_SPAN = 0

Swing is rotation from side to side, around the axis perpendicular to the twist axis.

The swing span defines, how much rotation will not get corrected along the swing axis.

Could be defined as looseness in the ConeTwistJoint3D.

If below 0.05, this behavior is locked.

Param PARAM_TWIST_SPAN = 1

Twist is the rotation around the twist axis, this value defined how far the joint can twist.

Twist is locked if below 0.05.

Param PARAM_BIAS = 2

The speed with which the swing or twist will take place.

The higher, the faster.

Param PARAM_SOFTNESS = 3

The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.

Param PARAM_RELAXATION = 4

Defines, how fast the swing- and twist-speed-difference on both sides gets synced.

Param PARAM_MAX = 5

Represents the size of the Param enum.


Property Descriptions

float bias = 0.3

The speed with which the swing or twist will take place.

The higher, the faster.


float relaxation = 1.0

Defines, how fast the swing- and twist-speed-difference on both sides gets synced.


float softness = 0.8

The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.


float swing_span = 0.785398

Swing is rotation from side to side, around the axis perpendicular to the twist axis.

The swing span defines, how much rotation will not get corrected along the swing axis.

Could be defined as looseness in the ConeTwistJoint3D.

If below 0.05, this behavior is locked.


float twist_span = 3.14159

Twist is the rotation around the twist axis, this value defined how far the joint can twist.

Twist is locked if below 0.05.


Method Descriptions

float get_param ( Param param ) const

Returns the value of the specified parameter.


void set_param ( Param param, float value )

Sets the value of the specified parameter.