whiteoutlib 0.2.0

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

// SPDX-License-Identifier: BSD-3-Clause
// Copyright (c) 2026 Fernando Sahmkow

#include <string>

#include <whiteout/models/wem/anim/clip.h>

namespace whiteout {
namespace models {
namespace wem {

namespace {

/// Thousandths of a unit per second; see @ref ClipMoveSpeed.
const std::string kMoveSpeedMilli = "moveSpeedMilli";
/// Thousandths; see @ref ClipRarity.
const std::string kRarityMilli = "rarityMilli";

} // namespace

const char* ToString(Interpolation interp) {
    switch (interp) {
    case Interpolation::Step:
        return "step";
    case Interpolation::Linear:
        return "linear";
    case Interpolation::Hermite:
        return "hermite";
    case Interpolation::Bezier:
        return "bezier";
    case Interpolation::Slerp:
        return "slerp";
    case Interpolation::Count:
        break;
    }
    return "invalid";
}

const SubTrack* SubTrackContainer::find(u32 channel) const {
    for (const SubTrack& track : subTracks) {
        if (track.channel == channel) {
            return &track;
        }
    }
    return nullptr;
}

f32 ClipMoveSpeed(const Clip& clip) {
    // Whole units, which is how a document written before this key holds it.
    const i64 whole = clip.native.value("m3MoveSpeed", clip.native.value("moveSpeed", 0));
    return Milli(clip.native, kMoveSpeedMilli, static_cast<f32>(whole));
}

void SetClipMoveSpeed(Clip& clip, f32 speed) {
    SetMilli(clip.native, kMoveSpeedMilli, speed);
}

f32 ClipRarity(const Clip& clip) {
    return Milli(clip.native, kRarityMilli, static_cast<f32>(clip.native.value("rarity", 0)));
}

void SetClipRarity(Clip& clip, f32 rarity) {
    SetMilli(clip.native, kRarityMilli, rarity);
}

u32 AnimSet::find(u32 tagId) const {
    for (const AnimTag& entry : byTag) {
        if (entry.tagId == tagId) {
            return entry.clip;
        }
    }
    return kInvalidIndex;
}

} // namespace wem
} // namespace models
} // namespace whiteout