VTX.h

Go to the documentation of this file.

#pragma once
 
#include <array>
#include <span>
 
#include "MDL.h"
 
namespace mdlpp::VTX {
 
struct MaterialReplacement {
    int16_t materialID;
    //int32_t replacementMaterialNameOffset;
    std::string newMaterialPath;
};
 
struct BoneStateChange {
    int32_t hardwareID;
    int32_t newBoneID;
};
 
struct Vertex {
    std::array<uint8_t, 3> boneWeightIndex;
    uint8_t boneCount;
    uint16_t meshVertexID;
    std::array<int8_t, 3> boneID;
};
 
struct Strip {
    enum Flags : uint8_t {
        FLAG_NONE        = 0,
        FLAG_IS_TRILIST  = 1 << 0,
        FLAG_IS_TRISTRIP = 1 << 1,
    };
 
    //int32_t indicesCount;
    int32_t indicesOffset = 0; // Offset from the start of the strip group indices
    std::span<uint16_t> indices;
 
    //int32_t verticesCount;
    int32_t verticesOffset = 0; // Offset from the start of the strip group vertices
    std::span<Vertex> vertices;
 
    int16_t boneCount = 0;
    Flags flags = FLAG_NONE;
 
    //int32_t boneStateChangeCount;
    //int32_t boneStateChangeOffset;
    std::vector<BoneStateChange> boneStateChanges;
 
    //int32_t numTopologyIndices;
    int32_t topologyIndicesOffset = 0;
    std::span<uint16_t> topologyIndices;
};
SOURCEPP_BITFLAGS_ENUM(Strip::Flags)
 
struct StripGroup {
    enum Flags : uint8_t {
        FLAG_NONE              = 0,
        FLAG_IS_FLEXED         = 1 << 0,
        FLAG_IS_HW_SKINNED     = 1 << 1,
        FLAG_IS_DELTA_FLEXED   = 1 << 2,
        FLAG_SUPPRESS_HW_MORPH = 1 << 3,
    };
 
    //int32_t vertexCount;
    //int32_t vertexOffset;
    std::vector<Vertex> vertices;
 
    //int32_t indexCount;
    //int32_t indexOffset;
    std::vector<uint16_t> indices;
 
    //int32_t stripCount;
    //int32_t stripOffset;
    std::vector<Strip> strips;
 
    Flags flags;
 
    //int32_t numTopologyIndices;
    //int32_t topologyOffset;
    std::vector<uint16_t> topologyIndices;
};
SOURCEPP_BITFLAGS_ENUM(StripGroup::Flags)
 
struct Mesh {
    enum Flags : uint8_t {
        FLAG_NONE = 0,
        FLAG_IS_TEETH = 1 << 0,
        FLAG_IS_EYES = 1 << 1,
    };
 
    //int32_t stripGroupCount;
    //int32_t stripGroupHeaderOffset;
    std::vector<StripGroup> stripGroups;
 
    Flags flags;
};
SOURCEPP_BITFLAGS_ENUM(Mesh::Flags)
 
struct ModelLOD {
    //int32_t meshCount;
    //int32_t meshOffset;
    std::vector<Mesh> meshes;
 
    float switchDistance;
};
 
struct Model {
    //int32_t LODCount;
    //int32_t LODOffset;
    std::vector<ModelLOD> modelLODs;
};
 
struct BodyPart {
    //int32_t modelCount;
    //int32_t modelOffset;
    std::vector<Model> models;
};
 
struct VTX {
    enum class HasTopologyIndices {
        AUTOMATIC,
        NO,
        YES,
    };
 
    [[nodiscard]] bool open(const std::byte* data, std::size_t size, const MDL::MDL& mdl, HasTopologyIndices hasTopologyIndices = HasTopologyIndices::AUTOMATIC);
 
    int32_t version;
    int32_t vertexCacheSize;
    uint16_t maxBonesPerStrip;
    uint16_t maxBonesPerTriangle;
    int32_t maxBonesPerVertex;
    //int32_t checksum;
    int32_t numLODs;
 
    //int32_t materialReplacementListOffset;
    std::array<std::vector<MaterialReplacement>, MAX_LOD_COUNT> materialReplacementLists;
 
    //int32_t bodyPartCount;
    //int32_t bodyPartOffset;
    std::vector<BodyPart> bodyParts;
};
 
} // namespace mdlpp::VTX