whiteoutlib 0.1.4

Read and write Blizzard game assets from Rust: models (MDX, M2, M3), textures (BLP, DDS, PNG, JPEG, BMP, TGA, TIFF, GIF) and archives (CASC, MPQ).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94


#pragma once

#include "structures/base.h"
#include "structures/extensions.h"
#include "structures/skin.h"
#include "types.h"

#include <limits>
#include "../../compatibility.h"

namespace whiteout {
namespace m2 {

struct Model {
    std::string modelName;
    GlobalFlags globalFlags;

    std::vector<GlobalSequence> globalLoops;
    std::vector<Sequence> sequences;
    std::vector<u16> sequenceIdxHashById;

    std::vector<Bone> bones;
    std::vector<u16> keyBoneIds;

    std::vector<Vertex> vertices;
    std::vector<SkinProfile> skinProfiles;
    std::vector<SkinProfile> lodProfiles;
    u32 numSkinProfiles = 0;

    std::vector<ColorAnimation> colors;
    std::vector<Texture> textures;
    std::vector<TextureWeight> textureWeights;
    std::vector<TextureTransform> textureTransforms;
    std::vector<u16> textureIndicesById;
    std::vector<Material> materials;

    std::vector<u16> boneCombos;
    std::vector<u16> textureCombos;
    std::vector<u16> textureCoordCombos;
    std::vector<u16> textureWeightCombos;
    std::vector<u16> textureTransformCombos;

    Extent bounding;
    Extent collision;
    std::vector<u16> collisionTriangleIndices;
    std::vector<Vector3f> collisionVertices;
    std::vector<Vector3f> collisionFaceNormals;

    std::vector<Attachment> attachments;
    std::vector<u16> attachmentIndicesById;
    std::vector<Event> events;
    std::vector<Light> lights;
    std::vector<Camera> cameras;
    std::vector<u16> cameraIndicesById;

    std::vector<RibbonEmitter> ribbonEmitters;
    std::vector<ParticleEmitter> particleEmitters;

    std::vector<u16> textureCombinerCombos;

    // ── Chunk extension data ──────────

    std::vector<u32> texture_ids;                          ///< TXID
    std::optional<LodProfile> lodProfile;                  ///< LDV1
    std::vector<std::array<u8, 2>> textureCombinerHints;   ///< TXAC
    std::vector<u16> parentSequenceReplacements;           ///< PABC
    std::vector<TextureWeight> parentTextureWeights;       ///< PADC
    std::vector<Extent> parentSequenceBounds;              ///< PSBC
    std::vector<AnimationTrackBase> parentEventData;       ///< PEDC
    std::vector<u32> recursiveParticleModelIds;            ///< RPID
    std::vector<u32> geometryParticleModelIds;             ///< GPID
    std::optional<WaterfallData> waterData;                ///< WFV3
    std::vector<ParticleGeosetData> particleGeosets;       ///< PGD1
    std::vector<u8> physicsFileData;                       ///< PFDC
    std::vector<EdgeFadeData> edgeFadeEntries;             ///< EDGF
    std::vector<DistanceFadeData> nerfEntries;             ///< NERF
    std::vector<DetailedLightData> detailedLightEntries;   ///< DETL
    std::vector<DebugOcclusionData> debugOcclusionEntries; ///< DBOC
    std::vector<u8> animFrameData;                         ///< AFRA
    std::optional<PhysicsCollision> physicsCollision;      ///< PCOL
    std::optional<std::array<u8, 32>> dpivData;            ///< DPIV
    std::vector<TexturedLightData> texturedLightEntries;   ///< TEXL
};

enum class Format : u32 {
    ClassicMD20 = 0,
    LegionMD21 = 1,

    Invalid = std::numeric_limits<u32>::max(),
};

} // namespace m2
} // namespace whiteout