Emscripten Contrib Ports¶
Contrib ports are contributed by the wider community and supported on a “best effort” basis. Since they are not run as part of emscripten CI they are not always guaranteed to build or function.
The following is the complete list of the contrib ports that are
available in emscripten. In order to use a contrib port you use the
--use-port=<port_name> option (emcc).
contrib.glfw3¶
This project is an Emscripten port of GLFW written in C++ for the web/webassembly platform.
Note
Emscripten includes support for both GLFW 2 and 3 written in Javascript.
These can be activated with the settings -sUSE_GLFW=2
and -sUSE_GLFW=3. This non-official contribution, written in C++,
provides a more extensive and up-to-date implementation of the GLFW 3 API
than the built-in port. It is enabled with the option
--use-port=contrib.glfw3.
License: Apache 2.0 license
contrib.lua¶
Lua is a powerful, efficient, lightweight, embeddable scripting language.
Example usage:
// main.c
#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>
#include <stdio.h>
int main() {
lua_State *L = luaL_newstate();
luaL_openlibs(L);
if (luaL_dostring(L, "print('hello world')") != LUA_OK) {
printf("Error running Lua code %s\n", lua_tostring(L, -1));
lua_pop(L, 1);
}
lua_close(L);
return 0;
}
// compile with
emcc --use-port=contrib.lua main.c -o /tmp/index.html
License: MIT License
contrib.libwebp¶
libwebp is a library for encoding and decoding images in the WebP format, including animation, alpha and metadata (mux/demux) support.
Example usage:
// main.c
#include <webp/decode.h>
#include <webp/encode.h>
#include <stdio.h>
int main() {
uint8_t rgba[4 * 4 * 4] = {0};
uint8_t *webp = NULL;
size_t webp_size = WebPEncodeRGBA(rgba, 4, 4, 4 * 4, 80.0f, &webp);
printf("encoded %zu bytes\n", webp_size);
WebPFree(webp);
return 0;
}
// compile with
emcc --use-port=contrib.libwebp main.c -o /tmp/index.html
Passing -pthread alongside --use-port=contrib.libwebp builds a
multi-threaded variant of the library, which can speed up encoding.
License: BSD-3-Clause license