FogDensityField.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include "common/Result.h"
#include "graphics/fog/FogTypes.h"
 
#include <cstddef>
#include <cstdint>
#include <span>
#include <vector>
 
#include <glm/vec3.hpp>
 
namespace eve::graphics::fog {
 
class EVENGINE_API_WORLD FogDensityField {
public:
    [[nodiscard]] Result<void> resize(int width, int height, int depth, const FogWorldBounds& bounds);
 
    [[nodiscard]] int width() const noexcept { return width_; }
    [[nodiscard]] int height() const noexcept { return height_; }
    [[nodiscard]] int depth() const noexcept { return depth_; }
    [[nodiscard]] const FogWorldBounds& bounds() const noexcept { return bounds_; }
    [[nodiscard]] glm::vec3 cellSize() const noexcept { return cellSize_; }
    [[nodiscard]] std::uint64_t revision() const noexcept { return revision_; }
 
    void clear();
 
    void setDensity(int x, int y, int z, float density);
    [[nodiscard]] float densityAt(int x, int y, int z) const noexcept;
 
    void setCurlVelocity(int x, int y, int z, const glm::vec3& velocity);
    [[nodiscard]] glm::vec3 curlVelocityAt(int x, int y, int z) const noexcept;
 
    void setLightAssist(int x, int y, int z, const glm::vec3& assist);
    [[nodiscard]] glm::vec3 lightAssistAt(int x, int y, int z) const noexcept;
 
    [[nodiscard]] float sampleDensity(const glm::vec3& world) const noexcept;
    [[nodiscard]] glm::vec3 sampleCurlVelocity(const glm::vec3& world) const noexcept;
    [[nodiscard]] glm::vec3 sampleLightAssist(const glm::vec3& world) const noexcept;
 
    [[nodiscard]] Result<void> seedHeightBand(float baseDensity, float baseHeight, float falloff,
                                              float curlScale, std::uint32_t seed);
 
    [[nodiscard]] bool isOccupied(int x, int y, int z, float threshold = 1e-4f) const noexcept;
 
    [[nodiscard]] std::span<float> densitySpan() noexcept;
    [[nodiscard]] std::span<const float> densitySpan() const noexcept;
 
private:
    [[nodiscard]] std::size_t index(int x, int y, int z) const noexcept;
    [[nodiscard]] glm::vec3 cellCenter(int x, int y, int z) const noexcept;
    void sampleLattice(const glm::vec3& world, int& x0, int& y0, int& z0, int& x1, int& y1, int& z1,
                       float& fx, float& fy, float& fz) const noexcept;
 
    int width_ = 0;
    int height_ = 0;
    int depth_ = 0;
    FogWorldBounds bounds_{};
    glm::vec3 cellSize_{1.f};
    std::uint64_t revision_ = 1;
    std::vector<float> density_;
    std::vector<glm::vec3> curl_;
    std::vector<glm::vec3> lightAssist_;
};
 
}  // namespace eve::graphics::fog