TerrainPipeline.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "procgen/heightmap/Heightmap.h"
 
#include <cstdint>
#include <cstddef>
#include <string>
#include <vector>
 
namespace eve::procgen {
 
struct ThermalErosionSettings { int iterations = 20; float talus = 0.02f; float strength = 0.35f; };
struct HydraulicErosionSettings {
    int iterations = 60; float rainfall = 0.012f; float evaporation = 0.08f;
    float capacity = 2.f; float erosion = 0.18f; float deposition = 0.12f;
};
struct FluvialErosionSettings {
    int iterations = 8;
    float riverThreshold = 0.015f;
    float incision = 0.012f;
    float maxDepth = 0.28f;
    float bankWidth = 3.f;
    float maxBreachDepth = 0.04f;
    float coordinateScale = 1.f;
};
 
enum class Biome : uint8_t {
    Ocean, Beach, Desert, Grassland, Forest, Rainforest, Tundra, Taiga, Alpine,
    River, Lake, Wetland
};
 
struct HydrologyMap {
    int width = 0, height = 0;
    std::vector<int8_t> flowDirection; 
    std::vector<float> flowVectorX, flowVectorY; 
    std::vector<float> flowAccumulation;
    std::vector<float> lakeDepth; 
    std::vector<uint8_t> rivers;
    std::vector<uint8_t> streamOrder; 
};
 
struct ClimateMap {
    int width = 0, height = 0;
    std::vector<float> temperature, moisture;
    std::vector<Biome> biomes;
};
 
struct EVENGINE_API_DOMAINS TerrainErosionMap {
    int width = 0, height = 0;
    std::vector<float> wear;       
    std::vector<float> deposition; 
    std::vector<float> heightDelta; 
    int getWidth() const { return width; }
    int getHeight() const { return height; }
    float getWear(int x, int y) const;
    float getDeposition(int x, int y) const;
    float getHeightDelta(int x, int y) const;
};
 
class EVENGINE_API_DOMAINS TerrainLayers {
public:
    TerrainLayers() = default;
    TerrainLayers(HydrologyMap hydrology, ClimateMap climate);
 
    int getWidth() const;
    int getHeight() const;
    float getFlowAccumulation(int x, int y) const;
    int getFlowDirection(int x, int y) const;
    float getFlowVectorX(int x, int y) const;
    float getFlowVectorY(int x, int y) const;
    bool isRiver(int x, int y) const;
    int getStreamOrder(int x, int y) const;
    float getLakeDepth(int x, int y) const;
    bool isLake(int x, int y, float minimumDepth = 0.001f) const;
    float getTemperature(int x, int y) const;
    float getMoisture(int x, int y) const;
    int getBiome(int x, int y) const;
    std::string getBiomeName(int x, int y) const;
 
    const HydrologyMap &hydrology() const { return hydrology_; }
    const ClimateMap &climate() const { return climate_; }
 
private:
    size_t index(int x, int y) const;
    HydrologyMap hydrology_;
    ClimateMap climate_;
};
 
class EVENGINE_API_DOMAINS TerrainPipeline {
public:
    static void erodeThermal(Heightmap &heightmap, const ThermalErosionSettings &settings = {});
    static void erodeHydraulic(Heightmap &heightmap, const HydraulicErosionSettings &settings = {});
    static void erodeFluvial(Heightmap &heightmap, const FluvialErosionSettings &settings = {});
    static TerrainErosionMap erodeFluvialDetailed(
        Heightmap &heightmap, const FluvialErosionSettings &settings = {});
    static HydrologyMap buildHydrology(const Heightmap &heightmap, float riverThreshold = 0.025f,
                                       float seaLevel = 0.25f, float coordinateScale = 1.f,
                                       bool classifyLakes = true);
    static ClimateMap buildClimate(const Heightmap &heightmap, const HydrologyMap &hydrology,
                                   float seaLevel = 0.25f, float latitude = 0.35f,
                                   float coordinateScale = 1.f);
};
 
}  // namespace eve::procgen