ScenegraphXml_In

XML is a simple way to describe a hierarchical structure. Katana leverages this format to provide a rich descriptive asset language. Through XML, assets can be structured so they can be loaded and manipulated in stages. Simpler parts of the asset can load quicker and use less memory, only loading the full asset when absolutely necessary.

Note:  ScenegraphXML is provided as a reference example only. It is not intended for production use, and is not supported.

Some asset elements that can be described within a ScenegraphXml file are:

Assembly locations

Component locations

Level-of-detail group locations

Level-of-detail locations

Other XML locations

Control (UI)

Default Value

Function

name

/root/world/geo

Describes where the scene is imported in the scene graph. The name parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter.

For more information, refer to the Create Scene Graph Location Widget Type in the Common Parameter Widgets.

asset

N/A

Describes the file path and name of the XML scene file.

For more information, refer to the Asset and File Path Widget Types in the Common Parameter Widgets.

timing

mode

Current Frame

Sets the timing mode to apply to the asset:

Current Frame - uses the equivalent of global.currentTime and reads data at that frame.

Hold Frame - reads only the frame specified (default global.inTime).

Clamp Range - reads frames within range and clamps values for any frame below or above the range (default [global.inTime, global.outTime]).

When mode: Hold Frame

holdTime

1

When the mode parameter is set to Hold Frame, this is the frame at which the timing is held.

When mode: Clamp Range

inTime

1

When the mode parameter is set to Clamp Range, this is the start frame previous to which all values are clamped.

outTime

100

When the mode parameter is set to Clamp Range, this is the end frame after which all values are clamped.