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
// SPDX-License-Identifier: BSD-3-Clause // Copyright (c) 2026 Fernando Sahmkow /// @file huffman.h /// @brief Blizzard adaptive Huffman decompression for MPQ sectors. #pragma once #include <whiteout/common_types.h> #include <span> #include <vector> namespace whiteout::storages::mpq { /// Decompress Huffman-encoded data using the Blizzard adaptive Huffman tree. /// @param src Compressed data (without the MPQ compression byte prefix). /// @param expectedSize Expected decompressed size. /// @return Decompressed data, or empty vector on failure. [[nodiscard]] std::vector<u8> huffmanDecompress(std::span<const u8> src, size_t expectedSize); /// Compress data using the Blizzard adaptive Huffman algorithm. /// @param src Raw data to compress. /// @param compType Compression type (0-8), selects the initial weight table. /// @return Compressed data, or empty vector on failure. [[nodiscard]] std::vector<u8> huffmanCompress(std::span<const u8> src, u32 compType = 0); } // namespace whiteout::storages::mpq