toolboxes/image/include/nk/image/io/io.hpp

Go to the documentation of this file.

// toolboxes/image/include/nk/image/io/io.hpp
//
// Autonomous, zero-dependency in-tree image disk I/O (PNG, JPEG, BMP,
// TGA, PNM, TIFF/BigTIFF).
//
// imread returns an H × W (grayscale) or H × W × 3 / 4 (color)
// uint8 or uint16 array, preserving full scientific 16-bit depth.
 
#pragma once
 
#include <cstdint>
#include <memory_resource>
#include <nk/value/value.hpp>
#include <string>
#include <utility>
#include <vector>
 
namespace nk::image {

 

Value imread(const std::string &path,
             std::pmr::memory_resource *mr = nullptr);

void imwrite(const Value &A, const std::string &path,
             std::pmr::memory_resource *mr = nullptr);

std::string imwriteToBytes(const Value &A, const std::string &ext,
                           std::pmr::memory_resource *mr = nullptr);

Value imfinfo(const std::string &path,
              std::pmr::memory_resource *mr = nullptr);

Value imfinfoFromBytes(const std::string &bytes, const std::string &filename,
                       std::pmr::memory_resource *mr = nullptr);

Value readTiff(const std::string &path,
               std::pmr::memory_resource *mr = nullptr);

Value readTiff(const std::string &path, std::uint32_t page,
               std::pmr::memory_resource *mr = nullptr);

Value readTiff(std::vector<std::uint8_t> buf, std::uint32_t page,
               std::pmr::memory_resource *mr = nullptr);
std::pair<Value, Value>
readTiffWithMap(std::vector<std::uint8_t> buf, std::uint32_t page,
                std::pmr::memory_resource *mr = nullptr);

std::pair<Value, Value>
readTiffWithMap(const std::string &path, std::uint32_t page,
                std::pmr::memory_resource *mr = nullptr);

void peekTiff(const std::string &path,
              std::uint32_t &W,
              std::uint32_t &H,
              std::uint16_t &bits,
              std::uint16_t &channels);

void peekTiff(const std::vector<std::uint8_t> &buf,
              std::uint32_t &W,
              std::uint32_t &H,
              std::uint16_t &bits,
              std::uint16_t &channels);

std::uint32_t tiffNumPages(const std::string &path);

void writeTiff(const Value &A, const std::string &path,
               const std::string &compression = "none",
               bool appendMode = false);

std::vector<std::uint8_t>
writeTiffToBytes(const Value &A,
                 const std::string &compression = "none",
                 const std::vector<std::uint8_t> *existing = nullptr);
 

} // namespace nk::image