CloudField.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include <cstdint>
 
namespace eve::procgen {
 
class EVENGINE_API_DOMAINS CloudField {
public:
    struct Params {
        uint32_t seed        = 1337;
        float    worldScale  = 96.f;   // world units per tile (larger = larger clouds)
        float    coverage    = 0.55f;  // 0..1 fraction of sky covered (threshold)
        float    softness    = 0.12f;  // 0..1 edge softness of cloud blobs
        float    detail      = 0.5f;   // 0..1 high-frequency wisp detail amount
        float    windSpeed   = 4.f;    // world units / second drift speed
        float    windAngle   = 0.f;    // drift direction (radians, +z axis = 0)
        int      octaves     = 4;
        float    lacunarity  = 2.f;
        float    gain        = 0.5f;
        float    warp        = 2.2f;   // domain-warp amplitude (organic puffs)
        bool     seamless    = true;
    };
 
    CloudField() = default;
    explicit CloudField(const Params &params) { setParams(params); }
 
    const Params &params() const { return params_; }
    void          setParams(const Params &params);
 
    void setSeed(uint32_t seed);
    void setWorldScale(float worldScale);
    void setCoverage(float coverage);
    void setSoftness(float softness);
    void setDetail(float detail);
    void setWind(float speed, float angleRad);
    void setOctaves(int octaves);
    void setWarp(float warp);
    void setSeamless(bool seamless);
 
    float coverageAt(float x, float z, float time) const;
 
    void sample(float *out, int width, int height, float time, float x0, float z0,
                float extent) const;
 
    void windVelocity(float &vx, float &vz) const;
 
    static constexpr int kLattice = 64;
 
private:
    Params params_;
};
 
}  // namespace eve::procgen