blob: f1a0a1c922ed6ac97ddab590d6f75ee57f3a8d6e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
#pragma once
#include <mbgl/util/noncopyable.hpp>
#include <mbgl/storage/resource.hpp>
namespace mbgl {
class FileSource;
class AsyncRequest;
class Response;
class Tileset;
namespace style {
class UpdateParameters;
}
template <typename T>
class TileSource : private util::noncopyable {
public:
// TileSources can have two states: optional or required.
// - optional means that only low-cost actions should be taken to obtain the data
// (e.g. load from cache, but accept stale data)
// - required means that every effort should be taken to obtain the data (e.g. load
// from internet and keep the data fresh if it expires)
enum class Necessity : bool {
Optional = false,
Required = true,
};
TileSource(T&,
const OverscaledTileID&,
const style::UpdateParameters&,
const Tileset&);
void setNecessity(Necessity newNecessity) {
if (newNecessity != necessity) {
necessity = newNecessity;
if (necessity == Necessity::Required) {
makeRequired();
} else {
makeOptional();
}
}
}
private:
// called when the tile is one of the ideal tiles that we want to show definitely. the tile source
// should try to make every effort (e.g. fetch from internet, or revalidate existing resources).
void makeRequired();
// called when the zoom level no longer corresponds to the displayed one, but
// we're still interested in retaining the tile, e.g. for backfill.
// subclassed TileSources should cancel actions they are taking to provide
// an up-to-date version or load new data
void makeOptional();
void loadOptional();
void loadedData(const Response&);
void loadRequired();
T& tileData;
Necessity necessity;
Resource resource;
FileSource& fileSource;
std::unique_ptr<AsyncRequest> request;
};
} // namespace mbgl
|