_images/numerion_carbon_relationship.png

Carbon Joint

Type

_images/carbon_relationship.png

Relationship node (DOP only).

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.

_images/animation_carbon_joint.gif

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.