Documentation

SpeedTree Runtime SDK

Version: 10

SpeedTree Runtime SDK

Version: 10

Introduction to the reference application

Learn about the purpose of the SpeedTree Runtime SDK reference application.
Read time 1 minuteLast updated 2 hours ago

The purpose of the reference application is to provide an example of how to use the SpeedTree Runtime SDK.
Scene of a rocky and grassy environment with a variety of trees and vegetation
All source files prefixed with "My" indicate an example implementation meant to detail what an application might (and, in a lot of cases, should) do when interfacing with the SpeedTree Runtime SDK. These files constitute the bulk of the reference application and are not part of the official Runtime SDK; they are merely examples or "reference" implementations.
Most of the code in the reference application is dedicated to feeding the following data to the Runtime SDK:
  • Forest population, both random and by .stf files
  • Terrain population via an example height map class
  • Grass population using a procedural system
The other main parts of the reference application are as follows:
  • The actual render loop
  • Mouse, keyboard, and gamepad controls
  • Gathering and printing rendering statistics
  • Extracting the user configuration from the given .sfc (SpeedTree Forest Configuration) file (which has a considerable number of options) and passing them into the Runtime SDK. Example .sfc files are shown in the Reference App Launcher application (screenshot below, executable is at
    [SDK]/SDK/Bin/Reference Application Launcher.exe
    ). The .sfc syntax is not part of the Runtime SDK, but a handy mini-language our developers use to build example forests. Runtime SDK users can use it for experimentation and running their own art assets through the reference application.
Screenshot of the SpeedTree SDK Reference Application Launcher
In the figure below, the reference application serves as an example of one of the blue application boxes.
Workflow diagram of SpeedTree's libraries and client applications
Note
To execute the reference application in Linux, refer to the Linux version's instructions.