whiteoutlib 0.1.1

Read and write Blizzard game assets: models (MDX, M2, M3), textures (BLP, DDS, PNG, ...) 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

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

#include "whiteout/utils/os_file_system.h"

#include "../common/unicode_path.h"

#include <filesystem>
#include <fstream>

namespace fs = std::filesystem;

namespace whiteout::utils {

struct OsFileSystem::Impl {
    fs::path root;

    explicit Impl(std::string rootPath) : root(common::utf8_to_path(rootPath)) {}

    fs::path resolve(const std::string& path) const {
        return root / common::utf8_to_path(path);
    }
};

OsFileSystem::OsFileSystem(std::string rootPath)
    : m_impl(std::make_unique<Impl>(std::move(rootPath))) {}

OsFileSystem::~OsFileSystem() = default;

OsFileSystem::OsFileSystem(OsFileSystem&&) noexcept = default;
OsFileSystem& OsFileSystem::operator=(OsFileSystem&&) noexcept = default;

std::vector<u8> OsFileSystem::readFile(const std::string& path) const {
    const fs::path fullPath = m_impl->resolve(path);

    std::ifstream file(fullPath, std::ios::binary | std::ios::ate);
    if (!file.is_open())
        return {};

    const auto size = file.tellg();
    if (size <= 0)
        return {};

    file.seekg(0);
    std::vector<u8> buffer(static_cast<size_t>(size));
    file.read(reinterpret_cast<char*>(buffer.data()), size);
    if (!file)
        return {};

    return buffer;
}

bool OsFileSystem::fileExists(const std::string& path) const {
    return fs::is_regular_file(m_impl->resolve(path));
}

bool OsFileSystem::writeFile(const std::string& path, const std::vector<u8>& data) {
    const fs::path fullPath = m_impl->resolve(path);

    // Ensure parent directories exist
    std::error_code ec;
    fs::create_directories(fullPath.parent_path(), ec);

    std::ofstream file(fullPath, std::ios::binary);
    if (!file.is_open())
        return false;

    file.write(reinterpret_cast<const char*>(data.data()),
               static_cast<std::streamsize>(data.size()));
    return file.good();
}

std::vector<interfaces::DirectoryEntry> OsFileSystem::listDirectory(const std::string& path) const {
    std::vector<interfaces::DirectoryEntry> entries;
    const fs::path fullPath = m_impl->resolve(path);

    std::error_code ec;
    for (const auto& entry : fs::directory_iterator(fullPath, ec)) {
        if (ec)
            break;
        entries.push_back({entry.path().filename().string(), entry.is_directory()});
    }
    return entries;
}

} // namespace whiteout::utils