Continue 3d terrain work

CMakeLists.txt

@@ -184,6 +184,9 @@ list(APPEND SRC_FILES
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layer_group.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/tile_layer_group.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layer_tweaker.cpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/render_terrain.cpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/dem_elevation_provider.cpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/texture_pool.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/background_layer_tweaker.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/background_layer_tweaker.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/circle_layer_tweaker.cpp
@@ -208,6 +211,7 @@ list(APPEND SRC_FILES
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/raster_layer_tweaker.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/symbol_layer_tweaker.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/symbol_layer_tweaker.hpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/terrain_layer_tweaker.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/collision_layer_tweaker.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/renderer/layers/collision_layer_tweaker.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/shader_program_base.cpp
@@ -311,6 +315,7 @@ list(APPEND INCLUDE_FILES
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/rotation.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/source.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/source_options.hpp
+    ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/terrain.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/tileset.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/conversion/transition_options.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/expression/assertion.hpp
@@ -388,6 +393,8 @@ list(APPEND INCLUDE_FILES
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/style_property.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/style.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/transition_options.hpp
+    ${PROJECT_SOURCE_DIR}/include/mbgl/style/terrain.hpp
+    ${PROJECT_SOURCE_DIR}/include/mbgl/style/terrain_observer.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/types.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/undefined.hpp
     ${PROJECT_SOURCE_DIR}/include/mbgl/style/variable_anchor_offset_collection.hpp
@@ -675,6 +682,8 @@ list(APPEND SRC_FILES
     ${PROJECT_SOURCE_DIR}/src/mbgl/storage/resource_transform.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/storage/response.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/collection.hpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/style/terrain.cpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/style/terrain_impl.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/color_ramp_property_value.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/constant.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/sprite.cpp
@@ -695,6 +704,7 @@ list(APPEND SRC_FILES
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/source.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/source_options.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/stringify.hpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/terrain.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/tileset.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/conversion/transition_options.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/style/custom_tile_loader.cpp

bazel/core.bzl

@@ -112,6 +112,8 @@ MLN_GENERATED_OPENGL_SHADER_HEADERS = [
     "include/mbgl/shaders/gl/symbol_icon.hpp",
     "include/mbgl/shaders/gl/symbol_sdf.hpp",
     "include/mbgl/shaders/gl/symbol_text_and_icon.hpp",
+    "include/mbgl/shaders/gl/terrain.hpp",
+    "include/mbgl/shaders/gl/terrain_depth.hpp",
     "include/mbgl/shaders/gl/wide_vector.hpp",
     "include/mbgl/shaders/gl/prelude.hpp",
 ]
@@ -275,6 +277,10 @@ MLN_CORE_SOURCE = [
     "src/mbgl/renderer/render_source.hpp",
     "src/mbgl/renderer/render_source_observer.hpp",
     "src/mbgl/renderer/render_static_data.cpp",
+    "src/mbgl/renderer/render_terrain.cpp",
+    "src/mbgl/renderer/render_terrain.hpp",
+    "src/mbgl/renderer/dem_elevation_provider.cpp",
+    "src/mbgl/renderer/dem_elevation_provider.hpp",
     "src/mbgl/renderer/render_static_data.hpp",
     "src/mbgl/renderer/render_tile.cpp",
     "src/mbgl/renderer/render_tile.hpp",
@@ -305,6 +311,7 @@ MLN_CORE_SOURCE = [
     "src/mbgl/renderer/tile_parameters.hpp",
     "src/mbgl/renderer/tile_pyramid.cpp",
     "src/mbgl/renderer/tile_pyramid.hpp",
+    "src/mbgl/renderer/texture_pool.hpp",
     "src/mbgl/renderer/tile_render_data.cpp",
     "src/mbgl/renderer/tile_render_data.hpp",
     "src/mbgl/renderer/transition_parameters.hpp",
@@ -344,6 +351,7 @@ MLN_CORE_SOURCE = [
     "src/mbgl/style/conversion/json.hpp",
     "src/mbgl/style/conversion/layer.cpp",
     "src/mbgl/style/conversion/light.cpp",
+    "src/mbgl/style/conversion/terrain.cpp",
     "src/mbgl/style/conversion/position.cpp",
     "src/mbgl/style/conversion/property_value.cpp",
     "src/mbgl/style/conversion/hillshade_conversions.cpp",
@@ -463,6 +471,8 @@ MLN_CORE_SOURCE = [
     "src/mbgl/style/style.cpp",
     "src/mbgl/style/style_impl.cpp",
     "src/mbgl/style/style_impl.hpp",
+    "src/mbgl/style/terrain.cpp",
+    "src/mbgl/style/terrain_impl.hpp",
     "src/mbgl/style/types.cpp",
     "src/mbgl/style/variable_anchor_offset_collection.cpp",
     "src/mbgl/text/bidi.hpp",
@@ -719,6 +729,7 @@ MLN_CORE_HEADERS = [
     "include/mbgl/style/conversion/get_json_type.hpp",
     "include/mbgl/style/conversion/layer.hpp",
     "include/mbgl/style/conversion/light.hpp",
+    "include/mbgl/style/conversion/terrain.hpp",
     "include/mbgl/style/conversion/position.hpp",
     "include/mbgl/style/conversion/property_value.hpp",
     "include/mbgl/style/conversion/rotation.hpp",
@@ -789,6 +800,8 @@ MLN_CORE_HEADERS = [
     "include/mbgl/style/sprite.hpp",
     "include/mbgl/style/style.hpp",
     "include/mbgl/style/style_property.hpp",
+    "include/mbgl/style/terrain.hpp",
+    "include/mbgl/style/terrain_observer.hpp",
     "include/mbgl/style/transition_options.hpp",
     "include/mbgl/style/types.hpp",
     "include/mbgl/style/undefined.hpp",
@@ -939,6 +952,7 @@ MLN_DRAWABLES_SOURCE = [
     "src/mbgl/renderer/change_request.cpp",
     "src/mbgl/renderer/layer_group.cpp",
     "src/mbgl/renderer/tile_layer_group.cpp",
+    "src/mbgl/renderer/texture_pool.cpp",
     "src/mbgl/renderer/layer_tweaker.cpp",
     "src/mbgl/renderer/render_target.cpp",
     "src/mbgl/renderer/layers/background_layer_tweaker.cpp",
@@ -967,6 +981,8 @@ MLN_DRAWABLES_SOURCE = [
     "src/mbgl/renderer/layers/raster_layer_tweaker.hpp",
     "src/mbgl/renderer/layers/symbol_layer_tweaker.cpp",
     "src/mbgl/renderer/layers/symbol_layer_tweaker.hpp",
+    "src/mbgl/renderer/layers/terrain_layer_tweaker.cpp",
+    "src/mbgl/renderer/layers/terrain_layer_tweaker.hpp",
     "src/mbgl/renderer/layers/collision_layer_tweaker.cpp",
     "src/mbgl/renderer/layers/collision_layer_tweaker.hpp",
     "src/mbgl/shaders/shader_program_base.cpp",
@@ -1013,6 +1029,7 @@ MLN_DRAWABLES_HEADERS = [
     "include/mbgl/shaders/line_layer_ubo.hpp",
     "include/mbgl/shaders/location_indicator_ubo.hpp",
     "include/mbgl/shaders/raster_layer_ubo.hpp",
+    "include/mbgl/shaders/terrain_layer_ubo.hpp",
     "include/mbgl/shaders/shader_defines.hpp",
     "include/mbgl/shaders/shader_program_base.hpp",
     "include/mbgl/shaders/symbol_layer_ubo.hpp",
@@ -1088,6 +1105,8 @@ MLN_DRAWABLES_MTL_SOURCE = [
     "src/mbgl/shaders/mtl/line.cpp",
     "src/mbgl/shaders/mtl/location_indicator.cpp",
     "src/mbgl/shaders/mtl/raster.cpp",
+    "src/mbgl/shaders/mtl/terrain.cpp",
+    "src/mbgl/shaders/mtl/terrain_depth.cpp",
     "src/mbgl/shaders/mtl/symbol.cpp",
     "src/mbgl/shaders/mtl/widevector.cpp",
     "src/mbgl/style/layers/mtl/custom_layer_render_parameters.cpp",
@@ -1131,6 +1150,8 @@ MLN_DRAWABLES_MTL_HEADERS = [
     "include/mbgl/shaders/mtl/line.hpp",
     "include/mbgl/shaders/mtl/location_indicator.hpp",
     "include/mbgl/shaders/mtl/raster.hpp",
+    "include/mbgl/shaders/mtl/terrain.hpp",
+    "include/mbgl/shaders/mtl/terrain_depth.hpp",
     "include/mbgl/shaders/mtl/shader_group.hpp",
     "include/mbgl/shaders/mtl/shader_program.hpp",
     "include/mbgl/shaders/mtl/symbol.hpp",
@@ -1178,6 +1199,8 @@ MLN_DRAWABLES_WEBGPU_SOURCE = [
     "src/mbgl/shaders/webgpu/location_indicator.cpp",
     "src/mbgl/shaders/webgpu/raster.cpp",
     "src/mbgl/shaders/webgpu/symbol.cpp",
+    "src/mbgl/shaders/webgpu/terrain.cpp",
+    "src/mbgl/shaders/webgpu/terrain_depth.cpp",
     "src/mbgl/shaders/webgpu/widevector.cpp",
 ]
 
@@ -1223,6 +1246,8 @@ MLN_DRAWABLES_WEBGPU_HEADERS = [
     "include/mbgl/shaders/webgpu/shader_group.hpp",
     "include/mbgl/shaders/webgpu/shader_program.hpp",
     "include/mbgl/shaders/webgpu/symbol.hpp",
+    "include/mbgl/shaders/webgpu/terrain.hpp",
+    "include/mbgl/shaders/webgpu/terrain_depth.hpp",
     "include/mbgl/shaders/webgpu/wgsl_preprocessor.hpp",
     "include/mbgl/shaders/webgpu/widevector.hpp",
 ]

cmake/metal.cmake

@@ -92,6 +92,8 @@ list(APPEND
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/location_indicator.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/raster.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/symbol.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/terrain.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/terrain_depth.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/mtl/widevector.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/style/layers/mtl/custom_layer_render_parameters.cpp
 )

cmake/vulkan.cmake

@@ -54,6 +54,8 @@ list(APPEND
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/location_indicator.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/raster.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/symbol.hpp
+        ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/terrain.hpp
+        ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/terrain_depth.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/vulkan/widevector.hpp
 )
 
@@ -100,5 +102,7 @@ list(APPEND
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/location_indicator.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/raster.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/symbol.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/terrain.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/terrain_depth.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/vulkan/widevector.cpp
 )

cmake/webgpu.cmake

@@ -47,6 +47,8 @@ list(APPEND
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/location_indicator.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/raster.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/symbol.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/terrain.cpp
+        ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/terrain_depth.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/shaders/webgpu/widevector.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/webgpu/vertex_buffer_resource.cpp
         ${PROJECT_SOURCE_DIR}/src/mbgl/webgpu/vertex_attribute.cpp
@@ -87,6 +89,8 @@ list(APPEND
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/location_indicator.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/raster.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/symbol.hpp
+        ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/terrain.hpp
+        ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/terrain_depth.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/shaders/webgpu/widevector.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/webgpu/texture2d.hpp
         ${PROJECT_SOURCE_DIR}/include/mbgl/webgpu/uniform_buffer.hpp

include/mbgl/gfx/context.hpp

@@ -83,6 +83,14 @@ class Context {
 
     virtual std::unique_ptr<OffscreenTexture> createOffscreenTexture(Size, TextureChannelDataType) = 0;
 
+    /// Create an offscreen texture with explicit depth/stencil attachments. Terrain drape
+    /// targets need a stencil to clip overlapping draped tiles against each other, as
+    /// maplibre-gl-js does for its render-to-texture framebuffer.
+    virtual std::unique_ptr<OffscreenTexture> createOffscreenTexture(Size,
+                                                                     TextureChannelDataType,
+                                                                     bool depth,
+                                                                     bool stencil) = 0;
+
     template <RenderbufferPixelType pixelType>
     Renderbuffer<pixelType> createRenderbuffer(const Size size) {
         return {size, createRenderbufferResource(pixelType, size)};
@@ -138,19 +146,24 @@ class Context {
     /// Create a tile layer group implementation
     virtual TileLayerGroupPtr createTileLayerGroup(int32_t layerIndex,
                                                    std::size_t initialCapacity,
-                                                   std::string name) = 0;
+                                                   std::string name,
+                                                   bool renderToTerrain) = 0;
 
     /// Create a layer group implementation
-    virtual LayerGroupPtr createLayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name) = 0;
+    virtual LayerGroupPtr createLayerGroup(int32_t layerIndex,
+                                           std::size_t initialCapacity,
+                                           std::string name,
+                                           bool renderToTerrain) = 0;
 
     /// Create a texture
     virtual Texture2DPtr createTexture2D() = 0;
 
     /// Create a dynamic texture
     virtual DynamicTexturePtr createDynamicTexture(Size size, TexturePixelType pixelType) = 0;
 
-    /// Create a render target
-    virtual RenderTargetPtr createRenderTarget(const Size size, const TextureChannelDataType type) = 0;
+    /// Create a render target. `stencil` attaches a stencil buffer, which terrain drape
+    /// targets need to clip overlapping draped tiles against each other.
+    virtual RenderTargetPtr createRenderTarget(const Size size, const TextureChannelDataType type, bool stencil) = 0;
 
     /// Resets the context state to defaults
     virtual void resetState(gfx::DepthMode depthMode, gfx::ColorMode colorMode) = 0;

include/mbgl/gfx/rendering_stats.hpp

@@ -73,8 +73,8 @@ struct RenderingStats {
     /// Sum of uniform buffers update sizes
     std::size_t uniformUpdateBytes = 0;
 
-    /// Total texture memory
-    int memTextures = 0;
+    /// Total texture memory (int64_t: terrain scenes can track more than 2GB)
+    int64_t memTextures = 0;
     /// Total buffer memory
     int memBuffers = 0;
     /// Total index buffer memory

include/mbgl/gl/layer_group_gl.hpp

@@ -14,7 +14,7 @@ namespace gl {
  */
 class TileLayerGroupGL : public TileLayerGroup {
 public:
-    TileLayerGroupGL(int32_t layerIndex, std::size_t initialCapacity, std::string name);
+    TileLayerGroupGL(int32_t layerIndex, std::size_t initialCapacity, std::string name, bool renderToTerrain);
     ~TileLayerGroupGL() override {}
 
     void upload(gfx::UploadPass&) override;
@@ -33,7 +33,7 @@ class TileLayerGroupGL : public TileLayerGroup {
  */
 class LayerGroupGL : public LayerGroup {
 public:
-    LayerGroupGL(int32_t layerIndex, std::size_t initialCapacity, std::string name);
+    LayerGroupGL(int32_t layerIndex, std::size_t initialCapacity, std::string name, bool renderToTerrain);
     ~LayerGroupGL() override {}
 
     void upload(gfx::UploadPass&) override;

include/mbgl/mtl/context.hpp

@@ -92,21 +92,30 @@ class Context final : public gfx::Context {
 
     gfx::ShaderProgramBasePtr getGenericShader(gfx::ShaderRegistry&, const std::string& name) override;
 
-    TileLayerGroupPtr createTileLayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name) override;
+    TileLayerGroupPtr createTileLayerGroup(int32_t layerIndex,
+                                           std::size_t initialCapacity,
+                                           std::string name,
+                                           bool renderToTerrain) override;
 
-    LayerGroupPtr createLayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name) override;
+    LayerGroupPtr createLayerGroup(int32_t layerIndex,
+                                   std::size_t initialCapacity,
+                                   std::string name,
+                                   bool renderToTerrain) override;
 
     gfx::Texture2DPtr createTexture2D() override;
 
     gfx::DynamicTexturePtr createDynamicTexture(Size size, gfx::TexturePixelType pixelType) override;
 
-    RenderTargetPtr createRenderTarget(const Size size, const gfx::TextureChannelDataType type) override;
+    RenderTargetPtr createRenderTarget(const Size size, const gfx::TextureChannelDataType type, bool stencil) override;
 
     void resetState(gfx::DepthMode depthMode, gfx::ColorMode colorMode) override;
 
     void setDirtyState() override;
 
-    std::unique_ptr<gfx::OffscreenTexture> createOffscreenTexture(Size, gfx::TextureChannelDataType, bool, bool);
+    std::unique_ptr<gfx::OffscreenTexture> createOffscreenTexture(Size,
+                                                                  gfx::TextureChannelDataType,
+                                                                  bool,
+                                                                  bool) override;
 
     std::unique_ptr<gfx::OffscreenTexture> createOffscreenTexture(Size, gfx::TextureChannelDataType) override;
 

include/mbgl/mtl/layer_group.hpp

@@ -16,7 +16,7 @@ class RenderPass;
  */
 class LayerGroup : public mbgl::LayerGroup {
 public:
-    LayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name);
+    LayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name, bool renderToTerrain);
     ~LayerGroup() override {}
 
     void upload(gfx::UploadPass&) override;

include/mbgl/mtl/render_pass.hpp

@@ -41,6 +41,12 @@ class RenderPass final : public gfx::RenderPass {
     /// Set the sampler for a texture binding
     void setFragmentSamplerState(const MTLSamplerStatePtr&, int32_t location);
 
+    /// Bind a texture to the vertex location
+    void setVertexTexture(const MTLTexturePtr&, int32_t location);
+
+    /// Set the sampler for a vertex texture binding
+    void setVertexSamplerState(const MTLSamplerStatePtr&, int32_t location);
+
     /// Set the render pipeline state
     void setRenderPipelineState(const MTLRenderPipelineStatePtr&);
 
@@ -91,6 +97,9 @@ class RenderPass final : public gfx::RenderPass {
     std::array<MTLTexturePtr, maxBinds> fragmentTextureBindings;
     std::array<MTLSamplerStatePtr, maxBinds> fragmentSamplerStates;
 
+    std::array<MTLTexturePtr, maxBinds> vertexTextureBindings;
+    std::array<MTLSamplerStatePtr, maxBinds> vertexSamplerStates;
+
     MTL::CullMode currentCullMode = MTL::CullModeNone;
     MTL::Winding currentWinding = MTL::WindingClockwise;
     MTL::ScissorRect currentScissorRect;

include/mbgl/mtl/tile_layer_group.hpp

@@ -21,7 +21,7 @@ class RenderPass;
  */
 class TileLayerGroup : public mbgl::TileLayerGroup {
 public:
-    TileLayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name);
+    TileLayerGroup(int32_t layerIndex, std::size_t initialCapacity, std::string name, bool renderToTerrain);
     ~TileLayerGroup() override {}
 
     void upload(gfx::UploadPass&) override;