On this page |
This output operator is used to write files that define an agent. The created files can then be loaded in by the Agent geometry node to create agent primitives for crowds.
Note
Agent primitives currently only support deforming point normals and not vertex normals. When the deforming geometry is written out, vertex normals will be automatically promoted to point normals as a result.
Parameters
Render
Begins the render with the last render control settings.
Render Control
Opens the render control dialog to allow adjustments of the render parameters before rendering.
Valid Frame Range
What frames to render.
Render Current Frame
Allow the baking any and all frames.
Render Frame Range
Only bake the frames in the range set below, but allow the baking other frames if they are referenced by in-range frames.
Render Frame Range Only (Strict)
Only bake the frames in the range set below, and don’t allow baking of other frames, even if they are referenced by in-range frames.
Start/End/Inc
The range of frames for the clip (start frame, end frame, and increment), inclusive.
All values may be decimal (for example, start on frame 1.5)..
Render with Take
Uses the settings in a particular take while rendering. Choose Current to use the current take when rendering.
Source
Specifies the source of the agent definition that will be written to disk.
Object Subnet
Generate an agent definition from a character rig.
Agent Primitive
Use the agent definition from an existing agent primitive.
FBX
Generate an agent definition from an FBX file containing a character.
Object Subnet
Path to the object subnetwork containing the character rig.
SOP Path
Specifies a SOP network that contains an agent primitive.
FBX File
Filename of the FBX file to generate agents from.
Convert Units
Specifies whether to convert to Houdini units when importing the FBX file.
Minimal Nodes
Only bake objects whose display flags are on. If you turn this off, all nodes in the object subnet are baked into the animation clip.
Convert to Polygon Soups
Combine polygon primitives into polygon soup primitives when creating the shape library. This can reduce memory usage, particularly when rendering with Mantra.
Load as Polygon Soups
Create polygon soup primitives instead of polygon primitives when loading geometry from the FBX file. This can reduce memory usage, particularly when rendering with Mantra.
Layer Name
The default layer for the agent, created using the display flags of the objects. Every agent must have at least one layer.
Bounds Scale
Specifies a scale for the bounding box of each shape in the default layer. See the Agent Primitive help page for more information on how an agent’s bounding box is computed.
Generate Collision Layer
Generate a collision layer from geometry containing capture/deform weights. This generates capture region primitives and assigns them to the corresponding bones in the rig.
Collision Layer Name
When Generate Collision Layer is on, the name of the collision layer.
Clip Name
Name of the baked out clip (agent animation). The animation is taken from the current scene.
Clip Name
Specifies the names of the animation clip(s). A clip is created for each take in the FBX file.
The ${FBX_TAKE_NAME}
and ${FBX_TAKE_INDEX}
local variables can be used to generate clip names based on the take name and index from the FBX file.
Override Sample Rate
Specifies whether to use the value of the Sample Rate parameter instead of the sample rate stored in the FBX file. This is useful if the application that exported the original FBX file did not set the sample rate correctly.
Sample Rate
Sample rate to use for the clip when Override Sample Rate is enabled.
Additional Channels
Adds channels from the specified CHOP node to the agent’s clip.
Shift Clip to Frame 1
Shift output clips from the specified frame range to start at frame 1.
Convert to In-Place Animation
Convert a moving character animation to an in-place clip, by subtracting the positions of the Locomotion Node (relative to the origin or where it was on the first frame depending on Use Pivot from First Frame parameter).
Locomotion Node
The object inside the Object Subnet that controls the locomotion of the character (the node in the character rig that has translation channels that move it forward in space). When Convert to In-Place Animation, Houdini uses this to remove the translation from the character animation to keep the character in place. (The crowd solver node assumes that the agent animation is in-place since it will be attached to a moving particle.)
The locomotion animation is placed in a separate transform in the rig named
__locomotion__
. If this parameter is empty, then __locomotion__
will
use the Object Subnet.
Locomotion Orient
If this parameter and Locomotion Node are specified, the generated
__locomotion__
transform will also contain rotational information using
the vector from the Locomotion Node to the Locomotion Orient node.
This parameter has no effect if Locomotion Node is empty.
Project Positions on Dominant Axis
When creating the animation of the Locomotion Node, project the positions along the dominant axis of motion in the XZ plane. If the clip will be used as an in-place clip with the crowd solver, enabling this option can help to maintain hip swaying in the motion.
Use Pivot from First Frame
When creating the animation of the Locomotion Node, calculate the positions to be relative to the origin. If this option is disabled (the default), then the positions will be relative to where it was on the first frame.
Agent Name
Name of the agent. The parameter is provided for convenience
so that it can be referenced via the $AGENT
local variable in other
parameter values.
Cache Directory
Parent directory of agent definition files. This parameter is
provided for convenience so that its value can be referenced via the
$CACHEDIR
local variable in the other filename parameters.
Rig
Filename for the agent rig. The rig file is a JSON file describing the transform hierarchy of the agent.
Agent Layers
Filename pattern for agent layer files.
The ${LAYER}
local variable can be used to the include the name of the layer in the filename.
Shape Library
Filename for the agent shape library.
Clips
Filename pattern for agent clip files.
The ${CLIP}
local variable can be used to the include the name of the clip in the filename.
Transform Groups
Filename pattern for agent transform group files.
The ${TRANSFORM_GROUP}
local variable can be used to include the name of the transform group in the filename.
Create Intermediate Directories
Create intermediate parent directories for output files as needed. This currently only applies to generated scripts, images, and shadow maps.
Pre-Render Script
Execute this script before any baking.
Post-Render Script
Execute this script after all baking
Locals
AGENT
The name of agent. The value either comes from the agentname
string
attribute on the input points when Allow Attributes to Override is
enabled, or from the value of the Agent Name parameter.
CACHEDIR
A local variable provided for convenience so that the value of the Cache Directory parameter can be easily referenced.
LAYER
Contains the name of the current layer when evaluating the Agent Layers parameter.
CLIP
Contains the name of the current clip when evaluating the Clips parameter.
TRANSFORM_GROUP
Contains the name of the current transform group when evaluating the Transform Groups filename parameter.
FBX_TAKE_NAME
Contains the name of the current take in the FBX file when evaluating the Clip Name parameter and Source is FBX.
FBX_TAKE_INDEX
Contains the index of the current take in the FBX file when evaluating the Clip Name parameter and Source is FBX.
See also |