whiteoutlib 0.1.0

Parsers and writers for Blizzard model and texture formats (MDX, M2, M3, BLP, DDS, PNG).
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

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

/// @file md5.h
/// @brief Standalone MD5 hash implementation (RFC 1321).
///
/// Internal header — not part of the public include path.

#pragma once

#include <array>
#include <cstddef>
#include <span>

#include <whiteout/common_types.h>

namespace whiteout::storages::common {

/// Incremental MD5 hasher.
class MD5 {
public:
    MD5();

    /// Feed data into the hash.
    void update(const void* data, size_t length);

    /// Feed a span of bytes.
    void update(std::span<const u8> data) {
        update(data.data(), data.size());
    }

    /// Finalize and return the 16-byte digest.
    /// After calling finalize(), the hasher should not be reused.
    std::array<u8, 16> finalize();

private:
    void processBlock(const u8* block);

    u32 m_state[4];
    u64 m_totalLen = 0;
    u8 m_buffer[64]{};
    size_t m_bufferLen = 0;
};

/// Convenience: compute MD5 of a byte span in one call.
inline std::array<u8, 16> md5Hash(std::span<const u8> data) {
    MD5 hasher;
    hasher.update(data);
    return hasher.finalize();
}

} // namespace whiteout::storages::common