vts-browser-cpp
vts-browser-cpp copied to clipboard
VTS Browser C++ library
![VTS Browser JS](https://github.com/melowntech/assets/blob/master/vts-browser-cpp/vts-browser-cpp-no-left-margin.png?raw=true)
VTS Browser CPP is a collection of libraries that bring VTS frontend capabilities to your native applications.
Examples
Unity 3D integration example
(Click to play the video)
iOS app example
(Click to play the video)
Features
- Highly flexible -> almost all aspects can be changed through configuration.
- Rendering API independent -> the browser library, on its own, does not render anything.
Instead, it just tells the application what to render.
- Optional OpenGL (ES) rendering library is also provided.
- Clean C++ API.
- C and C# bindings are available too.
- Works on Windows, UWP (experimental), Linux, Web Assembly (experimental), macOS and iOS.
- We also provide plugin for VTS integration into Unity 3D.
- And javascript browser for integration with websites.
- Simple -> minimal application using these libraries has about 300 LOC. See vts-browser-minimal.
WIP
Be warned, this library is still in development. We make no attempt on maintaining ABI nor API compatibility yet.
Documentation
Browser documentation is available at the wiki.
Documentation for the whole VTS is at VTS Geospatial.
Installing from Melown repository (Linux desktop only)
We provide pre-compiled packages for some popular linux distributions. See Melown OSS package repository for more information.
The packages are named libvts-browser0 (the library itself), libvts-browser-dbg (debug symbols for the library), libvts-browser-dev (developer files for the library) and vts-browser-desktop (example application).
Building and using the browser
See BUILDING.md for instructions to build the libraries from source.
See USING.md for instructions to write a simple app with VTS browser.
Running example application
Run the desktop example application with default mapconfig (our Intergeo presentation):
vts-browser-desktop
Run the desktop example application with specific mapconfig:
vts-browser-desktop https://cdn.melown.com/mario/store/melown2015/map-config/melown/Melown-Earth-Intergeo-2017/mapConfig.json
Bug reports
For bug reports or enhancement suggestions use the Issue tracker.
How to contribute
Check the CONTRIBUTING.md file.
License
See the LICENSE file.