ProceduralDecal.h

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
#include "common/Result.h"
 
#include <array>
#include <cstdint>
#include <string_view>
#include <vector>
 
namespace eve::decal {
 
enum class DecalPattern : std::uint8_t {
    Spots,
    Cracks,
    Streaks,
    Puddle,
    Grunge,
};
 
struct ProceduralDecalLayer {
    bool                 enabled  = true;
    DecalPattern         pattern  = DecalPattern::Grunge;
    std::uint32_t        seed     = 1;
    int                  sourcePatternId = -1;
    bool                 invertMask = false;
    float                amount   = 0.65f;
    float                scale    = 5.f;
    float                rotation = 0.f;
    float                blur     = 0.08f;
    float                contrast = 1.4f;
    std::array<float, 3> color{0.35f, 0.12f, 0.06f};
    float                colorVariation     = 0.15f;
    float                hueVariation       = 0.f;
    float                roughness          = 0.7f;
    float                roughnessVariation = 0.1f;
    float                metallic           = 0.f;
    float                emissive           = 0.f;
    float                normalStrength     = 2.f;
    float                normalSoftness     = 0.08f;
    float                normalTrim         = 0.f;
    float                normalThickness    = 1.f;
    int                  normalStyle        = 0;
    float                height             = 0.5f;
};
 
struct ProceduralDecalRecipe {
    static constexpr std::uint32_t kSchemaVersion = 2;
    std::uint32_t                  schemaVersion  = kSchemaVersion;
    int                            width          = 256;
    int                            height         = 256;
    std::uint32_t                  seed           = 1;
    ProceduralDecalLayer             layerA{};
    ProceduralDecalLayer             layerB{};
    float                          layerHeightBlend = 0.5f;
    float                          layerBalance     = 0.5f;
    int                            layerBlendMode   = 0;
    float                          opacity          = 1.f;
};
 
struct ProceduralDecalBake {
    int                       width  = 0;
    int                       height = 0;
    std::vector<std::uint8_t> albedo;
    std::vector<std::uint8_t> normal;
    std::vector<std::uint8_t> params;
};
 
[[nodiscard]] EVENGINE_API_WORLD Result<ProceduralDecalRecipe> proceduralDecalPreset(std::string_view name,
                                                                                     std::uint32_t seed = 1);
 
[[nodiscard]] EVENGINE_API_WORLD Result<ProceduralDecalRecipe> importProceduralDecalSbsprs(std::string_view xml);
 
[[nodiscard]] EVENGINE_API_WORLD Result<ProceduralDecalBake> bakeProceduralDecal(const ProceduralDecalRecipe& recipe);
 
}  // namespace eve::decal