Other Types

group

Groups are the simplest scene graph location type, with no special meaning. They are typically used to organize the scene and to apply transformations affecting all descendant locations.

assembly and component

Components are designed to be the building blocks that assets can be made out of. Assemblies are designed to be structured assets that can be built out of components or other assemblies.

As a convention for complex hierarchies, a component is a building block that can contain a hierarchy of geometry and non-geometry locations, but it shouldn’t contain any assemblies or other components. This convention is used by some tools in Katana to reduce the amount of Scenegraph that needs to be inspected to do certain things, such as search for LookFiles that are being used, with the assumption that no LookFile is assigned deeper than any ‘component’ location.

camera

Location type to declare a camera.

Type

Attribute

Description

string

geometry.projection

The projection mode, such as perspective or orthographic.

double

geometry.fov

The field of view angle in degrees

double

geometry.near

Distance of the near clipping plane

double

geometry.far

Distance of the far clipping plane

double

geometry.left geometry.right geometry.bottom geometry.top

The screen window placement on the imaging plane. The bound of the screen window.

double

geometry.centerOfInterest

This is used for tumbling in the viewer; it has no affect on the camera matrix.

double

geometry.orthographicWidth

The orthographic projection width.

light

Location type to declare a light.

Type

Attribute

Description

group

geometry

Shares the same attributes as cameras.

float

geometry.radius

The radius of the light.

float[3]

geometry.previewColor

The color of the light in the Viewer.

volume and openvdbasset

An openvdbasset location should be nested under a volume location.

The volume location has the following attributes, with <fieldName> being the name of the OpenVDB field(s).

Type

Attribute

Description

string

fields.<fieldName>.fieldName

The name of the field from the openVDB asset.

string

fields.<fieldName>.fieldId

The field location this volume is parent to.

The openvdbasset location has the following attributes:

Type

Attribute

Description

string

fieldAttributes.filePath

The file path to the openVDB asset on disk.

string

fieldAttributes.fieldName

The name of the field to use from the OpenVDB asset. This should match the fields.<fieldName>.fieldName attribute of the parent volume.

int

fieldAttributes.fieldIndex

The index of the field to use from the OpenVDB asset.

string

fieldAttributes.fieldDataType

The data type of the field (optional attribute).

string

fieldAttributes.fieldClass

The class of the grid (optional attribute).

material

See Materials.

instance, instance source and instance array

See Instancing.

level-of-detail group and level-of-detail

A level-of-detail group location should contain child locations of type level-of-detail. Each child corresponds to an LoD, and should have the following attributes:

Type

Attribute

Description

float

lodRanges.minVisible lodRanges.maxVisible lodRanges.lowerTransition lodRanges.upperTransition

Geometry with a specific level of detail.

renderer procedural and renderer procedural args

Note

This section is under construction.

Type

Attribute

Description

string

rendererProcedural.procedural

group

rendererProcedural.args

string

rendererProcedural.args.__outputstyle

int

rendererProcedural.useInfiniteBounds

string

rendererProcedural.includeCameraInfo

string

rendererProcedural.cameraInfo.whichCamera

string

rendererProcedural.cameraInfo.cameraPath

group

geometry.arbitrary

See Arbitrary Attributes.

error

Renders halt if this type is encountered (fatal error). An error message is written to the render log and displayed in the console.