1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
# WebAudio Csound
Authors: Steven Yi, Victor Lazzarini, Edward Costello
## Introduction
These are the sources for WebAudio Csound, based on Web Assembly (WASM)
and the Web Audio API. It supports the AudioWorklet interface if
present, falling back to using ScriptProcessorNode otherwise. Csound
is availble through the use of the CsoundObj API, or as an audio
processor Node.
## Requirements
* [Emscripten SDK/toolchain](https://github.com/kripken/emscripten): install
the Emscripten tools using these \
[instructions](https://kripken.github.io/emscripten-site/docs/getting_started/downloads.html)
thoroughly. Make sure all steps are followed to ensure a correct
installation of the toolchain.
* [NPM](https://www.npmjs.com/): Used to assemble the CsoundObj.js release
* [JSDoc]](https://usejsdoc.org): if you are build a release package
and/or documentation, you will need to install JSDoc.
## Build Instructions
1. First you will need to build libsndfile. Use the
`download_and_build_libsndfile.sh` script. In the emscripten folder, run
`sh ./download_and_build_libsndfile.sh`. This will create a deps folder,
download libsndfile 1.0.25, unarchive the tarball, and then compile libsndfile
with Emscripten.
2. Run the build.sh script using `sh ./build.sh`. This will create a build
folder (./dist), run cmake from there with the Csound source, then compile Csound
with Emscripten, producing the WASM binaries and their JS interfaces.
At this point, the two .js files in the ./dist folder are all that are necessary to run Csound in a
Web browser that supports WebAudio.
### Release Instructions
This step builds a release package with the distribution files and documentation.
1. Run `sh build.sh`
2. Run `sh update_example_libs_from_dist.sh`
3. Update CS_VERSION in build.sh if necessary
4. Run `sh release.sh`
### Acknowledgements
The original port of CsoundObj.js using ScriptProcessorNode to WASM
support was contributed by Henri Manson.
|
