decoders/include/rive/decoders/texture_decoder.hpp

/*
 * Copyright 2026 Rive
 */

#ifndef _RIVE_TEXTURE_DECODER_HPP_
#define _RIVE_TEXTURE_DECODER_HPP_

#include "rive/decoders/bitmap_decoder.hpp"
#include "rive/gpu_texture_format.hpp"

#include <cstddef>
#include <cstdint>
#include <memory>

// Decode one mip level of block-compressed texture data to an RGBA Bitmap.
// `blocks` points at the start of the level's block grid; `byteCount` is its
// size in bytes. `width` / `height` are the level's logical pixel dimensions.
// `blockWidth` / `blockHeight` default to 4 (BC/ETC); ASTC callers pass the
// block footprint from the format.
//
// Returns nullptr if the format's software decoder was not compiled in or
// decoding fails.
//
// Build flags that enable each family:
//   RIVE_ASTC_DECODER  --  astc (any block size)
//   RIVE_BC_DECODER    --  bc1 / bc2 / bc3 / bc7
//   RIVE_ETC_DECODER   --  etc2 (RGB8 and RGBA8)
std::unique_ptr<Bitmap> decode_texture(const uint8_t* blocks,
                                       size_t byteCount,
                                       uint32_t width,
                                       uint32_t height,
                                       rive::GPUTextureFormat format,
                                       uint32_t blockWidth = 1,
                                       uint32_t blockHeight = 1);

#endif