Awesome
:mountain: Rocky
Rocky is a 3D Geospatial C++ SDK. <img align="right" width="200" alt="Screenshot 2023-02-22 124318" src="https://user-images.githubusercontent.com/326618/220712284-8a17d87a-431f-4966-a425-0f2628b23b40.png">
Rocky will render an accurate 3D or 2D map with real geospatial imagery and elevation data. It supports thousands of map projections and many popular geodata sources including GeoTIFF, TMS, OpenStreetMap, WMTS, WMS, and Azure Maps. Rocky's data model is inspired by the osgEarth SDK, a 3D GIS toolkit created in 2008 and still in wide use today.
This project is in its early stages so expect a lot of API and architectural changes before version 1.0.
A simple Rocky application
main.cpp
#include <rocky/vsg/Application.h>
#include <rocky/TMSImageLayer.h>
int main(int argc, char** argv)
{
rocky::Application app(argc, argv);
auto imagery = rocky::TMSImageLayer::create();
imagery->setURI("https://readymap.org/readymap/tiles/1.0.0/7/");
app.map()->layers().add(imagery);
return app.run();
}
CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(myApp VERSION 0.1.0 LANGUAGES CXX C)
find_package(rocky CONFIG REQUIRED)
add_executable(myApp main.cpp)
target_link_libraries(myApp PRIVATE rocky::rocky)
install(TARGETS myApp RUNTIME DESTINATION bin)
Dependencies
- cpp-httplib
- entt
- GDAL (optional)
- glm
- nlohmann-json
- openssl (optional)
- proj
- spdlog
- sqlite3 (optional)
- vsgXchange (optional)
- VulkanSceneGraph
- weejobs
Building
Rocky comes with a handy Windows batch file to automatically configure the project using vcpkg
:
bootstrap-vcpkg.bat
That will download and build all the dependencies (takes a while) and generate your CMake project and Visual Studio solution file.
Running
Set up a couple environment variables so Rocky can find its data.
set ROCKY_FILE_PATH=%rocky_install_dir%/share
set ROCKY_DEFAULT_FONT=C:/windows/fonts/arialbd.ttf
set PROJ_DATA=%proj_install_dir%/share/proj
If you built with vcpkg
you will also need to add the dependencies folder to your path; this will normally be found in vcpkg_installed/x64-windows
(or whatever platform you are using).
rdemo
There are some example JSON map files in the data
folder. Load them with the --map
option.
rdemo --map data\openstreetmap.map.json
<img width="500" alt="Screenshot 2023-02-22 124318" src="https://user-images.githubusercontent.com/326618/236200807-73567789-a5a3-46d5-a98d-e9c1f24a0f62.png">
Use --help
to see all command line options.
rdemo --help