---
title: SpeedForest files (.instances files)
product: SpeedTree Runtime SDK
version: '10'
latest_version: '10'
status: This page documents version 10. The latest version is 10.
canonical: https://docs.unity.com/en-us/speedtree-runtime-sdk/10/speed-forest-files
latest_url: https://docs.unity.com/en-us/speedtree-runtime-sdk/10/speed-forest-files.md
last_updated: 2026-11-20
generated_at: 2026-11-20T20:16:44.484Z
locale: en-us
---

# SpeedForest files (.instances files)

> SpeedForest is an internal population tool used by the SpeedTree development team.

SpeedForest 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:

```cpp
<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:

```cpp
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.
