TerrainVegetationRuntime.h

浏览该文件的文档.

#pragma once
 
#include "asset/procgen/EvpackInstanceSetLoader.h"
#include "asset/procgen/EvpackPointGraphLoader.h"
 
#include <array>
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::asset_procgen {
 
struct LoadedTerrainMaterial;
struct TerrainMaterialAtlases;
 
struct TerrainVegetationLimits {
    std::uint32_t maximumGeneratedInstances = 1'000'000;
    std::uint32_t maximumTotalInstances     = 2'000'000;
    std::uint32_t maximumGraphNodes         = 4096;
};
 
struct TerrainVegetationInstance {
    std::uint64_t        id = 0;
    std::string          prototype;
    std::string          layer;
    std::array<float, 3> position{};
    std::array<float, 4> rotation{0.f, 0.f, 0.f, 1.f};
    std::array<float, 3> scale{1.f, 1.f, 1.f};
    std::array<float, 3> normal{0.f, 1.f, 0.f};
    std::uint32_t        seed = 0;
};
 
struct TerrainVegetationBucket {
    std::string   prototype;
    std::uint32_t firstInstance = 0;
    std::uint32_t instanceCount = 0;
};
 
struct TerrainVegetationRealization {
    float                                  wavingGrassAmount = 0.f;
    float                                  wavingGrassSpeed = 0.f;
    float                                  wavingGrassStrength = 0.f;
    std::array<float, 4>                   wavingGrassTint{1.f, 1.f, 1.f, 1.f};
    std::vector<RuntimeInstancePrototype>  prototypes;
    std::vector<TerrainVegetationInstance> instances;
    std::vector<TerrainVegetationBucket>   buckets;
    std::uint32_t                          generatedCount      = 0;
    std::uint32_t                          explicitCount       = 0;
    std::uint32_t                          weightCulledCount   = 0;
    std::uint32_t                          graphNodesEvaluated = 0;
    double                                 graphMilliseconds   = 0.0;
};
 
struct TerrainVegetationWeightDomain {
    float minimumX = 0.f;
    float minimumZ = 0.f;
    float maximumX = 0.f;
    float maximumZ = 0.f;
    bool flipV = false;
};
 
[[nodiscard]] EVENGINE_API_ORCHESTRATION Result<TerrainVegetationRealization> realizeTerrainVegetation(
    LoadedPointGraph* graph, const LoadedInstanceSet* explicitInstances, const TerrainVegetationLimits& limits = {});
 
[[nodiscard]] EVENGINE_API_ORCHESTRATION Result<TerrainVegetationRealization> filterTerrainVegetationByLayerWeights(
    const TerrainVegetationRealization& realization, const LoadedTerrainMaterial& material,
    const TerrainMaterialAtlases& atlases, const TerrainVegetationWeightDomain& domain);
 
}  // namespace eve::asset_procgen