https://github.com/linux-china/embind_demo
Emscripten embind demo
https://github.com/linux-china/embind_demo
Last synced: about 1 year ago
JSON representation
Emscripten embind demo
- Host: GitHub
- URL: https://github.com/linux-china/embind_demo
- Owner: linux-china
- Created: 2019-10-09T22:54:37.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-10-23T16:25:38.000Z (over 6 years ago)
- Last Synced: 2025-04-02T02:51:08.898Z (over 1 year ago)
- Language: C++
- Size: 46.9 KB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Embind Demo
===================
WebAssembly bind demo with embind & Web IDL
# WebIDL Binder
https://emscripten.org/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.html
* Create WebIDL, for example hello.idl
* Generate cpp file from idl
* Create C++ header file with Class definition
* Implement C++ class
* Compile cpp to wasm and js
# Wasm call JS functions
* Implement a C API in JavaScript: https://emscripten.org/docs/porting/connecting_cpp_and_javascript/Interacting-with-code.html
* Using val to transliterate JavaScript to C++: https://emscripten.org/docs/porting/connecting_cpp_and_javascript/embind.html#using-val-to-transliterate-javascript-to-c
* Memory views and Access memory from JavaScript:
```c
unsigned char *byteBuffer;
val getBytes(offset, lenth) {
return val(typed_memory_view(lenth, byteBuffer+offset));
}
```
* Passing and returning WebAssembly array parameters: https://becominghuman.ai/passing-and-returning-webassembly-array-parameters-a0f572c65d97
* Access memory from JavaScript: https://emscripten.org/docs/porting/connecting_cpp_and_javascript/Interacting-with-code.html
# Reactive communication between Wasm and Hosting
### receive connection & messages from peer
* void send(int id, int type, String metadata, String data)
* void receive(int id, int type, String metadata, String data)
Wasm的唯一标识在初始化wasm的js中进行设置，然后在通讯过程中进行拦截。
Asyncify: https://emscripten.org/docs/porting/asyncify.html
TinyFSM: a simple finite state machine library for C++, designed for optimal performance and low memory footprint. https://digint.ch/tinyfsm/index.html
# Extension
* EventBus: 可以利用Hosting runtime提供的EventBus特性，这样可以实现pub/sub https://nodejs.org/dist/latest-v13.x/docs/api/events.html
# Clion Integration
CLion with emscripten: Settings > Build, Execution, Deployment > CMake, add following in CMake options:
```
-DCMAKE_TOOLCHAIN_FILE=/usr/local/opt/emscripten/libexec/cmake/Modules/Platform/Emscripten.cmake
```
# References
* Google Developer WebAssembly: https://developers.google.cn/web/updates/tags/webassembly
* Embind: https://emscripten.org/docs/porting/connecting_cpp_and_javascript/embind.html
* Emscripten’s embind: https://developers.google.cn/web/updates/2018/08/embind
* Emscripten and npm: https://developers.google.cn/web/updates/2019/01/emscripten-npm
* Replacing a hot path in your app's JavaScript with WebAssembly: https://developers.google.cn/web/updates/2019/02/hotpath-with-wasm
* Emscripten Compiler Frontend: https://emscripten.org/docs/tools_reference/emcc.html
* Web IDL: https://heycam.github.io/webidl/