OpenCV Emscripten 编译 opencv.js

缘起

周末偶尔在浏览最新的openCV 4 系列时看到platforms目录下已经有js目录，看了眼，使用了 WebAssembly 技术；使得C++ 代码编译后能被JS调用；
本来以为WebAssembly 距离实际应用还很远，但是查询了下最新的兼容性数据：

wasm浏览器支持

其实已经被主流浏览器支持了；另外据知乎说bilibili已经在视频上传阶段使用WebAssembly做端上的模型加速处理了；发展的还真是快啊

看了眼opencv的js目录下README.md文件，这么简短的README.md文件，直觉告诉我，会遇到坑。但JS上跑opencv的想法无法拒绝啊，决定踩坑。

踩坑

基础环境 Mac 10.13.6, 安装了 git/cmake/make/xcode command line

1 安装 Emscripten 官方文档

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
git pull
./emsdk install latest  # 在国内这个下载是真慢
./emsdk activate latest
source ./emsdk_env.sh

2 新建 build-js目录

cd build-js
python ~/opencv-4.0.1/platforms/js/build_js.py .  --emscripten_dir 
 ~/emsdk/upstream/emscripten --build_wasm

此处注意两个地方，一个是习惯性思维走cmake的gui界面去生成工程，勾选opencv.js的选项，折腾了很长时间。后来想想真是稀里糊涂，Emscripten需要用单独的工具链，直接用cmake 去生成肯定用的PC的工具链啊；二是emscripten_dir 选项的设置，后面会讲到；

build_js.py

仔细看 platforms/js/buid_js.py 文件能发现里面Builder类里面两处重要的地方：

其一；get_toolchain_file 函数直接从 emscripten_dir 目录下读取转悠的 Emscripten.cmake 文件，该文件应该就是定义了一系列独有的tools的地方；

从这个地方也知道 emscripten_dir 这个目录需要配置成能从该目录下找到 cmake/Modules/Platform/Emscripten.cmake 的目录；这也是上面编译命令 --emscripten_dir 选项设置目录的依据；

其二；get_cmake_cmd 函数定义了一系列的opencv的宏配置；从中也能看出来被打开的模块并不多：ZLIB，calib3d，dnn，features2d，flann，photo；

遇到的问题

编译过程中间遇到 reference ambiguous 的报错；如下，仔细看错误信息知道这是一个对index重复定义的问题，命名太随意了导致。两个定义的地方一个是 emscripten/system/include/libc/strings.h 一个是 emscripten/system/include/emscripten/bind.h；都没法动；
发生错误的地方是build-js/modules/js/bindings.cpp；这个文件是生成的，可以动；所以最好在这里改动下

～/opencv-4.0.1/build-js/modules/js/bindings.cpp:508:18: error: reference to 'index' is ambiguous
        .element(index<0>())
                 ^
～/emsdk/upstream/emscripten/system/include/libc/strings.h:19:7: note: candidate found by name lookup is 'index'
char *index (const char *, int);
      ^
～/emsdk/upstream/emscripten/system/include/emscripten/bind.h:767:12: note: candidate found by name lookup is
      'emscripten::index'
    struct index {
           ^
～/opencv-4.0.1/build-js/modules/js/bindings.cpp:509:18: error: reference to 'index' is ambiguous
        .element(index<1>())
                 ^
～/emsdk/upstream/emscripten/system/include/libc/strings.h:19:7: note: candidate found by name lookup is 'index'
char *index (const char *, int);
      ^
～/emsdk/upstream/emscripten/system/include/emscripten/bind.h:767:12: note: candidate found by name lookup is
      'emscripten::index'
    struct index {
           ^
～/opencv-4.0.1/build-js/modules/js/bindings.cpp:510:18: error: reference to 'index' is ambiguous
        .element(index<2>())
                 ^
～/emsdk/upstream/emscripten/system/include/libc/strings.h:19:7: note: candidate found by name lookup is 'index'
char *index (const char *, int);
      ^
～/emsdk/upstream/emscripten/system/include/emscripten/bind.h:767:12: note: candidate found by name lookup is
      'emscripten::index'
    struct index {
           ^
～/opencv-4.0.1/build-js/modules/js/bindings.cpp:511:18: error: reference to 'index' is ambiguous
        .element(index<3>());
                 ^
～/emsdk/upstream/emscripten/system/include/libc/strings.h:19:7: note: candidate found by name lookup is 'index'
char *index (const char *, int);
      ^
～/emsdk/upstream/emscripten/system/include/emscripten/bind.h:767:12: note: candidate found by name lookup is
      'emscripten::index'
    struct index {

仔细看了下bind.h的代码，发现里面的代码都在 namespace emscripten里面，那就好办了，bindings.cpp里面用到index的地方都加个前缀：

emscripten::value_array> ("Scalar")
        .element(index<0>())
        .element(index<1>())
        .element(index<2>())
        .element(index<3>());

改成
emscripten::value_array> ("Scalar")
        .element(emscripten::index<0>())
        .element(emscripten::index<1>())
        .element(emscripten::index<2>())
        .element(emscripten::index<3>());

最终在build-js/bin目录下编译出来opencv.js文件，大小7.3MB。

接下来摸索下写自己的C++ 处理函数以及经过warp后供JS调用；

期待有时间搞个JS版本的Pulp Camera。