ModelData.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Resource.h"
#include "common/Result.h"
 
#include "medialoader/model/ModelScene.h"
 
#include <memory>
#include <string>
#include <string_view>
 
struct aiMesh;
struct aiScene;
struct aiMaterial;
 
namespace eve {
namespace image {
class ImageData;
}
namespace model3d {
 
struct SurfaceUv {
    float u = 0.f;
    float v = 0.f;
    float barycentricA = 0.f;
    float barycentricB = 0.f;
    float barycentricC = 0.f;
    int triangleIndex = -1;
    int uvChannel = 0;
};
 
class EVENGINE_API_WORLD ModelData : public Resource {
public:
    explicit ModelData(medialoader::ModelScene scene, std::string uri = "", bool uvFlipped = false);
    bool hasFlippedUvs() const noexcept { return uvFlipped_; }
    ~ModelData() override;
 
    bool empty() const;
    int getMeshCount() const;
    int getMaterialCount() const;
    int getVertexCount(int meshIndex) const;
    int getFaceCount(int meshIndex) const;
    float getVertexPosition(int meshIndex, int vertexIndex, int component) const;
    float getVertexNormal(int meshIndex, int vertexIndex, int component) const;
    [[nodiscard]] eve::Result<void> setVertexNormal(int meshIndex, int vertexIndex, float x, float y,
                                                    float z);
    [[nodiscard]] eve::Result<void> applyVertexNormals(int meshIndex, std::string_view kind);
    [[nodiscard]] eve::Result<void> applyVertexNormalsFrom(int meshIndex, std::string_view kind,
                                                           float originX, float originY, float originZ);
    [[nodiscard]] eve::Result<std::unique_ptr<image::ImageData>> bakeNormalMap(
        int meshIndex, int width, int height, int uvChannel = 0, std::string_view space = "tangent") const;
    int getFaceVertexIndex(int meshIndex, int triangleIndex, int corner) const;
    bool hasNormals(int meshIndex) const;
    bool hasTexCoords(int meshIndex) const;
    int getTexCoordChannelCount(int meshIndex) const;
    bool hasTexCoordChannel(int meshIndex, int channel) const;
    float getTexCoord(int meshIndex, int channel, int vertexIndex, int component) const;
    [[nodiscard]] eve::Result<SurfaceUv> mapSurfacePointToUv(
        int meshIndex, int triangleIndex, float localX, float localY, float localZ,
        int channel = 0) const;
    bool hasTangents(int meshIndex) const;
    float getTangent(int meshIndex, int vertexIndex, int component) const;
    float getBitangent(int meshIndex, int vertexIndex, int component) const;
    int getVertexColorChannelCount(int meshIndex) const;
    bool hasVertexColorChannel(int meshIndex, int channel) const;
    float getVertexColor(int meshIndex, int channel, int vertexIndex, int component) const;
 
    // ---- material accessors ----
    int getMaterialIndex(int meshIndex) const;
    std::string getMaterialName(int matIndex) const;
    float getMaterialBaseColorR(int matIndex) const;
    float getMaterialBaseColorG(int matIndex) const;
    float getMaterialBaseColorB(int matIndex) const;
    float getMaterialBaseColorA(int matIndex) const;
    float getMaterialMetallicFactor(int matIndex) const;
    float getMaterialRoughnessFactor(int matIndex) const;
    float getMaterialOpacity(int matIndex) const;
    bool getMaterialTwoSided(int matIndex) const;
    std::string getMaterialAlphaMode(int matIndex) const;
    float getMaterialAlphaCutoff(int matIndex) const;
 
    int getMaterialTextureSlotCount(int matIndex, const std::string &type) const;
    std::string getMaterialTexturePath(int matIndex, const std::string &type, int slot = 0) const;
    int getMaterialTextureEmbeddedIndex(int matIndex, const std::string &type, int slot = 0) const;
 
    // ---- embedded textures (glTF / FBX can embed PNG/JPEG blobs) ----
    int getEmbeddedTextureCount() const;
    std::string getEmbeddedTextureName(int idx) const;
    int getEmbeddedTextureWidth(int idx) const;
    int getEmbeddedTextureHeight(int idx) const;
    image::ImageData *getEmbeddedTextureImageData(int idx) const;
 
    int getMorphTargetCount(int meshIndex) const;
    std::string getMorphTargetName(int meshIndex, int morphIndex) const;
 
    bool hasBones(int meshIndex) const;
    int getBoneCount(int meshIndex) const;
    std::string getBoneName(int meshIndex, int boneIndex) const;
    float getInverseBindMatrixElement(int meshIndex, int boneIndex, int elementIndex) const;
    int getBoneWeightCount(int meshIndex, int boneIndex) const;
    int getBoneWeightVertex(int meshIndex, int boneIndex, int weightIndex) const;
    float getBoneWeightValue(int meshIndex, int boneIndex, int weightIndex) const;
 
    int getAnimationCount() const;
    std::string getAnimationName(int animIndex) const;
 
    const aiScene *getScene() const;
    const aiMesh *getMesh(int meshIndex) const;
 
    void adopt(eve::Resource &replacement) override;
 
private:
    const aiMesh *meshAt(int meshIndex) const;
    aiMesh *meshAtMutable(int meshIndex);
    const aiMaterial *materialAt(int matIndex) const;
 
    medialoader::ModelScene scene;
    bool                    uvFlipped_ = false;
};
 
}  // namespace model3d
}  // namespace eve