DualGrid.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Result.h"
#include "map/TileLayer.h"
 
#include <array>
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::map {
 
struct DualGridOptions {
    int filledGid = 0;
    int firstDisplayGid = 0;
    bool applyHalfOffset = true;
    bool hideLogic = true;
    bool useDefaultFrameTable = true;
};
 
struct DualGridMaskConfig {
    int      width         = 128;
    int      height        = 64;
    float    edgeWidth     = 0.08f;
    float    noiseScale    = 5.f;
    float    noiseStrength = 0.08f;
    uint32_t seed          = 0;
};
 
struct EVENGINE_API_WORLD DualGridMaskAtlas {
    int                width  = 0;
    int                height = 0;
    std::vector<float> coverage;
    std::vector<float> signedDistance;
 
    [[nodiscard]] float coverageAt(int mask, int x, int y) const;
    [[nodiscard]] float signedDistanceAt(int mask, int x, int y) const;
    [[nodiscard]] float bandAt(int mask, int x, int y, float center, float halfWidth, float softness = 0.01f) const;
};
 
struct DualGridRgbaImage {
    int                  width  = 0;
    int                  height = 0;
    std::vector<uint8_t> pixels;
};
 
[[nodiscard]] EVENGINE_API_WORLD eve::Result<DualGridMaskAtlas> generateDualGridMaskAtlas(
    const DualGridMaskConfig &config);
 
[[nodiscard]] EVENGINE_API_WORLD eve::Result<DualGridRgbaImage> bakeDualGridTransitionAtlas(
    const DualGridRgbaImage &terrainA, const DualGridRgbaImage &terrainB, const DualGridMaskConfig &config);
 
inline int dualGridMaskFromCorners(bool tl, bool tr, bool bl, bool br) {
    return (tl ? 1 : 0) | (tr ? 2 : 0) | (bl ? 4 : 0) | (br ? 8 : 0);
}
 
EVENGINE_API_WORLD int dualGridDefaultFrame(int mask);
 
EVENGINE_API_WORLD const std::array<int, 16> &dualGridDefaultFrameTable();
 
EVENGINE_API_WORLD void dualGridHalfOffset(const TileLayer::Config &cfg, float &offX, float &offY);
 
bool dualGridLogicFilled(TileLayer &logic, int tx, int ty, int filledGid);
 
EVENGINE_API_WORLD int dualGridMaskAt(TileLayer &logic, int dx, int dy, int filledGid = 0);
 
EVENGINE_API_WORLD bool resolveDualGrid(TileLayer *logic, TileLayer *display, const DualGridOptions &opts,
                                        std::string *error = nullptr);
 
EVENGINE_API_WORLD bool resolveDualGrid(TileLayer *logic, TileLayer *display, std::string *error = nullptr);
 
}  // namespace eve::map