VegetationFieldGpu.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include <array>
#include <cstdint>
#include <glm/vec3.hpp>
#include <span>
#include "common/Result.h"
 
namespace eve::graphics {
 
class IResourceFactory;
class Texture;
class VegetationField;
struct PbrSurface;
struct VegetationAtlas;
struct VegetationChannelAtlas;
 
struct VegetationGpuAtlas {
    Texture*  texture       = nullptr;
    uint64_t  fieldRevision = 0;
    uint32_t  width = 0, height = 0, layers = 0;
    glm::vec3 center{0.f}, extent{1.f};
};
using VegetationExtrasGpuAtlas = VegetationGpuAtlas;
using VegetationColorsGpuAtlas = VegetationGpuAtlas;
using VegetationMotionGpuAtlas = VegetationGpuAtlas;
using VegetationVertexGpuAtlas = VegetationGpuAtlas;
 
struct VegetationGpuFieldSet {
    VegetationExtrasGpuAtlas extras;
    VegetationColorsGpuAtlas colors;
    VegetationMotionGpuAtlas motion;
    VegetationVertexGpuAtlas vertex;
};
 
struct VegetationGpuRuntime {
    Texture*             motionNoise = nullptr;
    Texture*             fadeNoise   = nullptr;
    std::array<float, 2> motionDirection{1, 0};
    std::array<float, 3> worldOrigin{0, 0, 0};
    double               time          = 0;
    float                globalBending = 1, globalBranch = 1, globalFlutter = 1, noiseTiling = 1;
    float                motionFadeDistance = 100;
    float                cameraFadeMin = 0, cameraFadeMax = 100, fadeNoiseTiling = 1;
    bool                 enableMotion = true;
};
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationExtrasGpuAtlas> uploadVegetationExtrasAtlas(
    IResourceFactory& factory, const VegetationField& field, glm::vec3 center, glm::vec3 extent, uint32_t width,
    uint32_t height, bool snapToTexel = true);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationColorsGpuAtlas> uploadVegetationColorsAtlas(
    IResourceFactory& factory, const VegetationField& field, glm::vec3 center, glm::vec3 extent, uint32_t width,
    uint32_t height, bool snapToTexel = true);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationMotionGpuAtlas> uploadVegetationMotionAtlas(
    IResourceFactory& factory, const VegetationField& field, glm::vec3 center, glm::vec3 extent, uint32_t width,
    uint32_t height, bool snapToTexel = true);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationVertexGpuAtlas> uploadVegetationVertexAtlas(
    IResourceFactory& factory, const VegetationField& field, glm::vec3 center, glm::vec3 extent, uint32_t width,
    uint32_t height, bool snapToTexel = true);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationGpuFieldSet> uploadVegetationGpuFieldSet(
    IResourceFactory& factory, const VegetationField& field, glm::vec3 center, glm::vec3 extent, uint32_t width,
    uint32_t height, bool snapToTexel = true);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationGpuFieldSet> uploadVegetationGpuFieldSet(
    IResourceFactory& factory, std::span<const VegetationAtlas, 9> layers, std::uint64_t sourceRevision);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<VegetationGpuFieldSet> uploadVegetationGpuFieldSet(
    IResourceFactory& factory, std::span<const VegetationChannelAtlas, 9> colors,
    std::span<const VegetationChannelAtlas, 9> extras, std::span<const VegetationChannelAtlas, 9> motion,
    std::span<const VegetationChannelAtlas, 9> vertex, std::uint64_t sourceRevision);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<void> releaseVegetationGpuFieldSet(IResourceFactory&      factory,
                                                                              VegetationGpuFieldSet& set);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<void> bindVegetationGpuFields(
    PbrSurface& surface, const VegetationField& field, const VegetationExtrasGpuAtlas& extras,
    const VegetationColorsGpuAtlas& colors, const VegetationMotionGpuAtlas& motion,
    const VegetationVertexGpuAtlas& vertex, const VegetationGpuRuntime& runtime);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<void> bindVegetationGpuFields(PbrSurface&                  surface,
                                                                         const VegetationField&       field,
                                                                         const VegetationGpuFieldSet& set,
                                                                         const VegetationGpuRuntime&  runtime);
 
[[nodiscard]] EVENGINE_API_BACKENDS Result<void> bindVegetationGpuFields(PbrSurface&                  surface,
                                                                         const VegetationGpuFieldSet& set,
                                                                         std::uint64_t                expectedRevision,
                                                                         const VegetationGpuRuntime&  runtime);
 
}  // namespace eve::graphics