Rocky is a C++ SDK for rendering maps and globes. 
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.
On Windows, Rocky comes with a handy batch file to automatically configure the project using vcpkg:
bootstrap-vcpkg.batThat will download and build all the dependencies (takes a while) and generate your CMake project and Visual Studio solution file.
On Linux you can use vcpkg as well, or you can install the dependencies using your favorite package manager (like apt).
Thanks to these excellent open source projects!
- cpp-httplib
- entt
- GDAL (optional)
- glm
- ImGui (optional)
- nlohmann-json
- openssl (optional)
- proj
- spdlog
- sqlite3 (optional)
- vsgXchange (optional)
- VulkanSceneGraph
- weejobs (embedded)
Rocky is pretty good at finding its data files, but you might need so up a couple environment variables to help:
set ROCKY_FILE_PATH=%rocky_install_dir%/share
set ROCKY_DEFAULT_FONT=C:/windows/fonts/arialbd.ttf
set PROJ_DATA=%proj_install_dir%/share/projIf 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).
Now we're ready:
rocky_demo
There are some JSON map files in the data folder. Load one with the --map option:
rocky_demo --map data\openstreetmap.map.json
The easiest way to write a turnkey Rocky app is to use the rocky::Application object. It will create a viewer, a default map, and a scene graph to store everything you want to visualize.
#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->uri = "https://readymap.org/readymap/tiles/1.0.0/7/";
app.mapNode->map->layers().add(imagery);
return app.run();
}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)You can embed Rocky in a Qt widget. See the rocky_demo_qt example for details.
If you're already using VSG in your application and want to add a MapNode to a view, do this:
// make a map node:
auto mapNode = rocky::MapNode::create();
// optional - add one or more maps to your map:
auto layer = rocky::TMSImageLayer::create();
layer->uri = "https://[abc].tile.openstreetmap.org/{z}/{x}/{y}.png";
layer->setProfile(rocky::Profile::SPHERICAL_MERCATOR);
layer->setAttribution(rocky::Hyperlink{ "\u00a9 OpenStreetMap contributors", "https://openstreetmap.org/copyright" });
mapNode->map->layers().add(layer);
// Required- You MUST tell the rocky runtime context about your `vsg::Viewer` instance:
auto& runtime = mapNode->instance.runtime();
runtime.viewer = viewer;
...
scene->addChild(mapNode);You'll probably also want to add the MapManipulator to that view to control the map:
viewer->addEventHandler(rocky::MapManipulator::create(mapNode, window, camera));Coming soon.
Rocky has a set of building blocks for creating map annotations like labels, icons, and geometry. Rocky uses an ECS (entity component system) based on EnTT to store these primitives. Coming soon.
