This section describes the overall organization of the SpeedTree SDK and assumes no prior knowledge of SpeedTree. It is recommended that you read the How to Use This SDK section to gain an understanding of the purpose of the SDK as well as the level of application integration that will best suit your needs.
There are four libraries in the SDK, each representing a different level of integration (the cyan boxes below):
The SDK ships with a demonstration application called the Reference Application. More on the Reference Application, but it's a complete standalone program that shows how a deep integration might be handled, though every user's integration will vary according to their goals and requirements.
At its most basic level, the SpeedTree SDK is organized like any other SDK or middleware offering. You'll need to be able to include the SDK header files, link to its libraries and, in the case of DLLs, make sure that the correct DLL(s) are in your binary path or copied next to your application's executable. Static libraries are also included.
In a default installation (notated here as “[SDK]/”), the key SDK files needed for an integration are located as noted below:
Each LIB and DLL file is named descriptively to avoid mixing up the wrong versions. The naming structure is as follows:
SpeedTree<lib base name>_<version>_<build type>_<runtime library>[_Static][_d]
This results in names such as “SpeedTreeCore_Windows_v7.0_VS2012_MT64_Static”, or “SpeedTreeCore_PS3_v7.0_Static_d.a”, etc. There are quite a few libraries and DLLs to chose from in the SDK, but hopefully this naming policy will prevent headaches in finding the correct version for your needs.
|Note: If using the DLL versions of the SpeedTree libraries, be sure to #define ST_USE_SDK_AS_DLLS in the client application.|
The SpeedTree SDK includes versioning hints to help runtime configuration and usage. The ST_VERSION_STRING macro contains a string version number (e.g. “7.0.0”), and ST_VERSION_MAJOR, ST_VERSION_MINOR, and ST_VERSION_SUBMINOR contain the numerical values 7, 0, and 0 respectively. These macros can be checked at any point to determine the version of the SpeedTree SDK being used.
To avoid mismatches between header files and libraries, the static CCore::Version() function can be used. CCore::Version() returns a long descriptive string about the build type, platform, and version used when building the library. Or, passing true in the bShort parameter to CCore::Version() returns a string that can be directly compared to the ST_VERSION_STRING define to determine if the header and library match.
All of the source code contained in the SDK libraries is housed in the SpeedTree namespace. Use this namespace to resolve any conflicts between SDK types and your own.