whiteoutlib 0.1.4

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

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

/// @file packbits.h
/// @brief Apple PackBits (TIFF compression 32773) decompressor.
///
/// Internal header — not part of the public include path.
///
/// Header byte n:
///   0..127     copy next n+1 bytes literally
///   128        no-op (skip header)
///   129..255   repeat next byte (257 - n) times, i.e. (-n + 1) in two's
///              complement reading

#pragma once

#include <span>
#include <vector>

#include <whiteout/common_types.h>

namespace whiteout::textures::tiff {

/// Decompress a PackBits stream into a fresh buffer.
/// @return decompressed bytes, or empty vector on malformed input
///         (truncated literal/run, overshoot of @p expectedSize when nonzero).
[[nodiscard]] std::vector<u8> packBitsDecompress(std::span<const u8> src,
                                                 size_t expectedSize = 0);

} // namespace whiteout::textures::tiff