libavoid-js

Libavoid port for js.

Usage

There are two versions of the library:

• Release version of the library is in dist directory
• Debug version of the library is in examples/lib directory

A usage example is in examples directory. To try it out start http server in this directory, just opening index.html in your browser doesn't work unfortunately.

The library works in both webbrowser and node.js environments.

Documentation

Library API Documentation is in api_docs_build directory, just open index.html

FAQ

• I get the following error: RuntimeError: Aborted(CompileError: WebAssembly.instantiate(): expected magic word ...

  It means, that libavoid.wasm file is invalid. Please check in Network tab of the browser, that it is downloaded without errors and its size is the same as of libavoid.wasm file.

Build

Requirements

• Git (to clone original libavoid library)
• Docker (used to run emcc)
• Python 3.5+ (used for tooling/build automation)

Build commands

1. npm run full-rebuild

   It will generate both release and debug versions of the library, also update documentation.

2. If you want only to rebuild JS package without regenerating bindings, you can use the following command: npm run build

Debugging

Address to source map is hardcoded in tools/generate.py script and is always 'http://localhost:8080' in debug build.

Also, symlink to adaptagrams should be in examples directory to provide libavoid sources for debugger.

Lessons learned

• WebIDL is a powerful concept, but implementation in emscripten toolset is not very actively developed and if certain feature is missing such as support of callbacks or you encounter a bug, you should be ready to implement or to fix it by yourself. We started with WebIDL(own fork with implementation of callbacks, support of prefixed enums and more) and then switched to embind. Embind supports more features, so probability you need to modify it is lower, and it is more performant.

History

This project was started as part of a research project at Technische Universität Wien and is further developed by its author and contributors.