PcgMeshLod.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Result.h"
#include "procgen/GtsMeshSimplifier.h"
 
#include <vector>
#include <array>
#include <string>
 
namespace eve::procgen {
 
class PcgMeshCombinePlan;
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<int> combinePcgStaticMeshesInto(MeshBuild&                output,
                                                                          const PcgMeshCombinePlan& plan);
 
struct PcgMeshLodRendererState {
    int skinQuality = 0;                 // Auto, Bone1, Bone2, Bone4
    int shadowCastingMode = 1;           // Off, On, TwoSided, ShadowsOnly
    bool receiveShadows = true;
    int motionVectorMode = 1;            // Camera, Object, ForceNoMotion
    bool skinnedMotionVectors = true;
    int lightProbeUsage = 1;             // Off, BlendProbes, UseProxyVolume, CustomProvided
    int reflectionProbeUsage = 1;        // Off, BlendProbes, Simple
};
 
class EVENGINE_API_DOMAINS PcgMeshTransform {
public:
    PcgMeshTransform() noexcept;
    [[nodiscard]] Result<void> setElement(int row, int column, float value);
    [[nodiscard]] float getElement(int row, int column) const noexcept;
private:
    friend class PcgMeshCombinePlan;
    friend EVENGINE_API_DOMAINS Result<int> combinePcgStaticMeshesInto(MeshBuild&, const PcgMeshCombinePlan&);
    std::array<float, 16> matrix_{};
};
 
class EVENGINE_API_DOMAINS PcgMeshCombinePlan {
public:
    [[nodiscard]] Result<void> appendSource(const MeshBuild& mesh, const PcgMeshTransform& transform,
                                            const std::string& defaultMaterialId);
    void clear() noexcept;
    [[nodiscard]] int getSourceCount() const noexcept;
private:
    struct Source { MeshBuild mesh; PcgMeshTransform transform; std::string defaultMaterialId; };
    friend EVENGINE_API_DOMAINS Result<int> combinePcgStaticMeshesInto(MeshBuild&, const PcgMeshCombinePlan&);
    std::vector<Source> sources_;
};
 
struct PcgMeshLodLevel {
    float screenRelativeTransitionHeight = 0.5F;
    float fadeTransitionWidth = 0.0F;
    float quality = 1.0F;
    bool combineMeshes = false;
    bool combineSubMeshes = false;
    GtsMeshSimplificationOptions simplification{};
    PcgMeshLodRendererState renderer{};
};
 
class EVENGINE_API_DOMAINS PcgMeshLodProfile {
public:
    [[nodiscard]] Result<void> appendLevel(float transitionHeight, float fadeWidth, float quality,
                                           bool combineMeshes = false, bool combineSubMeshes = false);
    [[nodiscard]] Result<void> setLevelRendererState(int index, int skinQuality, int shadowCastingMode,
                                                     bool receiveShadows, int motionVectorMode,
                                                     bool skinnedMotionVectors, int lightProbeUsage,
                                                     int reflectionProbeUsage);
    [[nodiscard]] int getLevelRendererState(int index, int field) const noexcept;
    [[nodiscard]] Result<void> setFadePolicy(int fadeMode, bool animateCrossFading,
                                             float animationDuration = 0.5F);
    [[nodiscard]] int getFadeMode() const noexcept { return fadeMode_; }
    [[nodiscard]] bool getAnimateCrossFading() const noexcept { return animateCrossFading_; }
    [[nodiscard]] float getCrossFadeAnimationDuration() const noexcept { return crossFadeAnimationDuration_; }
    void clear() noexcept { levels_.clear(); }
    [[nodiscard]] int getLevelCount() const noexcept { return static_cast<int>(levels_.size()); }
    [[nodiscard]] const PcgMeshLodLevel* levelAt(int index) const noexcept;
    [[nodiscard]] const std::vector<PcgMeshLodLevel>& levels() const noexcept { return levels_; }
private:
    std::vector<PcgMeshLodLevel> levels_;
    int fadeMode_ = 0;
    bool animateCrossFading_ = false;
    float crossFadeAnimationDuration_ = 0.5F;
};
 
class EVENGINE_API_DOMAINS PcgMeshLodSet {
public:
    [[nodiscard]] int getLevelCount() const noexcept { return static_cast<int>(meshes_.size()); }
    [[nodiscard]] float getTransitionHeight(int index) const noexcept;
    [[nodiscard]] float getFadeWidth(int index) const noexcept;
    [[nodiscard]] float getQuality(int index) const noexcept;
    [[nodiscard]] int selectLevel(float relativeHeight) const noexcept;
    [[nodiscard]] float getSwitchDistance(int level, float worldDiameter, float verticalFovDegrees) const noexcept;
    [[nodiscard]] const MeshBuild* meshAt(int index) const noexcept;
    [[nodiscard]] const PcgMeshLodRendererState* rendererStateAt(int index) const noexcept;
    [[nodiscard]] int getFadeMode() const noexcept { return fadeMode_; }
    [[nodiscard]] bool getAnimateCrossFading() const noexcept { return animateCrossFading_; }
    [[nodiscard]] float getCrossFadeAnimationDuration() const noexcept { return crossFadeAnimationDuration_; }
private:
    friend EVENGINE_API_DOMAINS Result<void> buildPcgMeshLodsInto(PcgMeshLodSet&, const MeshBuild&,
                                                                  const PcgMeshLodProfile&);
    std::vector<PcgMeshLodLevel> levels_;
    std::vector<MeshBuild> meshes_;
    int fadeMode_ = 0;
    bool animateCrossFading_ = false;
    float crossFadeAnimationDuration_ = 0.5F;
};
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<void> buildPcgMeshLodsInto(PcgMeshLodSet& output, const MeshBuild& source,
                                                                     const PcgMeshLodProfile& profile);
 
[[nodiscard]] EVENGINE_API_DOMAINS Result<void> buildPcgCombinedMeshLodsInto(PcgMeshLodSet&            output,
                                                                             const PcgMeshCombinePlan& plan,
                                                                             const PcgMeshLodProfile&  profile);
 
}  // namespace eve::procgen