Files
MapLibreParticleLab/include/mln/renderer/renderer_observer.hpp
Bart Louwers 2a8ebc4906 core: rename mbgl directories to mln (#4511)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2026-08-22 20:50:14 +02:00

90 lines
3.2 KiB
C++

#pragma once
#include <mln/tile/tile_id.hpp>
#include <mln/util/font_stack.hpp>
#include <mln/gfx/rendering_stats.hpp>
#include <mln/text/glyph_range.hpp>
#include <mln/tile/tile_operation.hpp>
#include <mln/gfx/backend.hpp>
#include <mln/shaders/shader_source.hpp>
#include <mln/util/symbol_error_observer.hpp>
#include <cstdint>
#include <exception>
#include <functional>
#include <string>
namespace mln {
namespace gfx {
class ShaderRegistry;
}
class RendererObserver : public SymbolErrorObserver {
public:
~RendererObserver() override = default;
enum class RenderMode : uint32_t {
Partial,
Full
};
/// Signals that a repaint is required
virtual void onInvalidate() {}
/// Resource failed to download / parse
virtual void onResourceError(std::exception_ptr) {}
/// First frame
virtual void onWillStartRenderingMap() {}
/// Start of frame, initial is the first frame for this map
virtual void onWillStartRenderingFrame() {}
/// End of frame, booleans flags that a repaint is required and that placement changed.
virtual void onDidFinishRenderingFrame(RenderMode, bool /*repaint*/, bool /*placementChanged*/) {}
/// End of frame, booleans flags that a repaint is required and that placement changed.
virtual void onDidFinishRenderingFrame(RenderMode mode,
bool repaint,
bool placementChanged,
double /*frameEncodingTime*/,
double /*frameRenderingTime*/) {
onDidFinishRenderingFrame(mode, repaint, placementChanged);
}
virtual void onDidFinishRenderingFrame(RenderMode mode,
bool repaint,
bool placementChanged,
const gfx::RenderingStats& stats) {
onDidFinishRenderingFrame(mode, repaint, placementChanged, stats.encodingTime, stats.renderingTime);
}
/// Final frame
virtual void onDidFinishRenderingMap() {}
/// Style is missing an image
using StyleImageMissingCallback = std::function<void()>;
virtual void onStyleImageMissing(const std::string&, const StyleImageMissingCallback& done) { done(); }
virtual void onRemoveUnusedStyleImages(const std::vector<std::string>&) {}
// Entry point for custom shader registration
virtual void onRegisterShaders(gfx::ShaderRegistry&) {};
virtual void onPreCompileShader(shaders::BuiltIn, gfx::Backend::Type, const std::string&) {}
virtual void onPostCompileShader(shaders::BuiltIn, gfx::Backend::Type, const std::string&) {}
virtual void onShaderCompileFailed(shaders::BuiltIn, gfx::Backend::Type, const std::string&) {}
// Glyph loading
virtual void onGlyphsLoaded(const FontStack&, const GlyphRange&) {}
virtual void onGlyphsError(const FontStack&, const GlyphRange&, std::exception_ptr) {}
virtual void onGlyphsRequested(const FontStack&, const GlyphRange&) {}
// Tile loading
virtual void onTileAction(TileOperation, const OverscaledTileID&, const std::string&) {}
/// Render layer or drawable failed
virtual void onRenderError(std::exception_ptr) {}
};
} // namespace mln