mirror of
https://github.com/BinomialLLC/basis_universal.git
synced 2026-07-12 08:58:52 +00:00
4136 lines
166 KiB
C++
4136 lines
166 KiB
C++
// basis_wrappers.cpp - Wrappers to the C++ compressor and transcoder for WebAssembly/WebGL use.
|
|
// This file exposes wrappers for transcoding and encoding .basis and .KTX2 files.
|
|
//
|
|
// **Important**:
|
|
// Compile with -fno-strict-aliasing (same as the Linux kernel).
|
|
// This code HAS NOT been tested with strict aliasing enabled.
|
|
// The "initializeBasis()" function MUST be called at least once before using either the compressor or transcoder.
|
|
//
|
|
// There are four main categories of wrappers in this module:
|
|
// 1. Transcoding, low-level .basis file information: See class basis_file. Only depends on transcoder/basisu_transcoder.cpp.
|
|
// getFileDesc(), getImageDesc(), getImageLevelDesc(): These functions return low-level information about where compressed data is located for each image in a .basis file.
|
|
// This is useful for when you want to extract the compressed data and embed it into your own file formats, for container independent transcoding.
|
|
//
|
|
// 2. Encoding (optional): See class basis_encoder. Encodes LDR .PNG or 32bpp images, or HDR half-float/float or .EXR/.HDR images to .basis/.ktx2 files in memory.
|
|
// Must compile with BASISU_SUPPORT_ENCODING=1.
|
|
// Requires basisu_transcoder.cpp as well as all the .cpp files in the "encoder" directory. Results in a larger WebAssembly executable.
|
|
//
|
|
// 3. Low level transcoding/container independent transcoding: See class lowlevel_etc1s_image_transcoder or function transcodeUASTCImage().
|
|
// For transcoding raw compressed ETC1S/UASTC LDR/UASTC HDR texture data from non-.basis files (say from KTX2) to GPU texture data.
|
|
//
|
|
// 4. Helpers, transcoder texture format information: See functions getBytesPerBlockOrPixel(), formatHasAlpha(), etc.
|
|
//
|
|
// Note: The thread pool size is setup in the CMakeLists.txt file:
|
|
// set(LINK_THREADS "-s USE_PTHREADS=1 -s PTHREAD_POOL_SIZE=32 -s ENVIRONMENT=web,worker")
|
|
|
|
// If BASISU_SUPPORT_ENCODING is 1, wrappers for the compressor will be included. Otherwise, only the wrappers for the transcoder will be compiled in.
|
|
#ifndef BASISU_SUPPORT_ENCODING
|
|
#define BASISU_SUPPORT_ENCODING 0
|
|
#endif
|
|
|
|
// Enable debug printf()'s in this module.
|
|
#ifndef BASISU_DEBUG_PRINTF
|
|
// DO NOT CHECK IN
|
|
#define BASISU_DEBUG_PRINTF 0
|
|
#endif
|
|
|
|
// This check can be removed, but you risk crashing on larger images in 32-bit WASM. Also, ETC1S/UASTC LDR 4x4 encoding uses way less memory than UASTC HDR 6x6 encoding, so you could boost this in those cases.
|
|
// 32-bit WASM limitation (TODO: remove for 64-bit), to prevent OOM crashes during HDR encoding in particular.
|
|
// TODO: Even WASM64 in Chrome has limits which seem too low for us. For now, just impose this limit.
|
|
#ifdef __wasm64__
|
|
#define BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS (1024*1024*16)
|
|
#define BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS_HIGHER_LIMIT (1024*1024*16)
|
|
#else
|
|
#define BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS (1024*1024*4)
|
|
#define BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS_HIGHER_LIMIT (1024*1024*12)
|
|
#endif
|
|
|
|
#include "basisu_transcoder.h"
|
|
#include <algorithm>
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
#include "../../encoder/basisu_comp.h"
|
|
#include "../../encoder/basisu_astc_hdr_6x6_enc.h"
|
|
#include "../../encoder/basisu_resampler_filters.h"
|
|
#include "../../encoder/basisu_gpu_texture.h" // for basisu::transcode_ktx2_to_dds()
|
|
#include "../../encoder/basisu_dds_export.h" // direct source->DDS export (build_dds), distinct from the lossy KTX2->DDS path above
|
|
#endif
|
|
|
|
#include <emscripten/bind.h>
|
|
#if BASISU_SUPPORT_ENCODING
|
|
#include <emscripten/threading.h>
|
|
#endif
|
|
#include <emscripten.h>
|
|
|
|
using namespace emscripten;
|
|
using namespace basist;
|
|
using namespace basisu;
|
|
|
|
static bool g_basis_initialized_flag;
|
|
|
|
// Global one-time initialization. MUST be called before using any other functionality.
|
|
void basis_init()
|
|
{
|
|
static std::mutex s_init_mutex;
|
|
std::lock_guard<std::mutex> lock(s_init_mutex);
|
|
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_init() " BASISD_VERSION_STRING " ");
|
|
#ifdef __wasm64__
|
|
printf("WASM64 ");
|
|
#endif
|
|
#ifdef WASM_THREADS_ENABLED
|
|
printf("PTHREADS");
|
|
#endif
|
|
printf("\n");
|
|
#endif
|
|
|
|
if (g_basis_initialized_flag)
|
|
return;
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
basisu_encoder_init();
|
|
#endif
|
|
|
|
basisu_transcoder_init();
|
|
|
|
g_basis_initialized_flag = true;
|
|
}
|
|
|
|
#if 0
|
|
// Old copy methods, used in previous builds for plain WASM (not WASM64).
|
|
|
|
// false if resize() fails
|
|
static bool copy_from_jsbuffer(const emscripten::val& srcBuffer, basisu::vector<uint8_t>& dstVec)
|
|
{
|
|
unsigned int length = srcBuffer["length"].as<unsigned int>();
|
|
|
|
if (!dstVec.try_resize(length))
|
|
return false;
|
|
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = srcBuffer["constructor"].new_(memory, reinterpret_cast<uintptr_t>(dstVec.data()), length);
|
|
|
|
// Copy the bytes from the Javascript buffer.
|
|
memoryView.call<void>("set", srcBuffer);
|
|
|
|
return true;
|
|
}
|
|
|
|
static bool copy_to_jsbuffer(const emscripten::val& dstBuffer, const basisu::vector<uint8_t>& srcVec)
|
|
{
|
|
if (srcVec.empty())
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("copy_to_jsbuffer: Provided source buffer is empty\n");
|
|
#endif
|
|
return false;
|
|
}
|
|
|
|
// Make sure the provided buffer from Javascript is big enough. If not, bail.
|
|
int dstBufferLen = dstBuffer["byteLength"].as<int>();
|
|
|
|
if (srcVec.size() > dstBufferLen)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("copy_to_jsbuffer: Provided destination buffer is too small (wanted %u bytes, got %u bytes)!\n", (uint32_t)srcVec.size(), dstBufferLen);
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = emscripten::val::global("Uint8Array").new_(memory, reinterpret_cast<uintptr_t>(srcVec.data()), srcVec.size());
|
|
|
|
// Copy the bytes into the Javascript buffer.
|
|
dstBuffer.call<void>("set", memoryView);
|
|
|
|
return true;
|
|
}
|
|
#else
|
|
// New methods, compatible with WASM64.
|
|
static bool copy_from_jsbuffer(const emscripten::val& srcBuffer, basisu::vector<uint8_t>& dstVec)
|
|
{
|
|
const size_t length = srcBuffer["length"].as<size_t>();
|
|
if (!dstVec.try_resize(length))
|
|
return false;
|
|
|
|
// View over dstVec in WASM memory; copy from JS buffer into it.
|
|
emscripten::val dstView = emscripten::val(emscripten::typed_memory_view(length, dstVec.data()));
|
|
dstView.call<void>("set", srcBuffer);
|
|
return true;
|
|
}
|
|
|
|
// WASM -> JS
|
|
static bool copy_to_jsbuffer(const emscripten::val& dstBuffer, const basisu::vector<uint8_t>& srcVec)
|
|
{
|
|
if (srcVec.empty())
|
|
return false;
|
|
|
|
const size_t dstLen = dstBuffer["byteLength"].as<size_t>();
|
|
if (srcVec.size() > dstLen)
|
|
return false;
|
|
|
|
// View over srcVec; copy into provided JS TypedArray.
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(srcVec.size(), const_cast<uint8_t*>(srcVec.data())));
|
|
dstBuffer.call<void>("set", srcView);
|
|
return true;
|
|
}
|
|
#endif
|
|
|
|
const uint32_t BASIS_MAGIC = 0xD4ADBEA1;
|
|
const uint32_t KTX2_MAGIC = 0xD4ADBEF2;
|
|
const uint32_t DDS_MAGIC = 0xD4ADBEF3;
|
|
|
|
struct basis_file_desc
|
|
{
|
|
uint32_t m_version;
|
|
|
|
uint32_t m_us_per_frame;
|
|
|
|
uint32_t m_total_images;
|
|
|
|
uint32_t m_userdata0;
|
|
uint32_t m_userdata1;
|
|
|
|
// Type of texture (cETC1S, cUASTC_LDR_4x4, cUASTC_HDR_4x4, etc.)
|
|
uint32_t m_tex_format; // basis_tex_format
|
|
|
|
bool m_y_flipped;
|
|
bool m_has_alpha_slices;
|
|
|
|
// ETC1S endpoint codebook
|
|
uint32_t m_num_endpoints;
|
|
uint32_t m_endpoint_palette_ofs;
|
|
uint32_t m_endpoint_palette_len;
|
|
|
|
// ETC1S selector codebook
|
|
uint32_t m_num_selectors;
|
|
uint32_t m_selector_palette_ofs;
|
|
uint32_t m_selector_palette_len;
|
|
|
|
// Huffman codelength tables
|
|
uint32_t m_tables_ofs;
|
|
uint32_t m_tables_len;
|
|
|
|
uint32_t m_block_width;
|
|
uint32_t m_block_height;
|
|
};
|
|
|
|
struct basis_image_desc
|
|
{
|
|
uint32_t m_orig_width;
|
|
uint32_t m_orig_height;
|
|
uint32_t m_num_blocks_x;
|
|
uint32_t m_num_blocks_y;
|
|
uint32_t m_num_levels;
|
|
uint32_t m_block_width;
|
|
uint32_t m_block_height;
|
|
|
|
// Will be true if the image has alpha (for UASTC this may vary per-image)
|
|
bool m_alpha_flag;
|
|
bool m_iframe_flag;
|
|
};
|
|
|
|
struct basis_image_level_desc
|
|
{
|
|
// File offset/length of the compressed ETC1S or UASTC LDR/HDR texture data.
|
|
uint32_t m_rgb_file_ofs;
|
|
uint32_t m_rgb_file_len;
|
|
|
|
// Optional alpha data file offset/length - will be 0's for UASTC LDR/HDR or opaque ETC1S files.
|
|
uint32_t m_alpha_file_ofs;
|
|
uint32_t m_alpha_file_len;
|
|
};
|
|
|
|
struct basis_file
|
|
{
|
|
int m_magic = 0;
|
|
basisu_transcoder m_transcoder;
|
|
basisu::vector<uint8_t> m_file;
|
|
|
|
basis_file(const emscripten::val& jsBuffer)
|
|
: m_file(jsBuffer["byteLength"].as<size_t>())
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_file::basis_file: Must call basis_init() first!\n");
|
|
#endif
|
|
assert(0);
|
|
return;
|
|
}
|
|
|
|
#if 0
|
|
unsigned int length = jsBuffer["length"].as<unsigned int>();
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = jsBuffer["constructor"].new_(memory, reinterpret_cast<uintptr_t>(m_file.data()), length);
|
|
memoryView.call<void>("set", jsBuffer);
|
|
#else
|
|
const size_t n = jsBuffer["byteLength"].as<size_t>();
|
|
|
|
if (!n)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_file::basis_file: zero size file\n");
|
|
#endif
|
|
m_file.clear();
|
|
return;
|
|
}
|
|
|
|
emscripten::val dstView = emscripten::val(emscripten::typed_memory_view(n, m_file.data()));
|
|
dstView.call<void>("set", jsBuffer);
|
|
#endif
|
|
|
|
if (!m_transcoder.validate_header(m_file.data(), m_file.size()))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_file::basis_file: m_transcoder.validate_header() failed!\n");
|
|
#endif
|
|
m_file.clear();
|
|
}
|
|
|
|
// Initialized after validation
|
|
m_magic = BASIS_MAGIC;
|
|
}
|
|
|
|
void close()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return;
|
|
|
|
m_file.clear();
|
|
}
|
|
|
|
uint32_t getHasAlpha()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
basisu_image_level_info li;
|
|
if (!m_transcoder.get_image_level_info(m_file.data(), m_file.size(), li, 0, 0))
|
|
return 0;
|
|
|
|
return li.m_alpha_flag;
|
|
}
|
|
|
|
uint32_t getNumImages()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.get_total_images(m_file.data(), m_file.size());
|
|
}
|
|
|
|
uint32_t getNumLevels(uint32_t image_index)
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
basisu_image_info ii;
|
|
if (!m_transcoder.get_image_info(m_file.data(), m_file.size(), ii, image_index))
|
|
return 0;
|
|
|
|
return ii.m_total_levels;
|
|
}
|
|
|
|
uint32_t getImageWidth(uint32_t image_index, uint32_t level_index)
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
uint32_t orig_width, orig_height, total_blocks;
|
|
if (!m_transcoder.get_image_level_desc(m_file.data(), m_file.size(), image_index, level_index, orig_width, orig_height, total_blocks))
|
|
return 0;
|
|
|
|
return orig_width;
|
|
}
|
|
|
|
uint32_t getImageHeight(uint32_t image_index, uint32_t level_index)
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
uint32_t orig_width, orig_height, total_blocks;
|
|
if (!m_transcoder.get_image_level_desc(m_file.data(), m_file.size(), image_index, level_index, orig_width, orig_height, total_blocks))
|
|
return 0;
|
|
|
|
return orig_height;
|
|
}
|
|
|
|
// Returns a basis_tex_format (cETC1S, cUASTC_LDR_4x4, cUASTC_HDR_4x4, etc. - see basiu_file_headers.h)
|
|
uint32_t getBasisTexFormat()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return (uint32_t)fmt;
|
|
}
|
|
|
|
// Returns 4-12
|
|
uint32_t getBlockWidth() const
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_get_block_width(fmt);
|
|
}
|
|
|
|
// Returns 4-12
|
|
uint32_t getBlockHeight()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_get_block_height(fmt);
|
|
}
|
|
|
|
basis_file_desc getFileDesc()
|
|
{
|
|
basis_file_desc result;
|
|
memset(&result, 0, sizeof(result));
|
|
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return result;
|
|
|
|
basisu_file_info file_info;
|
|
|
|
if (!m_transcoder.get_file_info(m_file.data(), m_file.size(), file_info))
|
|
{
|
|
assert(0);
|
|
return result;
|
|
}
|
|
|
|
result.m_version = file_info.m_version;
|
|
result.m_us_per_frame = file_info.m_us_per_frame;
|
|
result.m_total_images = file_info.m_total_images;
|
|
result.m_userdata0 = file_info.m_userdata0;
|
|
result.m_userdata1 = file_info.m_userdata1;
|
|
result.m_tex_format = static_cast<uint32_t>(file_info.m_tex_format);
|
|
result.m_y_flipped = file_info.m_y_flipped;
|
|
result.m_has_alpha_slices = file_info.m_has_alpha_slices;
|
|
|
|
result.m_num_endpoints = file_info.m_total_endpoints;
|
|
result.m_endpoint_palette_ofs = file_info.m_endpoint_codebook_ofs;
|
|
result.m_endpoint_palette_len = file_info.m_endpoint_codebook_size;
|
|
|
|
result.m_num_selectors = file_info.m_total_selectors;
|
|
result.m_selector_palette_ofs = file_info.m_selector_codebook_ofs;
|
|
result.m_selector_palette_len = file_info.m_selector_codebook_size;
|
|
|
|
result.m_tables_ofs = file_info.m_tables_ofs;
|
|
result.m_tables_len = file_info.m_tables_size;
|
|
|
|
result.m_block_width = file_info.m_block_width;
|
|
result.m_block_height = file_info.m_block_height;
|
|
|
|
return result;
|
|
}
|
|
|
|
basis_image_desc getImageDesc(uint32_t image_index)
|
|
{
|
|
basis_image_desc result;
|
|
memset(&result, 0, sizeof(result));
|
|
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return result;
|
|
|
|
basisu_image_info image_info;
|
|
|
|
// bool get_image_info(const void *pData, uint32_t data_size, basisu_image_info &image_info, uint32_t image_index) const;
|
|
if (!m_transcoder.get_image_info(m_file.data(), m_file.size(), image_info, image_index))
|
|
{
|
|
assert(0);
|
|
return result;
|
|
}
|
|
|
|
result.m_orig_width = image_info.m_orig_width;
|
|
result.m_orig_height = image_info.m_orig_height;
|
|
result.m_num_blocks_x = image_info.m_num_blocks_x;
|
|
result.m_num_blocks_y = image_info.m_num_blocks_y;
|
|
result.m_num_levels = image_info.m_total_levels;
|
|
result.m_alpha_flag = image_info.m_alpha_flag;
|
|
result.m_iframe_flag = image_info.m_iframe_flag;
|
|
result.m_block_width = image_info.m_block_width;
|
|
result.m_block_height = image_info.m_block_height;
|
|
|
|
return result;
|
|
}
|
|
|
|
basis_image_level_desc getImageLevelDesc(uint32_t image_index, uint32_t level_index)
|
|
{
|
|
basis_image_level_desc result;
|
|
memset(&result, 0, sizeof(result));
|
|
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return result;
|
|
|
|
basisu_image_level_info image_info;
|
|
|
|
if (!m_transcoder.get_image_level_info(m_file.data(), m_file.size(), image_info, image_index, level_index))
|
|
{
|
|
assert(0);
|
|
return result;
|
|
}
|
|
|
|
result.m_rgb_file_ofs = image_info.m_rgb_file_ofs;
|
|
result.m_rgb_file_len = image_info.m_rgb_file_len;
|
|
result.m_alpha_file_ofs = image_info.m_alpha_file_ofs;
|
|
result.m_alpha_file_len = image_info.m_alpha_file_len;
|
|
|
|
return result;
|
|
}
|
|
|
|
// format is transcoder_texture_format
|
|
uint32_t getImageTranscodedSizeInBytes(uint32_t image_index, uint32_t level_index, uint32_t format)
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
const transcoder_texture_format tex_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
uint32_t orig_width, orig_height, total_src_blocks;
|
|
if (!m_transcoder.get_image_level_desc(m_file.data(), m_file.size(), image_index, level_index, orig_width, orig_height, total_src_blocks))
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
return basis_compute_transcoded_image_size_in_bytes(tex_format, orig_width, orig_height);
|
|
}
|
|
|
|
// Only true for UASTC LDR 4x4.
|
|
bool isUASTC_LDR_4x4()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
return m_transcoder.get_basis_tex_format(m_file.data(), m_file.size()) == basis_tex_format::cUASTC_LDR_4x4;
|
|
}
|
|
|
|
bool isETC1S()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
return m_transcoder.get_basis_tex_format(m_file.data(), m_file.size()) == basis_tex_format::cETC1S;
|
|
}
|
|
|
|
// True for any LDR texture types
|
|
bool isLDR()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return (fmt == basis_tex_format::cETC1S) || (fmt == basis_tex_format::cUASTC_LDR_4x4);
|
|
}
|
|
|
|
// True if the texture is UASTC HDR 4x4 or ASTC HDR 6x6.
|
|
// In this case, it can only be transcoded to BC6H, ASTC HDR (of the same block dimensions, currently 4x4 or 6x6), RGB9E5 or half-float RGB/RGBA images.
|
|
bool isHDR()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_is_hdr(fmt);
|
|
}
|
|
|
|
bool isHDR4x4()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return (fmt == basis_tex_format::cUASTC_HDR_4x4);
|
|
}
|
|
|
|
bool isHDR6x6()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return (fmt == basis_tex_format::cASTC_HDR_6x6) || (fmt == basis_tex_format::cUASTC_HDR_6x6_INTERMEDIATE);
|
|
}
|
|
|
|
// True for plain ASTC LDR 4x4-12x12
|
|
bool isASTC_LDR()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_is_astc_ldr(fmt);
|
|
}
|
|
|
|
// True for XUASTC LDR 4x4-12x12
|
|
bool isXUASTC_LDR()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_is_xuastc_ldr(fmt);
|
|
}
|
|
|
|
bool isXUBC7()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return false;
|
|
|
|
basis_tex_format fmt = m_transcoder.get_basis_tex_format(m_file.data(), m_file.size());
|
|
return basis_tex_format_is_xubc7(fmt);
|
|
}
|
|
|
|
uint32_t startTranscoding()
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.start_transcoding(m_file.data(), m_file.size());
|
|
}
|
|
|
|
// Here for backwards compat, prefer transcodeImageWithFlags().
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImage(const emscripten::val& dst, uint32_t image_index, uint32_t level_index, uint32_t format, uint32_t unused, uint32_t get_alpha_for_opaque_formats)
|
|
{
|
|
(void)unused;
|
|
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
uint32_t orig_width, orig_height, total_src_blocks;
|
|
if (!m_transcoder.get_image_level_desc(m_file.data(), m_file.size(), image_index, level_index, orig_width, orig_height, total_src_blocks))
|
|
return 0;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
uint32_t flags = get_alpha_for_opaque_formats ? cDecodeFlagsTranscodeAlphaDataToOpaqueFormats : 0;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(image_index, level_index, format);
|
|
|
|
if (!dst_data.try_resize(transcoded_size_in_bytes))
|
|
return 0;
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
status = m_transcoder.transcode_image_level(
|
|
m_file.data(), m_file.size(), image_index, level_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
nullptr,
|
|
orig_height);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
m_file.data(), m_file.size(), image_index, level_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
static_cast<basist::transcoder_texture_format>(format),
|
|
flags);
|
|
}
|
|
|
|
#if 0
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = emscripten::val::global("Uint8Array").new_(memory, reinterpret_cast<uintptr_t>(dst_data.data()), dst_data.size());
|
|
dst.call<void>("set", memoryView);
|
|
#else
|
|
if (!dst_data.empty())
|
|
{
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // 'dst' is a JS Uint8Array
|
|
}
|
|
#endif
|
|
|
|
return status;
|
|
}
|
|
|
|
// Like transcodeImage(), but with updated parameters.
|
|
// For flags, see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImageWithFlags(const emscripten::val& dst, uint32_t image_index, uint32_t level_index, uint32_t format, uint32_t flags)
|
|
{
|
|
assert(m_magic == BASIS_MAGIC);
|
|
if (m_magic != BASIS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
uint32_t orig_width, orig_height, total_src_blocks;
|
|
if (!m_transcoder.get_image_level_desc(m_file.data(), m_file.size(), image_index, level_index, orig_width, orig_height, total_src_blocks))
|
|
return 0;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(image_index, level_index, format);
|
|
|
|
if (!dst_data.try_resize(transcoded_size_in_bytes))
|
|
return 0;
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
status = m_transcoder.transcode_image_level(
|
|
m_file.data(), m_file.size(), image_index, level_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
nullptr,
|
|
orig_height);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
m_file.data(), m_file.size(), image_index, level_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
static_cast<basist::transcoder_texture_format>(format),
|
|
flags);
|
|
}
|
|
|
|
#if 0
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = emscripten::val::global("Uint8Array").new_(memory, reinterpret_cast<uintptr_t>(dst_data.data()), dst_data.size());
|
|
dst.call<void>("set", memoryView);
|
|
#else
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // 'dst' is a JS Uint8Array
|
|
#endif
|
|
|
|
return status;
|
|
}
|
|
};
|
|
|
|
#if BASISD_SUPPORT_KTX2
|
|
struct ktx2_header_js
|
|
{
|
|
uint32_t m_vk_format;
|
|
uint32_t m_type_size;
|
|
uint32_t m_pixel_width;
|
|
uint32_t m_pixel_height;
|
|
uint32_t m_pixel_depth;
|
|
uint32_t m_layer_count;
|
|
uint32_t m_face_count;
|
|
uint32_t m_level_count;
|
|
uint32_t m_supercompression_scheme;
|
|
uint32_t m_dfd_byte_offset;
|
|
uint32_t m_dfd_byte_length;
|
|
uint32_t m_kvd_byte_offset;
|
|
uint32_t m_kvd_byte_length;
|
|
uint32_t m_sgd_byte_offset;
|
|
uint32_t m_sgd_byte_length;
|
|
};
|
|
|
|
struct ktx2_file
|
|
{
|
|
int m_magic = 0;
|
|
basist::ktx2_transcoder m_transcoder;
|
|
basisu::vector<uint8_t> m_file;
|
|
bool m_is_valid = false;
|
|
|
|
ktx2_file(const emscripten::val& jsBuffer)
|
|
: m_file(jsBuffer["byteLength"].as<size_t>())
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_file::basis_file: Must call basis_init() first!\n");
|
|
#endif
|
|
assert(0);
|
|
return;
|
|
}
|
|
|
|
#if 0
|
|
unsigned int length = jsBuffer["length"].as<unsigned int>();
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = jsBuffer["constructor"].new_(memory, reinterpret_cast<uintptr_t>(m_file.data()), length);
|
|
memoryView.call<void>("set", jsBuffer);
|
|
#else
|
|
const size_t n = jsBuffer["byteLength"].as<size_t>();
|
|
emscripten::val dstView = emscripten::val(emscripten::typed_memory_view(n, m_file.data()));
|
|
dstView.call<void>("set", jsBuffer);
|
|
#endif
|
|
|
|
if (!m_transcoder.init(m_file.data(), m_file.size()))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("m_transcoder.init() failed!\n");
|
|
#endif
|
|
assert(0);
|
|
|
|
m_file.clear();
|
|
}
|
|
|
|
m_is_valid = true;
|
|
|
|
// Initialized after validation
|
|
m_magic = KTX2_MAGIC;
|
|
}
|
|
|
|
bool isValid()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
|
|
return m_is_valid;
|
|
}
|
|
|
|
void close()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return;
|
|
|
|
m_file.clear();
|
|
m_transcoder.clear();
|
|
}
|
|
|
|
uint32_t getDFDSize()
|
|
{
|
|
return m_transcoder.get_dfd().size();
|
|
}
|
|
|
|
uint32_t getDFD(const emscripten::val& dst)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
const uint8_vec &dst_data = m_transcoder.get_dfd();
|
|
|
|
if (dst_data.size())
|
|
return copy_to_jsbuffer(dst, dst_data);
|
|
|
|
return 1;
|
|
}
|
|
|
|
ktx2_header_js getHeader()
|
|
{
|
|
ktx2_header_js hdr;
|
|
memset(&hdr, 0, sizeof(hdr));
|
|
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return hdr;
|
|
|
|
const basist::ktx2_header& h = m_transcoder.get_header();
|
|
|
|
if ((h.m_sgd_byte_offset.get_uint64() > UINT32_MAX) || (h.m_sgd_byte_length.get_uint64() > UINT32_MAX))
|
|
{
|
|
// File is too large to handle with 32-bit WASM.
|
|
// (emscripten doesn't support binding uint64_t for some reason.)
|
|
assert(0);
|
|
return hdr;
|
|
}
|
|
|
|
hdr.m_vk_format = h.m_vk_format;
|
|
hdr.m_type_size = h.m_type_size;
|
|
hdr.m_pixel_width = h.m_pixel_width;
|
|
hdr.m_pixel_height = h.m_pixel_height;
|
|
hdr.m_pixel_depth = h.m_pixel_depth;
|
|
hdr.m_layer_count = h.m_layer_count;
|
|
hdr.m_face_count = h.m_face_count;
|
|
hdr.m_level_count = h.m_level_count;
|
|
hdr.m_supercompression_scheme = h.m_supercompression_scheme;
|
|
hdr.m_dfd_byte_offset = h.m_dfd_byte_offset;
|
|
hdr.m_dfd_byte_length = h.m_dfd_byte_length;
|
|
hdr.m_kvd_byte_offset = h.m_kvd_byte_offset;
|
|
hdr.m_kvd_byte_length = h.m_kvd_byte_length;
|
|
|
|
hdr.m_sgd_byte_offset = static_cast<uint32_t>(h.m_sgd_byte_offset.get_uint64());
|
|
hdr.m_sgd_byte_length = static_cast<uint32_t>(h.m_sgd_byte_length.get_uint64());
|
|
|
|
return hdr;
|
|
}
|
|
|
|
bool hasKey(std::string key_name)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
|
|
return m_transcoder.find_key(key_name) != nullptr;
|
|
}
|
|
|
|
uint32_t getTotalKeys()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.get_key_values().size();
|
|
}
|
|
|
|
std::string getKey(uint32_t index)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return std::string("");
|
|
|
|
return std::string((const char*)m_transcoder.get_key_values()[index].m_key.data());
|
|
}
|
|
|
|
uint32_t getKeyValueSize(std::string key_name)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
const uint8_vec* p = m_transcoder.find_key(key_name);
|
|
return p ? p->size() : 0;
|
|
}
|
|
|
|
uint32_t getKeyValue(std::string key_name, const emscripten::val& dst)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
const uint8_vec* p = m_transcoder.find_key(key_name);
|
|
if (!p)
|
|
return 0;
|
|
|
|
if (p->size())
|
|
return copy_to_jsbuffer(dst, *p);
|
|
|
|
return 1;
|
|
}
|
|
|
|
// The image's original width, i.e. before being potentially expanded up to blocks.
|
|
uint32_t getWidth()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_width();
|
|
}
|
|
|
|
// The image's original height, i.e. before being potentially expanded up to blocks.
|
|
uint32_t getHeight()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_height();
|
|
}
|
|
|
|
// 4-12
|
|
uint32_t getBlockWidth()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_block_width();
|
|
}
|
|
|
|
// 4-12
|
|
uint32_t getBlockHeight()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_block_height();
|
|
}
|
|
|
|
// 2D or cubemaps
|
|
uint32_t getFaces()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_faces();
|
|
}
|
|
|
|
// Layers for tex arrays
|
|
uint32_t getLayers()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_layers();
|
|
}
|
|
|
|
// Mip-map levels
|
|
uint32_t getLevels()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_levels();
|
|
}
|
|
|
|
// Returns a basis_tex_format: cETC1S, cUASTC_LDR_4x4, or cUASTC_HDR_4x4, etc. - see basisu_file_headers.h
|
|
uint32_t getBasisTexFormat()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return (uint32_t)m_transcoder.get_basis_tex_format();
|
|
}
|
|
|
|
// Returns true if the texture is UASTC LDR 4x4 (and not HDR - see isHDR()).
|
|
bool isUASTC_LDR_4x4()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_uastc();
|
|
}
|
|
|
|
// Returns true if the texture is UASTC LDR 4x4 (and not HDR - see isHDR()).
|
|
bool isUASTC()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_uastc();
|
|
}
|
|
|
|
bool isLDR()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return !m_transcoder.is_hdr();
|
|
}
|
|
|
|
bool isETC1S()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_etc1s();
|
|
}
|
|
|
|
// Returns true if the texture is UASTC HDR or ASTC HDR. In this case, it can only be transcoded to BC6H, ASTC HDR (of the same block dimensions), RGB9E5 or half-float RGB/RGBA images.
|
|
bool isHDR()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_hdr();
|
|
}
|
|
|
|
bool isHDR4x4()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_hdr_4x4();
|
|
}
|
|
|
|
bool isHDR6x6()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_hdr_6x6();
|
|
}
|
|
|
|
bool isASTC_LDR()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_astc_ldr();
|
|
}
|
|
|
|
bool isXUASTC_LDR()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_xuastc_ldr();
|
|
}
|
|
|
|
bool isXUBC7()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_xubc7();
|
|
}
|
|
|
|
bool getHasAlpha()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return false;
|
|
return m_transcoder.get_has_alpha();
|
|
}
|
|
|
|
uint32_t getDFDColorModel()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_color_model();
|
|
}
|
|
|
|
uint32_t getDFDColorPrimaries()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_color_primaries();
|
|
}
|
|
|
|
uint32_t getDFDTransferFunc()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_transfer_func();
|
|
}
|
|
|
|
bool isSRGB()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.is_srgb();
|
|
}
|
|
|
|
uint32_t getDFDFlags()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_flags();
|
|
}
|
|
|
|
uint32_t getDFDTotalSamples()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_total_samples();
|
|
}
|
|
|
|
uint32_t getDFDChannelID0()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_channel_id0();
|
|
}
|
|
|
|
uint32_t getDFDChannelID1()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_dfd_channel_id1();
|
|
}
|
|
|
|
// isVideo() will return true if there was a KTXanimData key, or if (after calling start_transcoding()) there were any P-frames on ETC1S files.
|
|
bool isVideo()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.is_video();
|
|
}
|
|
|
|
// The linear light LDR->HDR upconversion multiplier used (def=100.0 nits)
|
|
float getLDRHDRUpconversionNitMultiplier()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_ldr_hdr_upconversion_nit_multiplier();
|
|
}
|
|
|
|
uint32_t getDeblockingFilterIndex()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_deblocking_filter_index();
|
|
}
|
|
|
|
// startTranscoding() must be called before calling getETC1SImageDescImageFlags().
|
|
uint32_t getETC1SImageDescImageFlags(uint32_t level_index, uint32_t layer_index, uint32_t face_index)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.get_etc1s_image_descs_image_flags(level_index, layer_index, face_index);
|
|
}
|
|
|
|
ktx2_image_level_info getImageLevelInfo(uint32_t level_index, uint32_t layer_index, uint32_t face_index)
|
|
{
|
|
ktx2_image_level_info info;
|
|
memset(&info, 0, sizeof(info));
|
|
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return info;
|
|
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
{
|
|
assert(0);
|
|
return info;
|
|
}
|
|
|
|
return info;
|
|
}
|
|
|
|
// format is transcoder_texture_format
|
|
uint32_t getImageTranscodedSizeInBytes(uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
const transcoder_texture_format tex_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
return basis_compute_transcoded_image_size_in_bytes(tex_format, info.m_orig_width, info.m_orig_height);
|
|
}
|
|
|
|
// Must be called before transcodeImage() can be called.
|
|
// On ETC1S files this method decompresses the ETC1S global data, along with fetching the ETC1S image desc array, so it's not free to call.
|
|
uint32_t startTranscoding()
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.start_transcoding();
|
|
}
|
|
|
|
// Here for backwards compat, prefer transcodeImageWithFlags().
|
|
// get_alpha_for_opaque_formats defaults to false
|
|
// channel0/channel1 default to -1
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImage(const emscripten::val& dst, uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format, uint32_t get_alpha_for_opaque_formats, int channel0, int channel1)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
const uint32_t dst_block_width = basis_get_block_width(transcoder_format);
|
|
const uint32_t dst_block_height = basis_get_block_height(transcoder_format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
return 0;
|
|
|
|
uint32_t orig_width = info.m_orig_width, orig_height = info.m_orig_height, total_src_blocks = info.m_total_blocks;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
uint32_t flags = get_alpha_for_opaque_formats ? cDecodeFlagsTranscodeAlphaDataToOpaqueFormats : 0;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(level_index, layer_index, face_index, format);
|
|
|
|
if (!dst_data.try_resize(transcoded_size_in_bytes))
|
|
return 0;
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
orig_height,
|
|
channel0, channel1,
|
|
nullptr);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
static_cast<basist::transcoder_texture_format>(format),
|
|
flags,
|
|
0,
|
|
0,
|
|
channel0, channel1,
|
|
nullptr);
|
|
}
|
|
|
|
#if 0
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = emscripten::val::global("Uint8Array").new_(memory, reinterpret_cast<uintptr_t>(dst_data.data()), dst_data.size());
|
|
dst.call<void>("set", memoryView);
|
|
#else
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // 'dst' must be a Uint8Array (or compatible TypedArray)
|
|
#endif
|
|
|
|
return status;
|
|
}
|
|
|
|
// like transcodeImage(), but with fixed parameters (includes flags)
|
|
// For flags, see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImageWithFlags(const emscripten::val& dst, uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format, uint32_t flags, int channel0, int channel1)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
const uint32_t dst_block_width = basis_get_block_width(transcoder_format);
|
|
const uint32_t dst_block_height = basis_get_block_height(transcoder_format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
return 0;
|
|
|
|
uint32_t orig_width = info.m_orig_width, orig_height = info.m_orig_height, total_src_blocks = info.m_total_blocks;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(level_index, layer_index, face_index, format);
|
|
|
|
dst_data.resize(transcoded_size_in_bytes);
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
orig_height,
|
|
channel0, channel1,
|
|
nullptr);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
static_cast<basist::transcoder_texture_format>(format),
|
|
flags,
|
|
0,
|
|
0,
|
|
channel0, channel1,
|
|
nullptr);
|
|
}
|
|
|
|
#if 0
|
|
emscripten::val memory = emscripten::val::module_property("HEAP8")["buffer"];
|
|
emscripten::val memoryView = emscripten::val::global("Uint8Array").new_(memory, reinterpret_cast<uintptr_t>(dst_data.data()), dst_data.size());
|
|
dst.call<void>("set", memoryView);
|
|
#else
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // dst = JS Uint8Array
|
|
#endif
|
|
|
|
return status;
|
|
}
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
// Internal buffer holding the most recent exportToDDS()/exportToKTX() result.
|
|
basisu::vector<uint8_t> m_export_data;
|
|
|
|
// Transcodes this KTX2 file's entire contents (every mip level, array layer,
|
|
// and cubemap face) to the given transcoder_texture_format and builds a .DDS
|
|
// file in memory. 'format' must be a DDS-writable BC format (BC1/BC3/BC4/BC5/
|
|
// BC6H/BC7) or uncompressed RGBA32; anything else fails. Returns the size in
|
|
// bytes of the generated .DDS (0 on failure); then call getDDSData() to copy
|
|
// the bytes out into a JS Uint8Array.
|
|
// NOTE: only available in the encoder build (basis_encoder*.js) -- it relies on
|
|
// the encoder library (basisu_gpu_texture.cpp), which the transcoder-only build
|
|
// (basis_transcoder.js) does not link.
|
|
// srgb_mode: -1 = auto (follow the KTX2's transfer function via is_srgb()),
|
|
// 0 = force linear/UNORM, 1 = force sRGB. Ignored for formats with no sRGB variant.
|
|
// decode_flags is a cDecodeFlags* bitmask passed to transcode_image_level()
|
|
// (e.g. force/disable deblocking, high quality); pass 0 for default behavior.
|
|
uint32_t exportToDDS(uint32_t format, int srgb_mode = -1, uint32_t decode_flags = 0)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
m_export_data.clear();
|
|
|
|
if (format >= (uint32_t)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format fmt = static_cast<transcoder_texture_format>(format);
|
|
|
|
if (!basisu::transcode_ktx2_to_dds(m_transcoder, fmt, m_export_data, srgb_mode, decode_flags))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("ktx2_file::exportToDDS: transcode_ktx2_to_dds() failed\n");
|
|
#endif
|
|
m_export_data.clear();
|
|
return 0;
|
|
}
|
|
|
|
return (uint32_t)m_export_data.size();
|
|
}
|
|
|
|
// Like exportToDDS(), but builds a COMPRESSED KTX1 (.ktx) file instead. 'format'
|
|
// must be a compressed format the KTX writer supports (BC1-7, ETC1/ETC2, ETC2 EAC
|
|
// R11/RG11, PVRTC1, PVRTC2, ASTC LDR/HDR, UASTC); uncompressed is not supported.
|
|
// srgb_mode/decode_flags are as for exportToDDS() (srgb_mode only affects ASTC
|
|
// LDR output here). Returns the size in bytes (0 on failure); then call
|
|
// getKTXData() to copy the bytes out. Encoder build only.
|
|
uint32_t exportToKTX(uint32_t format, int srgb_mode = -1, uint32_t decode_flags = 0)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
m_export_data.clear();
|
|
|
|
if (format >= (uint32_t)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format fmt = static_cast<transcoder_texture_format>(format);
|
|
|
|
if (!basisu::transcode_ktx2_to_ktx(m_transcoder, fmt, m_export_data, srgb_mode, decode_flags))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("ktx2_file::exportToKTX: transcode_ktx2_to_ktx() failed\n");
|
|
#endif
|
|
m_export_data.clear();
|
|
return 0;
|
|
}
|
|
|
|
return (uint32_t)m_export_data.size();
|
|
}
|
|
|
|
// Copies the bytes produced by the last successful exportToDDS()/exportToKTX()
|
|
// into the caller-provided JS Uint8Array (which must be at least the returned
|
|
// size). Returns nonzero on success, 0 on failure.
|
|
uint32_t getDDSData(const emscripten::val& dst)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
if (m_export_data.empty())
|
|
return 0;
|
|
|
|
return copy_to_jsbuffer(dst, m_export_data);
|
|
}
|
|
|
|
// Identical to getDDSData() (both copy out the last export's bytes); provided as
|
|
// a parallel name to pair with exportToKTX().
|
|
uint32_t getKTXData(const emscripten::val& dst)
|
|
{
|
|
assert(m_magic == KTX2_MAGIC);
|
|
if (m_magic != KTX2_MAGIC)
|
|
return 0;
|
|
|
|
if (m_export_data.empty())
|
|
return 0;
|
|
|
|
return copy_to_jsbuffer(dst, m_export_data);
|
|
}
|
|
#endif // BASISU_SUPPORT_ENCODING
|
|
|
|
};
|
|
|
|
// DDS source transcoder wrapper. New functionality (we read/transcode a .DDS file as a SOURCE);
|
|
// this does not replace the KTX2->DDS export path above (exportToDDS()).
|
|
//
|
|
// basist::dds_transcoder is self-contained in the transcoder library and does not require the
|
|
// encoder. It deliberately mirrors ktx2_transcoder's API, including reusing the same
|
|
// ktx2_image_level_info struct -- so this wrapper is a near-copy of ktx2_file with the KTX2-only
|
|
// DFD/key/header machinery removed and a few DDS-specific accessors added.
|
|
//
|
|
// It lives inside the BASISD_SUPPORT_KTX2 block because it reuses the KTX2ImageLevelInfo
|
|
// value_object (registered only when KTX2 support is enabled). KTX2 support is always on in the
|
|
// webgl builds, so this coupling is purely about not duplicating the level-info binding.
|
|
struct dds_file
|
|
{
|
|
int m_magic = 0;
|
|
basist::dds_transcoder m_transcoder;
|
|
basisu::vector<uint8_t> m_file;
|
|
bool m_is_valid = false;
|
|
|
|
dds_file(const emscripten::val& jsBuffer)
|
|
: m_file(jsBuffer["byteLength"].as<size_t>())
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("dds_file::dds_file: Must call basis_init() first!\n");
|
|
#endif
|
|
assert(0);
|
|
return;
|
|
}
|
|
|
|
const size_t n = jsBuffer["byteLength"].as<size_t>();
|
|
emscripten::val dstView = emscripten::val(emscripten::typed_memory_view(n, m_file.data()));
|
|
dstView.call<void>("set", jsBuffer);
|
|
|
|
if (!m_transcoder.init(m_file.data(), (uint32_t)m_file.size()))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("dds_file: m_transcoder.init() failed!\n");
|
|
#endif
|
|
// Note: a bad .DDS is an expected runtime condition (not an internal bug), so no assert here.
|
|
m_file.clear();
|
|
m_magic = DDS_MAGIC;
|
|
return;
|
|
}
|
|
|
|
m_is_valid = true;
|
|
m_magic = DDS_MAGIC;
|
|
}
|
|
|
|
bool isValid()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return false;
|
|
return m_is_valid && m_transcoder.is_valid();
|
|
}
|
|
|
|
void close()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return;
|
|
m_file.clear();
|
|
m_transcoder.clear();
|
|
m_is_valid = false;
|
|
}
|
|
|
|
// The image's original width, i.e. before being potentially expanded up to blocks.
|
|
uint32_t getWidth()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_width();
|
|
}
|
|
|
|
// The image's original height, i.e. before being potentially expanded up to blocks.
|
|
uint32_t getHeight()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_height();
|
|
}
|
|
|
|
// Mip-map levels (>=1)
|
|
uint32_t getLevels()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_levels();
|
|
}
|
|
|
|
// Array elements; 0 == not an array (ktx2 convention)
|
|
uint32_t getLayers()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_layers();
|
|
}
|
|
|
|
// 6 == cubemap, else 1
|
|
uint32_t getFaces()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return m_transcoder.get_faces();
|
|
}
|
|
|
|
bool getIsCubemap()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return false;
|
|
return m_transcoder.get_is_cubemap();
|
|
}
|
|
|
|
// Format-declared alpha presence (NOT a scan of the pixel data). See dds_transcoder::get_has_alpha().
|
|
bool getHasAlpha()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return false;
|
|
return m_transcoder.get_has_alpha() != 0;
|
|
}
|
|
|
|
bool isSRGB()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return false;
|
|
return m_transcoder.is_srgb();
|
|
}
|
|
|
|
// The format physically contained in the DDS, expressed as a transcoder_texture_format
|
|
// (e.g. cTFBC7_RGBA). This is what a passthrough transcode emits.
|
|
uint32_t getFormat()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return (uint32_t)m_transcoder.get_format();
|
|
}
|
|
|
|
// The EXACT physical format stored in the file (a basist::dds_format value). More specific than
|
|
// getFormat()/getSourceKind() -- distinguishes A8R8G8B8 vs X8R8G8B8, R5G6B5 vs A1R5G5B5, etc.
|
|
uint32_t getDDSFormat()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return (uint32_t)m_transcoder.get_dds_format();
|
|
}
|
|
|
|
// What's physically stored in the file (a dds_transcoder::source_kind value: compressed block kind
|
|
// or generic uncompressed).
|
|
uint32_t getSourceKind()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
return (uint32_t)m_transcoder.get_source_kind();
|
|
}
|
|
|
|
// True if this DDS's contents can be transcoded to format (a transcoder_texture_format).
|
|
bool isTranscodeFormatSupported(uint32_t format)
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return false;
|
|
if (format >= (uint32_t)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return false;
|
|
return m_transcoder.is_transcode_format_supported(static_cast<transcoder_texture_format>(format));
|
|
}
|
|
|
|
ktx2_image_level_info getImageLevelInfo(uint32_t level_index, uint32_t layer_index, uint32_t face_index)
|
|
{
|
|
ktx2_image_level_info info;
|
|
memset(&info, 0, sizeof(info));
|
|
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return info;
|
|
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
{
|
|
assert(0);
|
|
return info;
|
|
}
|
|
|
|
return info;
|
|
}
|
|
|
|
// format is transcoder_texture_format
|
|
uint32_t getImageTranscodedSizeInBytes(uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format)
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
const transcoder_texture_format tex_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
{
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
return basis_compute_transcoded_image_size_in_bytes(tex_format, info.m_orig_width, info.m_orig_height);
|
|
}
|
|
|
|
// Must be called before transcodeImage() can be called. For DDS there are no global tables to
|
|
// unpack, so this just verifies init() succeeded. Safe to call repeatedly.
|
|
uint32_t startTranscoding()
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
|
|
return m_transcoder.start_transcoding();
|
|
}
|
|
|
|
// Here for parity with KTX2File; prefer transcodeImageWithFlags().
|
|
// get_alpha_for_opaque_formats defaults to false; channel0/channel1 default to -1.
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImage(const emscripten::val& dst, uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format, uint32_t get_alpha_for_opaque_formats, int channel0, int channel1)
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
return 0;
|
|
|
|
uint32_t orig_width = info.m_orig_width, orig_height = info.m_orig_height;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
uint32_t flags = get_alpha_for_opaque_formats ? cDecodeFlagsTranscodeAlphaDataToOpaqueFormats : 0;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(level_index, layer_index, face_index, format);
|
|
|
|
if (!dst_data.try_resize(transcoded_size_in_bytes))
|
|
return 0;
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
// dds_transcoder::transcode_image_level() has no trailing ktx2_transcoder_state* (DDS has no per-thread state).
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
orig_height,
|
|
channel0, channel1);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
transcoder_format,
|
|
flags,
|
|
0,
|
|
0,
|
|
channel0, channel1);
|
|
}
|
|
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // 'dst' must be a Uint8Array (or compatible TypedArray)
|
|
|
|
return status;
|
|
}
|
|
|
|
// like transcodeImage(), but takes an explicit cDecodeFlags* bitmask.
|
|
// format is transcoder_texture_format
|
|
uint32_t transcodeImageWithFlags(const emscripten::val& dst, uint32_t level_index, uint32_t layer_index, uint32_t face_index, uint32_t format, uint32_t flags, int channel0, int channel1)
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return 0;
|
|
|
|
if (format >= (int)transcoder_texture_format::cTFTotalTextureFormats)
|
|
return 0;
|
|
|
|
const transcoder_texture_format transcoder_format = static_cast<transcoder_texture_format>(format);
|
|
|
|
ktx2_image_level_info info;
|
|
if (!m_transcoder.get_image_level_info(info, level_index, layer_index, face_index))
|
|
return 0;
|
|
|
|
uint32_t orig_width = info.m_orig_width, orig_height = info.m_orig_height;
|
|
|
|
basisu::vector<uint8_t> dst_data;
|
|
|
|
const uint32_t transcoded_size_in_bytes = getImageTranscodedSizeInBytes(level_index, layer_index, face_index, format);
|
|
|
|
if (!dst_data.try_resize(transcoded_size_in_bytes))
|
|
return 0;
|
|
|
|
uint32_t status;
|
|
|
|
if (basis_transcoder_format_is_uncompressed(transcoder_format))
|
|
{
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), orig_width * orig_height,
|
|
transcoder_format,
|
|
flags,
|
|
orig_width,
|
|
orig_height,
|
|
channel0, channel1);
|
|
}
|
|
else
|
|
{
|
|
const uint32_t bytes_per_block = basis_get_bytes_per_block_or_pixel(transcoder_format);
|
|
|
|
status = m_transcoder.transcode_image_level(
|
|
level_index, layer_index, face_index,
|
|
dst_data.data(), dst_data.size() / bytes_per_block,
|
|
transcoder_format,
|
|
flags,
|
|
0,
|
|
0,
|
|
channel0, channel1);
|
|
}
|
|
|
|
const size_t n = dst_data.size();
|
|
emscripten::val srcView = emscripten::val(emscripten::typed_memory_view(n, dst_data.data()));
|
|
dst.call<void>("set", srcView); // dst = JS Uint8Array
|
|
|
|
return status;
|
|
}
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
// Human-readable name for a basist::dds_format value. Encoder build only:
|
|
// basisu::get_dds_format_string() lives in the encoder library (basisu_gpu_texture.cpp), which the
|
|
// transcoder-only build (basis_transcoder.js) does not link. Transcoder-only callers can map the
|
|
// dds_format enum to a name in JS instead.
|
|
std::string getDDSFormatString(uint32_t format)
|
|
{
|
|
assert(m_magic == DDS_MAGIC);
|
|
if (m_magic != DDS_MAGIC)
|
|
return std::string("");
|
|
if (format >= (uint32_t)basist::dds_format::cTotalDDSFormats)
|
|
return std::string("?");
|
|
return std::string(basisu::get_dds_format_string(static_cast<basist::dds_format>(format)));
|
|
}
|
|
#endif // BASISU_SUPPORT_ENCODING
|
|
};
|
|
#endif // BASISD_SUPPORT_KTX2
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
|
|
enum class ldr_image_type
|
|
{
|
|
cRGBA32 = 0,
|
|
cPNGImage = 1,
|
|
cJPGImage = 2,
|
|
cQOIImage = 3
|
|
};
|
|
|
|
enum xuastc_ldr_syntax
|
|
{
|
|
cFullArith = (int)basist::astc_ldr_t::xuastc_ldr_syntax::cFullArith,
|
|
cHybridArithZStd = (int)basist::astc_ldr_t::xuastc_ldr_syntax::cHybridArithZStd,
|
|
cFullZStd = (int)basist::astc_ldr_t::xuastc_ldr_syntax::cFullZStd,
|
|
cTotal = 3
|
|
};
|
|
|
|
class basis_encoder
|
|
{
|
|
bool m_threading_enabled = false;
|
|
uint32_t m_num_extra_worker_threads = 0;
|
|
float m_last_encode_mip0_rgba_psnr = 0.0f;
|
|
|
|
public:
|
|
basis_compressor_params m_params;
|
|
|
|
// DDS export options (format + BC7 packer knobs) consumed by encode_to_dds(). Independent of m_params.
|
|
dds_export_params m_dds_params;
|
|
|
|
basis_encoder()
|
|
{
|
|
}
|
|
|
|
void control_threading(bool enabled_flag, uint32_t num_extra_worker_threads)
|
|
{
|
|
m_threading_enabled = enabled_flag;
|
|
m_num_extra_worker_threads = num_extra_worker_threads;
|
|
}
|
|
|
|
// Only valid for LDR inputs.
|
|
bool set_slice_source_image(uint32_t slice_index, const emscripten::val& src_image_js_val, uint32_t src_image_width, uint32_t src_image_height, ldr_image_type img_type)
|
|
{
|
|
// Resize the source_images array if necessary
|
|
if (slice_index >= m_params.m_source_images.size())
|
|
m_params.m_source_images.resize(slice_index + 1);
|
|
|
|
// First copy the src image buffer to the heap.
|
|
basisu::vector<uint8_t> src_image_buf;
|
|
if (!copy_from_jsbuffer(src_image_js_val, src_image_buf))
|
|
return false;
|
|
|
|
// Now load the source image.
|
|
image& src_img = m_params.m_source_images[slice_index];
|
|
if (img_type == ldr_image_type::cPNGImage)
|
|
{
|
|
// It's a PNG file, so try and parse it.
|
|
if (!load_png(src_image_buf.data(), src_image_buf.size(), src_img, nullptr))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::set_slice_source_image: Failed parsing provided PNG file!\n");
|
|
#endif
|
|
return false;
|
|
}
|
|
|
|
src_image_width = src_img.get_width();
|
|
src_image_height = src_img.get_height();
|
|
}
|
|
else if (img_type == ldr_image_type::cJPGImage)
|
|
{
|
|
// It's a JPG file, so try and parse it.
|
|
if (!load_jpg(src_image_buf.data(), src_image_buf.size(), src_img))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::set_slice_source_image: Failed parsing provided JPG file!\n");
|
|
#endif
|
|
return false;
|
|
}
|
|
|
|
src_image_width = src_img.get_width();
|
|
src_image_height = src_img.get_height();
|
|
}
|
|
else if (img_type == ldr_image_type::cQOIImage)
|
|
{
|
|
// It's a QOI file, so try and parse it.
|
|
if (!load_qoi(src_image_buf.data(), src_image_buf.size(), src_img))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::set_slice_source_image: Failed parsing provided QOI file!\n");
|
|
#endif
|
|
return false;
|
|
}
|
|
|
|
src_image_width = src_img.get_width();
|
|
src_image_height = src_img.get_height();
|
|
}
|
|
else if (img_type == ldr_image_type::cRGBA32)
|
|
{
|
|
// It's a raw image, so check the buffer's size.
|
|
if (src_image_buf.size() != src_image_width * src_image_height * sizeof(uint32_t))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::set_slice_source_image: Provided source buffer has an invalid size!\n");
|
|
#endif
|
|
return false;
|
|
}
|
|
|
|
// Copy the raw image's data into our source image.
|
|
src_img.resize(src_image_width, src_image_height);
|
|
memcpy(src_img.get_ptr(), src_image_buf.data(), src_image_width * src_image_height * sizeof(uint32_t));
|
|
}
|
|
else
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::set_slice_source_image: Invalid img_type parameter\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
// Accepts RGBA half float or RGBA float images, or .EXR, .HDR, .PNG, or .JPG file data.
|
|
bool set_slice_source_image_hdr(
|
|
uint32_t slice_index,
|
|
const emscripten::val& src_image_js_val,
|
|
uint32_t src_image_width, uint32_t src_image_height,
|
|
hdr_image_type img_type, bool ldr_srgb_to_linear_conversion, float ldr_to_hdr_nit_multiplier)
|
|
{
|
|
assert(ldr_to_hdr_nit_multiplier > 0.0f);
|
|
|
|
// Resize the source_images_hdr array if necessary
|
|
if (slice_index >= m_params.m_source_images_hdr.size())
|
|
m_params.m_source_images_hdr.resize(slice_index + 1);
|
|
|
|
// First copy the src image buffer to the heap.
|
|
basisu::vector<uint8_t> src_image_buf;
|
|
if (!copy_from_jsbuffer(src_image_js_val, src_image_buf))
|
|
return false;
|
|
|
|
// Now load the source image.
|
|
imagef& src_img = m_params.m_source_images_hdr[slice_index];
|
|
|
|
if (!load_image_hdr(src_image_buf.get_ptr(), src_image_buf.size(), src_img, src_image_width, src_image_height, img_type, ldr_srgb_to_linear_conversion, ldr_to_hdr_nit_multiplier))
|
|
return false;
|
|
|
|
if ((img_type == hdr_image_type::cHITPNGImage) || (img_type == hdr_image_type::cHITJPGImage) ||
|
|
(img_type == hdr_image_type::cHITQOIImage) || (img_type == hdr_image_type::cHITRGBA8Image))
|
|
{
|
|
// Because we're loading the image ourselves we need to add these tags so the UI knows how to tone map LDR upconverted outputs.
|
|
// Normally basis_compressor adds them when it loads the images itself from source files.
|
|
basist::add_key_value(m_params.m_key_values, "LDRUpconversionMultiplier", fmt_string("{}", ldr_to_hdr_nit_multiplier));
|
|
|
|
if (ldr_srgb_to_linear_conversion)
|
|
basist::add_key_value(m_params.m_key_values, "LDRUpconversionSRGBToLinear", "1");
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
uint32_t encode(const emscripten::val& dst_basis_file_js_val)
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::encode: Must call basis_init() first!\n");
|
|
#endif
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
// We don't use threading for now, but the compressor needs a job pool.
|
|
uint32_t num_new_threads = 0;
|
|
bool enable_threading = false;
|
|
|
|
#if WASM_THREADS_ENABLED
|
|
if ((emscripten_has_threading_support()) && (m_threading_enabled) && (m_num_extra_worker_threads))
|
|
{
|
|
enable_threading = true;
|
|
num_new_threads = m_num_extra_worker_threads;
|
|
}
|
|
#endif
|
|
|
|
// We always need a job pool, but making a job pool with just 1 thread doesn't actually create any additional helper threads (i.e. it always utilizes the main thread).
|
|
job_pool jpool(1 + num_new_threads);
|
|
|
|
// Initialize the compression parameters structure. This is the same structure that the command line tool fills in.
|
|
basis_compressor_params ¶ms = m_params;
|
|
|
|
// Check to see if we would risk running out of memory in 32-bit WASM. There's not much we can do about this limit until memory64 is available.
|
|
uint64_t total_src_texels = 0;
|
|
|
|
for (uint32_t i = 0; i < m_params.m_source_images.size(); i++)
|
|
total_src_texels += m_params.m_source_images[i].get_total_pixels();
|
|
|
|
for (uint32_t i = 0; i < m_params.m_source_images_hdr.size(); i++)
|
|
total_src_texels += m_params.m_source_images_hdr[i].get_total_pixels();
|
|
|
|
// Try to prevent running out of memory inside WASM.
|
|
uint32_t max_pixels_thresh = BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS;
|
|
|
|
// The simpler compressors need less temporary memory, so their threshold can be higher.
|
|
if (m_params.is_etc1s() || m_params.is_uastc_ldr_4x4() || m_params.is_uastc_hdr_4x4())
|
|
{
|
|
max_pixels_thresh = BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS_HIGHER_LIMIT;
|
|
}
|
|
|
|
if (total_src_texels > max_pixels_thresh)
|
|
{
|
|
printf("ERROR: basis_encoder::encode(): The total number of source texels to compress %llu is greater than %u, which is likely too large for WASM (above BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS in basis_wrappers.cpp).",
|
|
total_src_texels, max_pixels_thresh);
|
|
return 0;
|
|
}
|
|
|
|
params.m_pJob_pool = &jpool;
|
|
|
|
params.m_multithreading = enable_threading;
|
|
|
|
//params.m_status_output = params.m_debug;
|
|
|
|
params.m_read_source_images = false;
|
|
params.m_write_output_basis_or_ktx2_files = false;
|
|
|
|
basis_compressor comp;
|
|
|
|
if (!comp.init(params))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("Failed initializing BasisU compressor! One or more provided parameters may be invalid.\n");
|
|
#endif
|
|
return 0;
|
|
}
|
|
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("Begin BasisU compression\n");
|
|
#endif
|
|
|
|
basis_compressor::error_code ec = comp.process();
|
|
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("BasisU compression done, status %u, %u bytes\n", (uint32_t)ec, (uint32_t)comp.get_output_basis_file().size());
|
|
#endif
|
|
|
|
if (ec != basis_compressor::cECSuccess)
|
|
{
|
|
// Something failed during compression.
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("BasisU compression failed with status %u!\n", (uint32_t)ec);
|
|
#endif
|
|
return 0;
|
|
}
|
|
|
|
m_last_encode_mip0_rgba_psnr = 0.0f;
|
|
if (comp.get_stats().size())
|
|
{
|
|
// This is just for display: print the highest PSNR of either, because depending on the texture type (XUASTC, XUBC7, etc.) these will be in different transcoded formats.
|
|
float psnr = maximum(comp.get_stats()[0].m_basis_rgba_avg_psnr, comp.get_stats()[0].m_bc7_rgba_avg_psnr);
|
|
|
|
if (psnr == 0.0f)
|
|
psnr = comp.get_stats()[0].m_basis_rgb_avg_psnr; // HDR, not RGBA though
|
|
|
|
m_last_encode_mip0_rgba_psnr = psnr;
|
|
}
|
|
|
|
if (params.m_create_ktx2_file)
|
|
{
|
|
// Compression succeeded, so copy the .ktx2 file bytes to the caller's buffer.
|
|
if (!copy_to_jsbuffer(dst_basis_file_js_val, comp.get_output_ktx2_file()))
|
|
return 0;
|
|
|
|
// Return the file size of the .basis file in bytes.
|
|
return (uint32_t)comp.get_output_ktx2_file().size();
|
|
}
|
|
else
|
|
{
|
|
// Compression succeeded, so copy the .basis file bytes to the caller's buffer.
|
|
if (!copy_to_jsbuffer(dst_basis_file_js_val, comp.get_output_basis_file()))
|
|
return 0;
|
|
|
|
// Return the file size of the .basis file in bytes.
|
|
return (uint32_t)comp.get_output_basis_file().size();
|
|
}
|
|
}
|
|
|
|
// Encodes the provided source slice(s) directly to an in-memory DX10 .DDS file (NOT via KTX2).
|
|
// This is the high-quality, single-hop source->DDS path: it runs the compressor in
|
|
// process_source_images() mode (all the image loading/mipmap/array/cubemap prep, no GPU encode),
|
|
// then build_dds() packs the prepared slices into the format selected via setDDSFormat()/setDDS*().
|
|
// The DDS bytes are copied into the caller-provided buffer exactly like encode(); returns the
|
|
// file size in bytes (0 on failure). LDR only for now (HDR DDS export is a future addition).
|
|
uint32_t encode_to_dds(const emscripten::val& dst_dds_file_js_val)
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::encode_to_dds: Must call basis_init() first!\n");
|
|
#endif
|
|
assert(0);
|
|
return 0;
|
|
}
|
|
|
|
uint32_t num_new_threads = 0;
|
|
bool enable_threading = false;
|
|
|
|
#if WASM_THREADS_ENABLED
|
|
if ((emscripten_has_threading_support()) && (m_threading_enabled) && (m_num_extra_worker_threads))
|
|
{
|
|
enable_threading = true;
|
|
num_new_threads = m_num_extra_worker_threads;
|
|
}
|
|
#endif
|
|
|
|
job_pool jpool(1 + num_new_threads);
|
|
|
|
// NOTE: we alias m_params (like encode() does) rather than copy it, to avoid an expensive
|
|
// deep copy of the source images in 32-bit WASM. This permanently sets the format mode to
|
|
// the LDR prep path, which is consistent with how encode() permanently mutates m_params.
|
|
basis_compressor_params ¶ms = m_params;
|
|
|
|
// Same WASM out-of-memory guard as encode().
|
|
uint64_t total_src_texels = 0;
|
|
|
|
for (uint32_t i = 0; i < m_params.m_source_images.size(); i++)
|
|
total_src_texels += m_params.m_source_images[i].get_total_pixels();
|
|
|
|
for (uint32_t i = 0; i < m_params.m_source_images_hdr.size(); i++)
|
|
total_src_texels += m_params.m_source_images_hdr[i].get_total_pixels();
|
|
|
|
// DDS export only prepares the source images (no heavy GPU encode), so the higher limit applies.
|
|
uint32_t max_pixels_thresh = BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS_HIGHER_LIMIT;
|
|
|
|
if (total_src_texels > max_pixels_thresh)
|
|
{
|
|
printf("ERROR: basis_encoder::encode_to_dds(): The total number of source texels to prepare %llu is greater than %u, which is likely too large for WASM (above BASISU_ENCODER_MAX_SOURCE_IMAGE_PIXELS in basis_wrappers.cpp).",
|
|
total_src_texels, max_pixels_thresh);
|
|
return 0;
|
|
}
|
|
|
|
params.m_pJob_pool = &jpool;
|
|
params.m_multithreading = enable_threading;
|
|
params.m_read_source_images = false;
|
|
params.m_write_output_basis_or_ktx2_files = false;
|
|
|
|
// build_dds() consumes the prepared source slices, so drive the appropriate preparation path
|
|
// based on the input type: XUBC7 (LDR) for LDR inputs, UASTC_HDR_4x4 for HDR inputs. HDR DDS
|
|
// export is NOT implemented in build_dds() yet, so for HDR inputs the export below will fail
|
|
// for now - but selecting the HDR prep mode here means we're ready once an HDR build_dds()
|
|
// path (and HDR DDS formats) are added.
|
|
// We remember the caller's format mode and restore it after init() (which takes its own copy of
|
|
// params), so reusing this BasisEncoder for a later encode() isn't silently changed by our spoof.
|
|
const basist::basis_tex_format orig_format_mode = m_params.get_format_mode();
|
|
const bool is_hdr_input = !m_params.m_source_images_hdr.empty();
|
|
params.set_format_mode(is_hdr_input ? basist::basis_tex_format::cUASTC_HDR_4x4 : basist::basis_tex_format::cXUBC7);
|
|
|
|
basis_compressor comp;
|
|
|
|
const bool init_ok = comp.init(params);
|
|
|
|
// init() copied params, so restore the caller's format mode on m_params now (regardless of outcome).
|
|
params.set_format_mode(orig_format_mode);
|
|
|
|
if (!init_ok)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::encode_to_dds: Failed initializing BasisU compressor! One or more provided parameters may be invalid.\n");
|
|
#endif
|
|
return 0;
|
|
}
|
|
|
|
basis_compressor::error_code ec = comp.process_source_images();
|
|
|
|
if (ec != basis_compressor::cECSuccess)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::encode_to_dds: process_source_images() failed with status %u!\n", (uint32_t)ec);
|
|
#endif
|
|
return 0;
|
|
}
|
|
|
|
uint8_vec dds_data;
|
|
std::string error_msg;
|
|
if (!build_dds(dds_data, comp, m_dds_params, error_msg))
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("basis_encoder::encode_to_dds: build_dds() failed: %s\n", error_msg.c_str());
|
|
#endif
|
|
return 0;
|
|
}
|
|
|
|
// Copy the .dds file bytes to the caller's buffer (same mechanism as encode()).
|
|
if (!copy_to_jsbuffer(dst_dds_file_js_val, dds_data))
|
|
return 0;
|
|
|
|
return (uint32_t)dds_data.size();
|
|
}
|
|
|
|
float get_last_encode_mip0_rgba_psnr() const
|
|
{
|
|
return m_last_encode_mip0_rgba_psnr;
|
|
}
|
|
};
|
|
#endif
|
|
|
|
class lowlevel_etc1s_image_transcoder : public basisu_lowlevel_etc1s_transcoder
|
|
{
|
|
// Using our own transcoder state, for video support.
|
|
basisu_transcoder_state m_state;
|
|
|
|
public:
|
|
lowlevel_etc1s_image_transcoder()
|
|
{
|
|
}
|
|
|
|
bool decode_palettes(uint32_t num_endpoints, const emscripten::val& endpoint_data, uint32_t num_selectors, const emscripten::val& selector_data)
|
|
{
|
|
basisu::vector<uint8_t> temp_endpoint_data, temp_selector_data;
|
|
if (!copy_from_jsbuffer(endpoint_data, temp_endpoint_data))
|
|
return false;
|
|
if (!copy_from_jsbuffer(selector_data, temp_selector_data))
|
|
return false;
|
|
|
|
#if 0
|
|
printf("decode_palettes: %u %u %u %u, %u %u\n",
|
|
num_endpoints, (uint32_t)temp_endpoint_data.size(),
|
|
num_selectors, (uint32_t)temp_selector_data.size(),
|
|
temp_endpoint_data[0], temp_selector_data[0]);
|
|
#endif
|
|
|
|
if (!temp_endpoint_data.size() || !temp_selector_data.size())
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("decode_tables: endpoint_data and/or selector_data is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
return basisu_lowlevel_etc1s_transcoder::decode_palettes(num_endpoints, &temp_endpoint_data[0], (uint32_t)temp_endpoint_data.size(),
|
|
num_selectors, &temp_selector_data[0], (uint32_t)temp_selector_data.size());
|
|
}
|
|
|
|
bool decode_tables(const emscripten::val& table_data)
|
|
{
|
|
basisu::vector<uint8_t> temp_table_data;
|
|
if (!copy_from_jsbuffer(table_data, temp_table_data))
|
|
return false;
|
|
|
|
if (!temp_table_data.size())
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("decode_tables: table_data is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
return basisu_lowlevel_etc1s_transcoder::decode_tables(&temp_table_data[0], (uint32_t)temp_table_data.size());
|
|
}
|
|
|
|
bool transcode_image(
|
|
uint32_t target_format, // see transcoder_texture_format
|
|
const emscripten::val& output_blocks, uint32_t output_blocks_buf_size_in_blocks_or_pixels,
|
|
const emscripten::val& compressed_data,
|
|
uint32_t num_blocks_x, uint32_t num_blocks_y, uint32_t orig_width, uint32_t orig_height, uint32_t level_index,
|
|
uint32_t rgb_offset, uint32_t rgb_length, uint32_t alpha_offset, uint32_t alpha_length,
|
|
uint32_t decode_flags, // see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
bool basis_file_has_alpha_slices,
|
|
bool is_video,
|
|
uint32_t output_row_pitch_in_blocks_or_pixels,
|
|
uint32_t output_rows_in_pixels)
|
|
{
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("lowlevel_etc1s_image_transcoder::transcode_image: basis_init() must be called first\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
// FIXME: Access the JavaScript buffer directly vs. copying it.
|
|
basisu::vector<uint8_t> temp_comp_data;
|
|
if (!copy_from_jsbuffer(compressed_data, temp_comp_data))
|
|
return false;
|
|
|
|
if (!temp_comp_data.size())
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("lowlevel_etc1s_image_transcoder::transcode_image: compressed_data is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
uint32_t output_blocks_len = output_blocks["byteLength"].as<uint32_t>();
|
|
if (!output_blocks_len)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("lowlevel_etc1s_image_transcoder::transcode_image: output_blocks is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
basisu::vector<uint8_t> temp_output_blocks(output_blocks_len);
|
|
|
|
bool status = basisu_lowlevel_etc1s_transcoder::transcode_image(
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
num_blocks_x, num_blocks_y, orig_width, orig_height, level_index,
|
|
rgb_offset, rgb_length, alpha_offset, alpha_length,
|
|
decode_flags,
|
|
basis_file_has_alpha_slices,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
&m_state,
|
|
output_rows_in_pixels);
|
|
|
|
if (!status)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("lowlevel_etc1s_image_transcoder::transcode_image: basisu_lowlevel_etc1s_transcoder::transcode_image failed\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
if (!copy_to_jsbuffer(output_blocks, temp_output_blocks))
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
};
|
|
|
|
// Supports UASTC LDR 4x4, UASTC HDR 4x4, and ASTC HDR 6x6/intermediate (but not ETC1S).
|
|
bool transcode_uastc_image2(
|
|
uint32_t basis_tex_format_int, bool use_astc_srgb_decode_profile,
|
|
uint32_t target_format_int, // see transcoder_texture_format
|
|
const emscripten::val& output_blocks, uint32_t output_blocks_buf_size_in_blocks_or_pixels,
|
|
const emscripten::val& compressed_data,
|
|
uint32_t src_num_blocks_x, uint32_t src_num_blocks_y, uint32_t orig_width, uint32_t orig_height, uint32_t level_index,
|
|
uint32_t slice_offset, uint32_t slice_length,
|
|
uint32_t decode_flags, // see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
bool has_alpha,
|
|
bool is_video,
|
|
uint32_t output_row_pitch_in_blocks_or_pixels,
|
|
uint32_t output_rows_in_pixels,
|
|
int channel0, int channel1)
|
|
{
|
|
assert(basis_tex_format_int < (uint32_t)basis_tex_format::cTotalFormats);
|
|
assert(target_format_int < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
|
|
basis_tex_format src_tex_format = static_cast<basis_tex_format>(basis_tex_format_int);
|
|
transcoder_texture_format target_format = static_cast<transcoder_texture_format>(target_format_int);
|
|
|
|
if (!g_basis_initialized_flag)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("transcode_uastc_image2: basis_init() must be called first\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
// FIXME: Access the JavaScript buffer directly vs. copying it.
|
|
basisu::vector<uint8_t> temp_comp_data;
|
|
if (!copy_from_jsbuffer(compressed_data, temp_comp_data))
|
|
return false;
|
|
|
|
if (!temp_comp_data.size())
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("transcode_uastc_image2: compressed_data is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
uint32_t output_blocks_len = output_blocks["byteLength"].as<uint32_t>();
|
|
if (!output_blocks_len)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("transcode_uastc_image2: output_blocks is empty\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
#if 0
|
|
printf("format: %u\n", (uint32_t)target_format);
|
|
printf("output_blocks size: %u buf size: %u\n", output_blocks_len, output_blocks_buf_size_in_blocks_or_pixels);
|
|
printf("compressed_data size: %u\n", compressed_data["byteLength"].as<uint32_t>());
|
|
printf("%u %u %u %u %u\n", src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index);
|
|
printf("%u %u\n", slice_offset, slice_length);
|
|
printf("%u\n", decode_flags);
|
|
printf("has_alpha: %u is_video: %u\n", has_alpha, is_video);
|
|
#endif
|
|
|
|
basisu::vector<uint8_t> temp_output_blocks(output_blocks_len);
|
|
|
|
bool status = false;
|
|
if (basis_tex_format_is_xubc7(src_tex_format))
|
|
{
|
|
basisu_lowlevel_xubc7_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
src_tex_format,
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else if (basis_tex_format_is_astc_ldr(src_tex_format) || basis_tex_format_is_xuastc_ldr(src_tex_format))
|
|
{
|
|
basisu_lowlevel_xuastc_ldr_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
src_tex_format, use_astc_srgb_decode_profile,
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else if (src_tex_format == basis_tex_format::cUASTC_HDR_4x4)
|
|
{
|
|
basisu_lowlevel_uastc_hdr_4x4_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else if (src_tex_format == basis_tex_format::cASTC_HDR_6x6)
|
|
{
|
|
basisu_lowlevel_astc_hdr_6x6_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else if (src_tex_format == basis_tex_format::cUASTC_HDR_6x6_INTERMEDIATE)
|
|
{
|
|
basisu_lowlevel_uastc_hdr_6x6_intermediate_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else if (src_tex_format == basis_tex_format::cUASTC_LDR_4x4)
|
|
{
|
|
basisu_lowlevel_uastc_ldr_4x4_transcoder transcoder;
|
|
|
|
status = transcoder.transcode_image(
|
|
(transcoder_texture_format)target_format,
|
|
&temp_output_blocks[0], output_blocks_buf_size_in_blocks_or_pixels,
|
|
&temp_comp_data[0], temp_comp_data.size(),
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags,
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
nullptr,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
else
|
|
{
|
|
assert(0);
|
|
}
|
|
|
|
if (!status)
|
|
{
|
|
#if BASISU_DEBUG_PRINTF
|
|
printf("transcode_uastc_image2: basisu_lowlevel_uastc_transcoder::transcode_image failed\n");
|
|
#endif
|
|
assert(0);
|
|
return false;
|
|
}
|
|
|
|
if (!copy_to_jsbuffer(output_blocks, temp_output_blocks))
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
|
|
// Previous API - prefer transcode_uastc_image2(), which allows the caller to control the ASTC decode profile (srgb/linear) for XUASTC/ASTC.
|
|
bool transcode_uastc_image(
|
|
uint32_t basis_tex_format_int,
|
|
uint32_t target_format_int, // see transcoder_texture_format
|
|
const emscripten::val& output_blocks, uint32_t output_blocks_buf_size_in_blocks_or_pixels,
|
|
const emscripten::val& compressed_data,
|
|
uint32_t src_num_blocks_x, uint32_t src_num_blocks_y, uint32_t orig_width, uint32_t orig_height, uint32_t level_index,
|
|
uint32_t slice_offset, uint32_t slice_length,
|
|
uint32_t decode_flags, // see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
bool has_alpha,
|
|
bool is_video,
|
|
uint32_t output_row_pitch_in_blocks_or_pixels,
|
|
uint32_t output_rows_in_pixels,
|
|
int channel0, int channel1)
|
|
{
|
|
// Just assume sRGB decode profile - which is the compressor's default.
|
|
const bool use_astc_srgb_decode_profile = true;
|
|
|
|
return transcode_uastc_image2(
|
|
basis_tex_format_int, use_astc_srgb_decode_profile,
|
|
target_format_int, // see transcoder_texture_format
|
|
output_blocks, output_blocks_buf_size_in_blocks_or_pixels,
|
|
compressed_data,
|
|
src_num_blocks_x, src_num_blocks_y, orig_width, orig_height, level_index,
|
|
slice_offset, slice_length,
|
|
decode_flags, // see cDecodeFlagsPVRTCDecodeToNextPow2 etc.
|
|
has_alpha,
|
|
is_video,
|
|
output_row_pitch_in_blocks_or_pixels,
|
|
output_rows_in_pixels,
|
|
channel0, channel1);
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
uint32_t get_bytes_per_block_or_pixel(uint32_t transcoder_tex_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_get_bytes_per_block_or_pixel(static_cast<transcoder_texture_format>(transcoder_tex_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
bool format_has_alpha(uint32_t transcoder_tex_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_transcoder_format_has_alpha(static_cast<transcoder_texture_format>(transcoder_tex_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
bool format_is_hdr(uint32_t transcode_tex_fmt)
|
|
{
|
|
assert(transcode_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_transcoder_format_is_hdr(static_cast<transcoder_texture_format>(transcode_tex_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
bool format_is_ldr(uint32_t transcode_tex_fmt)
|
|
{
|
|
assert(transcode_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return !basis_transcoder_format_is_hdr(static_cast<transcoder_texture_format>(transcode_tex_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
bool format_is_uncompressed(uint32_t transcoder_tex_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_transcoder_format_is_uncompressed(static_cast<transcoder_texture_format>(transcoder_tex_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format, file_fmt is basis_tex_fmt
|
|
bool is_format_supported(uint32_t transcoder_tex_fmt, uint32_t file_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_is_format_supported(static_cast<transcoder_texture_format>(transcoder_tex_fmt), static_cast<basis_tex_format>(file_fmt));
|
|
}
|
|
|
|
// transcoder_tex_fmt is transcoder_texture_format
|
|
uint32_t get_format_block_width(uint32_t transcoder_tex_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_get_block_width(static_cast<transcoder_texture_format>(transcoder_tex_fmt));
|
|
}
|
|
|
|
// fmt is transcoder_texture_format
|
|
uint32_t get_format_block_height(uint32_t transcoder_tex_fmt)
|
|
{
|
|
assert(transcoder_tex_fmt < (uint32_t)transcoder_texture_format::cTFTotalTextureFormats);
|
|
return basis_get_block_height(static_cast<transcoder_texture_format>(transcoder_tex_fmt));
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
uint32_t get_basis_tex_format_block_width(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_get_block_width(static_cast<basis_tex_format>(file_fmt));
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
uint32_t get_basis_tex_format_block_height(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_get_block_height(static_cast<basis_tex_format>(file_fmt));
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
bool is_basis_tex_format_hdr(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_is_hdr((basis_tex_format)file_fmt);
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
bool is_basis_tex_format_ldr(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_is_ldr((basis_tex_format)file_fmt);
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
bool is_basis_tex_format_xuastc_ldr(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_is_xuastc_ldr((basis_tex_format)file_fmt);
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
bool is_basis_tex_format_xubc7(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_is_xubc7((basis_tex_format)file_fmt);
|
|
}
|
|
|
|
// file_fmt is basis_tex_format
|
|
bool is_basis_tex_format_astc_ldr(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return basis_tex_format_is_astc_ldr((basis_tex_format)file_fmt);
|
|
}
|
|
|
|
// Returns transcoder_texture_format, file_fmt is basis_tex_format.
|
|
// // Returns the best ASTC texture format to use given any basis_tex_format (the one with the proper block size).
|
|
// Use get_transcoder_texture_format_from_basis_tex_format() instead (same thing). Here for backwards compat.
|
|
uint32_t get_transcoder_texture_format_from_xuastc_or_astc_ldr_basis_tex_format(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return (uint32_t)basis_get_transcoder_texture_format_from_xuastc_or_astc_ldr_basis_tex_format(static_cast<basis_tex_format>(file_fmt));
|
|
}
|
|
|
|
// Same as get_transcoder_texture_format_from_xuastc_or_astc_ldr_basis_tex_format(), just a smaller name, works with any basis_tex_format.
|
|
// Returns the best ASTC texture format to use given any basis_tex_format (the one with the proper block size).
|
|
// Returns transcoder_texture_format, file_fmt is basis_tex_format.
|
|
uint32_t get_transcoder_texture_format_from_basis_tex_format(uint32_t file_fmt)
|
|
{
|
|
assert(file_fmt < (uint32_t)basis_tex_format::cTotalFormats);
|
|
return (uint32_t)basis_get_transcoder_texture_format_from_basis_tex_format(static_cast<basis_tex_format>(file_fmt));
|
|
}
|
|
|
|
uint32_t convert_float_to_half(float f)
|
|
{
|
|
return basist::float_to_half(f);
|
|
}
|
|
|
|
float convert_half_to_float(uint32_t h)
|
|
{
|
|
assert(h < 65536);
|
|
return basist::half_to_float(h);
|
|
}
|
|
|
|
void set_debug_flags_wrapper(uint32_t flags)
|
|
{
|
|
basist::set_debug_flags(flags);
|
|
}
|
|
|
|
uint32_t get_debug_flags_wrapper()
|
|
{
|
|
return basist::get_debug_flags();
|
|
}
|
|
|
|
EMSCRIPTEN_BINDINGS(basis_codec) {
|
|
function("initializeBasis", &basis_init);
|
|
|
|
function("setDebugFlags", &set_debug_flags_wrapper);
|
|
function("getDebugFlags", &get_debug_flags_wrapper);
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
function("listConvars", &basisu::list_convars);
|
|
function("printConvar", &basisu::print_convar);
|
|
function("resetConvar", &basisu::reset_convar);
|
|
function("setConvar", &basisu::set_convar);
|
|
#endif
|
|
|
|
// Expose BasisFileDesc structure
|
|
value_object<basis_file_desc>("BasisFileDesc")
|
|
.field("version", &basis_file_desc::m_version)
|
|
.field("usPerFrame", &basis_file_desc::m_us_per_frame)
|
|
.field("totalImages", &basis_file_desc::m_total_images)
|
|
.field("userdata0", &basis_file_desc::m_userdata0)
|
|
.field("userdata1", &basis_file_desc::m_userdata1)
|
|
.field("texFormat", &basis_file_desc::m_tex_format)
|
|
.field("yFlipped", &basis_file_desc::m_y_flipped)
|
|
.field("hasAlphaSlices", &basis_file_desc::m_has_alpha_slices)
|
|
.field("numEndpoints", &basis_file_desc::m_num_endpoints)
|
|
.field("endpointPaletteOfs", &basis_file_desc::m_endpoint_palette_ofs)
|
|
.field("endpointPaletteLen", &basis_file_desc::m_endpoint_palette_len)
|
|
.field("numSelectors", &basis_file_desc::m_num_selectors)
|
|
.field("selectorPaletteOfs", &basis_file_desc::m_selector_palette_ofs)
|
|
.field("selectorPaletteLen", &basis_file_desc::m_selector_palette_len)
|
|
.field("tablesOfs", &basis_file_desc::m_tables_ofs)
|
|
.field("tablesLen", &basis_file_desc::m_tables_len)
|
|
.field("blockWidth", &basis_file_desc::m_block_width)
|
|
.field("blockHeight", &basis_file_desc::m_block_height)
|
|
;
|
|
|
|
// Expose BasisImageDesc structure
|
|
value_object<basis_image_desc>("BasisImageDesc")
|
|
.field("origWidth", &basis_image_desc::m_orig_width)
|
|
.field("origHeight", &basis_image_desc::m_orig_height)
|
|
.field("numBlocksX", &basis_image_desc::m_num_blocks_x)
|
|
.field("numBlocksY", &basis_image_desc::m_num_blocks_y)
|
|
.field("numLevels", &basis_image_desc::m_num_levels)
|
|
.field("blockWidth", &basis_image_desc::m_block_width)
|
|
.field("blockHeight", &basis_image_desc::m_block_height)
|
|
.field("alphaFlag", &basis_image_desc::m_alpha_flag)
|
|
.field("iframeFlag", &basis_image_desc::m_iframe_flag)
|
|
;
|
|
|
|
// Expose BasisImageLevelDesc structure
|
|
value_object<basis_image_level_desc>("BasisImageLevelDesc")
|
|
.field("rgbFileOfs", &basis_image_level_desc::m_rgb_file_ofs)
|
|
.field("rgbFileLen", &basis_image_level_desc::m_rgb_file_len)
|
|
.field("alphaFileOfs", &basis_image_level_desc::m_alpha_file_ofs)
|
|
.field("alphaFileLen", &basis_image_level_desc::m_alpha_file_len)
|
|
;
|
|
|
|
// Expose some key enums to JavaScript code.
|
|
|
|
// enum class transcoder_texture_format
|
|
enum_<transcoder_texture_format>("transcoder_texture_format")
|
|
.value("cTFETC1_RGB", transcoder_texture_format::cTFETC1_RGB)
|
|
.value("cTFETC2_RGBA", transcoder_texture_format::cTFETC2_RGBA)
|
|
.value("cTFBC1_RGB", transcoder_texture_format::cTFBC1_RGB)
|
|
.value("cTFBC3_RGBA", transcoder_texture_format::cTFBC3_RGBA)
|
|
.value("cTFBC4_R", transcoder_texture_format::cTFBC4_R)
|
|
.value("cTFBC5_RG", transcoder_texture_format::cTFBC5_RG)
|
|
.value("cTFBC7_RGBA", transcoder_texture_format::cTFBC7_RGBA)
|
|
.value("cTFPVRTC1_4_RGB", transcoder_texture_format::cTFPVRTC1_4_RGB)
|
|
.value("cTFPVRTC1_4_RGBA", transcoder_texture_format::cTFPVRTC1_4_RGBA)
|
|
.value("cTFASTC_4x4_RGBA", transcoder_texture_format::cTFASTC_4x4_RGBA)
|
|
.value("cTFATC_RGB", transcoder_texture_format::cTFATC_RGB)
|
|
.value("cTFATC_RGBA", transcoder_texture_format::cTFATC_RGBA)
|
|
.value("cTFFXT1_RGB", transcoder_texture_format::cTFFXT1_RGB)
|
|
.value("cTFPVRTC2_4_RGB", transcoder_texture_format::cTFPVRTC2_4_RGB)
|
|
.value("cTFPVRTC2_4_RGBA", transcoder_texture_format::cTFPVRTC2_4_RGBA)
|
|
.value("cTFETC2_EAC_R11", transcoder_texture_format::cTFETC2_EAC_R11)
|
|
.value("cTFETC2_EAC_RG11", transcoder_texture_format::cTFETC2_EAC_RG11)
|
|
.value("cTFBC6H", transcoder_texture_format::cTFBC6H)
|
|
.value("cTFASTC_HDR_4x4_RGBA", transcoder_texture_format::cTFASTC_HDR_4x4_RGBA)
|
|
.value("cTFRGBA32", transcoder_texture_format::cTFRGBA32)
|
|
.value("cTFRGB565", transcoder_texture_format::cTFRGB565)
|
|
.value("cTFBGR565", transcoder_texture_format::cTFBGR565)
|
|
.value("cTFRGBA4444", transcoder_texture_format::cTFRGBA4444)
|
|
.value("cTFRGB_HALF", transcoder_texture_format::cTFRGB_HALF)
|
|
.value("cTFRGBA_HALF", transcoder_texture_format::cTFRGBA_HALF)
|
|
.value("cTFRGB_9E5", transcoder_texture_format::cTFRGB_9E5)
|
|
.value("cTFASTC_HDR_6x6_RGBA", transcoder_texture_format::cTFASTC_HDR_6x6_RGBA)
|
|
.value("cTFASTC_LDR_5x4_RGBA", transcoder_texture_format::cTFASTC_LDR_5x4_RGBA)
|
|
.value("cTFASTC_LDR_5x5_RGBA", transcoder_texture_format::cTFASTC_LDR_5x5_RGBA)
|
|
.value("cTFASTC_LDR_6x5_RGBA", transcoder_texture_format::cTFASTC_LDR_6x5_RGBA)
|
|
.value("cTFASTC_LDR_6x6_RGBA", transcoder_texture_format::cTFASTC_LDR_6x6_RGBA)
|
|
.value("cTFASTC_LDR_8x5_RGBA", transcoder_texture_format::cTFASTC_LDR_8x5_RGBA)
|
|
.value("cTFASTC_LDR_8x6_RGBA", transcoder_texture_format::cTFASTC_LDR_8x6_RGBA)
|
|
.value("cTFASTC_LDR_10x5_RGBA", transcoder_texture_format::cTFASTC_LDR_10x5_RGBA)
|
|
.value("cTFASTC_LDR_10x6_RGBA", transcoder_texture_format::cTFASTC_LDR_10x6_RGBA)
|
|
.value("cTFASTC_LDR_8x8_RGBA", transcoder_texture_format::cTFASTC_LDR_8x8_RGBA)
|
|
.value("cTFASTC_LDR_10x8_RGBA", transcoder_texture_format::cTFASTC_LDR_10x8_RGBA)
|
|
.value("cTFASTC_LDR_10x10_RGBA", transcoder_texture_format::cTFASTC_LDR_10x10_RGBA)
|
|
.value("cTFASTC_LDR_12x10_RGBA", transcoder_texture_format::cTFASTC_LDR_12x10_RGBA)
|
|
.value("cTFASTC_LDR_12x12_RGBA", transcoder_texture_format::cTFASTC_LDR_12x12_RGBA)
|
|
.value("cTFTotalTextureFormats", transcoder_texture_format::cTFTotalTextureFormats)
|
|
;
|
|
|
|
// Expose some useful transcoder_texture_format helper functions
|
|
function("getBytesPerBlockOrPixel", &::get_bytes_per_block_or_pixel);
|
|
function("formatHasAlpha", &format_has_alpha);
|
|
function("formatIsHDR", &format_is_hdr);
|
|
function("formatIsLDR", &format_is_ldr);
|
|
function("formatIsUncompressed", &format_is_uncompressed);
|
|
function("isFormatSupported", &is_format_supported);
|
|
function("getFormatBlockWidth", &get_format_block_width);
|
|
function("getFormatBlockHeight", &get_format_block_height);
|
|
|
|
function("getBasisTexFormatBlockWidth", &get_basis_tex_format_block_width);
|
|
function("getBasisTexFormatBlockHeight", &get_basis_tex_format_block_height);
|
|
|
|
function("isBasisTexFormatHDR", &is_basis_tex_format_hdr);
|
|
function("isBasisTexFormatLDR", &is_basis_tex_format_ldr);
|
|
function("isBasisTexFormatXUASTCLDR", &is_basis_tex_format_xuastc_ldr);
|
|
function("isBasisTexFormatASTCLDR", &is_basis_tex_format_astc_ldr);
|
|
function("getTranscoderTextureFormatFromXUASTCOrASTCLDRBasisTexFormat", &get_transcoder_texture_format_from_xuastc_or_astc_ldr_basis_tex_format);
|
|
function("getTranscoderTextureFormatFromBasisTexFormat", &get_transcoder_texture_format_from_basis_tex_format);
|
|
|
|
function("convertFloatToHalf", &convert_float_to_half);
|
|
function("convertHalfToFloat", &convert_half_to_float);
|
|
|
|
// Expose enum basis_texture_type
|
|
enum_<basis_texture_type>("basis_texture_type")
|
|
.value("cBASISTexType2D", cBASISTexType2D)
|
|
.value("cBASISTexType2DArray", cBASISTexType2DArray)
|
|
.value("cBASISTexTypeCubemapArray", cBASISTexTypeCubemapArray)
|
|
.value("cBASISTexTypeVideoFrames", cBASISTexTypeVideoFrames)
|
|
.value("cBASISTexTypeVolume", cBASISTexTypeVolume)
|
|
;
|
|
|
|
// Expose enum basis_tex_format - supported KTX2/.basis texture types.
|
|
enum_<basis_tex_format>("basis_tex_format")
|
|
.value("cETC1S", basis_tex_format::cETC1S)
|
|
.value("cUASTC4x4", basis_tex_format::cUASTC_LDR_4x4) // name has changed, keeping for backwards compat
|
|
.value("cUASTC_LDR_4x4", basis_tex_format::cUASTC_LDR_4x4)
|
|
.value("cUASTC_HDR_4x4", basis_tex_format::cUASTC_HDR_4x4)
|
|
.value("cASTC_HDR_6x6", basis_tex_format::cASTC_HDR_6x6)
|
|
.value("cUASTC_HDR_6x6_INTERMEDIATE", basis_tex_format::cUASTC_HDR_6x6_INTERMEDIATE)
|
|
.value("cUASTC_HDR_6x6", basis_tex_format::cUASTC_HDR_6x6_INTERMEDIATE) // the correct name
|
|
.value("cASTC_HDR_6x6_INTERMEDIATE", basis_tex_format::cUASTC_HDR_6x6_INTERMEDIATE) // was misnamed in previous release, keeping for backwards compat
|
|
// XUASTC LDR 4x4-12x12
|
|
.value("cXUASTC_LDR_4x4", basis_tex_format::cXUASTC_LDR_4x4)
|
|
.value("cXUASTC_LDR_5x4", basis_tex_format::cXUASTC_LDR_5x4)
|
|
.value("cXUASTC_LDR_5x5", basis_tex_format::cXUASTC_LDR_5x5)
|
|
.value("cXUASTC_LDR_6x5", basis_tex_format::cXUASTC_LDR_6x5)
|
|
.value("cXUASTC_LDR_6x6", basis_tex_format::cXUASTC_LDR_6x6)
|
|
.value("cXUASTC_LDR_8x5", basis_tex_format::cXUASTC_LDR_8x5)
|
|
.value("cXUASTC_LDR_8x6", basis_tex_format::cXUASTC_LDR_8x6)
|
|
.value("cXUASTC_LDR_10x5", basis_tex_format::cXUASTC_LDR_10x5)
|
|
.value("cXUASTC_LDR_10x6", basis_tex_format::cXUASTC_LDR_10x6)
|
|
.value("cXUASTC_LDR_8x8", basis_tex_format::cXUASTC_LDR_8x8)
|
|
.value("cXUASTC_LDR_10x8", basis_tex_format::cXUASTC_LDR_10x8)
|
|
.value("cXUASTC_LDR_10x10", basis_tex_format::cXUASTC_LDR_10x10)
|
|
.value("cXUASTC_LDR_12x10", basis_tex_format::cXUASTC_LDR_12x10)
|
|
.value("cXUASTC_LDR_12x12", basis_tex_format::cXUASTC_LDR_12x12)
|
|
// ASTC LDR 4x4-12x12
|
|
.value("cASTC_LDR_4x4", basis_tex_format::cASTC_LDR_4x4)
|
|
.value("cASTC_LDR_5x4", basis_tex_format::cASTC_LDR_5x4)
|
|
.value("cASTC_LDR_5x5", basis_tex_format::cASTC_LDR_5x5)
|
|
.value("cASTC_LDR_6x5", basis_tex_format::cASTC_LDR_6x5)
|
|
.value("cASTC_LDR_6x6", basis_tex_format::cASTC_LDR_6x6)
|
|
.value("cASTC_LDR_8x5", basis_tex_format::cASTC_LDR_8x5)
|
|
.value("cASTC_LDR_8x6", basis_tex_format::cASTC_LDR_8x6)
|
|
.value("cASTC_LDR_10x5", basis_tex_format::cASTC_LDR_10x5)
|
|
.value("cASTC_LDR_10x6", basis_tex_format::cASTC_LDR_10x6)
|
|
.value("cASTC_LDR_8x8", basis_tex_format::cASTC_LDR_8x8)
|
|
.value("cASTC_LDR_10x8", basis_tex_format::cASTC_LDR_10x8)
|
|
.value("cASTC_LDR_10x10", basis_tex_format::cASTC_LDR_10x10)
|
|
.value("cASTC_LDR_12x10", basis_tex_format::cASTC_LDR_12x10)
|
|
.value("cASTC_LDR_12x12", basis_tex_format::cASTC_LDR_12x12)
|
|
// XUBC7
|
|
.value("cXUBC7", basis_tex_format::cXUBC7)
|
|
;
|
|
|
|
// .basis file transcoder object. If all you want to do is transcode already encoded .basis files, this is all you really need.
|
|
class_<basis_file>("BasisFile")
|
|
.constructor<const emscripten::val&>()
|
|
.function("close", optional_override([](basis_file& self) {
|
|
return self.close();
|
|
}))
|
|
.function("getHasAlpha", optional_override([](basis_file& self) {
|
|
return self.getHasAlpha();
|
|
}))
|
|
.function("getBasisTexFormat", optional_override([](basis_file& self) {
|
|
return self.getBasisTexFormat();
|
|
}))
|
|
.function("isUASTC_LDR_4x4", optional_override([](basis_file& self) {
|
|
return self.isUASTC_LDR_4x4();
|
|
}))
|
|
.function("isUASTC", optional_override([](basis_file& self) {
|
|
return self.isUASTC_LDR_4x4();
|
|
}))
|
|
.function("isETC1S", optional_override([](basis_file& self) {
|
|
return self.isETC1S();
|
|
}))
|
|
.function("isHDR", optional_override([](basis_file& self) {
|
|
return self.isHDR();
|
|
}))
|
|
.function("isHDR4x4", optional_override([](basis_file& self) {
|
|
return self.isHDR4x4();
|
|
}))
|
|
.function("isHDR6x6", optional_override([](basis_file& self) {
|
|
return self.isHDR6x6();
|
|
}))
|
|
.function("isLDR", optional_override([](basis_file& self) {
|
|
return self.isLDR();
|
|
}))
|
|
.function("isASTC_LDR", optional_override([](basis_file& self) {
|
|
return self.isASTC_LDR();
|
|
}))
|
|
.function("isXUASTC_LDR", optional_override([](basis_file& self) {
|
|
return self.isXUASTC_LDR();
|
|
}))
|
|
.function("isXUBC7", optional_override([](basis_file& self) {
|
|
return self.isXUBC7();
|
|
}))
|
|
.function("getNumImages", optional_override([](basis_file& self) {
|
|
return self.getNumImages();
|
|
}))
|
|
.function("getNumLevels", optional_override([](basis_file& self, uint32_t imageIndex) {
|
|
return self.getNumLevels(imageIndex);
|
|
}))
|
|
.function("getImageWidth", optional_override([](basis_file& self, uint32_t imageIndex, uint32_t levelIndex) {
|
|
return self.getImageWidth(imageIndex, levelIndex);
|
|
}))
|
|
.function("getImageHeight", optional_override([](basis_file& self, uint32_t imageIndex, uint32_t levelIndex) {
|
|
return self.getImageHeight(imageIndex, levelIndex);
|
|
}))
|
|
.function("getBlockWidth", optional_override([](basis_file& self) {
|
|
return self.getBlockWidth();
|
|
}))
|
|
.function("getBlockHeight", optional_override([](basis_file& self) {
|
|
return self.getBlockHeight();
|
|
}))
|
|
// format is enum class transcoder_texture_format
|
|
.function("getImageTranscodedSizeInBytes", optional_override([](basis_file& self, uint32_t imageIndex, uint32_t levelIndex, uint32_t format) {
|
|
return self.getImageTranscodedSizeInBytes(imageIndex, levelIndex, format);
|
|
}))
|
|
.function("startTranscoding", optional_override([](basis_file& self) {
|
|
return self.startTranscoding();
|
|
}))
|
|
// format is enum class transcoder_texture_format
|
|
.function("transcodeImage", optional_override([](basis_file& self, const emscripten::val& dst, uint32_t imageIndex, uint32_t levelIndex, uint32_t format, uint32_t unused, uint32_t getAlphaForOpaqueFormats) {
|
|
return self.transcodeImage(dst, imageIndex, levelIndex, format, unused, getAlphaForOpaqueFormats);
|
|
}))
|
|
.function("transcodeImageWithFlags", optional_override([](basis_file& self, const emscripten::val& dst, uint32_t imageIndex, uint32_t levelIndex, uint32_t format, uint32_t flags) {
|
|
return self.transcodeImageWithFlags(dst, imageIndex, levelIndex, format, flags);
|
|
}))
|
|
// Returns low-level information about the basis file.
|
|
.function("getFileDesc", optional_override([](basis_file& self) {
|
|
return self.getFileDesc();
|
|
}))
|
|
// Returns low-level information about a specific image in a basis file. An image can contain 1 or more mipmap levels.
|
|
.function("getImageDesc", optional_override([](basis_file& self, uint32_t imageIndex) {
|
|
return self.getImageDesc(imageIndex);
|
|
}))
|
|
// Returns low-level information about a specific image mipmap level in a basis file.
|
|
.function("getImageLevelDesc", optional_override([](basis_file& self, uint32_t imageIndex, uint32_t levelIndex) {
|
|
return self.getImageLevelDesc(imageIndex, levelIndex);
|
|
}))
|
|
|
|
;
|
|
|
|
// Low-level container independent transcoding of ETC1S and UASTC slice data.
|
|
// These functions allow the caller to transcode compressed ETC1S or UASTC texture data that is embedded within arbitrary data files, such as from KTX2.
|
|
enum_<basisu_decode_flags>("basisu_decode_flags")
|
|
.value("cDecodeFlagsPVRTCDecodeToNextPow2", cDecodeFlagsPVRTCDecodeToNextPow2)
|
|
.value("cDecodeFlagsTranscodeAlphaDataToOpaqueFormats", cDecodeFlagsTranscodeAlphaDataToOpaqueFormats)
|
|
.value("cDecodeFlagsBC1ForbidThreeColorBlocks", cDecodeFlagsBC1ForbidThreeColorBlocks)
|
|
.value("cDecodeFlagsOutputHasAlphaIndices", cDecodeFlagsOutputHasAlphaIndices)
|
|
.value("cDecodeFlagsHighQuality", cDecodeFlagsHighQuality)
|
|
.value("cDecodeFlagsNoETC1SChromaFiltering", cDecodeFlagsNoETC1SChromaFiltering)
|
|
.value("cDecodeFlagsNoDeblockFiltering", cDecodeFlagsNoDeblockFiltering)
|
|
.value("cDecodeFlagsForceDeblockFiltering", cDecodeFlagsForceDeblockFiltering)
|
|
.value("cDecodeFlagXUASTCLDRDisableFastBC7Transcoding", cDecodeFlagXUASTCLDRDisableFastBC7Transcoding)
|
|
;
|
|
|
|
// The low-level ETC1S transcoder is a class because it has persistent state (such as the endpoint/selector codebooks and Huffman tables, and transcoder state for video)
|
|
class_<lowlevel_etc1s_image_transcoder>("LowLevelETC1SImageTranscoder")
|
|
.constructor<>()
|
|
.function("decodePalettes", &lowlevel_etc1s_image_transcoder::decode_palettes)
|
|
.function("decodeTables", &lowlevel_etc1s_image_transcoder::decode_tables)
|
|
.function("transcodeImage", &lowlevel_etc1s_image_transcoder::transcode_image)
|
|
;
|
|
|
|
// The low-level UASTC transcoder (for UASTC LDR 4x4, HDR 4x4, or ASTC HDR 6x6) is a single function.
|
|
function("transcodeUASTCImage", &transcode_uastc_image);
|
|
function("transcodeUASTCImage2", &transcode_uastc_image2);
|
|
|
|
function("transcoderSupportsKTX2", &basisu_transcoder_supports_ktx2);
|
|
function("transcoderSupportsKTX2Zstd", &basisu_transcoder_supports_ktx2_zstd);
|
|
|
|
#if BASISD_SUPPORT_KTX2
|
|
// KTX2 enums/constants
|
|
enum_<ktx2_supercompression>("ktx2_supercompression")
|
|
.value("KTX2_SS_NONE", KTX2_SS_NONE)
|
|
.value("KTX2_SS_BASISLZ", KTX2_SS_BASISLZ)
|
|
.value("KTX2_SS_ZSTANDARD", KTX2_SS_ZSTANDARD)
|
|
;
|
|
|
|
constant("KTX2_VK_FORMAT_UNDEFINED", KTX2_VK_FORMAT_UNDEFINED);
|
|
constant("KTX2_KDF_DF_MODEL_ETC1S", KTX2_KDF_DF_MODEL_ETC1S);
|
|
constant("KTX2_KDF_DF_MODEL_UASTC", KTX2_KDF_DF_MODEL_UASTC_LDR_4X4);
|
|
constant("KTX2_KDF_DF_MODEL_UASTC_HDR_6X6_INTERMEDIATE", KTX2_KDF_DF_MODEL_UASTC_HDR_6X6_INTERMEDIATE);
|
|
constant("KTX2_KDF_DF_MODEL_XUASTC_LDR_INTERMEDIATE", KTX2_KDF_DF_MODEL_XUASTC_LDR_INTERMEDIATE);
|
|
constant("KTX2_KDF_DF_MODEL_XUBC7", KTX2_KDF_DF_MODEL_XUBC7);
|
|
|
|
constant("KTX2_IMAGE_IS_P_FRAME", KTX2_IMAGE_IS_P_FRAME);
|
|
constant("KTX2_UASTC_BLOCK_SIZE", KTX2_UASTC_BLOCK_SIZE);
|
|
constant("KTX2_MAX_SUPPORTED_LEVEL_COUNT", KTX2_MAX_SUPPORTED_LEVEL_COUNT);
|
|
|
|
constant("KTX2_KHR_DF_TRANSFER_LINEAR", KTX2_KHR_DF_TRANSFER_LINEAR);
|
|
constant("KTX2_KHR_DF_TRANSFER_SRGB", KTX2_KHR_DF_TRANSFER_SRGB);
|
|
|
|
enum_<ktx2_df_channel_id>("ktx2_df_channel_id")
|
|
.value("KTX2_DF_CHANNEL_ETC1S_RGB", KTX2_DF_CHANNEL_ETC1S_RGB)
|
|
.value("KTX2_DF_CHANNEL_ETC1S_RRR", KTX2_DF_CHANNEL_ETC1S_RRR)
|
|
.value("KTX2_DF_CHANNEL_ETC1S_GGG", KTX2_DF_CHANNEL_ETC1S_GGG)
|
|
.value("KTX2_DF_CHANNEL_ETC1S_AAA", KTX2_DF_CHANNEL_ETC1S_AAA)
|
|
.value("KTX2_DF_CHANNEL_UASTC_DATA", KTX2_DF_CHANNEL_UASTC_DATA)
|
|
.value("KTX2_DF_CHANNEL_UASTC_RGB", KTX2_DF_CHANNEL_UASTC_RGB)
|
|
.value("KTX2_DF_CHANNEL_UASTC_RGBA", KTX2_DF_CHANNEL_UASTC_RGBA)
|
|
.value("KTX2_DF_CHANNEL_UASTC_RRR", KTX2_DF_CHANNEL_UASTC_RRR)
|
|
.value("KTX2_DF_CHANNEL_UASTC_RRRG", KTX2_DF_CHANNEL_UASTC_RRRG)
|
|
.value("KTX2_DF_CHANNEL_UASTC_RG", KTX2_DF_CHANNEL_UASTC_RG)
|
|
;
|
|
|
|
enum_<ktx2_df_color_primaries>("ktx2_df_color_primaries")
|
|
.value("KTX2_DF_PRIMARIES_UNSPECIFIED", KTX2_DF_PRIMARIES_UNSPECIFIED)
|
|
.value("KTX2_DF_PRIMARIES_BT709", KTX2_DF_PRIMARIES_BT709)
|
|
.value("KTX2_DF_PRIMARIES_SRGB", KTX2_DF_PRIMARIES_SRGB)
|
|
.value("KTX2_DF_PRIMARIES_BT601_EBU", KTX2_DF_PRIMARIES_BT601_EBU)
|
|
.value("KTX2_DF_PRIMARIES_BT601_SMPTE", KTX2_DF_PRIMARIES_BT601_SMPTE)
|
|
.value("KTX2_DF_PRIMARIES_BT2020", KTX2_DF_PRIMARIES_BT2020)
|
|
.value("KTX2_DF_PRIMARIES_CIEXYZ", KTX2_DF_PRIMARIES_CIEXYZ)
|
|
.value("KTX2_DF_PRIMARIES_ACES", KTX2_DF_PRIMARIES_ACES)
|
|
.value("KTX2_DF_PRIMARIES_ACESCC", KTX2_DF_PRIMARIES_ACESCC)
|
|
.value("KTX2_DF_PRIMARIES_NTSC1953", KTX2_DF_PRIMARIES_NTSC1953)
|
|
.value("KTX2_DF_PRIMARIES_PAL525", KTX2_DF_PRIMARIES_PAL525)
|
|
.value("KTX2_DF_PRIMARIES_DISPLAYP3", KTX2_DF_PRIMARIES_DISPLAYP3)
|
|
.value("KTX2_DF_PRIMARIES_ADOBERGB", KTX2_DF_PRIMARIES_ADOBERGB)
|
|
;
|
|
|
|
// Expose ktx2_image_level_info structure
|
|
value_object<ktx2_image_level_info>("KTX2ImageLevelInfo")
|
|
.field("levelIndex", &ktx2_image_level_info::m_level_index)
|
|
.field("layerIndex", &ktx2_image_level_info::m_layer_index)
|
|
.field("faceIndex", &ktx2_image_level_info::m_face_index)
|
|
.field("origWidth", &ktx2_image_level_info::m_orig_width)
|
|
.field("origHeight", &ktx2_image_level_info::m_orig_height)
|
|
.field("width", &ktx2_image_level_info::m_width)
|
|
.field("height", &ktx2_image_level_info::m_height)
|
|
.field("numBlocksX", &ktx2_image_level_info::m_num_blocks_x)
|
|
.field("numBlocksY", &ktx2_image_level_info::m_num_blocks_y)
|
|
.field("blockWidth", &ktx2_image_level_info::m_block_width)
|
|
.field("blockHeight", &ktx2_image_level_info::m_block_height)
|
|
.field("totalBlocks", &ktx2_image_level_info::m_total_blocks)
|
|
.field("alphaFlag", &ktx2_image_level_info::m_alpha_flag)
|
|
.field("iframeFlag", &ktx2_image_level_info::m_iframe_flag)
|
|
;
|
|
|
|
// Expose the ktx2_header_js structure
|
|
value_object<ktx2_header_js>("KTX2Header")
|
|
.field("vkFormat", &ktx2_header_js::m_vk_format)
|
|
.field("typeSize", &ktx2_header_js::m_type_size)
|
|
.field("pixelWidth", &ktx2_header_js::m_pixel_width)
|
|
.field("pixelHeight", &ktx2_header_js::m_pixel_height)
|
|
.field("pixelDepth", &ktx2_header_js::m_pixel_depth)
|
|
.field("layerCount", &ktx2_header_js::m_layer_count)
|
|
.field("faceCount", &ktx2_header_js::m_face_count)
|
|
.field("levelCount", &ktx2_header_js::m_level_count)
|
|
.field("supercompressionScheme", &ktx2_header_js::m_supercompression_scheme)
|
|
.field("dfdByteOffset", &ktx2_header_js::m_dfd_byte_offset)
|
|
.field("dfdByteLength", &ktx2_header_js::m_dfd_byte_length)
|
|
.field("kvdByteOffset", &ktx2_header_js::m_kvd_byte_offset)
|
|
.field("kvdByteLength", &ktx2_header_js::m_kvd_byte_length)
|
|
.field("sgdByteOffset", &ktx2_header_js::m_sgd_byte_offset)
|
|
.field("sgdByteLength", &ktx2_header_js::m_sgd_byte_length)
|
|
;
|
|
|
|
// KTX2 transcoder class
|
|
class_<ktx2_file>("KTX2File")
|
|
.constructor<const emscripten::val&>()
|
|
.function("isValid", &ktx2_file::isValid)
|
|
.function("close", &ktx2_file::close)
|
|
.function("getDFDSize", &ktx2_file::getDFDSize)
|
|
.function("getDFD", &ktx2_file::getDFD)
|
|
.function("getHeader", &ktx2_file::getHeader)
|
|
.function("hasKey", &ktx2_file::hasKey)
|
|
.function("getTotalKeys", &ktx2_file::getTotalKeys)
|
|
.function("getKey", &ktx2_file::getKey)
|
|
.function("getKeyValueSize", &ktx2_file::getKeyValueSize)
|
|
.function("getKeyValue", &ktx2_file::getKeyValue)
|
|
.function("getWidth", &ktx2_file::getWidth)
|
|
.function("getHeight", &ktx2_file::getHeight)
|
|
.function("getBlockWidth", &ktx2_file::getBlockWidth)
|
|
.function("getBlockHeight", &ktx2_file::getBlockHeight)
|
|
.function("getFaces", &ktx2_file::getFaces)
|
|
.function("getLayers", &ktx2_file::getLayers)
|
|
.function("getLevels", &ktx2_file::getLevels)
|
|
.function("getBasisTexFormat", &ktx2_file::getBasisTexFormat)
|
|
.function("isUASTC_LDR_4x4", &ktx2_file::isUASTC_LDR_4x4)
|
|
.function("isUASTC", &ktx2_file::isUASTC_LDR_4x4)
|
|
.function("isHDR", &ktx2_file::isHDR)
|
|
.function("isHDR4x4", &ktx2_file::isHDR4x4)
|
|
.function("isHDR6x6", &ktx2_file::isHDR6x6)
|
|
.function("isLDR", &ktx2_file::isLDR)
|
|
.function("isETC1S", &ktx2_file::isETC1S)
|
|
.function("isASTC_LDR", &ktx2_file::isASTC_LDR)
|
|
.function("isXUASTC_LDR", &ktx2_file::isXUASTC_LDR)
|
|
.function("isXUBC7", &ktx2_file::isXUBC7)
|
|
.function("getHasAlpha", &ktx2_file::getHasAlpha)
|
|
.function("getDFDColorModel", &ktx2_file::getDFDColorModel)
|
|
.function("getDFDColorPrimaries", &ktx2_file::getDFDColorPrimaries)
|
|
.function("getDFDTransferFunc", &ktx2_file::getDFDTransferFunc)
|
|
.function("isSRGB", &ktx2_file::isSRGB)
|
|
.function("getDFDFlags", &ktx2_file::getDFDFlags)
|
|
.function("getDFDTotalSamples", &ktx2_file::getDFDTotalSamples)
|
|
.function("getDFDChannelID0", &ktx2_file::getDFDChannelID0)
|
|
.function("getDFDChannelID1", &ktx2_file::getDFDChannelID1)
|
|
.function("isVideo", &ktx2_file::isVideo)
|
|
.function("getLDRHDRUpconversionNitMultiplier", &ktx2_file::getLDRHDRUpconversionNitMultiplier)
|
|
.function("getDeblockingFilterIndex", &ktx2_file::getDeblockingFilterIndex)
|
|
.function("getETC1SImageDescImageFlags", &ktx2_file::getETC1SImageDescImageFlags)
|
|
.function("getImageLevelInfo", &ktx2_file::getImageLevelInfo)
|
|
.function("getImageTranscodedSizeInBytes", &ktx2_file::getImageTranscodedSizeInBytes)
|
|
.function("startTranscoding", &ktx2_file::startTranscoding)
|
|
.function("transcodeImage", &ktx2_file::transcodeImage)
|
|
.function("transcodeImageWithFlags", &ktx2_file::transcodeImageWithFlags)
|
|
#if BASISU_SUPPORT_ENCODING
|
|
// DDS/KTX export (encoder build only -- needs the encoder library).
|
|
.function("exportToDDS", &ktx2_file::exportToDDS)
|
|
.function("getDDSData", &ktx2_file::getDDSData)
|
|
.function("exportToKTX", &ktx2_file::exportToKTX)
|
|
.function("getKTXData", &ktx2_file::getKTXData)
|
|
#endif
|
|
;
|
|
|
|
// The EXACT physical low-level format stored in a .DDS file (basist::dds_format), as reported by
|
|
// DDSFile.getDDSFormat(). Distinct from transcoder_texture_format (the closest transcodable format).
|
|
enum_<basist::dds_format>("dds_format")
|
|
.value("cInvalid", basist::dds_format::cInvalid)
|
|
.value("cBC1", basist::dds_format::cBC1)
|
|
.value("cBC2", basist::dds_format::cBC2)
|
|
.value("cBC3", basist::dds_format::cBC3)
|
|
.value("cBC4", basist::dds_format::cBC4)
|
|
.value("cBC5", basist::dds_format::cBC5)
|
|
.value("cBC7", basist::dds_format::cBC7)
|
|
.value("cR5G6B5", basist::dds_format::cR5G6B5)
|
|
.value("cA1R5G5B5", basist::dds_format::cA1R5G5B5)
|
|
.value("cX1R5G5B5", basist::dds_format::cX1R5G5B5)
|
|
.value("cA4R4G4B4", basist::dds_format::cA4R4G4B4)
|
|
.value("cX4R4G4B4", basist::dds_format::cX4R4G4B4)
|
|
.value("cR8G8B8", basist::dds_format::cR8G8B8)
|
|
.value("cB8G8R8", basist::dds_format::cB8G8R8)
|
|
.value("cA8R8G8B8", basist::dds_format::cA8R8G8B8)
|
|
.value("cX8R8G8B8", basist::dds_format::cX8R8G8B8)
|
|
.value("cA8B8G8R8", basist::dds_format::cA8B8G8R8)
|
|
.value("cX8B8G8R8", basist::dds_format::cX8B8G8R8)
|
|
.value("cR8", basist::dds_format::cR8)
|
|
.value("cR8G8", basist::dds_format::cR8G8)
|
|
.value("cA8", basist::dds_format::cA8)
|
|
.value("cL8", basist::dds_format::cL8)
|
|
.value("cA8L8", basist::dds_format::cA8L8)
|
|
.value("cTotalDDSFormats", basist::dds_format::cTotalDDSFormats)
|
|
;
|
|
|
|
// What's physically stored in the file (dds_transcoder::source_kind): compressed block kind or generic uncompressed.
|
|
enum_<basist::dds_transcoder::source_kind>("dds_source_kind")
|
|
.value("cInvalid", basist::dds_transcoder::source_kind::cInvalid)
|
|
.value("cBC1", basist::dds_transcoder::source_kind::cBC1)
|
|
.value("cBC3", basist::dds_transcoder::source_kind::cBC3)
|
|
.value("cBC4", basist::dds_transcoder::source_kind::cBC4)
|
|
.value("cBC5", basist::dds_transcoder::source_kind::cBC5)
|
|
.value("cBC7", basist::dds_transcoder::source_kind::cBC7)
|
|
.value("cUncompressed", basist::dds_transcoder::source_kind::cUncompressed)
|
|
;
|
|
|
|
// DDS source transcoder class (read & transcode a .DDS as a source). Mirrors KTX2File.
|
|
class_<dds_file>("DDSFile")
|
|
.constructor<const emscripten::val&>()
|
|
.function("isValid", &dds_file::isValid)
|
|
.function("close", &dds_file::close)
|
|
.function("getWidth", &dds_file::getWidth)
|
|
.function("getHeight", &dds_file::getHeight)
|
|
.function("getLevels", &dds_file::getLevels)
|
|
.function("getLayers", &dds_file::getLayers)
|
|
.function("getFaces", &dds_file::getFaces)
|
|
.function("getIsCubemap", &dds_file::getIsCubemap)
|
|
.function("getHasAlpha", &dds_file::getHasAlpha)
|
|
.function("isSRGB", &dds_file::isSRGB)
|
|
.function("getFormat", &dds_file::getFormat)
|
|
.function("getDDSFormat", &dds_file::getDDSFormat)
|
|
.function("getSourceKind", &dds_file::getSourceKind)
|
|
.function("isTranscodeFormatSupported", &dds_file::isTranscodeFormatSupported)
|
|
.function("getImageLevelInfo", &dds_file::getImageLevelInfo)
|
|
.function("getImageTranscodedSizeInBytes", &dds_file::getImageTranscodedSizeInBytes)
|
|
.function("startTranscoding", &dds_file::startTranscoding)
|
|
.function("transcodeImage", &dds_file::transcodeImage)
|
|
.function("transcodeImageWithFlags", &dds_file::transcodeImageWithFlags)
|
|
#if BASISU_SUPPORT_ENCODING
|
|
// Encoder build only -- get_dds_format_string() lives in the encoder library.
|
|
.function("getDDSFormatString", &dds_file::getDDSFormatString)
|
|
#endif
|
|
;
|
|
|
|
#endif // BASISD_SUPPORT_KTX2
|
|
|
|
// Optional encoding/compression support of .basis and .KTX2 files (the same class encodes/compresses to either format).
|
|
|
|
#if BASISU_SUPPORT_ENCODING
|
|
|
|
// Compressor Constants
|
|
|
|
constant("BASISU_MAX_SUPPORTED_TEXTURE_DIMENSION", BASISU_MAX_SUPPORTED_TEXTURE_DIMENSION);
|
|
constant("BASISU_DEFAULT_ENDPOINT_RDO_THRESH", BASISU_DEFAULT_ENDPOINT_RDO_THRESH);
|
|
constant("BASISU_DEFAULT_SELECTOR_RDO_THRESH", BASISU_DEFAULT_SELECTOR_RDO_THRESH);
|
|
constant("BASISU_DEFAULT_QUALITY", BASISU_DEFAULT_QUALITY);
|
|
constant("BASISU_DEFAULT_HYBRID_SEL_CB_QUALITY_THRESH", BASISU_DEFAULT_HYBRID_SEL_CB_QUALITY_THRESH);
|
|
constant("BASISU_MAX_IMAGE_DIMENSION", BASISU_MAX_IMAGE_DIMENSION);
|
|
constant("BASISU_QUALITY_MIN", BASISU_QUALITY_MIN);
|
|
constant("BASISU_QUALITY_MAX", BASISU_QUALITY_MAX);
|
|
constant("BASISU_XUASTC_QUALITY_MIN", BASISU_XUASTC_QUALITY_MIN);
|
|
constant("BASISU_XUASTC_QUALITY_MAX", BASISU_XUASTC_QUALITY_MAX);
|
|
constant("BASISU_MAX_ENDPOINT_CLUSTERS", BASISU_MAX_ENDPOINT_CLUSTERS);
|
|
constant("BASISU_MAX_SELECTOR_CLUSTERS", BASISU_MAX_SELECTOR_CLUSTERS);
|
|
constant("BASISU_MAX_SLICES", BASISU_MAX_SLICES);
|
|
constant("BASISU_RDO_UASTC_DICT_SIZE_DEFAULT", BASISU_RDO_UASTC_DICT_SIZE_DEFAULT);
|
|
constant("BASISU_RDO_UASTC_DICT_SIZE_MIN", BASISU_RDO_UASTC_DICT_SIZE_MIN);
|
|
constant("BASISU_RDO_UASTC_DICT_SIZE_MAX", BASISU_RDO_UASTC_DICT_SIZE_MAX);
|
|
constant("BASISU_MAX_RESAMPLER_FILTERS", g_num_resample_filters);
|
|
constant("BASISU_DEFAULT_ETC1S_COMPRESSION_LEVEL", BASISU_DEFAULT_ETC1S_COMPRESSION_LEVEL);
|
|
constant("BASISU_MAX_ETC1S_COMPRESSION_LEVEL", BASISU_MAX_ETC1S_COMPRESSION_LEVEL);
|
|
|
|
// The maximum representable floating point value in a UASTC HDR or ASTC HDR texture (any larger values will get clamped and a warning issued).
|
|
constant("ASTC_HDR_MAX_VAL", basist::ASTC_HDR_MAX_VAL);
|
|
|
|
// UASTC LDR/HDR flags/options
|
|
constant("cPackUASTCLevelFastest", cPackUASTCLevelFastest);
|
|
constant("cPackUASTCLevelFaster", cPackUASTCLevelFaster);
|
|
constant("cPackUASTCLevelDefault", cPackUASTCLevelDefault);
|
|
constant("cPackUASTCLevelSlower", cPackUASTCLevelSlower);
|
|
constant("cPackUASTCLevelVerySlow", cPackUASTCLevelVerySlow);
|
|
constant("cPackUASTCLevelMask", cPackUASTCLevelMask);
|
|
constant("cPackUASTCFavorUASTCError", cPackUASTCFavorUASTCError);
|
|
constant("cPackUASTCFavorBC7Error", cPackUASTCFavorBC7Error);
|
|
constant("cPackUASTCETC1FasterHints", cPackUASTCETC1FasterHints);
|
|
constant("cPackUASTCETC1FastestHints", cPackUASTCETC1FastestHints);
|
|
constant("cPackUASTCETC1DisableFlipAndIndividual", cPackUASTCETC1DisableFlipAndIndividual);
|
|
|
|
constant("UASTC_RDO_DEFAULT_MAX_ALLOWED_RMS_INCREASE_RATIO", UASTC_RDO_DEFAULT_MAX_ALLOWED_RMS_INCREASE_RATIO);
|
|
constant("UASTC_RDO_DEFAULT_SKIP_BLOCK_RMS_THRESH", UASTC_RDO_DEFAULT_SKIP_BLOCK_RMS_THRESH);
|
|
|
|
constant("cPackASTC6x6MaxUserCompLevel", ::astc_6x6_hdr::ASTC_HDR_6X6_MAX_USER_COMP_LEVEL);
|
|
|
|
enum_<hdr_image_type>("hdr_image_type")
|
|
.value("cHITRGBAHalfFloat", hdr_image_type::cHITRGBAHalfFloat)
|
|
.value("cHITRGBAFloat", hdr_image_type::cHITRGBAFloat)
|
|
.value("cHITPNGImage", hdr_image_type::cHITPNGImage)
|
|
.value("cHITEXRImage", hdr_image_type::cHITEXRImage)
|
|
.value("cHITHDRImage", hdr_image_type::cHITHDRImage)
|
|
.value("cHITJPGImage", hdr_image_type::cHITJPGImage)
|
|
.value("cHITQOIImage", hdr_image_type::cHITQOIImage)
|
|
.value("cHITRGBA8Image", hdr_image_type::cHITRGBA8Image)
|
|
;
|
|
|
|
enum_<ldr_image_type>("ldr_image_type")
|
|
.value("cRGBA32", ldr_image_type::cRGBA32)
|
|
.value("cPNGImage", ldr_image_type::cPNGImage)
|
|
.value("cJPGImage", ldr_image_type::cJPGImage)
|
|
.value("cQOIImage", ldr_image_type::cQOIImage)
|
|
;
|
|
|
|
enum_<xuastc_ldr_syntax>("xuastc_ldr_syntax")
|
|
.value("cFullArith", xuastc_ldr_syntax::cFullArith)
|
|
.value("cHybridArithZStd", xuastc_ldr_syntax::cHybridArithZStd)
|
|
.value("cFullZStd", xuastc_ldr_syntax::cFullZStd)
|
|
.value("cTotal", xuastc_ldr_syntax::cTotal)
|
|
;
|
|
|
|
enum_<xuastc_ldr_sharpen_mode>("xuastc_ldr_sharpen_mode")
|
|
.value("cDisabled", xuastc_ldr_sharpen_mode::cDisabled)
|
|
.value("cOnlyLargestBlocks", xuastc_ldr_sharpen_mode::cOnlyLargestBlocks)
|
|
.value("cAllBlockSizes", xuastc_ldr_sharpen_mode::cAllBlockSizes)
|
|
.value("cTotal", xuastc_ldr_sharpen_mode::cTotal)
|
|
;
|
|
|
|
enum_<xuastc_ldr_astc_comp_selection>("xuastc_ldr_astc_comp_selection")
|
|
.value("cAuto", xuastc_ldr_astc_comp_selection::cAuto)
|
|
.value("cBasisU", xuastc_ldr_astc_comp_selection::cBasisU)
|
|
.value("cASTCENC", xuastc_ldr_astc_comp_selection::cASTCENC)
|
|
.value("cASTCF", xuastc_ldr_astc_comp_selection::cASTCF)
|
|
.value("cBasisU_and_ASTCENC", xuastc_ldr_astc_comp_selection::cBasisU_and_ASTCENC)
|
|
.value("cBasisU_and_ASTCF", xuastc_ldr_astc_comp_selection::cBasisU_and_ASTCF)
|
|
.value("cUseAll", xuastc_ldr_astc_comp_selection::cUseAll)
|
|
.value("cTotal", xuastc_ldr_astc_comp_selection::cTotal)
|
|
;
|
|
|
|
enum_<xuastc_ldr_deblocking_mode>("xuastc_ldr_deblocking_mode")
|
|
.value("cDisabled", xuastc_ldr_deblocking_mode::cDisabled)
|
|
.value("cUseSCDAndFilteringOnlyLargestBlocks", xuastc_ldr_deblocking_mode::cUseSCDAndFilteringOnlyLargestBlocks)
|
|
.value("cUseSCDAndFilteringAllBlockSizes", xuastc_ldr_deblocking_mode::cUseSCDAndFilteringAllBlockSizes)
|
|
.value("cUseSCDNoFiltering", xuastc_ldr_deblocking_mode::cUseSCDNoFiltering)
|
|
.value("cNoSCDButEnableFilteringOnLargestBlocks", xuastc_ldr_deblocking_mode::cNoSCDButEnableFilteringOnLargestBlocks)
|
|
.value("cNoSCDButEnableFilteringOnAllBlocks", xuastc_ldr_deblocking_mode::cNoSCDButEnableFilteringOnAllBlocks)
|
|
.value("cTotal", xuastc_ldr_deblocking_mode::cTotal)
|
|
;
|
|
|
|
// Which BC7 base encoder XUBC7 packs with (see setXUBC7Encoder).
|
|
enum_<xbc7::bc7_encoder_type>("xubc7_bc7_encoder_type")
|
|
.value("cBC7F", xbc7::bc7_encoder_type::cBC7F)
|
|
.value("cBC7E_Scalar", xbc7::bc7_encoder_type::cBC7E_Scalar)
|
|
;
|
|
|
|
// The output formats supported by direct DDS export / encodeToDDS (see setDDSFormat/setDDSFormatEnum).
|
|
// NOTE: distinct from the reader-side "dds_format" enum (basist::dds_format) used by the lossy
|
|
// KTX2->DDS exportToDDS() path - use THIS enum (cDDSFmt*) when creating DDS files via encodeToDDS().
|
|
enum_<dds_output_format>("dds_output_format")
|
|
.value("cDDSFmtInvalid", cDDSFmtInvalid)
|
|
.value("cDDSFmtBC1", cDDSFmtBC1)
|
|
.value("cDDSFmtBC2", cDDSFmtBC2)
|
|
.value("cDDSFmtBC3", cDDSFmtBC3)
|
|
.value("cDDSFmtBC4", cDDSFmtBC4)
|
|
.value("cDDSFmtBC5", cDDSFmtBC5)
|
|
.value("cDDSFmtBC7", cDDSFmtBC7)
|
|
.value("cDDSFmtA8R8G8B8", cDDSFmtA8R8G8B8)
|
|
.value("cDDSFmtA8B8G8R8", cDDSFmtA8B8G8R8)
|
|
.value("cDDSFmtR8", cDDSFmtR8)
|
|
.value("cDDSFmtR8G8", cDDSFmtR8G8)
|
|
.value("cDDSFmtR5G6B5", cDDSFmtR5G6B5)
|
|
.value("cDDSFmtA1R5G5B5", cDDSFmtA1R5G5B5)
|
|
.value("cDDSFmtA4R4G4B4", cDDSFmtA4R4G4B4)
|
|
.value("cDDSFmtTotal", cDDSFmtTotal)
|
|
;
|
|
|
|
// Which BC7 base packer build_dds() uses for "bc7" DDS output (see setDDSBC7Encoder).
|
|
enum_<dds_bc7_encoder>("dds_bc7_encoder")
|
|
.value("cDDSBC7Encoder_BC7F", cDDSBC7Encoder_BC7F)
|
|
.value("cDDSBC7Encoder_BC7E_Scalar", cDDSBC7Encoder_BC7E_Scalar)
|
|
;
|
|
|
|
// bc7f packer quality level for "bc7" DDS output (see setDDSBC7FLevel).
|
|
enum_<dds_bc7f_level>("dds_bc7f_level")
|
|
.value("cDDSBC7FLevel_Analytical", cDDSBC7FLevel_Analytical)
|
|
.value("cDDSBC7FLevel_PartiallyAnalytical", cDDSBC7FLevel_PartiallyAnalytical)
|
|
.value("cDDSBC7FLevel_NonAnalytical", cDDSBC7FLevel_NonAnalytical)
|
|
;
|
|
|
|
// DDS export helpers: canonical token string for a dds_output_format value, and whether a format has
|
|
// a distinct sRGB DXGI variant (so a caller can label output, e.g. "BC7 (sRGB)"). Take the int value
|
|
// of a dds_output_format (e.g. Module.dds_output_format.cDDSFmtBC7.value).
|
|
function("getDDSOutputFormatString", optional_override([](int format) {
|
|
return std::string(get_dds_output_format_string((dds_output_format)format));
|
|
}));
|
|
function("ddsOutputFormatHasSRGBVariant", optional_override([](int format) {
|
|
return dds_output_format_has_srgb_variant((dds_output_format)format);
|
|
}));
|
|
|
|
// Compression/encoding object.
|
|
// You create this object, call the set() methods to fill in the parameters/source images/options, call encode(), and you get back a .basis or .KTX2 file.
|
|
// You can call .encode() multiple times, changing the parameters/options in between calls.
|
|
// By default this class encodes to .basis, but call setCreateKTX2File() with true to get .KTX2 files.
|
|
class_<basis_encoder>("BasisEncoder")
|
|
.constructor<>()
|
|
|
|
// Compresses the provided source slice(s) to an output .basis file.
|
|
// At the minimum, you must provided at least 1 source slice by calling setSliceSourceImage() or setSliceSourceImageHDR() (for UASTC HDR) before calling this method.
|
|
.function("encode", optional_override([](basis_encoder& self, const emscripten::val& dst_basis_file_js_val) {
|
|
return self.encode(dst_basis_file_js_val);
|
|
}))
|
|
|
|
// Encodes the provided source slice(s) directly to an in-memory DX10 .DDS file (high-quality,
|
|
// single-hop, NOT via KTX2). Configure the output via setDDSFormat()/setDDSBC7*() first. The DDS
|
|
// bytes are written into the caller-provided buffer; returns the file size in bytes (0 on failure).
|
|
// Like encode(), there is no size-query: pass a buffer large enough for the whole .DDS (size depends
|
|
// on the format + mip/array/cubemap layout); if it's too small this fails and returns 0.
|
|
.function("encodeToDDS", optional_override([](basis_encoder& self, const emscripten::val& dst_dds_file_js_val) {
|
|
return self.encode_to_dds(dst_dds_file_js_val);
|
|
}))
|
|
|
|
.function("getLastEncodeMip0RGBAPSNR", optional_override([](basis_encoder& self) {
|
|
return self.get_last_encode_mip0_rgba_psnr();
|
|
}))
|
|
|
|
// Sets the slice's source image, either from a PNG/JPG file or from a raw 32-bit RGBA raster image.
|
|
// If the input is a raster image, the buffer must be width*height*4 bytes in size. The raster image is stored in top down scanline order.
|
|
// The first texel is the top-left texel. The texel byte order in memory is R,G,B,A (R first at offset 0, A last at offset 3).
|
|
// slice_index is the slice to change. Valid range is [0,BASISU_MAX_SLICES-1].
|
|
// All formats, including HDR formats. The compressor will upconvert LDR/SDR content to absolute light HDR as needed. See LDR upconversion options below.
|
|
.function("setSliceSourceImage", optional_override([](basis_encoder& self, uint32_t slice_index, const emscripten::val& src_image_js_val, uint32_t width, uint32_t height, uint32_t img_type) {
|
|
return self.set_slice_source_image(slice_index, src_image_js_val, width, height, (ldr_image_type)img_type);
|
|
}))
|
|
|
|
// If true threaded compression will be used with X *extra* helper threads.
|
|
.function("controlThreading", optional_override([](basis_encoder& self, bool enable_threading, uint32_t num_extra_worker_threads) {
|
|
return self.control_threading(enable_threading, num_extra_worker_threads);
|
|
}))
|
|
|
|
// HDR targets only
|
|
.function("setSliceSourceImageHDR", optional_override([](basis_encoder& self, uint32_t slice_index, const emscripten::val& src_image_js_val, uint32_t width, uint32_t height, uint32_t img_type,
|
|
bool ldr_srgb_to_linear_conversion, float ldr_to_hdr_nit_multiplier) {
|
|
return self.set_slice_source_image_hdr(slice_index, src_image_js_val, width, height, (hdr_image_type)img_type, ldr_srgb_to_linear_conversion, ldr_to_hdr_nit_multiplier);
|
|
}))
|
|
|
|
// Sets the desired encoding format. This is the preferred way to control which format/ASTC block size the encoder creates.
|
|
// tex_format is a basis_tex_format (cETC1s, cUASTC_LDR_4x4, cUASTC_HDR_4x4 etc.) - see basisu_file_headers.h.
|
|
// This can be used instead of the older setUASTC(), setHDR() etc. methods.
|
|
// All formats
|
|
.function("setFormatMode", optional_override([](basis_encoder& self, int tex_format) {
|
|
assert((tex_format >= 0) && (tex_format < (uint32_t)basis_tex_format::cTotalFormats));
|
|
self.m_params.set_format_mode((basis_tex_format)tex_format);
|
|
}))
|
|
|
|
// setFormatModeAndEffortQuality() is like setFormatMode(), except it also sets the effort [0,10] and quality [0,100] parameters to (hopefully) reasonable values for the selected format.
|
|
// If effort==-1, no effort related parameters will be modified.
|
|
// If quality==-1, no quality related parameters will be modified.
|
|
// These values directly correspond to the command line tool's "-effort X" and "-quality X" unified codec compression options.
|
|
// If set_defaults is true (recommended) and quality is -1, the default quality settings will be used, otherwise the quality settings will remain unchanged. Same for effort.
|
|
.function("setFormatModeAndQualityEffort", optional_override([](basis_encoder& self, int tex_format, int quality, int effort, bool set_defaults) {
|
|
assert((tex_format >= 0) && (tex_format < (uint32_t)basis_tex_format::cTotalFormats));
|
|
assert((effort >= -1) && (effort <= 10));
|
|
assert((quality >= -1) && (quality <= 100));
|
|
self.m_params.set_format_mode_and_quality_effort((basis_tex_format)tex_format, quality, effort, set_defaults);
|
|
}))
|
|
|
|
// If true, the encoder will output a UASTC LDR 4x4 texture, otherwise a ETC1S texture.
|
|
// (This is for backwards compatibility, prefer setFormatMode() instead.)
|
|
// All formats
|
|
.function("setUASTC", optional_override([](basis_encoder& self, bool uastc_flag) {
|
|
if (uastc_flag)
|
|
self.m_params.set_format_mode(basis_tex_format::cUASTC_LDR_4x4);
|
|
else
|
|
self.m_params.set_format_mode(basis_tex_format::cETC1S);
|
|
}))
|
|
|
|
// If true, the encoder will output a UASTC HDR 4x4 texture, otherwise a ETC1S texture.
|
|
// (This is for backwards compatibility, prefer setFormatMode() instead.)
|
|
// All formats
|
|
.function("setHDR", optional_override([](basis_encoder& self, bool hdr_flag) {
|
|
if (hdr_flag)
|
|
self.m_params.set_format_mode(basis_tex_format::cUASTC_HDR_4x4);
|
|
else
|
|
self.m_params.set_format_mode(basis_tex_format::cETC1S); // don't really know what to set
|
|
}))
|
|
|
|
// Sets the UASTC HDR 4x4 quality/effort vs. encoder performance tradeoff (0-4, default is 1). Higher=slower but better quality.
|
|
// TODO: Rename, this is really a compressor "effort" level.
|
|
// UASTC HDR 4x4
|
|
.function("setUASTCHDRQualityLevel", optional_override([](basis_encoder& self, int level) {
|
|
assert((level >= uastc_hdr_4x4_codec_options::cMinLevel) && (level <= uastc_hdr_4x4_codec_options::cMaxLevel));
|
|
self.m_params.m_uastc_hdr_4x4_options.set_quality_level(level);
|
|
}))
|
|
|
|
// If true the source images will be Y flipped before compression.
|
|
// All formats
|
|
.function("setYFlip", optional_override([](basis_encoder& self, bool y_flip_flag) {
|
|
self.m_params.m_y_flip = y_flip_flag;
|
|
}))
|
|
|
|
// Enables debug output to stdout
|
|
// All formats
|
|
.function("setDebug", optional_override([](basis_encoder& self, bool debug_flag) {
|
|
self.m_params.m_debug = debug_flag;
|
|
g_debug_printf = debug_flag;
|
|
}))
|
|
|
|
// If true, the input is assumed to be in sRGB space. Be sure to set this correctly! (Examples: True on photos, albedo/spec maps, and false on normal maps.)
|
|
// In HDR mode, if perceptual is true R and G are weighted higher (2.0, 3.0) than B (1.0). Otherwise the encoder uses equal weightings for each channel.
|
|
// Importantly, also see setKTX2SRGBTransferFunc() and setMipSRGB().
|
|
// ETC1S, UASTC LDR 4x4, UASTC HDR 4x4
|
|
.function("setPerceptual", optional_override([](basis_encoder& self, bool perceptual_flag) {
|
|
self.m_params.m_perceptual = perceptual_flag;
|
|
}))
|
|
|
|
// Check source images for active/used alpha channels
|
|
// ETC1S, UASTC LDR 4x4
|
|
.function("setCheckForAlpha", optional_override([](basis_encoder& self, bool check_for_alpha_flag) {
|
|
self.m_params.m_check_for_alpha = check_for_alpha_flag;
|
|
}))
|
|
|
|
// Fource output .basis/.ktx2 file to have an alpha channel
|
|
// ETC1S, UASTC LDR 4x4
|
|
.function("setForceAlpha", optional_override([](basis_encoder& self, bool force_alpha_flag) {
|
|
self.m_params.m_force_alpha = force_alpha_flag;
|
|
}))
|
|
|
|
// Set source image component swizzle.
|
|
// r,g,b,a - valid range is [0,3]
|
|
// All formats (but formats without alpha will ignore a)
|
|
.function("setSwizzle", optional_override([](basis_encoder& self, uint32_t r, uint32_t g, uint32_t b, uint32_t a) {
|
|
assert((r < 4) && (g < 4) && (b < 4) && (a < 4));
|
|
// Clamp to the valid [0,3] range (the assert flags bad values in debug; the clamp keeps release safe).
|
|
self.m_params.m_swizzle[0] = (uint8_t)clamp<uint32_t>(r, 0u, 3u);
|
|
self.m_params.m_swizzle[1] = (uint8_t)clamp<uint32_t>(g, 0u, 3u);
|
|
self.m_params.m_swizzle[2] = (uint8_t)clamp<uint32_t>(b, 0u, 3u);
|
|
self.m_params.m_swizzle[3] = (uint8_t)clamp<uint32_t>(a, 0u, 3u);
|
|
}))
|
|
|
|
// Sets the swizzle for a SINGLE output channel: output channel out_channel reads from source channel
|
|
// src_channel. Both indices are [0,3] (0=R,1=G,2=B,3=A). The full swizzle defaults to identity
|
|
// (0,1,2,3 = no swizzle). Unlike setSwizzle(), this VALIDATES at runtime and returns false (leaving
|
|
// the swizzle unchanged) if either index is out of [0,3]. All formats (formats without alpha ignore
|
|
// the alpha output, index 3).
|
|
.function("setSwizzleComponent", optional_override([](basis_encoder& self, uint32_t out_channel, uint32_t src_channel) {
|
|
if ((out_channel > 3) || (src_channel > 3))
|
|
return false;
|
|
self.m_params.m_swizzle[out_channel] = (uint8_t)src_channel;
|
|
return true;
|
|
}))
|
|
|
|
// ASTC HDR 6x6 options
|
|
// Sets ASTC HDR 6x6/6x6 intermediate lambda setting. The higher this setting, the lower the bitrate.
|
|
// ASTC HDR 6x6
|
|
.function("setLambda", optional_override([](basis_encoder& self, float rdo_quality) {
|
|
self.m_params.m_astc_hdr_6x6_options.m_lambda = rdo_quality;
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Enables REC 2020 delta E ITP vs. REC 709 in the encoder (and sets the colorspace in the KTX2 header).
|
|
// Note this colorspace always goes into the KTX2 header (DFD), for all modes (ETC1S, UASTC LDR 4x4, etc.)
|
|
.function("setRec2020", optional_override([](basis_encoder& self, bool rec2020) {
|
|
self.m_params.m_astc_hdr_6x6_options.m_rec2020_bt2100_color_gamut = rec2020;
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Enables JND (Just Noticeable Difference) optimization
|
|
.function("setJND", optional_override([](basis_encoder& self, float thresh) {
|
|
if (thresh == 0.0f)
|
|
{
|
|
self.m_params.m_astc_hdr_6x6_options.m_jnd_optimization = false;
|
|
}
|
|
else
|
|
{
|
|
self.m_params.m_astc_hdr_6x6_options.m_jnd_optimization = true;
|
|
self.m_params.m_astc_hdr_6x6_options.m_jnd_delta_itp_thresh = thresh;
|
|
}
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Compression speed vs. quality level. Ranges from [0,cPackASTC6x6MaxUserCompLevel].
|
|
.function("setASTC_HDR_6x6_Level", optional_override([](basis_encoder& self, int level) {
|
|
self.m_params.m_astc_hdr_6x6_options.set_user_level(level);
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Enable extra 2/3 subset patterns (slower)
|
|
.function("setASTC_HDR_6x6_ExtraPats", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_astc_hdr_6x6_options.m_extra_patterns_flag = flag;
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Enable brute force pattern searching (slower)
|
|
.function("setASTC_HDR_6x6_BruteForcePats", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_astc_hdr_6x6_options.m_brute_force_partition_matching = flag;
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Write v1.6 compatible UASTC HDR 6x6i files (the current default, but eventually this will be changed to default to false, requiring v2.0 or later transcoders)
|
|
.function("setASTC_HDR_6x6_WriteBasisU16CompatibleFiles", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_astc_hdr_6x6_options.m_write_basisu_1_6_compatible_files = flag;
|
|
}))
|
|
|
|
// ASTC HDR 6x6: Control gaussian filtering on very hard blocks
|
|
.function("setASTC_HDR_6x6_SetGaussian1", optional_override([](basis_encoder& self, float strength) {
|
|
if (strength <= 0.0f)
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian1_fallback = false;
|
|
else
|
|
{
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian1_fallback = true;
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian1_strength = strength;
|
|
}
|
|
}))
|
|
|
|
// ASTC HDR 6x6
|
|
.function("setASTC_HDR_6x6_SetGaussian2", optional_override([](basis_encoder& self, float strength) {
|
|
if (strength <= 0.0f)
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian2_fallback = false;
|
|
else
|
|
{
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian2_fallback = true;
|
|
self.m_params.m_astc_hdr_6x6_options.m_gaussian2_strength = strength;
|
|
}
|
|
}))
|
|
|
|
// LDR->HDR upconversion options (all HDR modes)
|
|
// All HDR modes
|
|
.function("setLDR_HDR_Upconversion_sRGBToLinear", optional_override([](basis_encoder& self, bool srgb_to_linear) {
|
|
self.m_params.m_ldr_hdr_upconversion_srgb_to_linear = srgb_to_linear;
|
|
}))
|
|
|
|
// All HDR modes
|
|
.function("setLDR_HDR_Upconversion_NitMultiplier", optional_override([](basis_encoder& self, float multiplier) {
|
|
self.m_params.m_ldr_hdr_upconversion_nit_multiplier = multiplier;
|
|
}))
|
|
|
|
// If true, the input is assumed to be a normal map, and all source texels will be renormalized before encoding.
|
|
// Impacts LDR images only
|
|
.function("setRenormalize", optional_override([](basis_encoder& self, bool renormalize_flag) {
|
|
self.m_params.m_renormalize = renormalize_flag;
|
|
}))
|
|
|
|
// Sets the max # of endpoint clusters for ETC1S mode. Use instead of setQualityLevel.
|
|
// Default is 512, range is [1,BASISU_MAX_ENDPOINT_CLUSTERS]
|
|
// ETC1S mode
|
|
.function("setMaxEndpointClusters", optional_override([](basis_encoder& self, uint32_t max_endpoint_clusters) {
|
|
assert(max_endpoint_clusters <= BASISU_MAX_ENDPOINT_CLUSTERS);
|
|
self.m_params.m_etc1s_max_endpoint_clusters = max_endpoint_clusters;
|
|
}))
|
|
|
|
// Sets the max # of selectors clusters for ETC1S mode. Use instead of setQualityLevel.
|
|
// Default is 512, range is [1,BASISU_MAX_ENDPOINT_CLUSTERS]
|
|
// ETC1S mode
|
|
.function("setMaxSelectorClusters", optional_override([](basis_encoder& self, uint32_t max_selector_clusters) {
|
|
assert(max_selector_clusters <= BASISU_MAX_SELECTOR_CLUSTERS);
|
|
self.m_params.m_etc1s_max_selector_clusters = max_selector_clusters;
|
|
}))
|
|
|
|
// Sets the ETC1S or XUASTC LDR 4x4-12x12 encoder's quality level, which controls the file size vs. quality tradeoff.
|
|
// Default is -1 (meaning unused - the compressor will use m_max_endpoint_clusters/m_max_selector_clusters instead to control the codebook sizes in ETC1S mode, or no DCT in XUASTC LDR 4x4-12x12 mode).
|
|
// Range is [1,BASISU_QUALITY_MAX] (ETC1S) or [1,100] (XUASTC LDR 4x4-12x12)
|
|
// For XUASTC LDR, you also need to enable DCT usage, below.
|
|
// ETC1S mode or XUASTC LDR 4x4-12x12
|
|
.function("setQualityLevel", optional_override([](basis_encoder& self, int quality_level) {
|
|
assert(quality_level >= -1 && quality_level <= BASISU_QUALITY_MAX);
|
|
self.m_params.m_quality_level = quality_level;
|
|
}))
|
|
|
|
// The compression_level parameter controls the encoder perf vs. file size tradeoff for ETC1S files.
|
|
// It does not directly control file size vs. quality - see quality_level().
|
|
// Default is BASISU_DEFAULT_COMPRESSION_LEVEL, range is [0,BASISU_MAX_COMPRESSION_LEVEL]
|
|
// ETC1S mode
|
|
.function("setETC1SCompressionLevel", optional_override([](basis_encoder& self, int comp_level) {
|
|
assert(comp_level >= 0 && comp_level <= BASISU_MAX_ETC1S_COMPRESSION_LEVEL);
|
|
self.m_params.m_etc1s_compression_level = comp_level;
|
|
}))
|
|
|
|
// setNormalMapMode is the same as the basisu.exe "-normal_map" option. It tunes several codec parameters so compression works better on normal maps.
|
|
// ETC1S/UASTC LDR 4x4/UASTC HDR 4x4
|
|
.function("setNormalMapPreset", optional_override([](basis_encoder& self) {
|
|
|
|
self.m_params.set_srgb_options(false);
|
|
|
|
self.m_params.m_no_selector_rdo = true;
|
|
self.m_params.m_no_endpoint_rdo = true;
|
|
|
|
self.m_params.set_xuastc_ldr_srgb_channel_weights(false);
|
|
|
|
self.m_params.m_xuastc_ldr_sharpen_mode = (int)xuastc_ldr_sharpen_mode::cDisabled;
|
|
self.m_params.m_xuastc_ldr_deblocking_mode = (int)xuastc_ldr_deblocking_mode::cDisabled;
|
|
}))
|
|
|
|
// -photo or -srgb option (the codec's defaults)
|
|
.function("setPhotoPreset", optional_override([](basis_encoder& self) {
|
|
|
|
self.m_params.set_srgb_options(true);
|
|
|
|
self.m_params.m_no_selector_rdo = false;
|
|
self.m_params.m_no_endpoint_rdo = false;
|
|
|
|
self.m_params.set_xuastc_ldr_srgb_channel_weights(true);
|
|
|
|
self.m_params.m_xuastc_ldr_sharpen_mode = (int)xuastc_ldr_sharpen_mode::cDisabled;
|
|
self.m_params.m_xuastc_ldr_deblocking_mode = (int)xuastc_ldr_deblocking_mode::cUseSCDAndFilteringOnlyLargestBlocks;
|
|
}))
|
|
|
|
// -linear option
|
|
.function("setLinearPreset", optional_override([](basis_encoder& self) {
|
|
|
|
self.m_params.set_srgb_options(false);
|
|
|
|
self.m_params.set_xuastc_ldr_srgb_channel_weights(false);
|
|
}))
|
|
|
|
// -srgb option
|
|
.function("setSRGBPreset", optional_override([](basis_encoder& self) {
|
|
|
|
self.m_params.set_srgb_options(true);
|
|
|
|
self.m_params.set_xuastc_ldr_srgb_channel_weights(true);
|
|
}))
|
|
|
|
// Sets ETC1S selector RDO threshold
|
|
// Default is BASISU_DEFAULT_SELECTOR_RDO_THRESH, range is [0,1e+10]
|
|
// ETC1S
|
|
.function("setSelectorRDOThresh", optional_override([](basis_encoder& self, float selector_rdo_thresh) {
|
|
self.m_params.m_selector_rdo_thresh = selector_rdo_thresh;
|
|
}))
|
|
|
|
// Sets ETC1S endpoint RDO threshold
|
|
// Default is BASISU_DEFAULT_ENDPOINT_RDO_THRESH, range is [0,1e+10]
|
|
// ETC1S
|
|
.function("setEndpointRDOThresh", optional_override([](basis_encoder& self, float endpoint_rdo_thresh) {
|
|
self.m_params.m_endpoint_rdo_thresh = endpoint_rdo_thresh;
|
|
}))
|
|
|
|
#if BASISD_SUPPORT_KTX2
|
|
// --- KTX2 related options
|
|
//
|
|
// Create .KTX2 files instead of .basis files. By default this is FALSE.
|
|
// All formats
|
|
.function("setCreateKTX2File", optional_override([](basis_encoder& self, bool create_ktx2_file) {
|
|
self.m_params.m_create_ktx2_file = create_ktx2_file;
|
|
}))
|
|
|
|
// KTX2: Use UASTC Zstandard supercompression. Defaults to disabled or KTX2_SS_NONE.
|
|
// Impacts UASTC LDR 4x4, UASTC HDR 4x4, and ASTC HDR 6x6 (but not ASTC HDR 6x6 intermediate)
|
|
.function("setKTX2UASTCSupercompression", optional_override([](basis_encoder& self, bool use_zstandard) {
|
|
self.m_params.m_ktx2_uastc_supercompression = use_zstandard ? basist::KTX2_SS_ZSTANDARD : basist::KTX2_SS_NONE;
|
|
}))
|
|
|
|
// TODO: Expose KTX2 key value array, other options to JavaScript. See encoder/basisu_comp.h.
|
|
#endif
|
|
|
|
// KTX2/.basis: Use sRGB transfer func in the file's header/DFD. Default is FALSE. This should very probably match the "perceptual" and mipRGB settings.
|
|
// All formats
|
|
.function("setKTX2AndBasisSRGBTransferFunc", optional_override([](basis_encoder& self, bool srgb_transfer_func) {
|
|
self.m_params.m_ktx2_and_basis_srgb_transfer_function = srgb_transfer_func;
|
|
}))
|
|
|
|
// Sets all the sRGB-related options (m_perceptual, m_mip_srgb, m_ktx2_and_basis_srgb_transfer_function) to the specified value, ensuring they are all kept in sync.
|
|
// For ASTC/XUASTC LDR, also see the channel weights below: m_xuastc_ldr_channel_weights. They default to 3,11,1,11.
|
|
.function("setSRGBOptions", optional_override([](basis_encoder& self, bool srgb_flag) {
|
|
self.m_params.set_srgb_options(srgb_flag);
|
|
}))
|
|
|
|
// --- Mip-map options (format independent)
|
|
|
|
// If true mipmaps will be generated from the source images
|
|
.function("setMipGen", optional_override([](basis_encoder& self, bool mip_gen_flag) {
|
|
self.m_params.m_mip_gen = mip_gen_flag;
|
|
}))
|
|
|
|
// Set mipmap filter's scale factor
|
|
// default is 1, range is [.000125, 4.0]
|
|
.function("setMipScale", optional_override([](basis_encoder& self, float mip_scale) {
|
|
self.m_params.m_mip_scale = mip_scale;
|
|
}))
|
|
|
|
// Sets the mipmap filter to apply
|
|
// mip_filter must be < BASISU_MAX_RESAMPLER_FILTERS
|
|
// See the end of basisu_resample_filters.cpp: g_resample_filters[]
|
|
.function("setMipFilter", optional_override([](basis_encoder& self, uint32_t mip_filter) {
|
|
assert(mip_filter < g_num_resample_filters);
|
|
if (mip_filter < g_num_resample_filters)
|
|
self.m_params.m_mip_filter = g_resample_filters[mip_filter].name;
|
|
}))
|
|
|
|
// If true mipmap filtering occurs in sRGB space - this generally should match the perceptual parameter.
|
|
.function("setMipSRGB", optional_override([](basis_encoder& self, bool mip_srgb_flag) {
|
|
self.m_params.m_mip_srgb = mip_srgb_flag;
|
|
}))
|
|
|
|
// If true, the input is assumed to be a normal map, and the texels of each mipmap will be renormalized before encoding.
|
|
.function("setMipRenormalize", optional_override([](basis_encoder& self, bool mip_renormalize_flag) {
|
|
self.m_params.m_mip_renormalize = mip_renormalize_flag;
|
|
}))
|
|
|
|
// If true the source texture will be sampled using wrap addressing during mipmap generation, otherwise clamp.
|
|
.function("setMipWrapping", optional_override([](basis_encoder& self, bool mip_wrapping_flag) {
|
|
self.m_params.m_mip_wrapping = mip_wrapping_flag;
|
|
}))
|
|
|
|
// Sets the mipmap generator's smallest allowed dimension.
|
|
// default is 1, range is [1,16384]
|
|
.function("setMipSmallestDimension", optional_override([](basis_encoder& self, int mip_smallest_dimension) {
|
|
self.m_params.m_mip_smallest_dimension = mip_smallest_dimension;
|
|
}))
|
|
|
|
// Sets the .basis texture type.
|
|
// cBASISTexTypeVideoFrames changes the encoder into video mode.
|
|
// tex_type is enum basis_texture_type
|
|
// default is cBASISTexType2D
|
|
// All formats
|
|
.function("setTexType", optional_override([](basis_encoder& self, uint32_t tex_type) {
|
|
assert(tex_type < cBASISTexTypeTotal);
|
|
self.m_params.m_tex_type = (basist::basis_texture_type)tex_type;
|
|
}))
|
|
|
|
// All formats (.basis only)
|
|
.function("setUserData0", optional_override([](basis_encoder& self, uint32_t userdata0) {
|
|
self.m_params.m_userdata0 = userdata0;
|
|
}))
|
|
|
|
// All formats (.basis only)
|
|
.function("setUserData1", optional_override([](basis_encoder& self, uint32_t userdata1) {
|
|
self.m_params.m_userdata1 = userdata1;
|
|
}))
|
|
|
|
// UASTC LDR 4x4 specific flags.
|
|
|
|
// Sets the UASTC encoding performance vs. quality tradeoff, and other lesser used UASTC encoder flags.
|
|
// This is a combination of flags. See cPackUASTCLevelDefault, etc.
|
|
// UASTC LDR 4x4
|
|
.function("setPackUASTCFlags", optional_override([](basis_encoder& self, uint32_t pack_uastc_flags) {
|
|
assert((pack_uastc_flags & cPackUASTCLevelMask) >= cPackUASTCLevelFastest);
|
|
assert((pack_uastc_flags & cPackUASTCLevelMask) <= cPackUASTCLevelVerySlow);
|
|
self.m_params.m_pack_uastc_ldr_4x4_flags = pack_uastc_flags;
|
|
}))
|
|
|
|
// If true, the RDO post-processor will be applied to the encoded UASTC texture data.
|
|
// UASTC LDR 4x4
|
|
.function("setRDOUASTC", optional_override([](basis_encoder& self, bool rdo_uastc) {
|
|
self.m_params.m_rdo_uastc_ldr_4x4 = rdo_uastc;
|
|
}))
|
|
|
|
// Default is 1.0 range is [0.001, 10.0]
|
|
// UASTC LDR 4x4
|
|
.function("setRDOUASTCQualityScalar", optional_override([](basis_encoder& self, float rdo_quality) {
|
|
self.m_params.m_rdo_uastc_ldr_4x4_quality_scalar = rdo_quality;
|
|
}))
|
|
|
|
// Default is BASISU_RDO_UASTC_DICT_SIZE_DEFAULT, range is [BASISU_RDO_UASTC_DICT_SIZE_MIN, BASISU_RDO_UASTC_DICT_SIZE_MAX]
|
|
// UASTC LDR 4x4
|
|
.function("setRDOUASTCDictSize", optional_override([](basis_encoder& self, int dict_size) {
|
|
assert((dict_size >= BASISU_RDO_UASTC_DICT_SIZE_MIN) && (dict_size <= BASISU_RDO_UASTC_DICT_SIZE_MAX));
|
|
self.m_params.m_rdo_uastc_ldr_4x4_dict_size = dict_size;
|
|
}))
|
|
|
|
// Default is UASTC_RDO_DEFAULT_MAX_ALLOWED_RMS_INCREASE_RATIO, range is [01, 100.0]
|
|
// UASTC LDR 4x4
|
|
.function("setRDOUASTCMaxAllowedRMSIncreaseRatio", optional_override([](basis_encoder& self, float rdo_uastc_max_allowed_rms_increase_ratio) {
|
|
self.m_params.m_rdo_uastc_ldr_4x4_max_allowed_rms_increase_ratio = rdo_uastc_max_allowed_rms_increase_ratio;
|
|
}))
|
|
|
|
// Default is UASTC_RDO_DEFAULT_SKIP_BLOCK_RMS_THRESH, range is [.01f, 100.0f]
|
|
// UASTC LDR 4x4
|
|
.function("setRDOUASTCSkipBlockRMSThresh", optional_override([](basis_encoder& self, float rdo_uastc_skip_block_rms_thresh) {
|
|
self.m_params.m_rdo_uastc_ldr_4x4_skip_block_rms_thresh = rdo_uastc_skip_block_rms_thresh;
|
|
}))
|
|
|
|
// XUASTC/ASTC LDR 4x4-12x12 specific options
|
|
|
|
// Enable XUASTC LDR DCT usage. Recommended to also enabled lossy supercompression for more compression.
|
|
// DCT quality [1,100] is set via setQualityLevel() above.
|
|
.function("setXUASTCLDRUseDCT", optional_override([](basis_encoder& self, bool xuastc_use_dct) {
|
|
self.m_params.m_xuastc_ldr_use_dct = xuastc_use_dct;
|
|
}))
|
|
|
|
// Enables lossy XUASTC LDR supercompression (bounded distortion/windowed RDO)
|
|
.function("setXUASTCLDRUseLossySupercompression", optional_override([](basis_encoder& self, bool xuastc_use_lossy_supercompression) {
|
|
self.m_params.m_xuastc_ldr_use_lossy_supercompression = xuastc_use_lossy_supercompression;
|
|
}))
|
|
|
|
// XUASTC LDR: Disable 2-3 subset usage, independent of effort level (for lower quality, for faster transcoding to BC7)
|
|
.function("setXUASTCLDRForceDisableSubsets", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_xuastc_ldr_force_disable_subsets = flag;
|
|
}))
|
|
|
|
// XUASTC LDR: Disable RGB dual plane usage, indepdnent of effort level (for lower quality, for faster transcoding to BC7)
|
|
.function("setXUASTCLDRForceDisableRGBDualPlane", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_xuastc_ldr_force_disable_rgb_dual_plane = flag;
|
|
}))
|
|
|
|
// Sets the XUASTC LDR syntax: see the xuastc_ldr_syntax enum.
|
|
.function("setXUASTCLDRSyntax", optional_override([](basis_encoder& self, int syntax) {
|
|
self.m_params.m_xuastc_ldr_syntax = syntax;
|
|
}))
|
|
|
|
// Sets the ASTC/XUASTC LDR: compressor effort level [0,10] (encoding time vs. max achievable quality tradeoff, higher=slower)
|
|
// This is like setCompressionLevel() above, but for only ASTC/UASTC LDR 4x4-12x12, and has a different range.
|
|
.function("setASTCOrXUASTCLDREffortLevel", optional_override([](basis_encoder& self, int effort_level) {
|
|
self.m_params.m_xuastc_ldr_effort_level = effort_level;
|
|
}))
|
|
|
|
// Sets the ASTC/XUASTC LDR channel weights
|
|
// The default channel weights are 3,11,1,11 - so override them for linear content (like normal maps or non-sRGB content).
|
|
.function("setASTCOrXUASTCLDRWeights", optional_override([](basis_encoder& self, uint32_t x, uint32_t y, uint32_t z, uint32_t w) {
|
|
self.m_params.m_xuastc_ldr_channel_weights[0] = x;
|
|
self.m_params.m_xuastc_ldr_channel_weights[1] = y;
|
|
self.m_params.m_xuastc_ldr_channel_weights[2] = z;
|
|
self.m_params.m_xuastc_ldr_channel_weights[3] = w;
|
|
}))
|
|
|
|
// Sets XUASTC LDR lossy supercompression (bounded/windows RDO) parameters.
|
|
// Must be enabled via setXUASTCLDRUseLossySupercompression().
|
|
.function("setXUASTCLDRBoundedRDOParam", optional_override([](basis_encoder& self, uint32_t idx, float value) {
|
|
switch (idx)
|
|
{
|
|
case 0: self.m_params.m_ls_min_psnr = value; break;
|
|
case 1: self.m_params.m_ls_min_alpha_psnr = value; break;
|
|
case 2: self.m_params.m_ls_thresh_psnr = value; break;
|
|
case 3: self.m_params.m_ls_thresh_alpha_psnr = value; break;
|
|
case 4: self.m_params.m_ls_thresh_edge_psnr = value; break;
|
|
case 5: self.m_params.m_ls_thresh_edge_alpha_psnr = value; break;
|
|
default:
|
|
assert(0);
|
|
break;
|
|
}
|
|
}))
|
|
|
|
// Enable/disable XUASTC LDR blur candidates (very slow)
|
|
.function("setXUASTCLDRUseBlurring", optional_override([](basis_encoder& self, bool use_blurring) {
|
|
self.m_params.m_xuastc_ldr_blurring = use_blurring;
|
|
}))
|
|
|
|
// Enable/disable astcenc utilization (library support must have been compiled in), compressor_mode is enum xuastc_ldr_astc_comp_selection
|
|
.function("setXUASTCLDRSelectCompressor", optional_override([](basis_encoder& self, int compressor_mode) {
|
|
self.m_params.m_xuastc_ldr_astc_comp_selection = compressor_mode;
|
|
}))
|
|
|
|
.function("setXUASTCLDRSharpenMode", optional_override([](basis_encoder& self, int sharpen_mode) {
|
|
self.m_params.m_xuastc_ldr_sharpen_mode = sharpen_mode;
|
|
}))
|
|
|
|
.function("setXUASTCLDRSharpenAmount", optional_override([](basis_encoder& self, float sharpen_amount) {
|
|
self.m_params.m_xuastc_ldr_sharpen_amount = sharpen_amount;
|
|
}))
|
|
|
|
// Enable/disable deblocking on large block sizes during encoding (also writes the DeblockFilterID key to the output ktx2 file)
|
|
// deblocking_mode is enum xuastc_ldr_deblocking_mode
|
|
.function("setXUASTCLDRDeblockingMode", optional_override([](basis_encoder& self, int deblocking_mode) {
|
|
self.m_params.m_xuastc_ldr_deblocking_mode = deblocking_mode;
|
|
}))
|
|
|
|
// Sets the # of deblocking passes utilized [2,256], 256=auto (set automatically from XUASTC LDR effort level)
|
|
.function("setXUASTCLDRNumDeblockingPasses", optional_override([](basis_encoder& self, int num_passes) {
|
|
self.m_params.m_xuastc_ldr_num_deblocking_passes = num_passes;
|
|
}))
|
|
|
|
// Try simplified latent configs (better low bitrate quality)
|
|
.function("setXUASTCLDRHeavySubsetUsage", optional_override([](basis_encoder& self, bool flag) {
|
|
self.m_params.m_xuastc_ldr_heavy_subset_usage = flag;
|
|
}))
|
|
|
|
// --- XUBC7 related options
|
|
.function("setXUBC7EffortLevel", optional_override([](basis_encoder& self, int effort_level) {
|
|
self.m_params.m_xubc7_effort_level = effort_level;
|
|
}))
|
|
|
|
.function("setXUBC7RDOLevel", optional_override([](basis_encoder& self, int rdo_level) {
|
|
self.m_params.m_xubc7_rdo_level = rdo_level;
|
|
}))
|
|
|
|
.function("setXUBC7NumStripes", optional_override([](basis_encoder& self, int num_stripes) {
|
|
self.m_params.m_xubc7_num_stripes = num_stripes;
|
|
}))
|
|
|
|
// Selects the BC7 base encoder XUBC7 packs with: cBC7F = built-in fast packer
|
|
// (default), cBC7E_Scalar = slower, higher quality. encoder is enum
|
|
// xubc7_bc7_encoder_type.
|
|
.function("setXUBC7Encoder", optional_override([](basis_encoder& self, int encoder) {
|
|
self.m_params.m_xubc7_encoder = encoder;
|
|
}))
|
|
|
|
// bc7e_scalar quality level [0,6] (only used when the encoder is bc7e_scalar).
|
|
.function("setXUBC7BC7EScalarLevel", optional_override([](basis_encoder& self, int level) {
|
|
self.m_params.m_xubc7_bc7e_scalar_level = level;
|
|
}))
|
|
|
|
// --- DDS export options (used by encodeToDDS()) ---
|
|
|
|
// Sets the DDS output format from a token (case-insensitive), e.g. "bc1","bc2","bc3","bc4","bc5",
|
|
// "bc7","a8r8g8b8","a8b8g8r8","r8","r8g8","r5g6b5","a1r5g5b5","a4r4g4b4". Returns false on an
|
|
// unrecognized token (and leaves the format unchanged). The sRGB-vs-UNORM DXGI variant is taken
|
|
// from the sRGB transfer-function flag (setKTX2SRGBTransferFunc), not from this token.
|
|
.function("setDDSFormat", optional_override([](basis_encoder& self, std::string token) {
|
|
dds_output_format fmt;
|
|
if (!parse_dds_output_format(token.c_str(), fmt))
|
|
return false;
|
|
self.m_dds_params.m_format = fmt;
|
|
return true;
|
|
}))
|
|
|
|
// Sets the DDS output format directly from a dds_output_format enum value (e.g.
|
|
// Module.dds_output_format.cDDSFmtBC7.value). Returns false on an out-of-range value (the
|
|
// format is left unchanged); cDDSFmtInvalid/cDDSFmtTotal are not valid selections.
|
|
.function("setDDSFormatEnum", optional_override([](basis_encoder& self, int format) {
|
|
if ((format <= (int)cDDSFmtInvalid) || (format >= (int)cDDSFmtTotal))
|
|
return false;
|
|
self.m_dds_params.m_format = (dds_output_format)format;
|
|
return true;
|
|
}))
|
|
|
|
// "bc7" DDS only: selects the BC7 base packer. encoder is enum dds_bc7_encoder
|
|
// (cDDSBC7Encoder_BC7F = built-in fast packer (default), cDDSBC7Encoder_BC7E_Scalar = slower/better).
|
|
// Returns false on an unrecognized value (the encoder is left unchanged).
|
|
.function("setDDSBC7Encoder", optional_override([](basis_encoder& self, int encoder) {
|
|
if ((encoder != cDDSBC7Encoder_BC7F) && (encoder != cDDSBC7Encoder_BC7E_Scalar))
|
|
return false;
|
|
self.m_dds_params.m_bc7_encoder = (dds_bc7_encoder)encoder;
|
|
return true;
|
|
}))
|
|
|
|
// "bc7" DDS only (bc7f packer): quality level, enum dds_bc7f_level [0,2]
|
|
// (0=analytical, 1=partially analytical (default), 2=non analytical / slowest-best).
|
|
.function("setDDSBC7FLevel", optional_override([](basis_encoder& self, int level) {
|
|
self.m_dds_params.m_bc7f_level = clamp(level, (int)cDDSBC7FLevel_Analytical, (int)cDDSBC7FLevel_NonAnalytical);
|
|
}))
|
|
|
|
// "bc7" DDS only (bc7e_scalar packer): quality level [0,6], 0=ultrafast..6=slowest.
|
|
.function("setDDSBC7EScalarLevel", optional_override([](basis_encoder& self, int level) {
|
|
self.m_dds_params.m_bc7e_scalar_level = clamp(level, 0, 6);
|
|
}))
|
|
|
|
// --- Low level options
|
|
|
|
// Disables ETC1S selector RDO
|
|
.function("setNoSelectorRDO", optional_override([](basis_encoder& self, bool no_selector_rdo_flag) {
|
|
self.m_params.m_no_selector_rdo = no_selector_rdo_flag;
|
|
}))
|
|
|
|
// Disables ETC1S endpoint RDO
|
|
.function("setNoEndpointRDO", optional_override([](basis_encoder& self, bool no_endpoint_rdo_flag) {
|
|
self.m_params.m_no_endpoint_rdo = no_endpoint_rdo_flag;
|
|
}))
|
|
|
|
// Display output PSNR statistics
|
|
// All formats
|
|
.function("setComputeStats", optional_override([](basis_encoder& self, bool compute_stats_flag) {
|
|
self.m_params.m_compute_stats = compute_stats_flag;
|
|
}))
|
|
|
|
.function("setPrintStats", optional_override([](basis_encoder& self, bool print_stats_flag) {
|
|
self.m_params.m_print_stats = print_stats_flag;
|
|
}))
|
|
|
|
// Write output .PNG/.EXR files for debugging
|
|
// All formats
|
|
.function("setDebugImages", optional_override([](basis_encoder& self, bool debug_images_flag) {
|
|
self.m_params.m_debug_images = debug_images_flag;
|
|
}))
|
|
|
|
.function("setStatusOutput", optional_override([](basis_encoder& self, bool status_output) {
|
|
self.m_params.m_status_output = status_output;
|
|
}))
|
|
|
|
;
|
|
#endif // BASISU_SUPPORT_ENCODING
|
|
|
|
}
|