docs/README-emscripten.md
author Sam Lantinga <slouken@libsdl.org>
Fri, 07 Oct 2016 17:46:58 -0700
changeset 10486 5bf595c48fd4
parent 9782 fcf237e5e834
child 10896 bc382771cd10
permissions -rw-r--r--
Converted README documentation to DOS text format
slouken@10486
     1
Emscripten
slouken@10486
     2
================================================================================
slouken@10486
     3
slouken@10486
     4
Build:
slouken@10486
     5
slouken@10486
     6
    $ mkdir build
slouken@10486
     7
    $ cd build
slouken@10486
     8
    $ emconfigure ../configure --host=asmjs-unknown-emscripten --disable-assembly --disable-threads --enable-cpuinfo=false CFLAGS="-O2"
slouken@10486
     9
    $ emmake make
slouken@10486
    10
slouken@10486
    11
Or with cmake:
slouken@10486
    12
slouken@10486
    13
    $ mkdir build
slouken@10486
    14
    $ cd build
slouken@10486
    15
    $ emcmake cmake ..
slouken@10486
    16
    $ emmake make
slouken@10486
    17
slouken@10486
    18
To build one of the tests:
slouken@10486
    19
slouken@10486
    20
    $ cd test/
slouken@10486
    21
    $ emcc -O2 --js-opts 0 -g4 testdraw2.c -I../include ../build/.libs/libSDL2.a ../build/libSDL2_test.a -o a.html
slouken@10486
    22
slouken@10486
    23
Uses GLES2 renderer or software
slouken@10486
    24
slouken@10486
    25
tests: https://dl.dropboxusercontent.com/u/17360362/SDL2-em/index.html
slouken@10486
    26
slouken@10486
    27
Some other SDL2 libraries can be easily built (assuming SDL2 is installed somewhere):
slouken@10486
    28
slouken@10486
    29
SDL_mixer (http://www.libsdl.org/projects/SDL_mixer/):
slouken@10486
    30
slouken@10486
    31
    $ EMCONFIGURE_JS=1 emconfigure ../configure
slouken@10486
    32
    build as usual...
slouken@10486
    33
slouken@10486
    34
SDL_gfx (http://cms.ferzkopp.net/index.php/software/13-sdl-gfx):
slouken@10486
    35
slouken@10486
    36
    $ EMCONFIGURE_JS=1 emconfigure ../configure --disable-mmx
slouken@10486
    37
    build as usual...