What's new in SpeedTree Runtime SDK 10?
With the release of version 10.0.0, the SpeedTree Games SDK has been renamed to the SpeedTree Runtime SDK.
Read time 5 minutesLast updated 2 hours ago
The Runtime SDK remains focused on real-time, in-engine execution.
This release immediately succeeds the previous version, Games SDK 9.5.0, and brings the new product name, confirmed support of the v10 SpeedTree .stsdk/texture pipeline, updated support for Linux, and some moderate source cleanup.
Requirements
Ensure SpeedTree Modeler version 9.1.1 or newer is installed to compile .stsdk models compatible with this Runtime SDK release.
Features
- Games SDK Rebranded To Runtime SDK: The name change impacted several areas of the code and clarifications were necessary. also updated to report the new name.
CCore::Version() - Renewed Linux Support: Support for Linux lagged in 9.x but has been updated for version 10.
- C++20 Support: The Runtime SDK and Reference Application have been updated to be compliant with the C++20 standard. In some instances, there are C++20-only code paths for handling static member variables of templated classes.
- Xbox Series X/S Builds: Compiled and tested Xbox Series X/S builds against March 2024 GDK.
- PlayStation 5 Builds: Compiled and tested PlayStation 5 builds against Prospero SDK 9.000 and devkit system software version 9.00.00.45.
Changes
- Build Type Naming Convention Change (Windows): “MTDLL” is now “MD”, which is reflected in every Windows project file and .lib and .dll filename in the Runtime SDK.
- Standard Vertex Packers/Shaders Updated: The per-vertex attribute “two-sided” boolean was removed from the “Standard” and “Standard Grass” vertex packers in the Modeler. The Reference Application sample shaders were adjusted accordingly.
- SpeedWindTree.h Updates (in version 9.5.0, most proprietary wind functionality was consolidated into this single file, which compiles in both C++ and HLSL/GLSL shaders):
- Any references to “Games SDK” or “SDK” in the comments were updated to “Runtime SDK”.
- added for better randomization control.
CWindStateMgr::SetSeed()will no longer pick a random seed upon instantiation.CWindStateMgr - Structure renamed to
SWindBranchLevelSdk.SWindBranchLevelRuntimeSdk - Structure renamed to
SWindVertexSdk.SWindVertexRuntimeSdk - Structure renamed to
SWindOptionsSdk.SWindOptionsRuntimeSdk - Structure renamed to
SWindBranchStateSdk.SWindBranchStateRuntimeSdk - Structure renamed to
SWindRippleStateSdk.SWindRippleStateRuntimeSdk - Structure renamed to
SWindStateSdk.SWindStateRuntimeSdk - Structure renamed to
SWindInputSdk.SWindInputRuntimeSdk - Function renamed to
SdkNoise2DFlat().RuntimeSdkNoise2DFlat() - Function renamed to
WindSdk().WindRuntimeSdk() - Enumeration entry renamed to
ST_WIND_MODE_SDK.ST_WIND_MODE_RUNTIME_SDK - Structure renamed to
SConfigSdk.SConfigRuntimeSdk - Member function renamed to
CWindStateMgr::GetConfigSdk().CWindStateMgr::GetConfigRuntimeSdk() - Updated deprecated to
GLM_SWIZZLEin use of GLM library.GLM_FORCE_SWIZZLE - Added explicit copy constructors to float2, float3, and float due to gcc warnings.
- All boolean member variables in structures were updated to integers to help ensure C++/std140 alignment across all supported platforms. Conditionals referencing these values were also updated.
SWindOptions* - Minor bug fixes to and
WindGlobalBehaviorLegacy()to correct alternate coordinate system support.WindLeafTumbleLegacy() - Minor bug fix in so that
WindBranchByLevelVfx()has an effect on wind.sBranchLevel.m_fChaos - functions updated with more thorough initialization code.
CWindStateMgr::SetNoWind*()
- GLEW_STATIC Declaration Moved: For OpenGL applications, glew is compiled from source and the declaration was moved from
GLEW_STATICinto each project’s preprocessor definitions.Include/SpeedTree/Utilities/Utility.h - Linux Changes: Some changes were necessary to get the sample Reference Application to compile and function on Linux, others were from gcc heeding errors and warnings:
- Changes to the sample WASD-style navigation, defined in and
MyNavigationBase.h/cpp.MyMouseAndKeyboardNavigation.h/cpp - Several cases where case sensitivity to art asset filenames and paths needed adjustment.
- Iterator typename updates for class in the sample terrain engine.
CCellContainer
- Changes to the sample WASD-style navigation, defined in
- Win32/32-bit Builds Removed From DirectX12 Reference Application: These went unused and were causing issues with use of Dear ImGui. All of the Runtime SDK libraries, including the SpeedTree DirectX12 rendering library, still build under Win32/32-bit.
- Core Library Changes:
- Removed constant declared in
c_szFolderSeparatorInclude/SpeedTree/Core/Types.h - was removed from
c_apGfxResourceNamesand replaced with the static functionInclude/SpeedTree/Core/Core.h.CCore:GfxResourceName() - given a robust update in
st_strerror().PortableCrt.h
- Removed
- Reference Application Changes:
- In , used in the deferred rendering example,
gbuffer_example.handST_GEOMETRY_TYPE_TREE_2SIDEDwere removed and the sample tree, grass, and deferred lighting shaders were adjusted accordingly. This form of 2-sided lighting was deprecated in the Modeler in version 9.ST_GEOMETRY_TYPE_GRASS_2SIDED - removed from the example SSpeedTreePbrInput structure as it is no longer configurable.
m_iShaderLighting - Font updated for ImGui-based overlay.
- In
Bug fixes
- Windows Visual Studio Project Alignment: There are numerous preprocessor definitions across the Visual Studio 2015, 2017, 2019, and 2022 projects, each version with 16 build configurations of four libraries and a reference application. An audit and realignment of these settings for every configuration was conducted. Some alignments included:
- Having defined for every build of the Reference Application (many did not have it defined).
ST_USE_IMGUI - Setting instead of
/SUBSYSTEM:WINDOWSfor every Reference Application build./SUBSYSTEM:CONSOLE - Removing older, unused, or out-dated definitions.
- Having
- OpenGL Reference Application Bug Fixes (Windows):
- When built and run with DLL versions of the SpeedTree Runtime SDK libraries, a crash resulted at initialization with the glew library built with .
GLEW_STATIC - Max anisotropic filtering setting not passing through when SpeedTree Runtime SDK libraries were built and used as DLLs.
- Switching every configuration to using necessitated adding a
/SUBSYSTEM:CONSOLEentry point which just pointed to the existingWinMain()entry point.main()
- When built and run with DLL versions of the SpeedTree Runtime SDK libraries, a crash resulted at initialization with the glew library built with
Post-alpha updates
- SpeedTree Viewer application added, which is a comprehensive utility that provides a more straightforward example of using the SpeedTree Runtime SDK than the more complex Reference Application. It details loading, rendering, and animating SpeedTree .stsdk models using a straightforward architecture, implemented in C++ and OpenGL.
- Include file renamed to
Core/String.h.Core/StringDynamic.h - Include file renamed to
Core/FixedString.h.Core/StringFixed.h - Detailed comments added to structure in
SDrawCall.Core/Core.h