TerrainMultiTile.h

浏览该文件的文档.

#pragma once
 
#include <cstdint>
#include <string>
#include <memory>
#include <vector>
#include "common/Result.h"
 
namespace eve::procgen {
class Heightmap;
class TerrainDetailLayer;
struct TerrainStampSettings;
struct TerrainDetailSettings;
 
struct TerrainHeightStitchSettings {
    int extraSeamSize = 1;
    float maxDifference = 1;
};
 
struct TerrainHeightTile {
    std::string name;
    Heightmap*  heightmap = nullptr;
    double      originX = 0, originZ = 0, width = 1, depth = 1;
    bool        worldMap = false;
};
 
enum class TerrainOperationDomain { Heightmap, Texture, Tree, TerrainDetail, GameObject, BakedMask };
 
struct TerrainOperationTile {
    std::string name;
    double originX = 0, originZ = 0, width = 1, depth = 1;
    int resolutionX = 0, resolutionY = 0;
    bool worldMap = false;
};
 
struct TerrainDetailTile {
    std::string name;
    TerrainDetailLayer* layer = nullptr;
    double originX = 0, originZ = 0, width = 1, depth = 1;
    bool worldMap = false;
};
 
struct TerrainAffectedPixels {
    std::string terrainName;
    int localX = 0, localY = 0, operationX = 0, operationY = 0, width = 0, height = 0;
};
 
struct TerrainMultiTileReport {
    int affectedTiles = 0;
    int changedSamples = 0;
    int operationX = 0, operationY = 0, operationWidth = 0, operationHeight = 0;
    std::vector<TerrainAffectedPixels> mappings;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<TerrainMultiTileReport> mapTerrainOperationMultiTile(
    const std::vector<TerrainOperationTile>& tiles, const TerrainStampSettings& settings, TerrainOperationDomain domain,
    bool worldMapOperation = false, const std::vector<std::string>& validTerrainNames = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<TerrainMultiTileReport> applyTerrainDetailMultiTile(
    const std::vector<TerrainDetailTile>& tiles, const Heightmap& operationFitness,
    const TerrainDetailSettings& settings, const TerrainStampSettings& operationSettings, std::int32_t seed,
    bool worldMapOperation = false, const std::vector<std::string>& validTerrainNames = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<TerrainMultiTileReport> applyTerrainStampMultiTile(
    const std::vector<TerrainHeightTile>& tiles, const Heightmap& stamp, const TerrainStampSettings& settings,
    const Heightmap& localMask, const Heightmap& globalMask, bool worldMapOperation = false,
    const std::vector<std::string>& validTerrainNames = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> stitchTerrainHeightmaps(
    const TerrainHeightTile& terrainA, const TerrainHeightTile& terrainB,
    const TerrainHeightStitchSettings& settings = {});
 
class EVENGINE_API_DOMAINS TerrainMultiTileWorkspace {
public:
    TerrainMultiTileWorkspace();
    ~TerrainMultiTileWorkspace();
    TerrainMultiTileWorkspace(TerrainMultiTileWorkspace&&) noexcept;
    TerrainMultiTileWorkspace& operator=(TerrainMultiTileWorkspace&&) noexcept;
    TerrainMultiTileWorkspace(const TerrainMultiTileWorkspace&) = delete;
    TerrainMultiTileWorkspace& operator=(const TerrainMultiTileWorkspace&) = delete;
    [[nodiscard]] Result<int> addTile(const std::string& name, const Heightmap& heightmap, double originX,
                                      double originZ, double width, double depth, bool worldMap = false);
    [[nodiscard]] Result<int> stamp(const Heightmap& stamp, const TerrainStampSettings& settings,
                                    const Heightmap& localMask, const Heightmap& globalMask,
                                    bool worldMapOperation = false);
    [[nodiscard]] Result<int> stitch(const std::string& terrainA, const std::string& terrainB,
                                     const TerrainHeightStitchSettings& settings = {});
    [[nodiscard]] Result<int> copyTile(const std::string& name, Heightmap& output) const;
    [[nodiscard]] Result<int> undo();
    [[nodiscard]] Result<int> redo();
    int getTileCount() const noexcept;
    int getLastAffectedTiles() const noexcept;
    int getLastChangedSamples() const noexcept;
    int getLastMappingCount() const noexcept;
    int getOperationCount() const noexcept;
    int getAppliedCount() const noexcept;
private:
    struct Impl;
    std::unique_ptr<Impl> impl_;
};
 
class EVENGINE_API_DOMAINS TerrainMultiDetailWorkspace {
public:
    TerrainMultiDetailWorkspace();
    ~TerrainMultiDetailWorkspace();
    TerrainMultiDetailWorkspace(TerrainMultiDetailWorkspace&&) noexcept;
    TerrainMultiDetailWorkspace& operator=(TerrainMultiDetailWorkspace&&) noexcept;
    TerrainMultiDetailWorkspace(const TerrainMultiDetailWorkspace&) = delete;
    TerrainMultiDetailWorkspace& operator=(const TerrainMultiDetailWorkspace&) = delete;
    [[nodiscard]] Result<int> addTile(const std::string& name, const TerrainDetailLayer& layer, double originX,
                                      double originZ, double width, double depth, bool worldMap = false);
    [[nodiscard]] Result<int> apply(const Heightmap& operationFitness, const TerrainDetailSettings& settings,
                                    const TerrainStampSettings& operationSettings, std::int32_t seed,
                                    bool worldMapOperation = false);
    [[nodiscard]] Result<int> copyTile(const std::string& name, TerrainDetailLayer& output) const;
    [[nodiscard]] Result<int> undo();
    [[nodiscard]] Result<int> redo();
    int getTileCount() const noexcept;
    int getLastChangedSamples() const noexcept;
    int getLastAffectedTiles() const noexcept;
    int getOperationCount() const noexcept;
    int getAppliedCount() const noexcept;
 
private:
    struct Impl;
    std::unique_ptr<Impl> impl_;
};
}  // namespace eve::procgen