TerrainMask.h

浏览该文件的文档.

#pragma once
 
#include "common/Result.h"
 
namespace eve::procgen {
class Heightmap;
struct TerrainStampSettings;
enum class TerrainMaskBlend;
 
struct TerrainConcavitySettings {
    float featureSize = 10, concavity = 1;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateTerrainConcavityMask(Heightmap& target, const Heightmap& input,
                                                                            const Heightmap&                heights,
                                                                            const Heightmap&                curve,
                                                                            const TerrainConcavitySettings& settings,
                                                                            TerrainMaskBlend                mode);
 
struct TerrainCurvatureSettings {
    float radius = 0.001F, worldUnits = -400, intensity = 0.7F;
    int   steps = 32, directions = 16;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateTerrainCurvatureMask(Heightmap& target, const Heightmap& input,
                                                                            const Heightmap&                heights,
                                                                            const Heightmap&                curve,
                                                                            const TerrainCurvatureSettings& settings,
                                                                            TerrainMaskBlend                mode);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> growShrinkTerrainMask(Heightmap& target, const Heightmap& source,
                                                                     const Heightmap& curve, float distance);
 
enum class TerrainStrengthMode { Replace, Maximum, Minimum, Add, Subtract };
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> applyTerrainStrength(Heightmap& target, const Heightmap& source,
                                                                    const Heightmap& curve, TerrainStrengthMode mode,
                                                                    float strength, bool invert);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> smoothTerrainMask(Heightmap& target, const Heightmap& input,
                                                                 float verticality, float blurRadius);
 
struct TerrainBrushBlendSettings {
    float heightXX = 1, heightXZ = 0, heightZX = 0, heightZZ = 1;
    float heightOffsetX = 0, heightOffsetZ = 0;
    float brushXX = 1, brushXZ = 0, brushZX = 0, brushZZ = 1;
    float brushOffsetX = 0, brushOffsetZ = 0;
    float strength = 1;
};
 
struct TerrainSampleGrid {
    double originX = 0, originZ = 0, spacingX = 1, spacingZ = 1;
    int    width = 1, height = 1;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> configureTerrainBrushWorld(TerrainBrushBlendSettings&  target,
                                                                          const TerrainStampSettings& world,
                                                                          int contextWidth, int contextHeight,
                                                                          const TerrainSampleGrid& heights);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> blendTerrainBrush(Heightmap& target, const Heightmap& oldHeights,
                                                                 const Heightmap& newHeights, const Heightmap& brush,
                                                                 const TerrainBrushBlendSettings& settings);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateTerrainErosionMask(
    Heightmap& target, const Heightmap& oldHeights, const Heightmap& erosion, const Heightmap& brush,
    const TerrainBrushBlendSettings& spatial, const Heightmap& curve, TerrainStrengthMode mode, float strength,
    bool userInvert);
 
enum class TerrainDistanceAxis { Circle, X, Z, RoundedSquare };
 
struct TerrainDistanceMaskSettings {
    float               offsetX = 0, offsetZ = 0;
    float               scaleX = 1, scaleZ = 1;
    float               rotation = 0, roundness = 0.5F;
    bool                tiling = false;
    TerrainDistanceAxis axis   = TerrainDistanceAxis::Circle;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> transformTerrainMask(Heightmap& target, const Heightmap& source,
                                                                    const Heightmap& curve);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateTerrainRangeMask(Heightmap& target, const Heightmap& source,
                                                                        float minimum, float maximum,
                                                                        const Heightmap& filterCurve,
                                                                        const Heightmap& strengthCurve);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> deriveTerrainSlope(Heightmap& target, const Heightmap& heights,
                                                                  float spacingX, float spacingZ,
                                                                  float heightScale = 1);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> generateTerrainDistanceMask(Heightmap&                         target,
                                                                           const TerrainDistanceMaskSettings& settings,
                                                                           const Heightmap& filterCurve,
                                                                           const Heightmap& strengthCurve);
}  // namespace eve::procgen