osgearth

Welcome to osgEarth!

osgEarth adds geospatially accurate 3D maps to your C++ application.

osgEarth builds on trusted open source technologies like OpenSceneGraph and GDAL to give you high-performance, accurate terrain and map rendering. It supports a myriad of geospatial data formats and map projections.

Install the SDK

Install the latest version of osgEarth from vcpkg:

vcpkg install osgearth:x64-windows
vcpkg install osgearth[tools]:x64-windows

Check out some examples

osgearth_imgui is the main command-line viewer. osgearth_viewer is a stripped-down viewer without any GUI. Both of these read "earth files", XML files that describe the contents of a map.

You can find example earth files in the tests folder of the repo.

cd tests

:: Online imagery and elevation:
osgearth_imgui readymap.earth

:: Local GeoTIFFs:
osgearth_imgui simple.earth 

:: OpenStreetMap:
osgearth_imgui osm.earth

Integrate it into your project

CMakeLists.txt

cmake_minimum_required(VERSION 3.20)
project(myApp)
find_package(osgEarth CONFIG REQUIRED)
add_executable(myApp main.cpp)
target_link_libraries(myApp PRIVATE osgEarth::osgEarth)
install(TARGETS myApp RUNTIME DESTINATION bin)

main.cpp

…

Build it yourself

To build osgEarth yourself, follow the instructions here.

Resources

• Documentation
• Gallery
• Custom Software Development

© Copyright Pelican Mapping