ObjectBuildLayer.h

浏览该文件的文档.

#pragma once
 
#include "common/Result.h"
#include "procgen/PointSet.h"
 
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::procgen {
 
struct ObjectTransformRange {
    float minPitch     = 0.f;
    float maxPitch     = 0.f;
    float minYaw       = 0.f;
    float maxYaw       = 0.f;
    float minRoll      = 0.f;
    float maxRoll      = 0.f;
    float minScaleX    = 1.f;
    float maxScaleX    = 1.f;
    float minScaleY    = 1.f;
    float maxScaleY    = 1.f;
    float minScaleZ    = 1.f;
    float maxScaleZ    = 1.f;
    bool  uniformScale = false;
};
 
class EVENGINE_API_DOMAINS ObjectBuildLayer {
public:
    [[nodiscard]] Result<void> addAsset(std::string asset, float weight);
    void                       clearAssets();
 
    void setSeed(std::uint32_t seed) noexcept;
    void setLayerOffset(float x, float y, float z) noexcept;
    [[nodiscard]] Result<void> setLayerScale(float x, float y, float z);
    [[nodiscard]] Result<void> setPositionRadius(float radius);
    [[nodiscard]] Result<void> setRandomTransform(const ObjectTransformRange& range);
    [[nodiscard]] Result<void> setRandomRotation(float minPitch, float maxPitch, float minYaw, float maxYaw,
                                                 float minRoll, float maxRoll);
    [[nodiscard]] Result<void> setRandomScale(float minX, float maxX, float minY, float maxY, float minZ, float maxZ,
                                              bool uniform);
    [[nodiscard]] Result<void> setOrientation(float cellSize, float yawOffset, bool invert);
    void                       disableOrientation() noexcept;
    void setPlaceOnTop(bool enabled, bool useLowest, float topOffset) noexcept;
 
    [[nodiscard]] Result<void> addChildRule(std::string asset, int count, float radius,
                                            const ObjectTransformRange& range);
    [[nodiscard]] Result<void> addChild(std::string asset, int count, float radius, float minScale, float maxScale,
                                        float minYaw, float maxYaw);
    void                       clearChildRules();
 
    [[nodiscard]] Result<PointSet> build(const PointSet& source, const PointSet* orientation = nullptr) const;
    [[nodiscard]] std::string serializeDefinition() const;
    [[nodiscard]] Result<void> deserializeDefinition(std::string_view definition);
 
private:
    struct Asset {
        std::string id;
        float       weight = 1.f;
    };
    struct ChildRule {
        std::string          asset;
        int                  count  = 0;
        float                radius = 0.f;
        ObjectTransformRange transform;
    };
 
    std::vector<Asset>     assets_;
    std::vector<ChildRule> children_;
    ObjectTransformRange   transform_;
    std::uint32_t          seed_                 = 1;
    float                  offsetX_              = 0.f;
    float                  offsetY_              = 0.f;
    float                  offsetZ_              = 0.f;
    float                  scaleX_               = 1.f;
    float                  scaleY_               = 1.f;
    float                  scaleZ_               = 1.f;
    float                  positionRadius_       = 0.f;
    bool                   orient_               = false;
    bool                   invertOrientation_    = false;
    float                  orientationCellSize_  = 1.f;
    float                  orientationYawOffset_ = 0.f;
    bool                   placeOnTop_           = false;
    bool                   useLowest_            = false;
    float                  topOffset_            = 0.f;
};
 
}  // namespace eve::procgen