VTS Browser CPP is a collection of libraries that bring VTS client capabilities to your native applications.

This Unity Plugin integrates the VTS Browser into the popular Unity 3D game engine.

• The plugin handles data streaming and resource management
• Rendering is done in Unity (with custom shaders)
  • This allows you to customize the rendering process
  • Provided shaders:
    • Unlit
    • Unlit with shadows
    • Optionally with custom atmosphere that works with whole-planet views and transitions to street-level views
• Supports multiple cameras
• Support for physical collision

The Unity Plugin documentation is at the wiki.

Browser documentation is available at its own wiki.

Documentation for the whole VTS is at Read the Docs.

Build instructions are the same as for the VTS Browser Build Wrapper. Just start in the root folder of this repository to ensure that the settings from CMakeLists.txt here are applied too.

Unity 2018 or newer is required.

The simplest way is to create a few symbolic/directory links on the filesystem for each Unity project.

In all cases, make sure to configure the plugins in the Unity Inspector to only include them on the relevant platforms.

• <Unity Project>/Assets/Vts -> <This Repository>/src/Vts
• <Unity Project>/Assets/Vts/Plugins/vts-browser.dll -> <This Repository>/build/result/relwithdebinfo/vts-browser.dll

• <Unity Project>/Assets/Vts -> <This Repository>/src/Vts
• <Unity Project>/Assets/Vts/Plugins/vts-browser.bundle -> <This Repository>/build/result/relwithdebinfo/vts-browser.bundle

• <Unity Project>/Assets/Vts -> <This Repository>/src/Vts
• <Unity Project>/Assets/Vts/Plugins/vts-browser.framework -> <This Repository>/build-ios/result/relwithdebinfo/vts-browser.framework
• After you make the build in Unity, open the XCode project:
  • in the project, Build Settings, Linking, set Runpath Search Paths to @executable_path and @executable_path/Frameworks
  • in Build Phases, Copy Files, add vts-browser.framework to Destination Frameworks
    • make sure that Code Sign On Copy is on

• Build the vts-browser library on linux and copy it to <Unity Project>/Assets/Vts/Plugins/libvts-browser.so

For bug reports or enhancement suggestions use the Issue tracker.

Check the CONTRIBUTING.md on the VTS Browser CPP repository. It applies equally here.

See the LICENSE file.