Houdini 20.5 Nodes Geometry nodes

APEX Configure Controls geometry node

Configures the look and behavior of controls on APEX rigs.

On this page
Since 20.0
This feature is still under development. The current functionality is unfinished and subject to change, and may have thin or no documentation. Please bear this in mind when using it.

This node allows you to configure the look and behavior of the controls on an APEX rig. The look can be influenced by pre-shipped control shapes or an external source of shapes.

Parameters

Rig Source

The path to the rig graph in the packed character input (Character Stream input).

Skin Shape Source

The path to a geometry in the packed character input (Character Stream input) that can be used to create skin surface controls. Not implemented yet.

Guide Source

The path to the guide skeleton in the packed character input (Character Stream input). The guide skeleton can be used as a source of information to aid in building the rig.

Advanced Shape Settings

Create Missing Shape Names by Connectivity

When turned on, unnamed control shapes in your shape library are automatically assigned proper primitive names based on shape connectivity.

Control Configs

Control Group

The control(s) that are affected by the configurations in this section. The group pattern is based on the APEX path pattern syntax.

Use Shape Override

When turned on, sets the control shape.

Shape Override

The control shape to use for the controls in Control Group. The drop-down menu provides a list of pre-shipped control shapes. If a shape library is provided as the second input to this node, Shape Override can refer to one of the shapes in the shape library.

3dcross
ball
ball_wires
ballline_wires
blob
box
box_wires
boxcross_wires
boxplanes_wires
circle_plane
circle_wires
circleplanes_wires
cone
cross
cross_wires
crossplanes_wires
lineb
lineblob
plane_wires
planecross_wires
planes_wires
rigvisualizer
rubber
star
torus
torusb

Use Shapeoffset

When turned on, sets the transformation of the control shapes.

Mode

Defines if the transformation is applied as a pre- or post-multiplication of the current transformation.

Translate

The local translate offset applied to the control shapes.

Rotate

The local rotate offset applied to the control shapes.

Scale

The local scale offset applied to the control shapes.

Use Color

When turned on, sets the color for the controls.

Color

The color for the controls.

Use Visibility

When turned on, sets the visibility of the controls.

Is Visible

When turned on, the controls are visible.

Use Limits

When turned on, allows limits, such as transform limits, to be set on control parameters. These limits are enforced by the animate state in the viewport. See transform limits in the animate state for more information.

Parameter Limits

Limits a set of control parameters to a specified range. This can be helpful for ensuring that the anatomy or behavior of a character is not broken by its animation. The limits are stored on the TransformObject properties dictionary inside the rig.

There are two kinds of limits:

  • Locked limits are always enforced in the animate state. The only way to override locked limits is to modify the rig.

  • Soft limits can be suppressed via the Enforce Transform Limits option in the animate state settings HUD.

Parm Name

The name of the control parameter to set limits on. Select the parameter value type from the drop-down menu. The available options are Float and Vector3.

Min

When turned on, sets the minimum soft limit value.

Max

When turned on, sets the maximum soft limit value.

Min Lock

When turned on, sets the minimum locked limit value.

Max Lock

When turned on, sets the maximum locked limit value.

Inputs

CharacterStream

The APEX character geometry to modify.

Shape Library

Packed or unpacked geometry primitives to use as control shapes for the rig graph. These primitives have name attributes, and are added as packed geometry to the character stream. The animate state can fetch these shapes from the character.

Outputs

CharacterStream

The modified APEX character geometry.

See also

Geometry nodes