SpeedForest files (.instances files)

SpeedForest is an internal population tool used by the SpeedTree development team. It was used to populate the .stsdk instances in the reference application example forest.

It uses the .instances file extension and a very simple file format. It's text-based and each line represents a single instance. The format for a single line is:

<pos.x> <pos.y> <pos.z> <up.x> <up.y> <up.z> <right.x> <right.y> <right.z> <scalar>

The instance's normalized orientation vectors are “up” and “right”.

Here's an example .instances file with three instances:

4691 3426 53 0 0 1 0.442758 0.896641 0 2.5
4592 3465 63 0 0 1 -0.850994 -0.525175 0 3.2
4505 3403 59 0 0 1 0.847678 -0.530511 0 2.5

Example code for loading .instances files can be found in CMyPopulate::GetSpeedForestFileInstances() in the reference application.