3D Content Processing Options

The following options may be specified (as attribute/value pairs) to control the exact behaviour of the 3D content processing functionality:

'stripTerrainHeightDetail'

Defaults to false, if no attribute is supplied.
When set to true, any internal height detail in terrain parts of the resulting ground mesh will be stripped out.
PathEngine's terrain callback can then be applied, to supply the relevent height information more efficiently, and without repeated representation of heavy terrain data.
See Working with Terrain for more details about the terrain callback mechanism.

'numberOfTerrainLayers'

Controls the number of sectionID values that should be treated as terrain.

Affects the way the 'stripTerrainHeightDetail' and 'maxSlopeOnTerrain' options are applied.
This value defaults to 1, if no attribute is not supplied, and in most cases should be left at this default value.

'removeObstructedFragmentsWithShape'

When set, the value string for this attribute will be parsed to obtain an agent shape, and any disconnected ground fragments that are completely obstructed for this agent shape discarded.

The vertex coordinate string should be supplied in the format x1,y1,x2,y2,x3,y3.. i.e. as a set of comma separated alternating x and y coordinate values of length depending on the number of vertices in the shape.
Exactly the same constraints apply to these vertex coordinates as to the coordinate array passed in to iPathEngine::newShape(), i.e. the shape must be convex, contain the origin, and so forth.
An example valid vertex coordinate string is "-20,-20,-20,20,20,20,20,-20" for a 40 unit by 40 unit axis aligned square.

'clipToTile'

This option is designed to support tiled 3D content processing.
Refer to this page for details.

'maxSlopeOnTerrain'

This option enables a different maximum slope to be applied for terrain parts of the ground result.
When set, the value string for this option must be a valid 32 bit signed value >= -1, and this is then used instead of the maxSlope parameter value passed into the content processing, for terrain faces.
(See BuildMeshFrom3DContent for an explanation of the maxSlope parameter.)