
Carbon Joint¶
Description¶
This node defines a generic Carbon Joint that can be used to define different type of constraints between Carbon Rigid Body and Carbon Actor objects.
Warning
Joint nodes are an experimental feature of the DOP that are subject to change in future versions.
Only a few types of joint constraints are currently fully implemented:
- Spherical
- Prismatic
- Swing Lock
Use the Houdini handle to adjust the joint position and orientation where needed.

An axle and a ball and socket created using Carbon Joint nodes.
Inputs¶
Input #1: objects
All objects referenced by this relationship must also be connected to this input through a Houdini Merge node for the Carbon Joint node to operate within the Carbon Simulation it is connected to.
Parameters¶
Joints Type type
The joint type. Currently only the following types are fully implemented:
- Spherical: Simple position constraint within a radius distance. Can be used to simulate a ball and socket when the radius is set to zero.
- Prismatic: Position constraint within a box. Useful for creating a linear sliding movement between two bodies.
- Swing Lock: Allow a certain amount of twist angle. Can be used to simulate an axle when used simultaneously with a Spherical joint and with its twist angle set to 180 degrees.
Transform
Position tx
ty
tz
World coordinate of the joint position.
Click on the Show Handle icon to modify this parameter directly from the Scene View pane.
Rotation rx
ry
rz
World orientation of the joint.
Click on the Show Handle icon to modify this parameter directly from the Scene View pane.
Parameters
Radius radius
The spherical radius of the Spherical constraint.
PrismaticBoxSize sizex
sizey
sizez
The extents of the Prismatic box constraint.
SwingMax swingMax
The swing angular cone limit.
TwistMin twistMin
The twist angular lower limit of the Swing Cone or Swing Axle constraint.
TwistMax twistMax
The twist angular upper limit of the Swing Cone or Swing Axle constraint.
Twist twist
The twist angular limit of the Swing Lock constraint.
Force force
The maximum force limit of the Linear Drive constraint.
SwingTorque swingTorque
The maximum swing torque limit of the Angular Drive constraint.
TwistTorque twistTorque
The maximum twist torque limit of the Angular Drive constraint.
Joint Pairs
Parent parent
The parent Carbon Actor or Carbon Rigid Body object to use with this constraint.
Child Count count
The number of pairs generated from this node using the specified Parent object.
Child child#
The child Carbon Actor or Carbon Rigid Body object to use with this constraint.
Parameter File¶
Use Parameter File fileOverride
Replace parameter values by expressions fetching the values from the loaded parameter file. Parameter values from the exclusion filter are left unchanged.
File Name fileName
Json file path to save this node’s current parameters to, and load the parameter file from.
Save save
Save this node’s current parameters to the specified file.
Load load
Load or reload the specified parameter file. As the overriding expressions always fetch values from the last loaded parameter file, and not from the file itself, use this button to refresh the loaded current parameter file with the values on disk.
Reload Every Time The Node Is Loaded reload
Automatically reload the parameter file when the scene is loaded. If the specified file cannot be found then the overriding expressions will use the values of the last loaded parameter file instead.
Exclusion Filter exclusionFilter
The exclusion filter allows to select which of the parameters are not to be replaced by the overriding expressions, therefore keeping their original values while all other parameters will evaluate with the values set from the last loaded parameter file.
Guide Geometry¶
Show Guide Geometry showguide
Display the Joints guides.
Position Constraint colorPositionConstraintr
colorPositionConstraintg
colorPositionConstraintb
Color used to draw the sphere of the Spherical joint and the box of the
Prismatic joint position constraints when Show Guide Geometry is
toggled on
.
Links colorLinksr
colorLinksg
colorLinksb
Color used to draw lines between the joint and its Parent and Child
objects when Show Guide Geometry is toggled on
.