whiteoutlib 0.1.2

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

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

/// @file pixel_convert.cpp
/// @brief Template-generated pixel-format conversion tables.

#include "pixel_convert.h"

namespace whiteout::textures {

// ============================================================================
// N×N bulk conversion table (auto-generated from UncompressedFormats)
// ============================================================================

namespace {

using BulkFn = BulkConvertFn;

/// Build the N×N table at static-init time via template instantiation.
struct ConversionTable {
    BulkFn entries[kUncompressedCount][kUncompressedCount]{};

    ConversionTable() {
        for_each_format<UncompressedFormats>([this]<PixelFormat Src>() {
            for_each_format<UncompressedFormats>([this]<PixelFormat Dst>() {
                constexpr u32 si = static_cast<u32>(Src);
                constexpr u32 di = static_cast<u32>(Dst);
                entries[si][di] = &convert_pixels<Src, Dst>;
            });
        });
    }
};

const ConversionTable g_table;

} // anonymous namespace

BulkConvertFn get_converter(PixelFormat src, PixelFormat dst) {
    const u32 si = static_cast<u32>(src);
    const u32 di = static_cast<u32>(dst);
    if (si >= kUncompressedCount || di >= kUncompressedCount)
        return nullptr;
    return g_table.entries[si][di];
}

// ============================================================================
// Per-pixel float converter arrays (for custom pipelines)
// ============================================================================

namespace {

struct ToTable {
    ToRGBA32F entries[kUncompressedCount]{};

    ToTable() {
        for_each_format<UncompressedFormats>(
            [this]<PixelFormat Fmt>() { entries[static_cast<u32>(Fmt)] = &read_rgba32f<Fmt>; });
    }
};

struct FromTable {
    FromRGBA32F entries[kUncompressedCount]{};

    FromTable() {
        for_each_format<UncompressedFormats>(
            [this]<PixelFormat Fmt>() { entries[static_cast<u32>(Fmt)] = &write_rgba32f<Fmt>; });
    }
};

const ToTable g_to_table;
const FromTable g_from_table;

} // anonymous namespace

ToRGBA32F get_to_rgba32f(PixelFormat fmt) {
    const u32 idx = static_cast<u32>(fmt);
    if (idx >= kUncompressedCount)
        return nullptr;
    return g_to_table.entries[idx];
}

FromRGBA32F get_from_rgba32f(PixelFormat fmt) {
    const u32 idx = static_cast<u32>(fmt);
    if (idx >= kUncompressedCount)
        return nullptr;
    return g_from_table.entries[idx];
}

} // namespace whiteout::textures