114 lines
4.1 KiB
C++
114 lines
4.1 KiB
C++
#pragma once
|
|
|
|
#include <mbgl/renderer/query.hpp>
|
|
#include <mbgl/annotation/annotation.hpp>
|
|
#include <mbgl/util/geo.hpp>
|
|
#include <mbgl/util/geojson.hpp>
|
|
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace mbgl {
|
|
|
|
class RendererObserver;
|
|
class RenderedQueryOptions;
|
|
class SourceQueryOptions;
|
|
class UpdateParameters;
|
|
|
|
namespace gfx {
|
|
class RendererBackend;
|
|
} // namespace gfx
|
|
|
|
struct PlacedSymbolData {
|
|
/// Contents of the label
|
|
std::u16string key;
|
|
/// If symbol contains text, text collision box in viewport coordinates
|
|
optional<mapbox::geometry::box<float>> textCollisionBox;
|
|
/// If symbol contains icon, icon collision box in viewport coordinates
|
|
optional<mapbox::geometry::box<float>> iconCollisionBox;
|
|
/// Symbol text was placed
|
|
bool textPlaced;
|
|
/// Symbol icon was placed
|
|
bool iconPlaced;
|
|
/// Symbol text or icon collision box intersects tile borders
|
|
bool intersectsTileBorder;
|
|
/// Viewport padding ({viewportPadding, viewportPadding} is a coordinate of the tile's top-left corner)
|
|
float viewportPadding;
|
|
/// Layer id (leader of the symbol layout group)
|
|
std::string layer;
|
|
};
|
|
|
|
class Renderer {
|
|
public:
|
|
Renderer(gfx::RendererBackend&, float pixelRatio_, const optional<std::string>& localFontFamily = {});
|
|
~Renderer();
|
|
|
|
void markContextLost();
|
|
|
|
void setObserver(RendererObserver*);
|
|
|
|
void render(const std::shared_ptr<UpdateParameters>&);
|
|
|
|
/// Feature queries
|
|
std::vector<Feature> queryRenderedFeatures(const ScreenLineString&, const RenderedQueryOptions& options = {}) const;
|
|
std::vector<Feature> queryRenderedFeatures(const ScreenCoordinate& point, const RenderedQueryOptions& options = {}) const;
|
|
std::vector<Feature> queryRenderedFeatures(const ScreenBox& box, const RenderedQueryOptions& options = {}) const;
|
|
std::vector<Feature> querySourceFeatures(const std::string& sourceID, const SourceQueryOptions& options = {}) const;
|
|
AnnotationIDs queryPointAnnotations(const ScreenBox& box) const;
|
|
AnnotationIDs queryShapeAnnotations(const ScreenBox& box) const;
|
|
AnnotationIDs getAnnotationIDs(const std::vector<Feature>&) const;
|
|
|
|
/// Feature extension query
|
|
FeatureExtensionValue queryFeatureExtensions(const std::string& sourceID,
|
|
const Feature& feature,
|
|
const std::string& extension,
|
|
const std::string& extensionField,
|
|
const optional<std::map<std::string, Value>>& args = {}) const;
|
|
|
|
void setFeatureState(const std::string& sourceID, const optional<std::string>& sourceLayerID,
|
|
const std::string& featureID, const FeatureState& state);
|
|
|
|
void getFeatureState(FeatureState& state,
|
|
const std::string& sourceID,
|
|
const optional<std::string>& sourceLayerID,
|
|
const std::string& featureID) const;
|
|
|
|
void removeFeatureState(const std::string& sourceID,
|
|
const optional<std::string>& sourceLayerID,
|
|
const optional<std::string>& featureID,
|
|
const optional<std::string>& stateKey);
|
|
|
|
// Debug
|
|
void dumpDebugLogs();
|
|
|
|
/**
|
|
* @brief In Tile map mode, enables or disables collecting of the placed symbols data,
|
|
* which can be obtained with `getPlacedSymbolsData()`.
|
|
*
|
|
* The placed symbols data collecting is disabled by default.
|
|
*/
|
|
void collectPlacedSymbolData(bool enable);
|
|
|
|
/**
|
|
* @brief If collecting of the placed symbols data is enabled, returns the reference
|
|
* to the `PlacedSymbolData` vector holding the collected data.
|
|
*
|
|
* Note: the returned vector gets re-populated at every `render()` call.
|
|
*
|
|
* @return collected placed symbols data
|
|
*/
|
|
const std::vector<PlacedSymbolData>& getPlacedSymbolsData() const;
|
|
|
|
// Memory
|
|
void reduceMemoryUse();
|
|
void clearData();
|
|
|
|
private:
|
|
class Impl;
|
|
std::unique_ptr<Impl> impl;
|
|
};
|
|
|
|
} // namespace mbgl
|