RoadBake.h

浏览该文件的文档.

#pragma once
 
#include "procgen/MeshBuild.h"
#include "procgen/PointSet.h"
#include "procgen/road/RoadNetwork.h"
#include "procgen/road/RoadTypes.h"
 
#include <cstddef>
#include <vector>
 
namespace eve::procgen {
class Heightmap;
}
 
namespace eve::procgen::road {
 
struct RoadTerrainConformOptions {
    float originX           = 0.f;
    float originZ           = 0.f;
    float cellSize          = 1.f;
    float heightScale       = 1.f;
    float blendDistance     = 2.f;
    float maxVerticalDelta  = 2.f;
    std::size_t maximumWork = 16u * 1024u * 1024u;
};
 
struct RoadTerrainConformReceipt {
    int                        width  = 0;
    int                        height = 0;
    int                        skippedBridgeSamples = 0;  
    int                        skippedTunnelSamples = 0;  
    std::vector<std::size_t>   sampleIndices;
    std::vector<float>         before;
    std::vector<float>         after;
};
 
struct RoadBakeOptions {
    int   pathSegmentsPerEdge = 48;
    int   turnSamples         = 12;
    bool  includePiers        = true;
    bool  includeMarkings     = true;
    bool  includeNavigation   = true;
    bool  includeJunctions    = true;
    bool  includePlacements   = true;
    float navRibbonHalfWidth  = 0.22f;
    float arrowSpacing        = 5.f;
    float junctionChordError  = 0.10f;  
    float sideObjectSpacing   = 8.f;
    float sideObjectOffset    = 0.5f;
    float sideObjectClearance = 1.5f;  
    int   maximumPlacements   = 65536;
    std::size_t maximumMeshElements = 8u * 1024u * 1024u;  
};
 
struct RoadBakeResult {
    MeshBuild   mesh;
    RoadOverlay overlay;
    PointSet    placements;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<RoadBakeResult> bakeRoadNetwork(const RoadNetwork&     network,
                                                                          const RoadBakeOptions& options = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> conformHeightmapToRoad(Heightmap& terrain, const MeshBuild& roadMesh,
                                                                      const RoadTerrainConformOptions& options = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<RoadTerrainConformReceipt> conformHeightmapToRoadWithReceipt(
    Heightmap& terrain, const MeshBuild& roadMesh, const RoadTerrainConformOptions& options = {});
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> restoreHeightmapFromRoad(Heightmap&                       terrain,
                                                                        const RoadTerrainConformReceipt& receipt);
 
}  // namespace eve::procgen::road