7ff036cd01
Since client code can readily access the individual sources, Map doesn’t need to expose a dedicated API for iterating over them.
67 lines
1.8 KiB
C++
67 lines
1.8 KiB
C++
#pragma once
|
|
|
|
#include <mbgl/util/noncopyable.hpp>
|
|
#include <mbgl/util/optional.hpp>
|
|
#include <mbgl/style/types.hpp>
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
namespace mbgl {
|
|
namespace style {
|
|
|
|
/**
|
|
* The runtime representation of a [source](https://www.mapbox.com/mapbox-gl-style-spec/#sources) from the Mapbox Style
|
|
* Specification.
|
|
*
|
|
* `Source` is an abstract base class; concrete derived classes are provided for each source type. `Source` contains
|
|
* functionality that is common to all layer types:
|
|
*
|
|
* * Runtime type information: type predicates and casting
|
|
* * Accessors for properties common to all source types: ID, etc.
|
|
* * Cloning and copying
|
|
*
|
|
* All other functionality lives in the derived classes. To instantiate a source, create an instance of the desired
|
|
* type, passing the ID:
|
|
*
|
|
* auto vectorSource = std::make_unique<VectorSource>("my-vector-source");
|
|
*/
|
|
class Source : public mbgl::util::noncopyable {
|
|
public:
|
|
virtual ~Source();
|
|
|
|
// Check whether this source is of the given subtype.
|
|
template <class T>
|
|
bool is() const;
|
|
|
|
// Dynamically cast this source to the given subtype.
|
|
template <class T>
|
|
T* as() {
|
|
return is<T>() ? reinterpret_cast<T*>(this) : nullptr;
|
|
}
|
|
|
|
template <class T>
|
|
const T* as() const {
|
|
return is<T>() ? reinterpret_cast<const T*>(this) : nullptr;
|
|
}
|
|
|
|
const std::string& getID() const;
|
|
|
|
// Create a new source with the specified `id`. All other properties
|
|
// are copied from this source.
|
|
std::unique_ptr<Source> copy(const std::string& id) const;
|
|
|
|
optional<std::string> getAttribution() const;
|
|
|
|
// Private implementation
|
|
class Impl;
|
|
const std::unique_ptr<Impl> baseImpl;
|
|
|
|
protected:
|
|
const SourceType type;
|
|
Source(SourceType, std::unique_ptr<Impl>);
|
|
};
|
|
|
|
} // namespace style
|
|
} // namespace mbgl
|