TerrainImageAdapter.h

浏览该文件的文档.

#pragma once
#include <array>
#include <memory>
#include <vector>
#include "common/Result.h"
namespace ssq {
class Table;
}
namespace eve::image {
class ImageData;
}
namespace eve::procgen {
class Heightmap;
class TerrainSplatmap;
struct TerrainImageMaskSettings;
enum class TerrainMaskBlend;
struct GtsSnowSurfaceSettings {
    bool enabled = false;
    float power = 1, minimumHeight = 100, blendRange = 20, slopeBlend = 20, age = 0, scale = 1;
    float colorR = 1, colorG = 1, colorB = 1;
    float normalStrength = 3;
    std::array<float, 4> maskRemapMin{0, 0, 0, 0}, maskRemapMax{1, 1, 3, 1};
    float heightContrast = 1, heightBrightness = 1, heightIncrease = 0;
    float displacementContrast = 1, displacementBrightness = 0.4F, displacementIncrease = 0.1F;
    float tessellationAmount = 25;
    void setMaskRemapMin(float r, float g, float b, float a) { maskRemapMin = {r, g, b, a}; }
    void setMaskRemapMax(float r, float g, float b, float a) { maskRemapMax = {r, g, b, a}; }
};
struct GtsRainSurfaceSettings {
    bool enabled = false;
    float power = 1, minimumHeight = 0, maximumHeight = 3000, darkness = 0.2F;
    float speed = 1, smoothness = 0.8F, scale = 2;
};
struct GtsColorMapSettings {
    float alphaIntensity = 1, colorIntensity = 1, nearIntensity = 1, farIntensity = 1;
};
struct GtsMacroVariationSettings {
    float sizeA = 10, sizeB = 10, sizeC = 10, intensity = 0.5F;
    bool objectSpace = false;
};
struct GtsGeologicalSettings {
    bool enabled = false, objectSpace = false;
    float nearStrength = 0.2F, nearNormalStrength = 0.5F, nearScale = 50, nearOffset = 0;
    float farStrength = 0.2F, farNormalStrength = 0.5F, farScale = 200, farOffset = 0;
};
struct GtsDetailNormalSettings {
    bool enabled = true, objectSpace = false;
    float nearTiling = 100, nearStrength = 0.6F, farTiling = 1000, farStrength = 0.8F;
};
class EVENGINE_API_DOMAINS TerrainSplatPalette {
public:
    [[nodiscard]] Result<int> addColor(float red, float green, float blue, float alpha = 1);
    [[nodiscard]] int getColorCount() const noexcept { return static_cast<int>(colors_.size()); }
private:
    friend EVENGINE_API_DOMAINS Result<int> bakeTerrainSplatAlbedo(image::ImageData&, const TerrainSplatmap&,
                                                                   const TerrainSplatPalette&);
    std::vector<std::array<float, 4>> colors_;
};
struct GtsPackedLayerSettings {
    bool triPlanar = false, stochastic = false;
    float tileSizeX = 8, tileSizeZ = 8, offsetX = 0, offsetZ = 0;
    float triPlanarSizeX = 1, triPlanarSizeZ = 1;
    float tintR = 1, tintG = 1, tintB = 1, normalStrength = 1;
    float aoMin = 0, smoothnessMin = 0, aoMax = 1, smoothnessMax = 1;
    float geoAmount = 1, detailAmount = 1;
    float heightContrast = 1, heightBrightness = 1, heightIncrease = 0;
    float displacementContrast = 0.1F, displacementBrightness = 0.1F, displacementIncrease = 0;
    float tessellationAmount = 25;
};
class EVENGINE_API_DOMAINS GtsPackedLayerSet {
public:
    GtsPackedLayerSet();
    ~GtsPackedLayerSet();
    GtsPackedLayerSet(GtsPackedLayerSet&&) noexcept;
    GtsPackedLayerSet& operator=(GtsPackedLayerSet&&) noexcept;
    GtsPackedLayerSet(const GtsPackedLayerSet&) = delete;
    GtsPackedLayerSet& operator=(const GtsPackedLayerSet&) = delete;
    [[nodiscard]] Result<int> addLayer(const image::ImageData& albedoHeight,
                                       const image::ImageData& normalMask,
                                       const GtsPackedLayerSettings& settings);
    int getLayerCount() const noexcept;
private:
    struct Impl;
    std::unique_ptr<Impl> impl_;
    friend EVENGINE_API_DOMAINS Result<int> bakeGtsPackedLayers(image::ImageData&, image::ImageData&, Heightmap&,
                                                                Heightmap&, const Heightmap&, const TerrainSplatmap&,
                                                                const GtsPackedLayerSet&, double, double, double,
                                                                double, double);
    friend EVENGINE_API_DOMAINS Result<int> bakeGtsPackedLayerDisplacement(Heightmap&, Heightmap&, const Heightmap&,
                                                                           const TerrainSplatmap&,
                                                                           const GtsPackedLayerSet&, double, double,
                                                                           double, double, double, double, double,
                                                                           double, double);
};
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsPackedLayers(
    image::ImageData& albedo, image::ImageData& packedNormal, Heightmap& geoStrength, Heightmap& detailStrength,
    const Heightmap& heights, const TerrainSplatmap& splatmap, const GtsPackedLayerSet& layers, double originX = 0,
    double originY = 0, double originZ = 0, double spacingX = 1, double spacingZ = 1);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsPackedLayerDisplacement(
    Heightmap& displacement, Heightmap& tessellation, const Heightmap& heights, const TerrainSplatmap& splatmap,
    const GtsPackedLayerSet& layers, double cameraX, double cameraY, double cameraZ, double tessellationMultiplier = 1,
    double originX = 0, double originY = 0, double originZ = 0, double spacingX = 1, double spacingZ = 1);
[[nodiscard]] Result<int> generateTerrainImageMaskFromImage(Heightmap& target, const Heightmap& input,
                                                            const image::ImageData& image, const Heightmap& curve,
                                                            const TerrainImageMaskSettings& settings,
                                                            TerrainMaskBlend                mode);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeTerrainSplatAlbedo(image::ImageData&          output,
                                                                      const TerrainSplatmap&     splatmap,
                                                                      const TerrainSplatPalette& palette);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateGtsGlobalBlendDistance(
    Heightmap& output, const Heightmap& heights, double cameraX, double cameraY, double cameraZ, double blendDistance,
    double blendRange, double originX = 0, double originY = 0, double originZ = 0, double spacingX = 1,
    double spacingZ = 1);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsColorMapAlbedo(image::ImageData&          output,
                                                                     const image::ImageData&    colorMap,
                                                                     const Heightmap&           globalBlendDistance,
                                                                     const GtsColorMapSettings& settings);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsMacroVariationAlbedo(image::ImageData&       output,
                                                                           const image::ImageData& variationMap,
                                                                           const GtsMacroVariationSettings& settings,
                                                                           double originX = 0, double originZ = 0,
                                                                           double spacingX = 1, double spacingZ = 1);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsGeologicalSurface(
    image::ImageData& albedo, image::ImageData& packedNormal, const Heightmap& heights, const Heightmap& layerStrength,
    const Heightmap& globalBlendDistance, const image::ImageData& geoAlbedo, const image::ImageData& geoNormal,
    const GtsGeologicalSettings& settings, double originY = 0);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsDetailSurface(
    image::ImageData& albedo, image::ImageData& packedNormal, Heightmap& detailGreyscale,
    const Heightmap& layerStrength, const Heightmap& globalBlendDistance, const image::ImageData& detailNormal,
    const GtsDetailNormalSettings& settings, double originX = 0, double originZ = 0, double spacingX = 1,
    double spacingZ = 1);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsWeatherAlbedo(
    image::ImageData& output, const Heightmap& heights, const image::ImageData& snowAlbedo,
    const image::ImageData& snowMask, const GtsSnowSurfaceSettings& snow, const GtsRainSurfaceSettings& rain,
    double originX = 0, double originZ = 0, double spacingX = 1, double spacingZ = 1,
    const Heightmap* detailGreyscale = nullptr);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> bakeGtsWeatherPbr(
    image::ImageData& normalOutput, image::ImageData& maskOutput, Heightmap& displacement, Heightmap& tessellation,
    const Heightmap& heights, const image::ImageData& snowNormal, const image::ImageData& snowMask,
    const image::ImageData& rainData, const GtsSnowSurfaceSettings& snow, const GtsRainSurfaceSettings& rain,
    double timeSeconds, double originX = 0, double originZ = 0, double spacingX = 1, double spacingZ = 1);
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> combinePcgMaskMapChannels(
    image::ImageData& output, const image::ImageData& red, const image::ImageData& green, const image::ImageData& blue,
    const image::ImageData& alpha, std::uint32_t activeChannels = 15);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> placePcgMaskMapTileInto(image::ImageData&       output,
                                                                       const image::ImageData& tile, int destinationX,
                                                                       int destinationY, int destinationWidth,
                                                                       int destinationHeight);
 
EVENGINE_API_DOMAINS void exposeTerrainImageAdapter(ssq::Table& table);
}  // namespace eve::procgen