Using libraries with emscripten

jmoggr picture jmoggr · Dec 27, 2014 · Viewed 7.3k times · Source

I have just started using Emscripten and would like to start using GLFW and other libraries. I am completely lost on how to build, link, and use other libraries with Emscripten.

I have tried following the instructions on the Emscripten site but have they haven't helped me any. http://kripken.github.io/emscripten-site/docs/compiling/Building-Projects.html#using-libraries

Is there any place with detailed instructions on how to use libraries with Emscripten? Or specifically GLFW?

Answer

CoffeDeveloper picture CoffeDeveloper · Dec 27, 2014

Emscripten provide itself very few libraries. Those libraries are the minimum to get some OperativeSystem functionality on emscripten C++ code (audio, input, video)

  • libc: standard library for C
  • libc++: standard library for C++
  • SDL: SimpleDirectmediaLayer (SDL 1.X a opensource cross-platform project)
  • GLES2: OpenGL ES 2 API
  • GLFW: GLFW 2.X

For example, the standard way to include OpenGLES2 in Emscripten is:

#include <GLES2/gl2.h>

While to include GLFW:

#include <GL/glfw.h>

There's some crap in that, because if you want to use the more recent version of GLFW you just can't because Emscripten provides only 1 version of the library and you have to stick with that (unless Emscripten do a update for that and you update Emscripten).

You can compile libraries for emscripten only if that libraries can be compiled using one(or more) of the libraries listed above. (or if you know how to wrap javascript funciontalities and expose them through C interface)

Also, try to avoid templates only libraries when using Emscripten, they literally generate a lot of bloat code you could easily increase executable size by several MBs: This is a problem if you were already using Boost or UBLAS.

Since GLFW is not one of the libraries that are automatically linked, you should link it with:

-lglfw

You can find an example OpenGL project using Emscripten here:

https://github.com/QafooLabs/emscripten-opengl-example

you can inspect linker flags by opening the makefile