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

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

#include <algorithm>
#include <cmath>

#include "whiteout/models/wem/native_bag.h"

namespace whiteout {
namespace models {
namespace wem {

const NativeBag::Entry* NativeBag::find(const std::string& name) const {
    for (const Entry& entry : entries) {
        if (entry.name == name) {
            return &entry;
        }
    }
    return nullptr;
}

NativeBag::Entry& NativeBag::slot(const std::string& name) {
    for (Entry& entry : entries) {
        if (entry.name == name) {
            return entry;
        }
    }
    entries.push_back(Entry{name, 0, {}});
    return entries.back();
}

void NativeBag::set(const std::string& name, i64 value) {
    slot(name).value = value;
}

void NativeBag::setText(const std::string& name, std::string text) {
    slot(name).text = std::move(text);
}

i64 NativeBag::value(const std::string& name, i64 fallback) const {
    const Entry* entry = find(name);
    return entry == nullptr ? fallback : entry->value;
}

const std::string& NativeBag::text(const std::string& name) const {
    static const std::string kEmpty;
    const Entry* entry = find(name);
    return entry == nullptr ? kEmpty : entry->text;
}

void SetMilli(NativeBag& bag, const std::string& name, f32 value) {
    // A float off a file, so neither finite nor small: `llround` of either is
    // undefined.
    const f64 milli = std::isfinite(value) ? static_cast<f64>(value) * 1000.0 : 0.0;
    bag.set(name, static_cast<i64>(std::llround(std::clamp(milli, -1e15, 1e15))));
}

f32 Milli(const NativeBag& bag, const std::string& name, f32 fallback) {
    const NativeBag::Entry* entry = bag.find(name);
    return entry == nullptr ? fallback : static_cast<f32>(entry->value) / 1000.0f;
}

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