Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Attribute

Usage

Description

Values

name

Required

The name of this instance. Must be unique within the system.

String

zone

Optional

The name of the zone which contains this instance. If your world is split into chunks for streaming, use the zone attribute to group instances into a single zone for each chunk.

Positive integerString

instanceId

Optional

The ID of this instance. Must be unique within the system. If you specify this for one instance in the scene, then you must specify it for all instances. If omitted this will be automatically generated.

Positive integer

systemId

Optional

The scene-wide unique name of the system. Use this to explicitly group radiosity instances into a radiosity system.

String

paramSet

Optional

The name of the parameter set used for this instance. If this does not exist in the paramset file, a new paramset (using defaults) will be created. May be skipped for Fully Dynamic or Static Set Dressing objects.

String

systemGuid

Optional

Overrides the internal system GUID generated from the system ID and paramset ID. Must be unique within the entire scene.

128-bit hex string

instanceGuid

Optional

Specifies the GUID for this instance. This must be unique within the whole scene. If omitted, this is automatically generated from the system and instance names.

128-bit hex string

guid

Deprecated

Deprecated: see systemGuid.


geometry

Required

The name of the .geom file that contains the mesh information.

String

type

Required

The lighting type for this instance: 
'Radiosity' is immovable geometry that is lit with a lightmap. 
'Fully Dynamic' instances do not bounce light and are lit by SH probes at runtime and can be moved - it is optional to include these as they do not participate in the precompute. 
'Probe Radiosity' instances are lit by SH probes at runtime but still bounce light so they cannot move.

Radiosity 
Fully Dynamic 
Probe Radiosity 
Static Set Dressing

useVolumeTexture

Optional

For dynamic objects, whether to create and use a volume texture.

Boolean (default true)

lmName

Optional

If being used in a Baking lightmap, the name of the map. Must be specified on the instance, or on each mesh, or both.

String

lmType

Optional

If being used in a Baking lightmap, the type of the map. Must be specified on either the instance or each mesh, not both.

String

lmAtlas

Optional

If being used in a Baking lightmap that will be packed, whether to atlas the UVs.

Boolean

position

Optional

The location of the instance in world coordinates.

3-element vector

rotation

Optional

A quaternion representing the rotation of the instance.

4-element vector

transform

Optional

A full matrix specifying translation, rotation and scaling. Should be avoided in favour of the simpler position/rotation attributes, but is required to allow scene extract of arbitrary scenes.

4x4 matrix

includeInAutoSystemGeneration

Optional

If set to false, this instance will not take part in automatic system generation.

Boolean (default true)

scaleUvsWithInstanceSize

Optional

Specifies whether the scaling of the transform of this instance should be taken into account when generating the per-instance lightmap UVs (that is, whether the output pixel size specified for this instance should be in world units (true) or in local geometry units (false).

Boolean (default true)

additionalUvScale

Optional

 Specifies an additional scale that should be applied to the lightmap UVs for this instance (to change the output pixel size). This is applied in addition to any scaling related to the scaleUvsWithInstanceSize flag.

Positive decimal (default 1.0)

clusterSize 

Optional

The size of the clusters to generate for this instance, in world space units. If not specified, uses the system cluster size. 

Positive decimal  

...