DDS.wasm

A WebAssembly wrapper to display dds images on web pages in the browser.

Demo / viewer

This demo shows how to use dds files in regular img tags. You can check out the demo here

Usage as a library

npm install --save git+https://github.com/remixer-dec/dds.wasm.git (if it hangs, use yarn)

import * as ddsLoader from 'dds.wasm'
// this loads the wasm file
ddsLoader.isReady.then(async () => {
  // wasm runtime is ready
  const url = await ddsLoader.getDDSImage('path/to/file.dds')
  // returns a string with url of converted displayable image.
  // you can set it in <img>'s src attribute to see the image
  // to get image metadata and bytes, add the second argument {outputFormat: 'data'}
  // to toggle transparency, add {transparency: true} in the second argument
})

Setup

• clone the repo git clone https://github.com/remixer-dec/dds.wasm
• update dds library git submodule update --init --recursive
• install the project npm install
• start the web server npm run dev
• build the demo for production npm run build
• build the library for production npm run build-lib

Rebuilding wasm files

• fix the c library dds.c, replace #include <dds/dds.c> with #include "dds.c"
• set up the environment with emscripten sdk, to do it on ARM64 machine, you can use command npm run create-container, then update the dependencies with npm run update-container
• open container shell docker exec -it emsdk bash, go to /mnt, cd /mnt and build c modules with npm run compile

Credits

Original C library by dfranx