Tutorials - Katana

This section contains a tutorial about Atoms Katana workflow. Please refer to the reference guide to know more about the atoms proxy parameters.

Import an atoms cache

In order to render an Atoms cache in Katana, you should use the atoms proxy node. First create an atoms cache in Maya or Houdini.

Create an "AtomsProxy" node in Katana.
In the cachePath parameter of the AtomsProxy node pick the cache file (the file named youCacheName.atoms).
In the variationsPath parameter pick the variation file contained in the data folder of your atoms installation (variations/robot.json) or your variation file if you used your own agent type.

Display agents

Expand the atoms proxy location inside the scene graph.
Change the atomsProxy drawMode parameter to "Variations".
Open the katana Viewer.

Display metadata

Set the drawMetadata parameter to yes.

Filter agents

To filter agents using their ids:

Set the agentIds parameter to "2-10" or "!(2-10)".

To filter agent using some metadata values:

Set the metadataFiter parameter to variation:Robot1.

Expand agents

To expand an agent to a single location put its id inside the agentsToExpand parameter

Set the agentsToExpand parameter to "15-24".
In the scene graph, check the new locations under the atoms proxy.

Expand agent meshes

Is possible to expand the sub agent location even more by creating another child location for each mesh belonging to the agent.

Set the expandMeshes parameter to yes.

Override agent variations

Every sub-location of the atoms proxy has its own custom procedural parameters. You can override these parameters to change the agent type, agent variation, lod etc...

Create and AttributeSet node and place it after the AtomsProxy node.
Set the attributeName parameter to rendererProcedural.args.agentVariation,
Set the attributeType parameter to string.
Set the stringValue parameter to Robot1.

Move agents

You can move every expanded agent in its own sub location.

Create aTransform3d node and connect it after the AtomsProxyNode
Set the makeInteractive parameter to yes.
Set the stackOrder parameter to Last.
Set the path parameter to one of the agent sub location.
Inside the Katana viewer activate the translation manipulator and move the agent in the 3D space.