TerrainStreaming.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "procgen/heightmap/TerrainAsset.h"
 
#include <cstddef>
#include <cstdint>
#include <memory>
#include <string>
#include <unordered_map>
#include <utility>
#include <vector>
 
namespace eve::procgen {
 
struct TerrainStreamStats {
    int loaded = 0;
    int evicted = 0;
    int pending = 0;
    int failed = 0;
    int resident = 0;
};
 
struct TerrainSample {
    float height = 0.f, flowAccumulation = 0.f, lakeDepth = 0.f;
    float flowVectorX = 0.f, flowVectorY = 0.f;
    float temperature = 0.f, moisture = 0.f;
    int flowDirection = -1, streamOrder = 0;
    bool river = false, lake = false;
    Biome biome = Biome::Ocean;
};
 
struct TerrainStreamingWindow {
    int originX = 0, originY = 0;
    Heightmap heights;
    HydrologyMap hydrology;
    ClimateMap climate;
};
 
class EVENGINE_API_DOMAINS TerrainStreamingCache {
public:
    bool open(const uint8_t *data, size_t size, std::string *error = nullptr);
    [[nodiscard]] Result<void> openSource(std::shared_ptr<const ITerrainArchiveSource> source);
    void clear();
 
    TerrainStreamStats streamAround(int worldX, int worldY, int radiusChunks,
                                    int maxLoads = 0, std::string *error = nullptr);
 
    const TerrainChunkData *getChunk(int chunkX, int chunkY) const;
    bool sampleCell(int worldX, int worldY, TerrainSample &out) const;
    bool sampleHeight(float worldX, float worldY, float &out) const;
    bool getReceiver(int worldX, int worldY, int &receiverX, int &receiverY) const;
    bool traceFlow(int worldX, int worldY, int maxSteps,
                   std::vector<std::pair<int, int>> &out) const;
    bool buildWindow(int originX, int originY, int width, int height,
                     TerrainStreamingWindow &out) const;
 
    int getResidentCount() const { return int(resident_.size()); }
    const TerrainAsset &asset() const { return asset_; }
 
private:
    static uint64_t key(int chunkX, int chunkY);
    TerrainAsset asset_;
    std::unordered_map<uint64_t, TerrainChunkData> resident_;
};
 
}  // namespace eve::procgen