wasm-bindgen/examples/raytrace-parallel/README.md

# Parallel Raytracing

[View documentation for this example online][dox] or [View compiled example
online][compiled]

[dox]: https://rustwasm.github.io/docs/wasm-bindgen/examples/raytrace.html
[compiled]: https://rustwasm.github.io/wasm-bindgen/exbuild/raytrace-parallel/

You can build the example locally with:

```
$ ./build.sh
```

(or running the commands on Windows manually)

and then visiting http://localhost:8080 in a browser should run the example!
Implement support for WebAssembly threads ... and add a parallel raytracing demo! This commit adds enough support to `wasm-bindgen` to produce a workable wasm binary today with the experimental WebAssembly threads support implemented in Firefox Nightly. I've tried to comment what's going on in the commits and such, but at a high level the changes made here are: * A new transformation, living in a new `wasm-bindgen-threads-xform` crate, prepares a wasm module for parallel execution. This performs a number of mundane tasks which I hope to detail in a blog post later on. * The `--no-modules` output is enhanced with more support for when shared memory is enabled, allowing passing in the module/memory to initialize the wasm instance on multiple threads (sharing both module and memory). * The `wasm-bindgen` crate now offers the ability, in `--no-modules` mode, to get a handle on the `WebAssembly.Module` instance. * The example itself requires Xargo to recompile the standard library with atomics and an experimental feature enabled. Afterwards it experimentally also enables threading support in wasm-bindgen. I've also added hopefully enough CI support to compile this example in a builder so we can upload it and poke around live online. I hope to detail more about the technical details here in a blog post soon as well! 2018-10-04 20:00:23 -07:00			`# Parallel Raytracing`

			`[View documentation for this example online][dox] or [View compiled example`
			`online][compiled]`

docs: update docs link 2019-05-26 16:43:00 +09:00			`[dox]: https://rustwasm.github.io/docs/wasm-bindgen/examples/raytrace.html`
fixed link to compiled raytrace-parallel in examples 2018-11-30 23:36:27 +03:00			`[compiled]: https://rustwasm.github.io/wasm-bindgen/exbuild/raytrace-parallel/`
Implement support for WebAssembly threads ... and add a parallel raytracing demo! This commit adds enough support to `wasm-bindgen` to produce a workable wasm binary today with the experimental WebAssembly threads support implemented in Firefox Nightly. I've tried to comment what's going on in the commits and such, but at a high level the changes made here are: * A new transformation, living in a new `wasm-bindgen-threads-xform` crate, prepares a wasm module for parallel execution. This performs a number of mundane tasks which I hope to detail in a blog post later on. * The `--no-modules` output is enhanced with more support for when shared memory is enabled, allowing passing in the module/memory to initialize the wasm instance on multiple threads (sharing both module and memory). * The `wasm-bindgen` crate now offers the ability, in `--no-modules` mode, to get a handle on the `WebAssembly.Module` instance. * The example itself requires Xargo to recompile the standard library with atomics and an experimental feature enabled. Afterwards it experimentally also enables threading support in wasm-bindgen. I've also added hopefully enough CI support to compile this example in a builder so we can upload it and poke around live online. I hope to detail more about the technical details here in a blog post soon as well! 2018-10-04 20:00:23 -07:00
			`You can build the example locally with:`

			```
			`$ ./build.sh`
			```

			`(or running the commands on Windows manually)`

			`and then visiting http://localhost:8080 in a browser should run the example!`