[ { "path": ".github/CONTRIBUTING.md", "content": "Bug fixes and contributions are welcome!\n\nIf you're looking for ideas for where to get started, consider jumping in on any of these areas:\n\n### Examples\n\nTo contribute examples, please follow the current style of the examples. Add your example's title and file name to `examples/js/ExampleList.json` for it to appear in the examples list on the index page.\n\n### Docs\n\nThere is always more work that can be done on documentation. Especially adding good examples to methods and members to make the docs more informative and useful for people coming from diverse musical and technical backgrounds.\n\nAll of the docs are written in [TypeDoc](https://typedoc.org/)-style comments in the source code. If you catch a mistake, please send a pull request.\n\nAlong with this, it'd be great to integrate more visuals and references in the docs to help illustrate concepts.\n\n### Forum\n\nIf you are someone who is familiar with Tone.js, consider jumping in on [the forum](https://groups.google.com/forum/#!forum/tonejs) to answer some questions.\n\n### Tutorials\n\nI'd love to see more tutorials for newcomers to Tone.js to help them get up and running or solve a particular issue. If you make a tutorial, please send me a link.\n\n### Tests\n\nTone.js has an extensive [test suite](https://github.com/Tonejs/Tone.js/wiki/Testing) using Mocha and Chai.\n\nAlong with more unit tests, it'd also be great to have more tests which run in the online context and generate music to help find bugs by ear that the automated tests might not illuminate. [Audiokit](http://audiokit.io/tests/), for example, has a great suite of aural tests.\n\nYou can also take a look at Tone.js' [code coverage](https://coveralls.io/github/Tonejs/Tone.js) to get an idea of where more tests might be helpful.\n\n### Synths/Effects\n\nIf you'd like to contribute a cool and expressive synth or effect, I'd love to hear it. Please send me an example that I can play with along with the PR.\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Report an issue with Tone.js\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\n**Describe the bug**\n\nA description of what the bug is. \n\nFor help questions, check out the [forum](https://groups.google.com/forum/#!forum/tonejs).\n\nNote: Browsers' [Autoplay Policy](https://github.com/Tonejs/Tone.js/wiki/Autoplay) leads to a lot of subtle and inconsistent bugs where Tone.js produces no sound. Check out the link for more information and the solution.\n\nIf you are experiencing loose or inaccurate timing, double check that you are [correctly scheduling events](https://github.com/Tonejs/Tone.js/wiki/Accurate-Timing).\n\n\n**To Reproduce**\n\nPlease include a way to reproduce your issue. If possible, please includes a link to some example code using a platform like jsfiddle or codesandbox where the code can be edited. This makes it much easier to debug the issue and also create a validation test to verify the bug was fixed. \n\n**Expected behavior**\nA description of what you expected to happen.\n\n**What I've tried**\nHow have you tried resolving/debugging this issue? This can be helpful context for getting to the heart of the issue faster and not duplicating effort. \n\n**Additional context**\nAdd any other context about the problem here.\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.md", "content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: ''\nlabels: feature request\nassignees: ''\n\n---\n\n**The feature you'd like**\nA description of a module or method which you'd like to be included in Tone.js\n\n**Any alternatives you've considered**\nAre there existing modules or methods within Tone.js which can be combined to do the same thing? Are there other libraries or reference implementations which do a similar thing? \n\n**Additional context**\nAdd any other context or screenshots about the feature request here.\n\n**Feature Requests will eventually be closed if inactive**\nConsider submitted a Pull Request for the feature you want. If no one addresses your feature, it will eventually be closed due to inactivity. Though, someone could always implement your feature request after it's closed. Closing issues automatically keeps features requests from piling up.\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "1. Please make all pull requests on the `dev` branch.\n2. Don't commit build files\n2. Try to get all [tests](https://github.com/Tonejs/Tone.js/wiki/Testing) to pass.\n\n\n" }, { "path": ".github/codecov.yml", "content": "coverage:\n status:\n project:\n default:\n target: auto\n threshold: 1%" }, { "path": ".github/workflows/stale.yml", "content": "name: \"Close stale issues and PRs\"\non:\n schedule:\n - cron: \"30 1 * * *\"\n\njobs:\n stale:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/stale@v9\n with:\n any-of-labels: \"cant reproduce\"\n stale-issue-message: \"Please provide a way to reproduce the issue. Issues without a minimal (Tone.js-only) repro will be closed. A Tone.js-only repro helps ensure that the issue is not caused by another library.\"\n days-before-close: 7\n days-before-stale: 14\n - uses: actions/stale@v9\n with:\n any-of-labels: \"feature request\"\n stale-issue-message: \"Unfortunately with limited development time, not all feature requests can be tackled. If you are interested in contributing this feature, please open a PR.\"\n days-before-close: 30\n days-before-stale: 90\n" }, { "path": ".github/workflows/test.yml", "content": "name: Tests\n\non:\n pull_request:\n types: [opened, reopened, synchronize]\n branches:\n - dev\n - main\n push:\n branches:\n - dev\n - main\n\njobs:\n test-conventional-commit:\n name: Validate PR title\n runs-on: ubuntu-latest\n permissions:\n pull-requests: read\n steps:\n - uses: amannn/action-semantic-pull-request@v6\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n # only on PRs\n if: github.event_name == 'pull_request'\n run-tests:\n name: All tests\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n env:\n BROWSER: chrome\n CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: All tests\n run: npm run test\n - name: Upload coverage\n uses: codecov/codecov-action@v5\n with:\n fail_ci_if_error: false\n codecov_yml_path: ./.github/codecov.yml\n token: ${{ secrets.CODECOV_TOKEN }}\n test-code-examples:\n name: Check typedocs\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: Build Docs\n run: npm run build && npm run docs:json\n - name: tsdoc @example checks\n run: npm run test:examples\n test-html-examples:\n name: Run HTML Examples\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: Build\n run: npm run build\n - name: Code example tests\n run: npm run test:html\n test-lint:\n name: Linting and environment checks\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: Linting\n run: npm run lint\n - name: Spell check\n run: npm run spellcheck\n test-readme:\n name: Ensure that examples in the README compile\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: Build\n run: npm run build\n - name: Test\n run: npm run test:readme\n test-integrations:\n name: Test integrations\n permissions:\n contents: read\n id-token: write\n runs-on: ubuntu-latest\n needs: [test-conventional-commit]\n steps:\n - name: Check out Git repository\n uses: actions/checkout@v4\n - name: Setup Nodejs\n uses: actions/setup-node@v4\n with:\n node-version: 22.12.0\n cache: \"npm\"\n - name: Install dependencies\n run: npm install\n - name: Build\n run: npm run build\n - name: Test\n run: npm run test:integrations\n publish:\n runs-on: ubuntu-latest\n permissions:\n contents: read\n id-token: write\n # make sure all the tests pass first\n needs:\n [\n run-tests,\n test-code-examples,\n test-html-examples,\n test-lint,\n test-readme,\n test-integrations,\n ]\n # not on PRs\n if: github.event_name != 'pull_request'\n env:\n GITHUB_CI: true\n steps:\n - uses: actions/checkout@v5\n - uses: actions/setup-node@v6\n with:\n node-version: 24\n registry-url: \"https://registry.npmjs.org\"\n # Need to unset this in order to use OICD\n - name: Unset NODE_AUTH_TOKEN\n run: unset NODE_AUTH_TOKEN\n - name: Install dependencies\n run: npm install\n - name: Build\n run: npm run build\n - name: Increment version\n run: npm run increment\n - name: Publish @next\n # dev branch gets published with @next tag\n run: npm publish --tag next --provenance --access public\n if: ${{ github.ref == 'refs/heads/dev' }}\n - name: Publish @latest\n # main branch gets published with @latest tag\n run: npm publish --provenance --access public\n if: ${{ github.ref == 'refs/heads/main' }}\n" }, { "path": ".gitignore", "content": ".DS_Store\n*.asd\n*.scssc\n*.sublime-workspace\n*.sublime-project\n\nnode_modules\n\nTODO.txt\nwiki\n\nexamples/scratch.html\nexamples/deps/FileSaver.js\nexamples/oscilloscope.html\nexamples/graph.html\n\ntest/performance\ntest/mainTest.js\ntest/Main.js\ntest/supports.html\ncoverage/\n\nbuild/*\n**/dist/*\n\nexamples/scratch.js\nexamples/scratch.ts\nTone/version.js\nTone/version.ts\nTone/index.js\ntest/test.js\n\ndocs\n.vscode\ntone.d.ts\nexamples/scratch.ts\ntest/integration/*/package-lock.json\n" }, { "path": "CHANGELOG.md", "content": "# 15.0.x\n\n- `set` in constructor even if AudioBuffer is not from std-audio-context ([0399687](https://github.com/Tonejs/Tone.js/commit/0399687)), closes [#991](https://github.com/Tonejs/Tone.js/issues/991)\n- ability to mute a sequence ([ac856bc](https://github.com/Tonejs/Tone.js/commit/ac856bc)), closes [#823](https://github.com/Tonejs/Tone.js/issues/823)\n- Add `\"type\": \"module\"` to `package.json` ([69055ba](https://github.com/Tonejs/Tone.js/commit/69055ba))\n- Add back `main` as ESM build ([8cc6e8a](https://github.com/Tonejs/Tone.js/commit/8cc6e8a))\n- Add Pattern.index ([205c438](https://github.com/Tonejs/Tone.js/commit/205c438))\n- Add test for duplicate events ([d5c8a25](https://github.com/Tonejs/Tone.js/commit/d5c8a25))\n- adding @category definitions for docs, fixing some typos/mistakes along the way ([0e2b5b9](https://github.com/Tonejs/Tone.js/commit/0e2b5b9))\n- adding createMediaElementSource ([301f8cd](https://github.com/Tonejs/Tone.js/commit/301f8cd)), closes [#756](https://github.com/Tonejs/Tone.js/issues/756)\n- Allow instrument and PolySynth to be scheduled to the transport stop/loop events ([954a4fc](https://github.com/Tonejs/Tone.js/commit/954a4fc)), closes [#924](https://github.com/Tonejs/Tone.js/issues/924)\n- allow worklet-based effects to be used with native contexts (#1131) ([f06ff17](https://github.com/Tonejs/Tone.js/commit/f06ff17)), closes [#1131](https://github.com/Tonejs/Tone.js/issues/1131)\n- Analyser constructor smoothing option bug fix ([afb5284](https://github.com/Tonejs/Tone.js/commit/afb5284))\n- bumping standardized-audio-context version ([cbdb596](https://github.com/Tonejs/Tone.js/commit/cbdb596))\n- Chebyshev order must be an integer ([4f9aece](https://github.com/Tonejs/Tone.js/commit/4f9aece)), closes [#844](https://github.com/Tonejs/Tone.js/issues/844)\n- correctly offset phase for each oscillator ([0ac1da5](https://github.com/Tonejs/Tone.js/commit/0ac1da5)), closes [#733](https://github.com/Tonejs/Tone.js/issues/733)\n- custom decay curve #1107 ([d463286](https://github.com/Tonejs/Tone.js/commit/d463286)), closes [#1107](https://github.com/Tonejs/Tone.js/issues/1107)\n- Don't reschedule source when offset is very small ([444d617](https://github.com/Tonejs/Tone.js/commit/444d617)), closes [#999](https://github.com/Tonejs/Tone.js/issues/999) [#944](https://github.com/Tonejs/Tone.js/issues/944)\n- Export remaining effect option interfaces (#1293) ([2b8039b](https://github.com/Tonejs/Tone.js/commit/2b8039b)), closes [#1293](https://github.com/Tonejs/Tone.js/issues/1293)\n- exporting Mono ([8b996bc](https://github.com/Tonejs/Tone.js/commit/8b996bc)), closes [#765](https://github.com/Tonejs/Tone.js/issues/765)\n- fix the wrong variable name 'event' in Emitter.ts ([46bd717](https://github.com/Tonejs/Tone.js/commit/46bd717))\n- Garbage collect nodes used for Transport syncing ([a392067](https://github.com/Tonejs/Tone.js/commit/a392067))\n- increasing attack/release above 0 to avoid distortion ([b39883e](https://github.com/Tonejs/Tone.js/commit/b39883e)), closes [#770](https://github.com/Tonejs/Tone.js/issues/770)\n- latest std-audio-context ([8915e1b](https://github.com/Tonejs/Tone.js/commit/8915e1b)), closes [#720](https://github.com/Tonejs/Tone.js/issues/720)\n- Less verbose unit types (#1181) ([9353d33](https://github.com/Tonejs/Tone.js/commit/9353d33)), closes [#1181](https://github.com/Tonejs/Tone.js/issues/1181)\n- Load only a single AudioWorklet ([75a802c](https://github.com/Tonejs/Tone.js/commit/75a802c))\n- Memoize getTicksAtTime and getSecondsAtTime ([da73385](https://github.com/Tonejs/Tone.js/commit/da73385))\n- Parse note strings with three sharps or flats. ([5cd3560](https://github.com/Tonejs/Tone.js/commit/5cd3560))\n- pass in partials to LFO ([fdc7eb4](https://github.com/Tonejs/Tone.js/commit/fdc7eb4)), closes [#814](https://github.com/Tonejs/Tone.js/issues/814)\n- polysynth does not reschedule event if disposed ([e3a611f](https://github.com/Tonejs/Tone.js/commit/e3a611f))\n- Recorder resumes if start() is called in paused state (#1266) ([ead4f21](https://github.com/Tonejs/Tone.js/commit/ead4f21)), closes [#1266](https://github.com/Tonejs/Tone.js/issues/1266)\n- remove implicit \"stop\" scheduling ([0b7a352](https://github.com/Tonejs/Tone.js/commit/0b7a352)), closes [#778](https://github.com/Tonejs/Tone.js/issues/778)\n- Reverb input string time (#1313) ([bf3ee91](https://github.com/Tonejs/Tone.js/commit/bf3ee91)), closes [#1313](https://github.com/Tonejs/Tone.js/issues/1313) [#1253](https://github.com/Tonejs/Tone.js/issues/1253)\n- Reverse Emitter off callback loop for correct removal of duplicate events ([b5f582e](https://github.com/Tonejs/Tone.js/commit/b5f582e))\n- Revert \"fix for AudioBufferSourceNode stop time miscalculation\" ([e1c6631](https://github.com/Tonejs/Tone.js/commit/e1c6631))\n- Smooth RMS values per channel in Meter ([45d2009](https://github.com/Tonejs/Tone.js/commit/45d2009)), closes [#882](https://github.com/Tonejs/Tone.js/issues/882)\n- throws error when polysynth is used with a non monophonic class ([4f5353e](https://github.com/Tonejs/Tone.js/commit/4f5353e)), closes [#939](https://github.com/Tonejs/Tone.js/issues/939)\n- use now() instead of currentTime ([9e9b3d2](https://github.com/Tonejs/Tone.js/commit/9e9b3d2))\n- Use reciprocal of tempo when syncing time signals to Transport ([64c8a29](https://github.com/Tonejs/Tone.js/commit/64c8a29)), closes [#879](https://github.com/Tonejs/Tone.js/issues/879)\n- Using web-test-runner for tests, updating import paths (#1242) ([aaf880c](https://github.com/Tonejs/Tone.js/commit/aaf880c)), closes [#1242](https://github.com/Tonejs/Tone.js/issues/1242)\n- warn if event is scheduled without using the scheduled time. ([6dd22e7](https://github.com/Tonejs/Tone.js/commit/6dd22e7)), closes [#959](https://github.com/Tonejs/Tone.js/issues/959)\n- fix: load base64 encoded sounds when baseUrl is not empty ([a771811](https://github.com/Tonejs/Tone.js/commit/a771811)), closes [#898](https://github.com/Tonejs/Tone.js/issues/898)\n- fix: loading non relative URLs ([f7bdff0](https://github.com/Tonejs/Tone.js/commit/f7bdff0))\n- feat: sub-tick scheduling ([33e14d0](https://github.com/Tonejs/Tone.js/commit/33e14d0))\n\n### BREAKING CHANGES\n\n- Deprecating singleton variables, use singleton getter instead (#1233) ([3d42017](https://github.com/Tonejs/Tone.js/commit/3d42017)), closes [#1233](https://github.com/Tonejs/Tone.js/issues/1233)\n- Removing double-encoding of urls (#1254) ([de086f5](https://github.com/Tonejs/Tone.js/commit/de086f5)), closes [#1254](https://github.com/Tonejs/Tone.js/issues/1254)\n\n# 14.7.x\n\n### Features\n\n- **Converted to typescript!!!**\n- adding AudioWorkletNode constructors to Context ([f7bdd75](https://github.com/Tonejs/Tone.js/commit/f7bdd75))\n- adding ability to get the frequency at the FFT index ([22cecdc](https://github.com/Tonejs/Tone.js/commit/22cecdc281c8076c054affaef9dc422665acda2e))\n- adding AudioWorkletNode constructors to Context ([f7bdd75](https://github.com/Tonejs/Tone.js/commit/f7bdd7528fa9549740dc514df6308303c060e091))\n- adding BiquadFilter ([75617d3](https://github.com/Tonejs/Tone.js/commit/75617d341fe44ca5d332ea4e547f07c266a54753)), closes [#686](https://github.com/Tonejs/Tone.js/issues/686)\n- adding linting to jsdocs ([10ef513](https://github.com/Tonejs/Tone.js/commit/10ef513))\n- adding send/receive to Channel ([703f27a](https://github.com/Tonejs/Tone.js/commit/703f27a))\n- Adding triggerRelease to PluckSynth ([04405af](https://github.com/Tonejs/Tone.js/commit/04405af))\n- Can set the parameter after constructing Param ([23ca0f9](https://github.com/Tonejs/Tone.js/commit/23ca0f9))\n- adding onerror to Sampler ([7236600](https://github.com/Tonejs/Tone.js/commit/7236600182d336d6598f86d7d7afe8761e733774)), closes [#605](https://github.com/Tonejs/Tone.js/issues/605)\n- Chorus extends StereoFeedbackEffect ([a28f1af](https://github.com/Tonejs/Tone.js/commit/a28f1af)), closes [#575](https://github.com/Tonejs/Tone.js/issues/575)\n- Convolver is just a wrapper around the ConvolverNode, no longer an effect ([1668dec](https://github.com/Tonejs/Tone.js/commit/1668dec))\n- Get an oscillator wave as an array ([9ad519e](https://github.com/Tonejs/Tone.js/commit/9ad519e))\n- OfflineContext returns a ToneAudioBuffer ([889dafa](https://github.com/Tonejs/Tone.js/commit/889dafa))\n- OfflineContext yields thread every second of audio rendered ([1154470](https://github.com/Tonejs/Tone.js/commit/1154470)), closes [#436](https://github.com/Tonejs/Tone.js/issues/436)\n- Renaming TransportTimelineSignal to SyncedSignal ([86853fb](https://github.com/Tonejs/Tone.js/commit/86853fb))\n- es6 output ([e5d28ba](https://github.com/Tonejs/Tone.js/commit/e5d28baa5f02c19a6f1c8c50c99e98bd1551d15b))\n- Render a segment of the envelope as an array ([fc5b6f7](https://github.com/Tonejs/Tone.js/commit/fc5b6f7))\n- testing examples in jsdocs ([e306319](https://github.com/Tonejs/Tone.js/commit/e306319))\n- Wrapper around the AudioWorkletNode ([2ee8cb1](https://github.com/Tonejs/Tone.js/commit/2ee8cb1))\n- Input/Outputs are no longer arrays.\n - simplifies connect/disconnect logic greatly. Simplifies API to just have clearly named inputs/outputs instead of overloading input/output connect numbers\n- Using \"Destination\" instead of \"Master\" for output\n - More consistent with Web Audio API\n- FrequencyShifter - thanks @Foaly\n- PolySynth does not require a polyphony value.\n - Voice allocation and disposing is done automatically based on demand.\n- MetalSynth and MembraneSynth extends Monophonic enabling them to be used in PolySynth\n- OnePoleFilter is a 6b-per-octave lowpass or highpass filter\n - Using OnePoleFilter in PluckSynth and LowpassCombFilter\n- latencyHint is now set in constructor ([ba8e82b](https://github.com/Tonejs/Tone.js/commit/ba8e82b1ca8a841a23d6e774641916019c37cc92)), closes [#658](https://github.com/Tonejs/Tone.js/issues/658)\n- meter output can be normalRange in addition to decibels ([2625a13](https://github.com/Tonejs/Tone.js/commit/2625a134b62af117c1c525a4e631e4e52b25ba90))\n- option to pass in the number of input channels to Panner ([d966735](https://github.com/Tonejs/Tone.js/commit/d966735bd97bddc70039bce5a48f26413054eddc)), closes [#609](https://github.com/Tonejs/Tone.js/issues/609)\n\n### BREAKING CHANGES\n\n- TransportTimelineSignal renamed SyncedSignal\n- Master renamed Destination\n- Buffer renamed ToneAudioBuffer\n- Buffer.on(\"loaded\") is should now use: `Tone.loaded(): Promise`\n- Removing bower ([71c8b3b](https://github.com/Tonejs/Tone.js/commit/71c8b3bbb96e45cfc4aa2cce8a2d8c61a092c91e)), closes [#197](https://github.com/Tonejs/Tone.js/issues/197)\n- Removing Ctrl classes ([51d06bd](https://github.com/Tonejs/Tone.js/commit/51d06bd9873b2f1936a3169930f9696f1ccfb845))\n- `Players.get(name: string)` is renamed to `Players.player(name: string)`\n\n# 13.8.25\n\n- Moving to common.js-style code\n\n### BREAKING CHANGES\n\n- AudioNode.prototype.connect is no longer overwritten. This means that you can no longer connect native nodes to Tone.js Nodes.\n- Tone.connect(srcNode, destNode, [ouputNum], [inputNum]) is the way to connect native Web Audio nodes with Tone.js nodes.\n\n# 13.4.9\n\n- Updating semantic versioning to be more in line with other [semvers](https://semver.org/). Now version is 13.x.x\n- logging full version\n- Added Object notation for Tone.TimeBase and classes that extend it.\n - i.e. Tone.Time({'4n' : 1, '8t' : 2})\n - Replacement for deprecated expression strings.\n- Tone.Meter uses RMS instead of peak (thanks [@Idicious](https://github.com/Idicious))\n- Tone.Sampler supports polyphonic syntax (thanks [@zfan40](https://github.com/zfan40))\n- Building files with [webpack](https://webpack.js.org/)\n- Follower/Gate uses a single \"smoothing\" value instead of separate attacks and releases\n- Changing references to `window` allowing it to not throw error in node context\n- Testing examples\n- Tone.Channel combines Tone.PanVol with Tone.Solo.\n- Removing require.html example.\n- adding `partialCount` and `baseType` to Oscillator classes, helps with getting/setting complex types.\n\n# r12\n\n- Consolidating all shims into [shim folder](https://github.com/Tonejs/Tone.js/tree/dev/Tone/shim)\n- Using ConstantSourceNode in Signal when available\n- switching to eslint from jshint\n- Running [CI tests](https://travis-ci.org/Tonejs/Tone.js/) on Firefox, Chrome (latest and canary) and Safari (latest and version 9).\n- [Tone.Reverb](https://tonejs.github.io/docs/Reverb) is a convolution-based stereo reverb. [Example](https://tonejs.github.io/examples/#reverb).\n- Optimizing basic Oscillator types and many Signal use-case\n- Optimizing basic connection use-case of Tone.Signal where one signal is controlling another signal\n- Testing rendered output against an existing audio file for continuity and consistency\n- Optimizing triggerAttack/Release by starting/stopping oscillators when not playing\n- [TickSource](https://tonejs.github.io/docs/TickSource) (used in Clock and Player) tracks the elapsed ticks\n - Improved precision of tracking ticks in Transport and Clock\n- `Player.position` returns the playback position of the AudioBuffer accounting for any playbackRate changes\n- Removing `retrigger` option with Tone.Player. Tone.BufferSource should be used if retriggering is desired.\n\n**BREAKING CHANGES:**\n\n- Tone.TimeBase and all classes that extend it not longer support string expressions.\n RATIONALE :\n _ Since all classes implement `valueOf`, expressions can be composed in JS instead of as strings\n _ e.g. `Time('4n') * 2 + Time('3t')` instead of `Time('4n * 2 + 3t')` \\* this change greatly simplifies the code and is more performant\n\n# r11\n\n- [Code coverage](https://coveralls.io/github/Tonejs/Tone.js) analysis\n- [Dev build](https://tonejs.github.io/build/dev/Tone.js) with each successful commit\n- [Versioned docs](https://tonejs.github.io/docs/Tone) plus a [dev build of the docs](https://tonejs.github.io/docs/dev/Tone) on successful commits\n- [Tone.AudioNode](https://tonejs.github.io/docs/AudioNode) is base class for all classes which generate or process audio\n- [Tone.Sampler](https://tonejs.github.io/docs/Sampler) simplifies creating multisampled instruments\n- [Tone.Solo](https://tonejs.github.io/docs/Solo) makes it easier to mute/solo audio\n- [Mixer](https://tonejs.github.io/examples/#mixer) and [sampler](https://tonejs.github.io/examples/#sampler) examples\n- Making type-checking methods static\n- [Tone.TransportTimelineSignal](https://tonejs.github.io/docs/TransportTimelineSignal) is a signal which can be scheduled along the Transport\n- [Tone.FFT](https://tonejs.github.io/docs/FFT) and [Tone.Waveform](https://tonejs.github.io/docs/Waveform) abstract Tone.Analyser\n- [Tone.Meter](https://tonejs.github.io/docs/Meter) returns decibels\n- [Tone.Envelope](https://tonejs.github.io/docs/Envelope) uses exponential approach instead of exponential curve for decay and release curves\n- [Tone.BufferSource](https://tonejs.github.io/docs/BufferSource) fadeIn/Out can be either \"linear\" or \"exponential\" curve\n\n# r10\n\n- Tone.Context wraps AudioContext\n- Tone.OfflineContext wraps OfflineAudioContext\n- Tone.Offline: method for rendering audio offline\n- Rewriting tests with Tone.Offline\n- Optimizing Tone.Draw to only loop when events are scheduled: [#194](https://github.com/Tonejs/Tone.js/issues/194)\n- Time.eval->valueOf which takes advantage of build-in primitive evaluation [#205](https://github.com/Tonejs/Tone.js/issues/205)\n- [Offline example](https://tonejs.github.io/examples/#offline)\n\n# r9\n\n- Tone.Clock performance and lookAhead updates.\n- Tone.Transport.lookAhead = seconds|'playback'|'interactive'|'balanced'\n- Convolver.load and Player.load returns Promise\n- Tone.ExternalInput -> Tone.UserMedia, simplified API, open() returns Promise.\n- Tone.Draw for animation-frame synced drawing\n- Compressor Parameters are now Tone.Params\n- Bug fixes\n\n# r8\n\n- Transport.seconds returns the progress in seconds.\n- Buffer.from/toArray, Float32Array <-> Buffer conversions\n- Buffer.slice(start, end) slices and returns a subsection of the Buffer\n- Source.sync now syncs all subsequent calls to `start` and `stop` to the TransportTime instead of the AudioContext time.\n - e.g. source.sync().start(0).stop(0.8); //plays source between 0 and 0.8 of the Transport\n- Transport.on(\"start\" / \"stop\") callbacks are invoked just before the event.\n- Param can accept an LFO description in the constructor or .value\n - e.g. param.value = {min : 10, max : 20, frequency : 0.4}\n- Time.TimeBase has clone/copy methods.\n- Tone.Buffer.prototype.load returns Promise\n- Using Tone.Delay and Tone.Gain everywhere\n- Patch for Chrome 53+ issue of not correctly scheduling AudioParams with setValueAtTime\n- Panner3D and Tone.Listener wrap native PannerNode and AudioListener to give 3D panning ability.\n\n# r7\n\n- MetalSynth creates metallic, cymbal sounds\n- DrumSynth -> MembraneSynth\n- FMOscillator, AMOscillator types\n- FatOscillator creates multiple oscillators and detunes them slightly\n- FM, AM, Fat Oscillators incorporated into OmniOscillator\n- Simplified FM and AM Synths and APIs\n- Panner.pan is between -1,1 like the StereoPannerNode\n- Pruned away unused (or little used) Signal classes.\n - All this functionality will be available when the AudioWorkerNode is introduced.\n- Clock uses Web Workers instead of requestAnimationFrame which allows it to run in the background.\n- Removed `startMobile`. Using [StartAudioContext](https://github.com/tambien/StartAudioContext) in examples.\n- Automated test runner using [Travis CI](https://travis-ci.org/Tonejs/Tone.js/)\n- Simplified NoiseSynth by removing filter and filter envelope.\n- Added new timing primitive types: Time, Frequency, TransportTime.\n- Switching parameter position of type and size in Tone.Analyser\n- Tone.Meter uses Tone.Analyser instead of ScriptProcessorNode.\n- Tone.Envelope has 5 new attack/release curves: \"sine\", \"cosine\", \"bounce\", \"ripple\", \"step\"\n- Renamed Tone.SimpleSynth -> Tone.Synth\n- Tone.Buffers combines multiple buffers\n- Tone.BufferSource a low-level wrapper, and Tone.MultiPlayer which is good for multisampled instruments.\n- Tone.GrainPlayer: granular synthesis buffer player.\n- Simplified Sampler\n\nDEPRECATED:\n\n- Removed SimpleFM and SimpleAM\n\n# r6\n\n- Added PitchShift and Vibrato Effect.\n- Added Timeline/TimelineState/TimelineSignal which keeps track of all scheduled state changes.\n- Clock uses requestAnimationFrame instead of ScriptProcessorNode\n- Removed `onended` event from Tone.Source\n- Refactored tests into individual files.\n- Renamed some Signal methods: `exponentialRampToValueNow`->`exponentialRampToValue`, `setCurrentValueNow`->`setRampPoint`\n- LFO no longer starts at bottom of cycle. Starts at whatever phase it's set at.\n- Transport is an event emitter. triggers events on \"start\", \"stop\", \"pause\", and \"loop\".\n- Oscillator accepts a \"partials\" array.\n- Microphone inherits from ExternalInput which is generalized for different inputs.\n- New scheduling methods on Transport - `schedule`, `scheduleOnce`, and `scheduleRepeat`.\n- Tone.Gain and Tone.Delay classes wrap the native Web Audio nodes.\n- Moved [MidiToScore](https://github.com/Tonejs/MidiConvert) and [TypeScript](https://github.com/Tonejs/TypeScript) definitions to separate repos.\n- Tone.Param wraps the native AudioParam and allows for unit conversion.\n- Quantization with Transport.quantize and using \"@\" in any Time. [Read more](https://github.com/Tonejs/Tone.js/wiki/Time).\n- Control-rate generators for value interpolation, patterns, random numbers, and markov chains.\n- schedulable musical events: Tone.Event, Tone.Loop, Tone.Part, Tone.Pattern, Tone.Sequence.\n- Player's playbackRate is now a signal and Noise includes a playbackRate signal.\n- All filterEnvelopes use new Tone.FrequencyEnvelope with frequency units and `baseFrequency` and `octaves` instead of `min` and `max`.\n- Phaser uses \"octaves\" instead of \"depth\" to be more consistent across the whole Tone.js API.\n- Presets now have [their own repo](https://github.com/Tonejs/Presets)\n\nDEPRECATED:\n\n- `setTimeout`, `setInterval`, `setTimeline` in favor of new `schedule`, `scheduleOnce`, and `scheduleRepeat`.\n- Tone.Signal no longer takes an AudioParam in the first argument. Use Tone.Param instead.\n- Tone.Buffer.onload/onprogress/onerror is deprecated. Use `Tone.Buffer.on(\"load\", callback)` instead.\n\n# r5\n\n- reverse buffer for Player and Sampler.\n- Tone.Volume for simple volume control in Decibels.\n- Panner uses StereoPannerNode when available.\n- AutoFilter and Tremolo effects.\n- Made many attributes read-only. preventing this common type of error: `oscillator.frequency = 200` when it should be `oscillator.frequency.value = 200`.\n- Envelope supports \"linear\" and \"exponential\" attack curves.\n- Renamed Tone.EQ -> Tone.EQ3.\n- Tone.DrumSynth makes kick and tom sounds.\n- Tone.MidSideCompressor and Tone.MidSideSplit/Tone.MidSideMerge\n- Tone.Oscillator - can specify the number of partials in the type: i.e. \"sine10\", \"triangle3\", \"square4\", etc.\n- mute/unmute the master output: `Tone.Master.mute = true`.\n- 3 new simplified synths: SimpleSynth, SimpleAM and SimpleFM\n- `harmonicity` is a signal-rate value for all instruments.\n- expose Q in Phaser.\n- unit conversions using Tone.Type for signals and LFO.\n- [new docs](http://tonejs.org/docs)\n- [updated examples](http://tonejs.org/examples)\n\n# r4\n\n- `toFrequency` accepts notes by name (i.e. `\"C4\"`)\n- Envelope no longer accepts exponential scaling, only Tone.ScaledEnvelope\n- Buffer progress and load events which tracks the progress of all downloads\n- Buffer only accepts a single url\n- Sampler accepts multiple samples as an object.\n- `setPitch` in sampler -> `setNote`\n- Deprecated MultiSampler - use Sampler with PolySynth instead\n- Added [cdn](http://cdn.tonejs.org/latest/Tone.min.js) - please don't use for production code\n- Renamed DryWet to CrossFade\n- Functions return `this` to allow for chaining. i.e. `player.toMaster().start(2)`.\n- Added `units` to Signal class which allows signals to be set in terms of Tone.Time, Tone.Frequency, Numbers, or Decibels.\n- Replaced set/get method with ES5 dot notation. i.e. `player.setVolume(-10)` is now `player.volume.value = -10`.\n To ramp the volume use either `player.volume.linearRampToValueNow(-10, \"4n\")`, or the new `rampTo` method which automatically selects the ramp (linear|exponential) based on the type of data.\n- set/get methods for all components\n- syncSignal and unsyncSignal moved from Signal to Transport\n- Add/Multiply/Subtract/Min/Max/GreaterThan/LessThan all extend Tone.Signal which allows them to be scheduled and automated just like Tone.Signal.\n- Deprecated Tone.Divide and Tone.Inverse. They were more complicated than they were useful.\n\nBREAKING CHANGES:\n\nThe API has been changed consistently to use `.attribute` for getting and setting instead of `getAttribute` and `setAttribute` methods. The reasoning for this is twofold: firstly, Tone.Signal attributes were previously limited in their scheduling capabilities when set through a setter function. For exactly, it was not possible to do a setValueAtTime on the `bpm` of the Transport. Secondly, the new EcmaScript 5 getter/setter approach resembles the Web Audio API much more closely, which will make intermixing the two APIs even easier.\n\nIf you're using Sublime Text, one way to transition from the old API to the new one is with a regex find/replace:\nfind `Tone.Transport.setBpm\\((\\d+)\\)` and replace it with `Tone.Transport.bpm.value = $1`.\n\nOr if setBpm was being invoked with a rampTime:\nfind `Tone.Transport.setBpm\\((\\d+)\\, (\\d+)\\)` and replace it with `Tone.Transport.bpm.rampTo($1, $2)`.\n\n# r3\n\nCore Change:\n\n- Swing parameter on Transport\n- Player loop positions stay in tempo-relative terms even with tempo changes\n- Envelope ASDR stay in tempo-relative terms even with tempo changes\n- Modified build script to accommodate using requirejs with build and minified version\n\nSignal Processing:\n\n- Tone.Expr: signal processing expression parser for Tone.Signal math\n- All signal binary operators accept two signals as inputs\n- Deprecated Tone.Threshold - new class Tone.GreaterThanZero\n- NOT, OR, AND, and IfThenElse signal logic operators\n- Additional signal classes: Inverse, Divide, Pow, AudioToGain, Subtract\n- Scale no longer accepts input min/max. Assumes [0,1] range.\n- Normalize class if scaling needs to happen from other input ranges\n- WaveShaper function wraps the WaveShaperNode\n\nEffects:\n\n- Distortion and Chebyshev distortion effects\n- Compressor and MultibandCompressor\n- MidSide effect type and StereoWidener\n- Convolver effect and example\n\nSynths:\n\n- Setters on PluckSynth and PulseOscillator\n- new PWMOscillator\n- OmniOscillator which combines PWMOscillator, Oscillator, and PulseOscillator into one\n- NoiseSynth\n\n# r2\n\n- PluckSynth - Karplus-Strong Plucked String modeling synth\n- Freeverb\n- John Chowning Reverb (JCReverb)\n- LowpassCombFilter and FeedbackCombFilter\n- Sampler with pitch control\n- Clock tick callback is out of the audio thread using setTimeout\n- Optimized Tone.Modulo\n- Tests run using OfflineRenderingContext\n- Fixed Transport bug where timeouts/intervals and timelines were on a different tick counter\n- AmplitudeEnvelope + triggerAttackDecay on Envelope\n- Instruments inherit from Tone.Instrument base-class\n- midi<-->note conversions\n\n# r1 - First!\n" }, { "path": "LICENSE.md", "content": "MIT License\n\nCopyright (c) 2014-2025 Yotam Mann\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# Tone.js\n\n[![codecov](https://codecov.io/gh/Tonejs/Tone.js/branch/dev/graph/badge.svg)](https://codecov.io/gh/Tonejs/Tone.js)\n\nTone.js is a Web Audio framework for creating interactive music in the browser. The architecture of Tone.js aims to be familiar to both musicians and audio programmers creating web-based audio applications. On the high-level, Tone offers common DAW (digital audio workstation) features like a global transport for synchronizing and scheduling events as well as prebuilt synths and effects. Additionally, Tone provides high-performance building blocks to create your own synthesizers, effects, and complex control signals.\n\n- [API](https://tonejs.github.io/docs/)\n- [Examples](https://tonejs.github.io/examples/)\n\n# Installation\n\nThere are two ways to incorporate Tone.js into a project. First, it can be installed locally into a project using `npm`:\n\n```bash\nnpm install tone // Install the latest stable version\nnpm install tone@next // Or, alternatively, use the 'next' version\n```\n\nAdd Tone.js to a project using the JavaScript `import` syntax:\n\n```js\nimport * as Tone from \"tone\";\n```\n\nTone.js is also hosted at unpkg.com. It can be added directly within an HTML document, as long as it precedes any project scripts. [See the example here](https://github.com/Tonejs/Tone.js/blob/master/examples/simpleHtml.html) for more details.\n\n```html\n\n```\n\n# Hello Tone\n\n```javascript\n//create a synth and connect it to the main output (your speakers)\nconst synth = new Tone.Synth().toDestination();\n\n//play a middle 'C' for the duration of an 8th note\nsynth.triggerAttackRelease(\"C4\", \"8n\");\n```\n\n## Tone.Synth\n\n`Tone.Synth` is a basic synthesizer with a single oscillator and an ADSR envelope.\n\n### triggerAttack / triggerRelease\n\n`triggerAttack` starts the note (the amplitude is rising), and `triggerRelease` is when the amplitude is going back to 0 (i.e. **note off**).\n\n```javascript\nconst synth = new Tone.Synth().toDestination();\nconst now = Tone.now();\n// trigger the attack immediately\nsynth.triggerAttack(\"C4\", now);\n// wait one second before triggering the release\nsynth.triggerRelease(now + 1);\n```\n\n### triggerAttackRelease\n\n`triggerAttackRelease` is a combination of `triggerAttack` and `triggerRelease`\n\nThe first argument to the note which can either be a frequency in hertz (like `440`) or as \"pitch-octave\" notation (like `\"D#2\"`).\n\nThe second argument is the duration that the note is held. This value can either be in seconds, or as a [tempo-relative value](https://github.com/Tonejs/Tone.js/wiki/Time).\n\nThe third (optional) argument of `triggerAttackRelease` is _when_ along the AudioContext time the note should play. It can be used to schedule events in the future.\n\n```javascript\nconst synth = new Tone.Synth().toDestination();\nconst now = Tone.now();\nsynth.triggerAttackRelease(\"C4\", \"8n\", now);\nsynth.triggerAttackRelease(\"E4\", \"8n\", now + 0.5);\nsynth.triggerAttackRelease(\"G4\", \"8n\", now + 1);\n```\n\n## Time\n\nWeb Audio has advanced, sample accurate scheduling capabilities. The AudioContext time is what the Web Audio API uses to schedule events, starts at 0 when the page loads and counts up in **seconds**.\n\n`Tone.now()` gets the current time of the AudioContext.\n\n```javascript\nsetInterval(() => console.log(Tone.now()), 100);\n```\n\nTone.js abstracts away the AudioContext time. Instead of defining all values in seconds, any method which takes time as an argument can accept a number or a string. For example `\"4n\"` is a quarter-note, `\"8t\"` is an eighth-note triplet, and `\"1m\"` is one measure.\n\n[Read about Time encodings](https://github.com/Tonejs/Tone.js/wiki/Time).\n\n# Starting Audio\n\n**IMPORTANT**: Browsers will not play _any_ audio until a user clicks something (like a play button). Run your Tone.js code only after calling `Tone.start()` from a event listener which is triggered by a user action such as \"click\" or \"keydown\".\n\n`Tone.start()` returns a promise, the audio will be ready only after that promise is resolved. Scheduling or playing audio before the AudioContext is running will result in silence or incorrect scheduling.\n\n```javascript\n//attach a click listener to a play button\ndocument.querySelector(\"button\")?.addEventListener(\"click\", async () => {\n\tawait Tone.start();\n\tconsole.log(\"audio is ready\");\n});\n```\n\n# Scheduling\n\n## Transport\n\n`Tone.getTransport()` returns the main timekeeper. Unlike the AudioContext clock, it can be started, stopped, looped and adjusted on the fly. You can think of it like the arrangement view in a Digital Audio Workstation.\n\nMultiple events and parts can be arranged and synchronized along the Transport. `Tone.Loop` is a simple way to create a looped callback that can be scheduled to start and stop.\n\n```javascript\n// create two monophonic synths\nconst synthA = new Tone.FMSynth().toDestination();\nconst synthB = new Tone.AMSynth().toDestination();\n//play a note every quarter-note\nconst loopA = new Tone.Loop((time) => {\n\tsynthA.triggerAttackRelease(\"C2\", \"8n\", time);\n}, \"4n\").start(0);\n//play another note every off quarter-note, by starting it \"8n\"\nconst loopB = new Tone.Loop((time) => {\n\tsynthB.triggerAttackRelease(\"C4\", \"8n\", time);\n}, \"4n\").start(\"8n\");\n// all loops start when the Transport is started\nTone.getTransport().start();\n// ramp up to 800 bpm over 10 seconds\nTone.getTransport().bpm.rampTo(800, 10);\n```\n\nSince Javascript callbacks are **not precisely timed**, the sample-accurate time of the event is passed into the callback function. **Use this time value to schedule the events**.\n\n# Instruments\n\nThere are numerous synths to choose from including `Tone.FMSynth`, `Tone.AMSynth` and `Tone.NoiseSynth`.\n\nAll of these instruments are **monophonic** (single voice) which means that they can only play one note at a time.\n\nTo create a **polyphonic** synthesizer, use `Tone.PolySynth`, which accepts a monophonic synth as its first parameter and automatically handles the note allocation so you can pass in multiple notes. The API is similar to the monophonic synths, except `triggerRelease` must be given a note or array of notes.\n\n```javascript\nconst synth = new Tone.PolySynth(Tone.Synth).toDestination();\nconst now = Tone.now();\nsynth.triggerAttack(\"D4\", now);\nsynth.triggerAttack(\"F4\", now + 0.5);\nsynth.triggerAttack(\"A4\", now + 1);\nsynth.triggerAttack(\"C5\", now + 1.5);\nsynth.triggerAttack(\"E5\", now + 2);\nsynth.triggerRelease([\"D4\", \"F4\", \"A4\", \"C5\", \"E5\"], now + 4);\n```\n\n# Samples\n\nSound generation is not limited to synthesized sounds. You can also load a sample and play that back in a number of ways. `Tone.Player` is one way to load and play back an audio file.\n\n```javascript\nconst player = new Tone.Player(\n\t\"https://tonejs.github.io/audio/berklee/gong_1.mp3\"\n).toDestination();\nTone.loaded().then(() => {\n\tplayer.start();\n});\n```\n\n`Tone.loaded()` returns a promise which resolves when _all_ audio files are loaded. It's a helpful shorthand instead of waiting on each individual audio buffer's `onload` event to resolve.\n\n## Tone.Sampler\n\nMultiple samples can also be combined into an instrument. If you have audio files organized by note, `Tone.Sampler` will pitch shift the samples to fill in gaps between notes. So for example, if you only have every 3rd note on a piano sampled, you could turn that into a full piano sample.\n\nUnlike the other synths, Tone.Sampler is polyphonic so doesn't need to be passed into Tone.PolySynth\n\n```javascript\nconst sampler = new Tone.Sampler({\n\turls: {\n\t\tC4: \"C4.mp3\",\n\t\t\"D#4\": \"Ds4.mp3\",\n\t\t\"F#4\": \"Fs4.mp3\",\n\t\tA4: \"A4.mp3\",\n\t},\n\trelease: 1,\n\tbaseUrl: \"https://tonejs.github.io/audio/salamander/\",\n}).toDestination();\n\nTone.loaded().then(() => {\n\tsampler.triggerAttackRelease([\"Eb4\", \"G4\", \"Bb4\"], 4);\n});\n```\n\n# Effects\n\nIn the above examples, the sources were always connected directly to the `Destination`, but the output of the synth could also be routed through one (or more) effects before going to the speakers.\n\n```javascript\nconst player = new Tone.Player({\n\turl: \"https://tonejs.github.io/audio/berklee/gurgling_theremin_1.mp3\",\n\tloop: true,\n\tautostart: true,\n});\n//create a distortion effect\nconst distortion = new Tone.Distortion(0.4).toDestination();\n//connect a player to the distortion\nplayer.connect(distortion);\n```\n\nThe connection routing is flexible, connections can run serially or in parallel.\n\n```javascript\nconst player = new Tone.Player({\n\turl: \"https://tonejs.github.io/audio/drum-samples/loops/ominous.mp3\",\n\tautostart: true,\n});\nconst filter = new Tone.Filter(400, \"lowpass\").toDestination();\nconst feedbackDelay = new Tone.FeedbackDelay(0.125, 0.5).toDestination();\n\n// connect the player to the feedback delay and filter in parallel\nplayer.connect(filter);\nplayer.connect(feedbackDelay);\n```\n\nMultiple nodes can be connected to the same input enabling sources to share effects. `Tone.Gain` is useful utility node for creating complex routing.\n\n# Signals\n\nLike the underlying Web Audio API, Tone.js is built with audio-rate signal control over nearly everything. This is a powerful feature which allows for sample-accurate synchronization and scheduling of parameters.\n\n`Signal` properties have a few built in methods for creating automation curves.\n\nFor example, the `frequency` parameter on `Oscillator` is a Signal so you can create a smooth ramp from one frequency to another.\n\n```javascript\nconst osc = new Tone.Oscillator().toDestination();\n// start at \"C4\"\nosc.frequency.value = \"C4\";\n// ramp to \"C2\" over 2 seconds\nosc.frequency.rampTo(\"C2\", 2);\n// start the oscillator for 2 seconds\nosc.start().stop(\"+3\");\n```\n\n# AudioContext\n\nTone.js creates an AudioContext when it loads and shims it for maximum browser compatibility using [standardized-audio-context](https://github.com/chrisguttandin/standardized-audio-context). The AudioContext can be accessed at `Tone.getContext`. Or set your own AudioContext using `Tone.setContext(audioContext)`.\n\n# MIDI\n\nTo use MIDI files, you'll first need to convert them into a JSON format which Tone.js can understand using [Midi](https://tonejs.github.io/Midi/).\n\n# Performance\n\nTone.js makes extensive use of the native Web Audio Nodes such as the GainNode and WaveShaperNode for all signal processing, which enables Tone.js to work well on both desktop and mobile browsers.\n\n[This wiki](https://github.com/Tonejs/Tone.js/wiki/Performance) article has some suggestions related to performance for best practices.\n\n# Testing\n\nTone.js runs an extensive test suite using [mocha](https://mochajs.org/) and [chai](http://chaijs.com/) with nearly 100% coverage. Passing builds on the 'dev' branch are published on npm as `tone@next`.\n\n# Contributing\n\nThere are many ways to contribute to Tone.js. Check out [this wiki](https://github.com/Tonejs/Tone.js/wiki/Contributing) if you're interested.\n\n# References and Inspiration\n\n- [Many of Chris Wilson's Repositories](https://github.com/cwilso)\n- [Many of Mohayonao's Repositories](https://github.com/mohayonao)\n- [The Spec](http://webaudio.github.io/web-audio-api/)\n- [Sound on Sound - Synth Secrets](http://www.soundonsound.com/sos/may99/articles/synthsec.htm)\n- [Miller Puckette - Theory and Techniques of Electronic Music](http://msp.ucsd.edu/techniques.htm)\n- [standardized-audio-context](https://github.com/chrisguttandin/standardized-audio-context)\n" }, { "path": "Tone/classes.ts", "content": "export * from \"./component/index.js\";\nexport * from \"./core/index.js\";\nexport * from \"./effect/index.js\";\nexport * from \"./event/index.js\";\nexport * from \"./instrument/index.js\";\nexport * from \"./signal/index.js\";\nexport * from \"./source/index.js\";\n" }, { "path": "Tone/component/analysis/Analyser.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Noise } from \"../../source/Noise.js\";\nimport { Analyser } from \"./Analyser.js\";\n\ndescribe(\"Analyser\", () => {\n\tBasicTests(Analyser);\n\n\tit(\"can get and set properties\", () => {\n\t\tconst anl = new Analyser();\n\t\tanl.set({\n\t\t\tsize: 32,\n\t\t\tsmoothing: 0.2,\n\t\t});\n\t\tconst values = anl.get();\n\t\texpect(values.size).to.equal(32);\n\t\texpect(values.smoothing).to.equal(0.2);\n\t\tanl.dispose();\n\t});\n\n\tit(\"can correctly set the size\", () => {\n\t\tconst anl = new Analyser(\"fft\", 512);\n\t\texpect(anl.size).to.equal(512);\n\t\tanl.size = 1024;\n\t\texpect(anl.size).to.equal(1024);\n\t\tanl.dispose();\n\t});\n\n\tit(\"can run fft analysis\", () => {\n\t\tconst anl = new Analyser(\"fft\", 512);\n\t\tconst analysis = anl.getValue();\n\t\texpect(analysis.length).to.equal(512);\n\t\tanalysis.forEach((val) => {\n\t\t\texpect(val).is.lessThan(0);\n\t\t});\n\t\tanl.dispose();\n\t});\n\n\tit(\"can run waveform analysis\", (done) => {\n\t\tconst noise = new Noise();\n\t\tconst anl = new Analyser(\"waveform\", 256);\n\t\tnoise.connect(anl);\n\t\tnoise.start();\n\n\t\tsetTimeout(() => {\n\t\t\tconst analysis = anl.getValue();\n\t\t\texpect(analysis.length).to.equal(256);\n\t\t\tanalysis.forEach((val) => {\n\t\t\t\texpect(val).is.within(-1, 1);\n\t\t\t});\n\t\t\tanl.dispose();\n\t\t\tnoise.dispose();\n\t\t\tdone();\n\t\t}, 300);\n\t});\n\n\tit(\"throws an error if an invalid type is set\", () => {\n\t\tconst anl = new Analyser(\"fft\", 512);\n\t\texpect(() => {\n\t\t\t// @ts-ignore\n\t\t\tanl.type = \"invalid\";\n\t\t}).to.throw(Error);\n\t\tanl.dispose();\n\t});\n\n\tit(\"can do multichannel analysis\", () => {\n\t\tconst anl = new Analyser({\n\t\t\ttype: \"waveform\",\n\t\t\tchannels: 2,\n\t\t\tsize: 512,\n\t\t});\n\t\texpect(anl.getValue().length).to.equal(2);\n\t\texpect((anl.getValue()[0] as Float32Array).length).to.equal(512);\n\t\tanl.dispose();\n\t});\n});\n" }, { "path": "Tone/component/analysis/Analyser.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { NormalRange, PowerOfTwo } from \"../../core/type/Units.js\";\nimport { assert, assertRange } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Split } from \"../channel/Split.js\";\n\nexport type AnalyserType = \"fft\" | \"waveform\";\n\nexport interface AnalyserOptions extends ToneAudioNodeOptions {\n\tsize: PowerOfTwo;\n\ttype: AnalyserType;\n\tsmoothing: NormalRange;\n\tchannels: number;\n}\n\n/**\n * Wrapper around the native Web Audio's [AnalyserNode](http://webaudio.github.io/web-audio-api/#idl-def-AnalyserNode).\n * Extracts FFT or Waveform data from the incoming signal.\n * @category Component\n */\nexport class Analyser extends ToneAudioNode {\n\treadonly name: string = \"Analyser\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * The analyser node.\n\t */\n\tprivate _analyzers: AnalyserNode[] = [];\n\n\t/**\n\t * Input and output are a gain node\n\t */\n\tprivate _gain: Gain;\n\n\t/**\n\t * The channel splitter node\n\t */\n\tprivate _split: Split;\n\n\t/**\n\t * The analysis type\n\t */\n\tprivate _type!: AnalyserType;\n\n\t/**\n\t * The buffer that the FFT data is written to\n\t */\n\tprivate _buffers: Float32Array[] = [];\n\n\t/**\n\t * @param type The return type of the analysis, either \"fft\", or \"waveform\".\n\t * @param size The size of the FFT. This must be a power of two in the range 16 to 16384.\n\t */\n\tconstructor(type?: AnalyserType, size?: number);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tAnalyser.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"type\", \"size\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.input =\n\t\t\tthis.output =\n\t\t\tthis._gain =\n\t\t\t\tnew Gain({ context: this.context });\n\t\tthis._split = new Split({\n\t\t\tcontext: this.context,\n\t\t\tchannels: options.channels,\n\t\t});\n\t\tthis.input.connect(this._split);\n\n\t\tassertRange(options.channels, 1);\n\n\t\t// create the analyzers\n\t\tfor (let channel = 0; channel < options.channels; channel++) {\n\t\t\tthis._analyzers[channel] = this.context.createAnalyser();\n\t\t\tthis._split.connect(this._analyzers[channel], channel, 0);\n\t\t}\n\n\t\t// set the values initially\n\t\tthis.size = options.size;\n\t\tthis.type = options.type;\n\t\tthis.smoothing = options.smoothing;\n\t}\n\n\tstatic getDefaults(): AnalyserOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tsize: 1024,\n\t\t\tsmoothing: 0.8,\n\t\t\ttype: \"fft\" as AnalyserType,\n\t\t\tchannels: 1,\n\t\t});\n\t}\n\n\t/**\n\t * Run the analysis given the current settings. If {@link channels} = 1,\n\t * it will return a Float32Array. If {@link channels} > 1, it will\n\t * return an array of Float32Arrays where each index in the array\n\t * represents the analysis done on a channel.\n\t */\n\tgetValue(): Float32Array | Float32Array[] {\n\t\tthis._analyzers.forEach((analyser, index) => {\n\t\t\tconst buffer = this._buffers[index];\n\t\t\tif (this._type === \"fft\") {\n\t\t\t\tanalyser.getFloatFrequencyData(buffer);\n\t\t\t} else if (this._type === \"waveform\") {\n\t\t\t\tanalyser.getFloatTimeDomainData(buffer);\n\t\t\t}\n\t\t});\n\t\tif (this.channels === 1) {\n\t\t\treturn this._buffers[0];\n\t\t} else {\n\t\t\treturn this._buffers;\n\t\t}\n\t}\n\n\t/**\n\t * The size of analysis. This must be a power of two in the range 16 to 16384.\n\t */\n\tget size(): PowerOfTwo {\n\t\treturn this._analyzers[0].frequencyBinCount;\n\t}\n\tset size(size: PowerOfTwo) {\n\t\tthis._analyzers.forEach((analyser, index) => {\n\t\t\tanalyser.fftSize = size * 2;\n\t\t\tthis._buffers[index] = new Float32Array(size);\n\t\t});\n\t}\n\n\t/**\n\t * The number of channels the analyser does the analysis on. Channel\n\t * separation is done using {@link Split}\n\t */\n\tget channels(): number {\n\t\treturn this._analyzers.length;\n\t}\n\n\t/**\n\t * The analysis function returned by analyser.getValue(), either \"fft\" or \"waveform\".\n\t */\n\tget type(): AnalyserType {\n\t\treturn this._type;\n\t}\n\tset type(type: AnalyserType) {\n\t\tassert(\n\t\t\ttype === \"waveform\" || type === \"fft\",\n\t\t\t`Analyser: invalid type: ${type}`\n\t\t);\n\t\tthis._type = type;\n\t}\n\n\t/**\n\t * 0 represents no time averaging with the last analysis frame.\n\t */\n\tget smoothing(): NormalRange {\n\t\treturn this._analyzers[0].smoothingTimeConstant;\n\t}\n\tset smoothing(val: NormalRange) {\n\t\tthis._analyzers.forEach((a) => (a.smoothingTimeConstant = val));\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._analyzers.forEach((a) => a.disconnect());\n\t\tthis._split.dispose();\n\t\tthis._gain.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/analysis/DCMeter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { DCMeter } from \"./DCMeter.js\";\n\ndescribe(\"DCMeter\", () => {\n\tBasicTests(DCMeter);\n\n\tcontext(\"DCMetering\", () => {\n\t\tit(\"passes the audio through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst meter = new DCMeter().toDestination();\n\t\t\t\tinput.connect(meter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get the rms level of the incoming signal\", (done) => {\n\t\t\tconst meter = new DCMeter();\n\t\t\tconst osc = new Signal(2).connect(meter);\n\t\t\tsetTimeout(() => {\n\t\t\t\texpect(meter.getValue()).to.be.closeTo(2, 0.1);\n\t\t\t\tmeter.dispose();\n\t\t\t\tosc.dispose();\n\t\t\t\tdone();\n\t\t\t}, 400);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/analysis/DCMeter.ts", "content": "import { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { MeterBase, MeterBaseOptions } from \"./MeterBase.js\";\n\nexport type DCMeterOptions = MeterBaseOptions;\n\n/**\n * DCMeter gets the raw value of the input signal at the current time.\n * @see {@link Meter}.\n *\n * @example\n * const meter = new Tone.DCMeter();\n * const mic = new Tone.UserMedia();\n * mic.open();\n * // connect mic to the meter\n * mic.connect(meter);\n * // the current level of the mic\n * const level = meter.getValue();\n * @category Component\n */\nexport class DCMeter extends MeterBase {\n\treadonly name: string = \"DCMeter\";\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(optionsFromArguments(DCMeter.getDefaults(), arguments));\n\n\t\tthis._analyser.type = \"waveform\";\n\t\tthis._analyser.size = 256;\n\t}\n\n\t/**\n\t * Get the signal value of the incoming signal\n\t */\n\tgetValue(): number {\n\t\tconst value = this._analyser.getValue() as Float32Array;\n\t\treturn value[0];\n\t}\n}\n" }, { "path": "Tone/component/analysis/FFT.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Noise } from \"../../source/Noise.js\";\nimport { FFT } from \"./FFT.js\";\n\ndescribe(\"FFT\", () => {\n\tBasicTests(FFT);\n\n\tit(\"can get and set properties\", () => {\n\t\tconst fft = new FFT();\n\t\tfft.set({\n\t\t\tsize: 128,\n\t\t\tsmoothing: 0.4,\n\t\t});\n\t\tconst values = fft.get();\n\t\texpect(values.size).to.equal(128);\n\t\texpect(values.smoothing).to.equal(0.4);\n\t\tfft.dispose();\n\t});\n\n\tit(\"can correctly set the size\", () => {\n\t\tconst fft = new FFT(512);\n\t\texpect(fft.size).to.equal(512);\n\t\tfft.size = 1024;\n\t\texpect(fft.size).to.equal(1024);\n\t\tfft.dispose();\n\t});\n\n\tit(\"can set the smoothing\", () => {\n\t\tconst fft = new FFT(512);\n\t\tfft.smoothing = 0.2;\n\t\texpect(fft.smoothing).to.equal(0.2);\n\t\tfft.dispose();\n\t});\n\n\tit(\"can get the frequency values of each index of the return array\", () => {\n\t\tconst fft = new FFT(32);\n\t\texpect(fft.getFrequencyOfIndex(0)).to.be.closeTo(0, 1);\n\t\texpect(fft.getFrequencyOfIndex(16)).to.be.closeTo(\n\t\t\tfft.context.sampleRate / 4,\n\t\t\t1\n\t\t);\n\t\tfft.dispose();\n\t});\n\n\tit(\"can run waveform analysis\", (done) => {\n\t\tconst noise = new Noise();\n\t\tconst fft = new FFT(256);\n\t\tnoise.connect(fft);\n\t\tnoise.start();\n\n\t\tsetTimeout(() => {\n\t\t\tconst analysis = fft.getValue();\n\t\t\texpect(analysis.length).to.equal(256);\n\t\t\tanalysis.forEach((value) => {\n\t\t\t\texpect(value).is.within(-Infinity, 0);\n\t\t\t});\n\t\t\tfft.dispose();\n\t\t\tnoise.dispose();\n\t\t\tdone();\n\t\t}, 300);\n\t});\n\n\tit(\"outputs a normal range\", (done) => {\n\t\tconst noise = new Noise();\n\t\tconst fft = new FFT({\n\t\t\tnormalRange: true,\n\t\t});\n\t\tnoise.connect(fft);\n\t\tnoise.start();\n\n\t\tsetTimeout(() => {\n\t\t\tconst analysis = fft.getValue();\n\t\t\tanalysis.forEach((value) => {\n\t\t\t\texpect(value).is.within(0, 1);\n\t\t\t});\n\t\t\tfft.dispose();\n\t\t\tnoise.dispose();\n\t\t\tdone();\n\t\t}, 300);\n\t});\n});\n" }, { "path": "Tone/component/analysis/FFT.ts", "content": "import { ToneAudioNode } from \"../../core/context/ToneAudioNode.js\";\nimport { dbToGain } from \"../../core/type/Conversions.js\";\nimport { Hertz, NormalRange, PowerOfTwo } from \"../../core/type/Units.js\";\nimport { assert } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { MeterBase, MeterBaseOptions } from \"./MeterBase.js\";\n\nexport interface FFTOptions extends MeterBaseOptions {\n\tsize: PowerOfTwo;\n\tsmoothing: NormalRange;\n\tnormalRange: boolean;\n}\n\n/**\n * Get the current frequency data of the connected audio source using a fast Fourier transform.\n * Read more about FFT algorithms on [Wikipedia] (https://en.wikipedia.org/wiki/Fast_Fourier_transform).\n * @category Component\n */\nexport class FFT extends MeterBase {\n\treadonly name: string = \"FFT\";\n\n\t/**\n\t * If the output should be in decibels or normal range between 0-1. If `normalRange` is false,\n\t * the output range will be the measured decibel value, otherwise the decibel value will be converted to\n\t * the range of 0-1\n\t */\n\tnormalRange: boolean;\n\n\t/**\n\t * @param size The size of the FFT. Value must be a power of two in the range 16 to 16384.\n\t */\n\tconstructor(size?: PowerOfTwo);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(FFT.getDefaults(), arguments, [\n\t\t\t\"size\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.normalRange = options.normalRange;\n\t\tthis._analyser.type = \"fft\";\n\t\tthis.size = options.size;\n\t}\n\n\tstatic getDefaults(): FFTOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tnormalRange: false,\n\t\t\tsize: 1024,\n\t\t\tsmoothing: 0.8,\n\t\t});\n\t}\n\n\t/**\n\t * Gets the current frequency data from the connected audio source.\n\t * Returns the frequency data of length {@link size} as a Float32Array of decibel values.\n\t */\n\tgetValue(): Float32Array {\n\t\tconst values = this._analyser.getValue() as Float32Array;\n\t\treturn values.map((v) => (this.normalRange ? dbToGain(v) : v));\n\t}\n\n\t/**\n\t * The size of analysis. This must be a power of two in the range 16 to 16384.\n\t * Determines the size of the array returned by {@link getValue} (i.e. the number of\n\t * frequency bins). Large FFT sizes may be costly to compute.\n\t */\n\tget size(): PowerOfTwo {\n\t\treturn this._analyser.size;\n\t}\n\tset size(size) {\n\t\tthis._analyser.size = size;\n\t}\n\n\t/**\n\t * 0 represents no time averaging with the last analysis frame.\n\t */\n\tget smoothing(): NormalRange {\n\t\treturn this._analyser.smoothing;\n\t}\n\tset smoothing(val) {\n\t\tthis._analyser.smoothing = val;\n\t}\n\n\t/**\n\t * Returns the frequency value in hertz of each of the indices of the FFT's {@link getValue} response.\n\t * @example\n\t * const fft = new Tone.FFT(32);\n\t * console.log([0, 1, 2, 3, 4].map(index => fft.getFrequencyOfIndex(index)));\n\t */\n\tgetFrequencyOfIndex(index: number): Hertz {\n\t\tassert(\n\t\t\t0 <= index && index < this.size,\n\t\t\t`index must be greater than or equal to 0 and less than ${this.size}`\n\t\t);\n\t\treturn (index * this.context.sampleRate) / (this.size * 2);\n\t}\n}\n" }, { "path": "Tone/component/analysis/Follower.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Follower } from \"./Follower.js\";\n\ndescribe(\"Follower\", () => {\n\tBasicTests(Follower);\n\n\tcontext(\"Envelope Following\", () => {\n\t\tit(\"handles getter/setter as Object\", () => {\n\t\t\tconst foll = new Follower();\n\t\t\tconst values = {\n\t\t\t\tsmoothing: 0.2,\n\t\t\t};\n\t\t\tfoll.set(values);\n\t\t\texpect(foll.get()).to.have.keys([\"smoothing\"]);\n\t\t\texpect(foll.get().smoothing).to.be.closeTo(0.2, 0.001);\n\t\t\tfoll.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst follower = new Follower({\n\t\t\t\tsmoothing: 0.5,\n\t\t\t});\n\t\t\texpect(follower.smoothing).to.be.closeTo(0.5, 0.001);\n\t\t\tfollower.dispose();\n\t\t});\n\n\t\tit(\"smooths the incoming signal at 0.1\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst foll = new Follower(0.1).toDestination();\n\t\t\t\tconst sig = new Signal(0);\n\t\t\t\tsig.connect(foll);\n\t\t\t\tsig.setValueAtTime(1, 0.1);\n\t\t\t\tsig.setValueAtTime(0, 0.3);\n\t\t\t}, 0.41);\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.15)).to.be.closeTo(0.95, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.35)).to.be.closeTo(0.05, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"smooths the incoming signal at 0.05\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst foll = new Follower(0.05).toDestination();\n\t\t\t\tconst sig = new Signal(0);\n\t\t\t\tsig.connect(foll);\n\t\t\t\tsig.setValueAtTime(1, 0.1);\n\t\t\t\tsig.setValueAtTime(0, 0.3);\n\t\t\t}, 0.41);\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.125)).to.be.closeTo(0.95, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.15)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.325)).to.be.closeTo(0.05, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.35)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"smooths the incoming signal at 0.2\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst foll = new Follower(0.2).toDestination();\n\t\t\t\tconst sig = new Signal(0);\n\t\t\t\tsig.connect(foll);\n\t\t\t\tsig.setValueAtTime(1, 0.1);\n\t\t\t\tsig.setValueAtTime(0, 0.3);\n\t\t\t}, 0.51);\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.95, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0.05, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"smooths the incoming signal at 0.5\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst foll = new Follower(0.5).toDestination();\n\t\t\t\tconst sig = new Signal(0);\n\t\t\t\tsig.connect(foll);\n\t\t\t\tsig.setValueAtTime(1, 0.1);\n\t\t\t\tsig.setValueAtTime(0, 0.6);\n\t\t\t}, 1.11);\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.35)).to.be.closeTo(0.95, 0.05);\n\t\t\texpect(buffer.getValueAtTime(0.6)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.85)).to.be.closeTo(0.05, 0.05);\n\t\t\texpect(buffer.getValueAtTime(1.1)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst follower = new Follower().toDestination();\n\t\t\t\tinput.connect(follower);\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/analysis/Follower.ts", "content": "import {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Abs } from \"../../signal/Abs.js\";\nimport { OnePoleFilter } from \"../filter/OnePoleFilter.js\";\n\nexport interface FollowerOptions extends ToneAudioNodeOptions {\n\tsmoothing: Time;\n}\n\n/**\n * Follower is a simple envelope follower.\n * It's implemented by applying a lowpass filter to the absolute value of the incoming signal.\n * ```\n * +-----+ +---------------+\n * Input +--> Abs +----> OnePoleFilter +--> Output\n * +-----+ +---------------+\n * ```\n * @category Component\n */\nexport class Follower extends ToneAudioNode {\n\treadonly name: string = \"Follower\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * Private reference to the smoothing parameter\n\t */\n\tprivate _smoothing: Time;\n\n\t/**\n\t * The lowpass filter\n\t */\n\tprivate _lowpass: OnePoleFilter;\n\n\t/**\n\t * The absolute value\n\t */\n\tprivate _abs: Abs;\n\n\t/**\n\t * @param smoothing The rate of change of the follower.\n\t */\n\tconstructor(smoothing?: Time);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tFollower.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"smoothing\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._abs = this.input = new Abs({ context: this.context });\n\t\tthis._lowpass = this.output = new OnePoleFilter({\n\t\t\tcontext: this.context,\n\t\t\tfrequency: 1 / this.toSeconds(options.smoothing),\n\t\t\ttype: \"lowpass\",\n\t\t});\n\t\tthis._abs.connect(this._lowpass);\n\t\tthis._smoothing = options.smoothing;\n\t}\n\n\tstatic getDefaults(): FollowerOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tsmoothing: 0.05,\n\t\t});\n\t}\n\n\t/**\n\t * The amount of time it takes a value change to arrive at the updated value.\n\t */\n\tget smoothing(): Time {\n\t\treturn this._smoothing;\n\t}\n\tset smoothing(smoothing) {\n\t\tthis._smoothing = smoothing;\n\t\tthis._lowpass.frequency = 1 / this.toSeconds(this.smoothing);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._abs.dispose();\n\t\tthis._lowpass.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/analysis/Meter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests, warns } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { Merge } from \"../channel/Merge.js\";\nimport { Meter } from \"./Meter.js\";\n\ndescribe(\"Meter\", () => {\n\tBasicTests(Meter);\n\n\tcontext(\"Metering\", () => {\n\t\tit(\"handles getter/setter as Object\", () => {\n\t\t\tconst meter = new Meter();\n\t\t\tconst values = {\n\t\t\t\tsmoothing: 0.2,\n\t\t\t};\n\t\t\tmeter.set(values);\n\t\t\texpect(meter.get().smoothing).to.equal(0.2);\n\t\t\tmeter.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with the smoothing\", () => {\n\t\t\tconst meter = new Meter(0.5);\n\t\t\texpect(meter.smoothing).to.equal(0.5);\n\t\t\tmeter.dispose();\n\t\t});\n\n\t\tit(\"returns an array of channels if channels > 1\", () => {\n\t\t\tconst meter = new Meter({\n\t\t\t\tchannelCount: 4,\n\t\t\t});\n\t\t\texpect((meter.getValue() as number[]).length).to.equal(4);\n\t\t\tmeter.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst meter = new Meter({\n\t\t\t\tsmoothing: 0.3,\n\t\t\t});\n\t\t\texpect(meter.smoothing).to.equal(0.3);\n\t\t\tmeter.dispose();\n\t\t});\n\n\t\tit(\"passes the audio through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst meter = new Meter().toDestination();\n\t\t\t\tinput.connect(meter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"warns of deprecated method\", () => {\n\t\t\twarns(() => {\n\t\t\t\tconst meter = new Meter().toDestination();\n\t\t\t\tmeter.getLevel();\n\t\t\t\tmeter.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get the rms level of the incoming signal\", (done) => {\n\t\t\tconst meter = new Meter();\n\t\t\tconst osc = new Oscillator().connect(meter).start();\n\t\t\tosc.volume.value = -6;\n\t\t\tsetTimeout(() => {\n\t\t\t\texpect(meter.getValue()).to.be.closeTo(-9, 1);\n\t\t\t\tmeter.dispose();\n\t\t\t\tosc.dispose();\n\t\t\t\tdone();\n\t\t\t}, 400);\n\t\t});\n\n\t\tit(\"returns 0 below a threshold\", (done) => {\n\t\t\tconst meter = new Meter({\n\t\t\t\tnormalRange: true,\n\t\t\t});\n\t\t\tconst osc = new Oscillator().connect(meter).start();\n\t\t\tosc.volume.value = -101;\n\t\t\tsetTimeout(() => {\n\t\t\t\texpect(meter.getValue()).to.equal(0);\n\t\t\t\tmeter.dispose();\n\t\t\t\tosc.dispose();\n\t\t\t\tdone();\n\t\t\t}, 400);\n\t\t});\n\n\t\tit(\"can get the values in normal range\", (done) => {\n\t\t\tconst meter = new Meter({\n\t\t\t\tnormalRange: true,\n\t\t\t});\n\t\t\tconst osc = new Oscillator().connect(meter).start();\n\t\t\tosc.volume.value = -6;\n\t\t\tsetTimeout(() => {\n\t\t\t\texpect(meter.getValue()).to.be.closeTo(0.35, 0.15);\n\t\t\t\tmeter.dispose();\n\t\t\t\tosc.dispose();\n\t\t\t\tdone();\n\t\t\t}, 400);\n\t\t});\n\n\t\tit(\"can get the rms levels for multiple channels\", (done) => {\n\t\t\tconst meter = new Meter({\n\t\t\t\tchannelCount: 2,\n\t\t\t\tsmoothing: 0.5,\n\t\t\t});\n\t\t\tconst merge = new Merge().connect(meter);\n\t\t\tconst osc0 = new Oscillator().connect(merge, 0, 0).start();\n\t\t\tconst osc1 = new Oscillator().connect(merge, 0, 1).start();\n\t\t\tosc0.volume.value = -6;\n\t\t\tosc1.volume.value = -18;\n\t\t\tsetTimeout(() => {\n\t\t\t\tconst values = meter.getValue();\n\t\t\t\texpect(values).to.have.lengthOf(2);\n\t\t\t\texpect(values[0]).to.be.closeTo(-9, 1);\n\t\t\t\texpect(values[1]).to.be.closeTo(-21, 1);\n\t\t\t\tmeter.dispose();\n\t\t\t\tmerge.dispose();\n\t\t\t\tosc0.dispose();\n\t\t\t\tosc1.dispose();\n\t\t\t\tdone();\n\t\t\t}, 400);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/analysis/Meter.ts", "content": "import { dbToGain, gainToDb } from \"../../core/type/Conversions.js\";\nimport { NormalRange } from \"../../core/type/Units.js\";\nimport { warn } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Analyser } from \"./Analyser.js\";\nimport { MeterBase, MeterBaseOptions } from \"./MeterBase.js\";\n\nexport interface MeterOptions extends MeterBaseOptions {\n\tsmoothing: NormalRange;\n\tnormalRange: boolean;\n\tchannelCount: number;\n}\n\n/**\n * Meter gets the [RMS](https://en.wikipedia.org/wiki/Root_mean_square)\n * of an input signal. It can also get the raw value of the input signal.\n * Setting `normalRange` to `true` will covert the output to a range of\n * 0-1. See an example using a graphical display\n * [here](https://tonejs.github.io/examples/meter).\n * @see {@link DCMeter}.\n *\n * @example\n * const meter = new Tone.Meter();\n * const mic = new Tone.UserMedia();\n * mic.open();\n * // connect mic to the meter\n * mic.connect(meter);\n * // the current level of the mic\n * setInterval(() => console.log(meter.getValue()), 100);\n * @category Component\n */\nexport class Meter extends MeterBase {\n\treadonly name: string = \"Meter\";\n\n\t/**\n\t * If the output should be in decibels or normal range between 0-1. If `normalRange` is false,\n\t * the output range will be the measured decibel value, otherwise the decibel value will be converted to\n\t * the range of 0-1\n\t */\n\tnormalRange: boolean;\n\n\t/**\n\t * A value from between 0 and 1 where 0 represents no time averaging with the last analysis frame.\n\t */\n\tsmoothing: number;\n\n\t/**\n\t * The previous frame's value for each channel.\n\t */\n\tprivate _rms: number[];\n\n\t/**\n\t * @param smoothing The amount of smoothing applied between frames.\n\t */\n\tconstructor(smoothing?: NormalRange);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Meter.getDefaults(), arguments, [\n\t\t\t\"smoothing\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.input =\n\t\t\tthis.output =\n\t\t\tthis._analyser =\n\t\t\t\tnew Analyser({\n\t\t\t\t\tcontext: this.context,\n\t\t\t\t\tsize: 256,\n\t\t\t\t\ttype: \"waveform\",\n\t\t\t\t\tchannels: options.channelCount,\n\t\t\t\t});\n\n\t\tthis.smoothing = options.smoothing;\n\t\tthis.normalRange = options.normalRange;\n\t\tthis._rms = new Array(options.channelCount);\n\t\tthis._rms.fill(0);\n\t}\n\n\tstatic getDefaults(): MeterOptions {\n\t\treturn Object.assign(MeterBase.getDefaults(), {\n\t\t\tsmoothing: 0.8,\n\t\t\tnormalRange: false,\n\t\t\tchannelCount: 1,\n\t\t});\n\t}\n\n\t/**\n\t * Use {@link getValue} instead. For the previous getValue behavior, use DCMeter.\n\t * @deprecated\n\t */\n\tgetLevel(): number | number[] {\n\t\twarn(\"'getLevel' has been changed to 'getValue'\");\n\t\treturn this.getValue();\n\t}\n\n\t/**\n\t * Below this threshold, stop smoothing.\n\t */\n\tprivate minValue = dbToGain(-100);\n\n\t/**\n\t * Get the current value of the incoming signal.\n\t * Output is in decibels when {@link normalRange} is `false`.\n\t * If {@link channels} = 1, then the output is a single number\n\t * representing the value of the input signal. When {@link channels} > 1,\n\t * then each channel is returned as a value in a number array.\n\t */\n\tgetValue(): number | number[] {\n\t\tconst aValues = this._analyser.getValue();\n\t\tconst channelValues =\n\t\t\tthis.channels === 1\n\t\t\t\t? [aValues as Float32Array]\n\t\t\t\t: (aValues as Float32Array[]);\n\t\tconst vals = channelValues.map((values, channel) => {\n\t\t\tconst totalSquared = values.reduce(\n\t\t\t\t(total, current) => total + current * current,\n\t\t\t\t0\n\t\t\t);\n\t\t\tconst rms = Math.sqrt(totalSquared / values.length);\n\t\t\tif (rms < this.minValue) {\n\t\t\t\tthis._rms[channel] = 0;\n\t\t\t} else {\n\t\t\t\t// the rms can only fall at the rate of the smoothing\n\t\t\t\t// but can jump up instantly\n\t\t\t\tthis._rms[channel] = Math.max(\n\t\t\t\t\trms,\n\t\t\t\t\tthis._rms[channel] * this.smoothing\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn this.normalRange\n\t\t\t\t? this._rms[channel]\n\t\t\t\t: gainToDb(this._rms[channel]);\n\t\t});\n\t\tif (this.channels === 1) {\n\t\t\treturn vals[0];\n\t\t} else {\n\t\t\treturn vals;\n\t\t}\n\t}\n\n\t/**\n\t * The number of channels of analysis.\n\t */\n\tget channels(): number {\n\t\treturn this._analyser.channels;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._analyser.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/analysis/MeterBase.ts", "content": "import {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Analyser } from \"./Analyser.js\";\n\nexport type MeterBaseOptions = ToneAudioNodeOptions;\n\n/**\n * The base class for Metering classes.\n */\nexport class MeterBase<\n\tOptions extends MeterBaseOptions,\n> extends ToneAudioNode {\n\treadonly name: string = \"MeterBase\";\n\n\t/**\n\t * The signal to be analyzed\n\t */\n\tinput: InputNode;\n\n\t/**\n\t * The output is just a pass through of the input\n\t */\n\toutput: OutputNode;\n\n\t/**\n\t * The analyser node for the incoming signal\n\t */\n\tprotected _analyser: Analyser;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(optionsFromArguments(MeterBase.getDefaults(), arguments));\n\n\t\tthis.input =\n\t\t\tthis.output =\n\t\t\tthis._analyser =\n\t\t\t\tnew Analyser({\n\t\t\t\t\tcontext: this.context,\n\t\t\t\t\tsize: 256,\n\t\t\t\t\ttype: \"waveform\",\n\t\t\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._analyser.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/analysis/Waveform.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Noise } from \"../../source/Noise.js\";\nimport { Waveform } from \"./Waveform.js\";\n\ndescribe(\"Waveform\", () => {\n\tBasicTests(Waveform);\n\n\tit(\"can get and set properties\", () => {\n\t\tconst anl = new Waveform();\n\t\tanl.set({\n\t\t\tsize: 128,\n\t\t});\n\t\tconst values = anl.get();\n\t\texpect(values.size).to.equal(128);\n\t\tanl.dispose();\n\t});\n\n\tit(\"can correctly set the size\", () => {\n\t\tconst anl = new Waveform(512);\n\t\texpect(anl.size).to.equal(512);\n\t\tanl.size = 1024;\n\t\texpect(anl.size).to.equal(1024);\n\t\tanl.dispose();\n\t});\n\n\tit(\"can run waveform analysis\", (done) => {\n\t\tconst noise = new Noise();\n\t\tconst anl = new Waveform(256);\n\t\tnoise.connect(anl);\n\t\tnoise.start();\n\n\t\tsetTimeout(() => {\n\t\t\tconst analysis = anl.getValue();\n\t\t\texpect(analysis.length).to.equal(256);\n\t\t\tanalysis.forEach((value) => {\n\t\t\t\texpect(value).is.within(-1, 1);\n\t\t\t});\n\t\t\tanl.dispose();\n\t\t\tnoise.dispose();\n\t\t\tdone();\n\t\t}, 300);\n\t});\n});\n" }, { "path": "Tone/component/analysis/Waveform.ts", "content": "import { PowerOfTwo } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { MeterBase, MeterBaseOptions } from \"./MeterBase.js\";\n\nexport interface WaveformOptions extends MeterBaseOptions {\n\t/**\n\t * The size of the Waveform. Value must be a power of two in the range 16 to 16384.\n\t */\n\tsize: PowerOfTwo;\n}\n\n/**\n * Get the current waveform data of the connected audio source.\n * @category Component\n */\nexport class Waveform extends MeterBase {\n\treadonly name: string = \"Waveform\";\n\n\t/**\n\t * @param size The size of the Waveform. Value must be a power of two in the range 16 to 16384.\n\t */\n\tconstructor(size?: PowerOfTwo);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tWaveform.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"size\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._analyser.type = \"waveform\";\n\t\tthis.size = options.size;\n\t}\n\n\tstatic getDefaults(): WaveformOptions {\n\t\treturn Object.assign(MeterBase.getDefaults(), {\n\t\t\tsize: 1024,\n\t\t});\n\t}\n\n\t/**\n\t * Return the waveform for the current time as a Float32Array where each value in the array\n\t * represents a sample in the waveform.\n\t */\n\tgetValue(): Float32Array {\n\t\treturn this._analyser.getValue() as Float32Array;\n\t}\n\n\t/**\n\t * The size of analysis. This must be a power of two in the range 16 to 16384.\n\t * Determines the size of the array returned by {@link getValue}.\n\t */\n\tget size(): PowerOfTwo {\n\t\treturn this._analyser.size;\n\t}\n\tset size(size) {\n\t\tthis._analyser.size = size;\n\t}\n}\n" }, { "path": "Tone/component/channel/Channel.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Channel } from \"./Channel.js\";\n\ndescribe(\"Channel\", () => {\n\tBasicTests(Channel);\n\n\tcontext(\"Channel\", () => {\n\t\tit(\"can pass volume and panning into the constructor\", () => {\n\t\t\tconst channel = new Channel(-10, -1);\n\t\t\texpect(channel.pan.value).to.be.closeTo(-1, 0.01);\n\t\t\texpect(channel.volume.value).to.be.closeTo(-10, 0.01);\n\t\t\tchannel.dispose();\n\t\t});\n\n\t\tit(\"can pass in an object into the constructor\", () => {\n\t\t\tconst channel = new Channel({\n\t\t\t\tpan: 1,\n\t\t\t\tvolume: 6,\n\t\t\t\tmute: false,\n\t\t\t\tsolo: true,\n\t\t\t});\n\t\t\texpect(channel.pan.value).to.be.closeTo(1, 0.01);\n\t\t\texpect(channel.volume.value).to.be.closeTo(6, 0.01);\n\t\t\texpect(channel.mute).to.be.false;\n\t\t\texpect(channel.solo).to.be.true;\n\t\t\tchannel.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst channel = new Channel().toDestination();\n\t\t\t\tinput.connect(channel);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can mute the input\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst channel = new Channel(0).toDestination();\n\t\t\t\tnew Signal(1).connect(channel);\n\t\t\t\tchannel.mute = true;\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.be.true;\n\t\t});\n\n\t\tit(\"reports itself as muted when either muted or another channel is soloed\", () => {\n\t\t\tconst channelA = new Channel();\n\t\t\tconst channelB = new Channel();\n\t\t\tchannelB.solo = true;\n\t\t\texpect(channelA.muted).to.be.true;\n\t\t\texpect(channelB.muted).to.be.false;\n\t\t\tchannelB.mute = true;\n\t\t\texpect(channelA.muted).to.be.true;\n\t\t\texpect(channelB.muted).to.be.true;\n\t\t\tchannelA.dispose();\n\t\t\tchannelB.dispose();\n\t\t});\n\n\t\tdescribe(\"bus\", () => {\n\t\t\tit(\"can connect two channels together by name\", () => {\n\t\t\t\treturn PassAudio((input) => {\n\t\t\t\t\tconst sendChannel = new Channel();\n\t\t\t\t\tinput.connect(sendChannel);\n\t\t\t\t\tsendChannel.send(\"test\");\n\t\t\t\t\tconst recvChannel = new Channel().toDestination();\n\t\t\t\t\trecvChannel.receive(\"test\");\n\t\t\t\t});\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Channel.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { Param } from \"../../core/context/Param.js\";\nimport {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { AudioRange, Decibels } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\nimport { PanVol } from \"./PanVol.js\";\nimport { Solo } from \"./Solo.js\";\n\nexport interface ChannelOptions extends ToneAudioNodeOptions {\n\tpan: AudioRange;\n\tvolume: Decibels;\n\tsolo: boolean;\n\tmute: boolean;\n\tchannelCount: number;\n}\n\n/**\n * Channel provides a channel strip interface with volume, pan, solo and mute controls.\n * @see {@link PanVol} and {@link Solo}\n * @example\n * // pan the incoming signal left and drop the volume 12db\n * const channel = new Tone.Channel(-0.25, -12);\n * @category Component\n */\nexport class Channel extends ToneAudioNode {\n\treadonly name: string = \"Channel\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * The soloing interface\n\t */\n\tprivate _solo: Solo;\n\n\t/**\n\t * The panning and volume node\n\t */\n\tprivate _panVol: PanVol;\n\n\t/**\n\t * The L/R panning control. -1 = hard left, 1 = hard right.\n\t * @min -1\n\t * @max 1\n\t */\n\treadonly pan: Param<\"audioRange\">;\n\n\t/**\n\t * The volume control in decibels.\n\t */\n\treadonly volume: Param<\"decibels\">;\n\n\t/**\n\t * @param volume The output volume.\n\t * @param pan the initial pan\n\t */\n\tconstructor(volume?: Decibels, pan?: AudioRange);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Channel.getDefaults(), arguments, [\n\t\t\t\"volume\",\n\t\t\t\"pan\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._solo = this.input = new Solo({\n\t\t\tsolo: options.solo,\n\t\t\tcontext: this.context,\n\t\t});\n\t\tthis._panVol = this.output = new PanVol({\n\t\t\tcontext: this.context,\n\t\t\tpan: options.pan,\n\t\t\tvolume: options.volume,\n\t\t\tmute: options.mute,\n\t\t\tchannelCount: options.channelCount,\n\t\t});\n\t\tthis.pan = this._panVol.pan;\n\t\tthis.volume = this._panVol.volume;\n\n\t\tthis._solo.connect(this._panVol);\n\t\treadOnly(this, [\"pan\", \"volume\"]);\n\t}\n\n\tstatic getDefaults(): ChannelOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tpan: 0,\n\t\t\tvolume: 0,\n\t\t\tmute: false,\n\t\t\tsolo: false,\n\t\t\tchannelCount: 1,\n\t\t});\n\t}\n\n\t/**\n\t * Solo/unsolo the channel. Soloing is only relative to other {@link Channel}s and {@link Solo} instances\n\t */\n\tget solo(): boolean {\n\t\treturn this._solo.solo;\n\t}\n\tset solo(solo) {\n\t\tthis._solo.solo = solo;\n\t}\n\n\t/**\n\t * If the current instance is muted, i.e. another instance is soloed,\n\t * or the channel is muted\n\t */\n\tget muted(): boolean {\n\t\treturn this._solo.muted || this.mute;\n\t}\n\n\t/**\n\t * Mute/unmute the volume\n\t */\n\tget mute(): boolean {\n\t\treturn this._panVol.mute;\n\t}\n\tset mute(mute) {\n\t\tthis._panVol.mute = mute;\n\t}\n\n\t/**\n\t * Store the send/receive channels by name.\n\t */\n\tprivate static buses: Map = new Map();\n\n\t/**\n\t * Get the gain node belonging to the bus name. Create it if\n\t * it doesn't exist\n\t * @param name The bus name\n\t */\n\tprivate _getBus(name: string): Gain {\n\t\tif (!Channel.buses.has(name)) {\n\t\t\tChannel.buses.set(name, new Gain({ context: this.context }));\n\t\t}\n\t\treturn Channel.buses.get(name) as Gain;\n\t}\n\n\t/**\n\t * Send audio to another channel using a string. `send` is a lot like\n\t * {@link connect}, except it uses a string instead of an object. This can\n\t * be useful in large applications to decouple sections since {@link send}\n\t * and {@link receive} can be invoked separately in order to connect an object\n\t * @param name The channel name to send the audio\n\t * @param volume The amount of the signal to send.\n\t * \tDefaults to 0db, i.e. send the entire signal\n\t * @returns Returns the gain node of this connection.\n\t */\n\tsend(name: string, volume: Decibels = 0): Gain<\"decibels\"> {\n\t\tconst bus = this._getBus(name);\n\t\tconst sendKnob = new Gain({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"decibels\",\n\t\t\tgain: volume,\n\t\t});\n\t\tthis.connect(sendKnob);\n\t\tsendKnob.connect(bus);\n\t\treturn sendKnob;\n\t}\n\n\t/**\n\t * Receive audio from a channel which was connected with {@link send}.\n\t * @param name The channel name to receive audio from.\n\t */\n\treceive(name: string): this {\n\t\tconst bus = this._getBus(name);\n\t\tbus.connect(this);\n\t\treturn this;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._panVol.dispose();\n\t\tthis.pan.dispose();\n\t\tthis.volume.dispose();\n\t\tthis._solo.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/CrossFade.test.ts", "content": "import { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { ConstantOutput } from \"../../../test/helper/ConstantOutput.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { CrossFade } from \"./CrossFade.js\";\n\ndescribe(\"CrossFade\", () => {\n\tBasicTests(CrossFade);\n\n\tcontext(\"Fading\", () => {\n\t\tit(\"handles input and output connections\", () => {\n\t\t\tconst comp = new CrossFade();\n\t\t\tconnectFrom().connect(comp.a);\n\t\t\tconnectFrom().connect(comp.b);\n\t\t\tcomp.connect(connectTo());\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"pass 100% of input 0\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst crossFade = new CrossFade();\n\t\t\t\t\tconst drySignal = new Signal(10);\n\t\t\t\t\tconst wetSignal = new Signal(20);\n\t\t\t\t\tdrySignal.connect(crossFade.a);\n\t\t\t\t\twetSignal.connect(crossFade.b);\n\t\t\t\t\tcrossFade.fade.value = 0;\n\t\t\t\t\tcrossFade.toDestination();\n\t\t\t\t},\n\t\t\t\t10,\n\t\t\t\t0.05\n\t\t\t);\n\t\t});\n\n\t\tit(\"pass 100% of input 1\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst crossFade = new CrossFade();\n\t\t\t\t\tconst drySignal = new Signal(10);\n\t\t\t\t\tconst wetSignal = new Signal(20);\n\t\t\t\t\tdrySignal.connect(crossFade.a);\n\t\t\t\t\twetSignal.connect(crossFade.b);\n\t\t\t\t\tcrossFade.fade.value = 1;\n\t\t\t\t\tcrossFade.toDestination();\n\t\t\t\t},\n\t\t\t\t20,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can mix two signals\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst crossFade = new CrossFade();\n\t\t\t\t\tconst drySignal = new Signal(2);\n\t\t\t\t\tconst wetSignal = new Signal(1);\n\t\t\t\t\tdrySignal.connect(crossFade.a);\n\t\t\t\t\twetSignal.connect(crossFade.b);\n\t\t\t\t\tcrossFade.fade.value = 0.5;\n\t\t\t\t\tcrossFade.toDestination();\n\t\t\t\t},\n\t\t\t\t2.12,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/CrossFade.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tconnect,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { NormalRange } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\nimport { GainToAudio } from \"../../signal/GainToAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { ToneConstantSource } from \"../../signal/ToneConstantSource.js\";\n\ninterface CrossFadeOptions extends ToneAudioNodeOptions {\n\tfade: NormalRange;\n}\n\n/**\n * Tone.Crossfade provides equal power fading between two inputs.\n * More on crossfading technique [here](https://en.wikipedia.org/wiki/Fade_(audio_engineering)#Crossfading).\n * ```\n * +---------+\n * +> input a +>--+\n * +-----------+ +---------------------+ | | |\n * | 1s signal +>--> stereoPannerNode L +>----> gain | |\n * +-----------+ | | +---------+ |\n * +-> pan R +>-+ | +--------+\n * | +---------------------+ | +---> output +>\n * +------+ | | +---------+ | +--------+\n * | fade +>----+ | +> input b +>--+\n * +------+ | | |\n * +--> gain |\n * +---------+\n * ```\n * @example\n * const crossFade = new Tone.CrossFade().toDestination();\n * // connect two inputs Tone.to a/b\n * const inputA = new Tone.Oscillator(440, \"square\").connect(crossFade.a).start();\n * const inputB = new Tone.Oscillator(440, \"sine\").connect(crossFade.b).start();\n * // use the fade to control the mix between the two\n * crossFade.fade.value = 0.5;\n * @category Component\n */\nexport class CrossFade extends ToneAudioNode {\n\treadonly name: string = \"CrossFade\";\n\n\t/**\n\t * The crossfading is done by a StereoPannerNode\n\t */\n\tprivate _panner: StereoPannerNode = this.context.createStereoPanner();\n\n\t/**\n\t * Split the output of the panner node into two values used to control the gains.\n\t */\n\tprivate _split: ChannelSplitterNode = this.context.createChannelSplitter(2);\n\n\t/**\n\t * Convert the fade value into an audio range value so it can be connected\n\t * to the panner.pan AudioParam\n\t */\n\tprivate _g2a: GainToAudio = new GainToAudio({ context: this.context });\n\n\t/**\n\t * The constant source which is used to control the panner\n\t */\n\tprivate _constant: ToneConstantSource;\n\n\t/**\n\t * The input which is at full level when fade = 0\n\t */\n\treadonly a: Gain = new Gain({\n\t\tcontext: this.context,\n\t\tgain: 0,\n\t});\n\n\t/**\n\t * The input which is at full level when fade = 1\n\t */\n\treadonly b: Gain = new Gain({\n\t\tcontext: this.context,\n\t\tgain: 0,\n\t});\n\n\t/**\n\t * The output is a mix between `a` and `b` at the ratio of `fade`\n\t */\n\treadonly output: Gain = new Gain({ context: this.context });\n\n\t/**\n\t * CrossFade has no input, you must choose either `a` or `b`\n\t */\n\treadonly input: undefined;\n\n\t/**\n\t * The mix between the two inputs. A fade value of 0\n\t * will output 100% crossFade.a and\n\t * a value of 1 will output 100% crossFade.b.\n\t */\n\treadonly fade: Signal<\"normalRange\">;\n\n\tprotected _internalChannels = [this.a, this.b];\n\n\t/**\n\t * @param fade The initial fade value [0, 1].\n\t */\n\tconstructor(fade?: NormalRange);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tCrossFade.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"fade\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.fade = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"normalRange\",\n\t\t\tvalue: options.fade,\n\t\t});\n\t\treadOnly(this, \"fade\");\n\n\t\tthis._constant = new ToneConstantSource({\n\t\t\tcontext: this.context,\n\t\t\toffset: 1,\n\t\t}).start();\n\t\tthis._constant.connect(this._panner);\n\t\tthis._panner.connect(this._split);\n\t\t// this is necessary for standardized-audio-context\n\t\t// doesn't make any difference for the native AudioContext\n\t\t// https://github.com/chrisguttandin/standardized-audio-context/issues/647\n\t\tthis._panner.channelCount = 1;\n\t\tthis._panner.channelCountMode = \"explicit\";\n\t\tconnect(this._split, this.a.gain, 0);\n\t\tconnect(this._split, this.b.gain, 1);\n\n\t\tthis.fade.chain(this._g2a, this._panner.pan);\n\n\t\tthis.a.connect(this.output);\n\t\tthis.b.connect(this.output);\n\t}\n\n\tstatic getDefaults(): CrossFadeOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tfade: 0.5,\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.a.dispose();\n\t\tthis.b.dispose();\n\t\tthis.output.dispose();\n\t\tthis.fade.dispose();\n\t\tthis._g2a.dispose();\n\t\tthis._panner.disconnect();\n\t\tthis._split.disconnect();\n\t\tthis._constant.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Merge.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Merge } from \"./Merge.js\";\n\ndescribe(\"Merge\", () => {\n\tBasicTests(Merge);\n\n\tcontext(\"Merging\", () => {\n\t\tit(\"handles input and output connections\", () => {\n\t\t\tconst merge = new Merge();\n\t\t\tconnectFrom().connect(merge);\n\t\t\tmerge.connect(connectTo());\n\t\t\tmerge.dispose();\n\t\t});\n\n\t\tit(\"defaults to two channels\", () => {\n\t\t\tconst merge = new Merge();\n\t\t\texpect(merge.numberOfInputs).to.equal(2);\n\t\t\tmerge.dispose();\n\t\t});\n\n\t\tit(\"can pass in more channels\", () => {\n\t\t\tconst merge = new Merge(4);\n\t\t\texpect(merge.numberOfInputs).to.equal(4);\n\t\t\tconnectFrom().connect(merge, 0, 0);\n\t\t\tconnectFrom().connect(merge, 0, 1);\n\t\t\tconnectFrom().connect(merge, 0, 2);\n\t\t\tconnectFrom().connect(merge, 0, 3);\n\t\t\tmerge.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst merge = new Merge().toDestination();\n\t\t\t\tinput.connect(merge);\n\t\t\t});\n\t\t});\n\n\t\tit(\"merge two signal into one stereo signal\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst sigL = new Signal(1);\n\t\t\t\t\tconst sigR = new Signal(2);\n\t\t\t\t\tconst merger = new Merge();\n\t\t\t\t\tsigL.connect(merger, 0, 0);\n\t\t\t\t\tsigR.connect(merger, 0, 1);\n\t\t\t\t\tmerger.toDestination();\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\texpect(buffer.toArray()[0][0]).to.be.closeTo(1, 0.001);\n\t\t\texpect(buffer.toArray()[1][0]).to.be.closeTo(2, 0.001);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Merge.ts", "content": "import {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Positive } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\ninterface MergeOptions extends ToneAudioNodeOptions {\n\tchannels: Positive;\n}\n\n/**\n * Merge brings multiple mono input channels into a single multichannel output channel.\n *\n * @example\n * const merge = new Tone.Merge().toDestination();\n * // routing a sine tone in the left channel\n * const osc = new Tone.Oscillator().connect(merge, 0, 0).start();\n * // and noise in the right channel\n * const noise = new Tone.Noise().connect(merge, 0, 1).start();;\n * @category Component\n */\nexport class Merge extends ToneAudioNode {\n\treadonly name: string = \"Merge\";\n\n\t/**\n\t * The merger node for the channels.\n\t */\n\tprivate _merger: ChannelMergerNode;\n\n\t/**\n\t * The output is the input channels combined into a single (multichannel) output\n\t */\n\treadonly output: ChannelMergerNode;\n\n\t/**\n\t * Multiple input connections combine into a single output.\n\t */\n\treadonly input: ChannelMergerNode;\n\n\t/**\n\t * @param channels The number of channels to merge.\n\t */\n\tconstructor(channels?: Positive);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Merge.getDefaults(), arguments, [\n\t\t\t\"channels\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._merger =\n\t\t\tthis.output =\n\t\t\tthis.input =\n\t\t\t\tthis.context.createChannelMerger(options.channels);\n\t}\n\n\tstatic getDefaults(): MergeOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tchannels: 2,\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._merger.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/MidSideMerge.test.ts", "content": "import { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { MidSideMerge } from \"./MidSideMerge.js\";\n\ndescribe(\"MidSideMerge\", () => {\n\tBasicTests(MidSideMerge);\n\n\tcontext(\"Merging\", () => {\n\t\tit(\"handles inputs and outputs\", () => {\n\t\t\tconst merge = new MidSideMerge();\n\t\t\tmerge.connect(connectTo());\n\t\t\tconnectFrom().connect(merge.mid);\n\t\t\tconnectFrom().connect(merge.side);\n\t\t\tmerge.dispose();\n\t\t});\n\n\t\tit(\"passes the mid signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst merge = new MidSideMerge().toDestination();\n\t\t\t\tinput.connect(merge.mid);\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/MidSideMerge.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Add } from \"../../signal/Add.js\";\nimport { Multiply } from \"../../signal/Multiply.js\";\nimport { Subtract } from \"../../signal/Subtract.js\";\nimport { Merge } from \"./Merge.js\";\n\nexport type MidSideMergeOptions = ToneAudioNodeOptions;\n\n/**\n * MidSideMerge merges the mid and side signal after they've been separated by {@link MidSideSplit}\n * ```\n * Mid = (Left+Right)/sqrt(2); // obtain mid-signal from left and right\n * Side = (Left-Right)/sqrt(2); // obtain side-signal from left and right\n * ```\n * @category Component\n */\nexport class MidSideMerge extends ToneAudioNode {\n\treadonly name: string = \"MidSideMerge\";\n\n\t/**\n\t * There is no input, connect sources to either {@link mid} or {@link side} inputs.\n\t */\n\treadonly input: undefined;\n\n\t/**\n\t * The merged signal\n\t */\n\treadonly output: Merge;\n\n\t/**\n\t * Merge the incoming signal into left and right channels\n\t */\n\tprivate _merge: Merge;\n\n\t/**\n\t * The \"mid\" input.\n\t */\n\treadonly mid: ToneAudioNode;\n\n\t/**\n\t * The \"side\" input.\n\t */\n\treadonly side: ToneAudioNode;\n\n\t/**\n\t * Recombine the mid/side into Left\n\t */\n\tprivate _left: Add;\n\n\t/**\n\t * Recombine the mid/side into Right\n\t */\n\tprivate _right: Subtract;\n\n\t/**\n\t * Multiply the right by sqrt(1/2)\n\t */\n\tprivate _leftMult: Multiply;\n\n\t/**\n\t * Multiply the left by sqrt(1/2)\n\t */\n\tprivate _rightMult: Multiply;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(optionsFromArguments(MidSideMerge.getDefaults(), arguments));\n\t\tthis.mid = new Gain({ context: this.context });\n\t\tthis.side = new Gain({ context: this.context });\n\t\tthis._left = new Add({ context: this.context });\n\t\tthis._leftMult = new Multiply({\n\t\t\tcontext: this.context,\n\t\t\tvalue: Math.SQRT1_2,\n\t\t});\n\t\tthis._right = new Subtract({ context: this.context });\n\t\tthis._rightMult = new Multiply({\n\t\t\tcontext: this.context,\n\t\t\tvalue: Math.SQRT1_2,\n\t\t});\n\t\tthis._merge = this.output = new Merge({ context: this.context });\n\n\t\tthis.mid.fan(this._left);\n\t\tthis.side.connect(this._left.addend);\n\t\tthis.mid.connect(this._right);\n\t\tthis.side.connect(this._right.subtrahend);\n\t\tthis._left.connect(this._leftMult);\n\t\tthis._right.connect(this._rightMult);\n\t\tthis._leftMult.connect(this._merge, 0, 0);\n\t\tthis._rightMult.connect(this._merge, 0, 1);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.side.dispose();\n\t\tthis._leftMult.dispose();\n\t\tthis._rightMult.dispose();\n\t\tthis._left.dispose();\n\t\tthis._right.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/MidSideSplit.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Merge } from \"./Merge.js\";\nimport { MidSideMerge } from \"./MidSideMerge.js\";\nimport { MidSideSplit } from \"./MidSideSplit.js\";\n\ndescribe(\"MidSideSplit\", () => {\n\tBasicTests(MidSideSplit);\n\n\tcontext(\"Splitting\", () => {\n\t\tit(\"handles inputs and outputs\", () => {\n\t\t\tconst split = new MidSideSplit();\n\t\t\tconnectFrom().connect(split);\n\t\t\tsplit.mid.connect(connectTo());\n\t\t\tsplit.side.connect(connectTo());\n\t\t\tsplit.dispose();\n\t\t});\n\n\t\tit(\"mid is if both L and R are the same\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst split = new MidSideSplit();\n\t\t\t\tsplit.mid.toDestination();\n\t\t\t\tconst merge = new Merge().connect(split);\n\t\t\t\tnew Signal(0.5).connect(merge, 0, 0);\n\t\t\t\tnew Signal(0.5).connect(merge, 0, 1);\n\t\t\t});\n\t\t\texpect(buffer.min()).to.be.closeTo(0.707, 0.01);\n\t\t\texpect(buffer.max()).to.be.closeTo(0.707, 0.01);\n\t\t});\n\n\t\tit(\"side is 0 if both L and R are the same\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst split = new MidSideSplit();\n\t\t\t\tsplit.side.toDestination();\n\t\t\t\tconst merge = new Merge().connect(split);\n\t\t\t\tnew Signal(0.5).connect(merge, 0, 0);\n\t\t\t\tnew Signal(0.5).connect(merge, 0, 1);\n\t\t\t});\n\t\t\texpect(buffer.min()).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.max()).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"mid is 0 if both L and R opposites\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst split = new MidSideSplit();\n\t\t\t\tsplit.mid.toDestination();\n\t\t\t\tconst merge = new Merge().connect(split);\n\t\t\t\tnew Signal(-1).connect(merge, 0, 0);\n\t\t\t\tnew Signal(1).connect(merge, 0, 1);\n\t\t\t});\n\t\t\texpect(buffer.min()).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.max()).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"can decompose and reconstruct a signal\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst midSideMerge = new MidSideMerge().toDestination();\n\t\t\t\t\tconst split = new MidSideSplit();\n\t\t\t\t\tsplit.mid.connect(midSideMerge.mid);\n\t\t\t\t\tsplit.side.connect(midSideMerge.side);\n\t\t\t\t\tconst merge = new Merge().connect(split);\n\t\t\t\t\tnew Signal(0.2).connect(merge, 0, 0);\n\t\t\t\t\tnew Signal(0.4).connect(merge, 0, 1);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\tbuffer\n\t\t\t\t.toArray()[0]\n\t\t\t\t.forEach((l) => expect(l).to.be.closeTo(0.2, 0.01));\n\t\t\tbuffer\n\t\t\t\t.toArray()[1]\n\t\t\t\t.forEach((r) => expect(r).to.be.closeTo(0.4, 0.01));\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/MidSideSplit.ts", "content": "import {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Add } from \"../../signal/Add.js\";\nimport { Multiply } from \"../../signal/Multiply.js\";\nimport { Subtract } from \"../../signal/Subtract.js\";\nimport { Split } from \"./Split.js\";\n\nexport type MidSideSplitOptions = ToneAudioNodeOptions;\n\n/**\n * Mid/Side processing separates the the 'mid' signal (which comes out of both the left and the right channel)\n * and the 'side' (which only comes out of the the side channels).\n * ```\n * Mid = (Left+Right)/sqrt(2); // obtain mid-signal from left and right\n * Side = (Left-Right)/sqrt(2); // obtain side-signal from left and right\n * ```\n * @category Component\n */\nexport class MidSideSplit extends ToneAudioNode {\n\treadonly name: string = \"MidSideSplit\";\n\n\treadonly input: Split;\n\n\t/**\n\t * There is no output node, use either {@link mid} or {@link side} outputs.\n\t */\n\treadonly output: undefined;\n\t/**\n\t * Split the incoming signal into left and right channels\n\t */\n\tprivate _split: Split;\n\n\t/**\n\t * Sums the left and right channels\n\t */\n\tprivate _midAdd: Add;\n\n\t/**\n\t * Subtract left and right channels.\n\t */\n\tprivate _sideSubtract: Subtract;\n\n\t/**\n\t * The \"mid\" output. `(Left+Right)/sqrt(2)`\n\t */\n\treadonly mid: ToneAudioNode;\n\n\t/**\n\t * The \"side\" output. `(Left-Right)/sqrt(2)`\n\t */\n\treadonly side: ToneAudioNode;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(optionsFromArguments(MidSideSplit.getDefaults(), arguments));\n\n\t\tthis._split = this.input = new Split({\n\t\t\tchannels: 2,\n\t\t\tcontext: this.context,\n\t\t});\n\t\tthis._midAdd = new Add({ context: this.context });\n\t\tthis.mid = new Multiply({\n\t\t\tcontext: this.context,\n\t\t\tvalue: Math.SQRT1_2,\n\t\t});\n\t\tthis._sideSubtract = new Subtract({ context: this.context });\n\t\tthis.side = new Multiply({\n\t\t\tcontext: this.context,\n\t\t\tvalue: Math.SQRT1_2,\n\t\t});\n\n\t\tthis._split.connect(this._midAdd, 0);\n\t\tthis._split.connect(this._midAdd.addend, 1);\n\t\tthis._split.connect(this._sideSubtract, 0);\n\t\tthis._split.connect(this._sideSubtract.subtrahend, 1);\n\t\tthis._midAdd.connect(this.mid);\n\t\tthis._sideSubtract.connect(this.side);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.side.dispose();\n\t\tthis._midAdd.dispose();\n\t\tthis._sideSubtract.dispose();\n\t\tthis._split.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Mono.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { StereoSignal } from \"../../../test/helper/StereoSignal.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Mono } from \"./Mono.js\";\n\ndescribe(\"Mono\", () => {\n\tBasicTests(Mono);\n\n\tcontext(\"Mono\", () => {\n\t\tit(\"Makes a mono signal in both channels\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst mono = new Mono().toDestination();\n\t\t\t\t\tconst signal = new Signal(2).connect(mono);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\texpect(buffer.toArray()[0][0]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][0]).to.equal(2);\n\t\t\texpect(buffer.toArray()[0][100]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][100]).to.equal(2);\n\t\t\texpect(buffer.toArray()[0][1000]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][1000]).to.equal(2);\n\t\t});\n\n\t\tit(\"Sums a stereo signal into a mono signal\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst mono = new Mono().toDestination();\n\t\t\t\t\tconst signal = StereoSignal(2, 2).connect(mono);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\texpect(buffer.toArray()[0][0]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][0]).to.equal(2);\n\t\t\texpect(buffer.toArray()[0][100]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][100]).to.equal(2);\n\t\t\texpect(buffer.toArray()[0][1000]).to.equal(2);\n\t\t\texpect(buffer.toArray()[1][1000]).to.equal(2);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Mono.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Merge } from \"./Merge.js\";\n\nexport type MonoOptions = ToneAudioNodeOptions;\n\n/**\n * Mono coerces the incoming mono or stereo signal into a mono signal\n * where both left and right channels have the same value. This can be useful\n * for [stereo imaging](https://en.wikipedia.org/wiki/Stereo_imaging).\n * @category Component\n */\nexport class Mono extends ToneAudioNode {\n\treadonly name: string = \"Mono\";\n\n\t/**\n\t * merge the signal\n\t */\n\tprivate _merge: Merge;\n\n\t/**\n\t * The summed output of the multiple inputs\n\t */\n\treadonly output: OutputNode;\n\n\t/**\n\t * The stereo signal to sum to mono\n\t */\n\treadonly input: Gain;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(optionsFromArguments(Mono.getDefaults(), arguments));\n\n\t\tthis.input = new Gain({ context: this.context });\n\n\t\tthis._merge = this.output = new Merge({\n\t\t\tchannels: 2,\n\t\t\tcontext: this.context,\n\t\t});\n\n\t\tthis.input.connect(this._merge, 0, 0);\n\t\tthis.input.connect(this._merge, 0, 1);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._merge.dispose();\n\t\tthis.input.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/MultibandSplit.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { MultibandSplit } from \"./MultibandSplit.js\";\n\ndescribe(\"MultibandSplit\", () => {\n\tBasicTests(MultibandSplit);\n\n\tit(\"handles input and output connections\", () => {\n\t\tconst split = new MultibandSplit();\n\t\tconnectFrom().connect(split);\n\t\tsplit.low.connect(connectTo());\n\t\tsplit.mid.connect(connectTo());\n\t\tsplit.high.connect(connectTo());\n\t\tsplit.dispose();\n\t});\n\n\tit(\"can be constructed with an object\", () => {\n\t\tconst split = new MultibandSplit({\n\t\t\tQ: 8,\n\t\t\thighFrequency: 2700,\n\t\t\tlowFrequency: 500,\n\t\t});\n\t\texpect(split.lowFrequency.value).to.be.closeTo(500, 0.01);\n\t\texpect(split.highFrequency.value).to.be.closeTo(2700, 0.01);\n\t\texpect(split.Q.value).to.be.closeTo(8, 0.01);\n\t\tsplit.dispose();\n\t});\n\n\tit(\"can be get and set through object\", () => {\n\t\tconst split = new MultibandSplit();\n\t\tsplit.set({\n\t\t\tQ: 4,\n\t\t\tlowFrequency: 250,\n\t\t});\n\t\texpect(split.get().Q).to.be.closeTo(4, 0.1);\n\t\texpect(split.get().lowFrequency).to.be.closeTo(250, 0.01);\n\t\tsplit.dispose();\n\t});\n\n\tit(\"passes the incoming signal through low\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst split = new MultibandSplit().low.toDestination();\n\t\t\tinput.connect(split);\n\t\t});\n\t});\n\n\tit(\"passes the incoming signal through mid\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst split = new MultibandSplit().mid.toDestination();\n\t\t\tinput.connect(split);\n\t\t});\n\t});\n\n\tit(\"passes the incoming signal through high\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst split = new MultibandSplit({\n\t\t\t\thighFrequency: 10,\n\t\t\t\tlowFrequency: 5,\n\t\t\t}).high.toDestination();\n\t\t\tinput.connect(split);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/MultibandSplit.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Frequency, Positive } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, writable } from \"../../core/util/Interface.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Filter } from \"../filter/Filter.js\";\n\ninterface MultibandSplitOptions extends ToneAudioNodeOptions {\n\tQ: Positive;\n\tlowFrequency: Frequency;\n\thighFrequency: Frequency;\n}\n\n/**\n * Split the incoming signal into three bands (low, mid, high)\n * with two crossover frequency controls.\n * ```\n * +----------------------+\n * +-> input < lowFrequency +------------------> low\n * | +----------------------+\n * |\n * | +--------------------------------------+\n * input ---+-> lowFrequency < input < highFrequency +--> mid\n * | +--------------------------------------+\n * |\n * | +-----------------------+\n * +-> highFrequency < input +-----------------> high\n * +-----------------------+\n * ```\n * @category Component\n */\nexport class MultibandSplit extends ToneAudioNode {\n\treadonly name: string = \"MultibandSplit\";\n\n\t/**\n\t * the input\n\t */\n\treadonly input = new Gain({ context: this.context });\n\n\t/**\n\t * no output node, use either low, mid or high outputs\n\t */\n\treadonly output = undefined;\n\n\t/**\n\t * The low band.\n\t */\n\treadonly low = new Filter({\n\t\tcontext: this.context,\n\t\tfrequency: 0,\n\t\ttype: \"lowpass\",\n\t});\n\n\t/**\n\t * the lower filter of the mid band\n\t */\n\tprivate _lowMidFilter = new Filter({\n\t\tcontext: this.context,\n\t\tfrequency: 0,\n\t\ttype: \"highpass\",\n\t});\n\n\t/**\n\t * The mid band output.\n\t */\n\treadonly mid = new Filter({\n\t\tcontext: this.context,\n\t\tfrequency: 0,\n\t\ttype: \"lowpass\",\n\t});\n\n\t/**\n\t * The high band output.\n\t */\n\treadonly high = new Filter({\n\t\tcontext: this.context,\n\t\tfrequency: 0,\n\t\ttype: \"highpass\",\n\t});\n\n\t/**\n\t * The low/mid crossover frequency.\n\t */\n\treadonly lowFrequency: Signal<\"frequency\">;\n\n\t/**\n\t * The mid/high crossover frequency.\n\t */\n\treadonly highFrequency: Signal<\"frequency\">;\n\n\tprotected _internalChannels = [this.low, this.mid, this.high];\n\n\t/**\n\t * The Q or Quality of the filter\n\t */\n\treadonly Q: Signal<\"positive\">;\n\n\t/**\n\t * @param lowFrequency the low/mid crossover frequency\n\t * @param highFrequency the mid/high crossover frequency\n\t */\n\tconstructor(lowFrequency?: Frequency, highFrequency?: Frequency);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tMultibandSplit.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"lowFrequency\", \"highFrequency\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.lowFrequency = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"frequency\",\n\t\t\tvalue: options.lowFrequency,\n\t\t});\n\n\t\tthis.highFrequency = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"frequency\",\n\t\t\tvalue: options.highFrequency,\n\t\t});\n\n\t\tthis.Q = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"positive\",\n\t\t\tvalue: options.Q,\n\t\t});\n\n\t\tthis.input.fan(this.low, this.high);\n\t\tthis.input.chain(this._lowMidFilter, this.mid);\n\t\t// the frequency control signal\n\t\tthis.lowFrequency.fan(this.low.frequency, this._lowMidFilter.frequency);\n\t\tthis.highFrequency.fan(this.mid.frequency, this.high.frequency);\n\t\t// the Q value\n\t\tthis.Q.connect(this.low.Q);\n\t\tthis.Q.connect(this._lowMidFilter.Q);\n\t\tthis.Q.connect(this.mid.Q);\n\t\tthis.Q.connect(this.high.Q);\n\n\t\treadOnly(this, [\"high\", \"mid\", \"low\", \"highFrequency\", \"lowFrequency\"]);\n\t}\n\n\tstatic getDefaults(): MultibandSplitOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tQ: 1,\n\t\t\thighFrequency: 2500,\n\t\t\tlowFrequency: 400,\n\t\t});\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\twritable(this, [\"high\", \"mid\", \"low\", \"highFrequency\", \"lowFrequency\"]);\n\t\tthis.low.dispose();\n\t\tthis._lowMidFilter.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.high.dispose();\n\t\tthis.lowFrequency.dispose();\n\t\tthis.highFrequency.dispose();\n\t\tthis.Q.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/PanVol.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { PanVol } from \"./PanVol.js\";\n\ndescribe(\"PanVol\", () => {\n\tBasicTests(PanVol);\n\n\tcontext(\"Pan and Volume\", () => {\n\t\tit(\"can be constructed with the panning and volume value\", () => {\n\t\t\tconst panVol = new PanVol(0.3, -12);\n\t\t\texpect(panVol.pan.value).to.be.closeTo(0.3, 0.001);\n\t\t\texpect(panVol.volume.value).to.be.closeTo(-12, 0.1);\n\t\t\tpanVol.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst panVol = new PanVol({\n\t\t\t\tmute: true,\n\t\t\t\tpan: 0.2,\n\t\t\t});\n\t\t\texpect(panVol.pan.value).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(panVol.mute).to.be.true;\n\t\t\tpanVol.dispose();\n\t\t});\n\n\t\tit(\"can set/get with an object\", () => {\n\t\t\tconst panVol = new PanVol();\n\t\t\tpanVol.set({\n\t\t\t\tvolume: -10,\n\t\t\t});\n\t\t\texpect(panVol.get().volume).to.be.closeTo(-10, 0.1);\n\t\t\tpanVol.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst panVol = new PanVol().toDestination();\n\t\t\t\tinput.connect(panVol);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can mute the volume\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst vol = new PanVol(0).toDestination();\n\t\t\t\tnew Signal(1).connect(vol);\n\t\t\t\tvol.mute = true;\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.be.true;\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/PanVol.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { AudioRange, Decibels } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\nimport { Panner } from \"./Panner.js\";\nimport { Volume } from \"./Volume.js\";\n\nexport interface PanVolOptions extends ToneAudioNodeOptions {\n\tpan: AudioRange;\n\tvolume: Decibels;\n\tmute: boolean;\n\tchannelCount: number;\n}\n\n/**\n * PanVol is a Tone.Panner and Tone.Volume in one.\n * @example\n * // pan the incoming signal left and drop the volume\n * const panVol = new Tone.PanVol(-0.25, -12).toDestination();\n * const osc = new Tone.Oscillator().connect(panVol).start();\n * @category Component\n */\nexport class PanVol extends ToneAudioNode {\n\treadonly name: string = \"PanVol\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * The panning node\n\t */\n\tprivate _panner: Panner;\n\n\t/**\n\t * The L/R panning control. -1 = hard left, 1 = hard right.\n\t * @min -1\n\t * @max 1\n\t */\n\treadonly pan: Param<\"audioRange\">;\n\n\t/**\n\t * The volume node\n\t */\n\tprivate _volume: Volume;\n\n\t/**\n\t * The volume control in decibels.\n\t */\n\treadonly volume: Param<\"decibels\">;\n\n\t/**\n\t * @param pan the initial pan\n\t * @param volume The output volume.\n\t */\n\tconstructor(pan?: AudioRange, volume?: Decibels);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(PanVol.getDefaults(), arguments, [\n\t\t\t\"pan\",\n\t\t\t\"volume\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._panner = this.input = new Panner({\n\t\t\tcontext: this.context,\n\t\t\tpan: options.pan,\n\t\t\tchannelCount: options.channelCount,\n\t\t});\n\t\tthis.pan = this._panner.pan;\n\t\tthis._volume = this.output = new Volume({\n\t\t\tcontext: this.context,\n\t\t\tvolume: options.volume,\n\t\t});\n\t\tthis.volume = this._volume.volume;\n\n\t\t// connections\n\t\tthis._panner.connect(this._volume);\n\t\tthis.mute = options.mute;\n\n\t\treadOnly(this, [\"pan\", \"volume\"]);\n\t}\n\n\tstatic getDefaults(): PanVolOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tmute: false,\n\t\t\tpan: 0,\n\t\t\tvolume: 0,\n\t\t\tchannelCount: 1,\n\t\t});\n\t}\n\n\t/**\n\t * Mute/unmute the volume\n\t */\n\tget mute(): boolean {\n\t\treturn this._volume.mute;\n\t}\n\tset mute(mute) {\n\t\tthis._volume.mute = mute;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._panner.dispose();\n\t\tthis.pan.dispose();\n\t\tthis._volume.dispose();\n\t\tthis.volume.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Panner.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Panner } from \"./Panner.js\";\n\ndescribe(\"Panner\", () => {\n\tBasicTests(Panner);\n\n\tcontext(\"Panning\", () => {\n\t\tit(\"can be constructed with the panning value\", () => {\n\t\t\tconst panner = new Panner(0.3);\n\t\t\texpect(panner.pan.value).to.be.closeTo(0.3, 0.001);\n\t\t\tpanner.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst panner = new Panner({\n\t\t\t\tpan: 0.5,\n\t\t\t});\n\t\t\texpect(panner.pan.value).to.be.closeTo(0.5, 0.001);\n\t\t\tpanner.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst panner = new Panner().toDestination();\n\t\t\t\tinput.connect(panner);\n\t\t\t});\n\t\t});\n\n\t\tit(\"pans hard left when the pan is set to -1\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst panner = new Panner(-1).toDestination();\n\t\t\t\t\tnew Signal(1).connect(panner);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\tconst l = buffer.toArray()[0];\n\t\t\tconst r = buffer.toArray()[1];\n\t\t\texpect(l[0]).to.be.closeTo(1, 0.01);\n\t\t\texpect(r[0]).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"pans hard right when the pan is set to 1\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst panner = new Panner(1).toDestination();\n\t\t\t\t\tnew Signal(1).connect(panner);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\tconst l = buffer.toArray()[0];\n\t\t\tconst r = buffer.toArray()[1];\n\t\t\texpect(l[0]).to.be.closeTo(0, 0.01);\n\t\t\texpect(r[0]).to.be.closeTo(1, 0.01);\n\t\t});\n\n\t\tit(\"mixes the signal in equal power when panned center\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst panner = new Panner(0).toDestination();\n\t\t\t\t\tnew Signal(1).connect(panner);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\tconst l = buffer.toArray()[0];\n\t\t\tconst r = buffer.toArray()[1];\n\t\t\texpect(l[0]).to.be.closeTo(0.707, 0.01);\n\t\t\texpect(r[0]).to.be.closeTo(0.707, 0.01);\n\t\t});\n\n\t\tit(\"can chain two panners when channelCount is 2\", async () => {\n\t\t\tconst buffer = await Offline(\n\t\t\t\t() => {\n\t\t\t\t\tconst panner1 = new Panner({\n\t\t\t\t\t\tchannelCount: 2,\n\t\t\t\t\t}).toDestination();\n\t\t\t\t\tconst panner0 = new Panner(-1).connect(panner1);\n\t\t\t\t\tnew Signal(1).connect(panner0);\n\t\t\t\t},\n\t\t\t\t0.1,\n\t\t\t\t2\n\t\t\t);\n\t\t\tconst l = buffer.toArray()[0];\n\t\t\tconst r = buffer.toArray()[1];\n\t\t\texpect(l[0]).to.be.closeTo(1, 0.01);\n\t\t\texpect(r[0]).to.be.closeTo(0, 0.01);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Panner.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { AudioRange } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\n\ninterface TonePannerOptions extends ToneAudioNodeOptions {\n\tpan: AudioRange;\n\tchannelCount: number;\n}\n\n/**\n * Panner is an equal power Left/Right Panner. It is a wrapper around the StereoPannerNode.\n * @example\n * return Tone.Offline(() => {\n * // move the input signal from right to left\n * \tconst panner = new Tone.Panner(1).toDestination();\n * \tpanner.pan.rampTo(-1, 0.5);\n * \tconst osc = new Tone.Oscillator(100).connect(panner).start();\n * }, 0.5, 2);\n * @category Component\n */\nexport class Panner extends ToneAudioNode {\n\treadonly name: string = \"Panner\";\n\n\t/**\n\t * the panner node\n\t */\n\tprivate _panner: StereoPannerNode = this.context.createStereoPanner();\n\treadonly input: StereoPannerNode = this._panner;\n\treadonly output: StereoPannerNode = this._panner;\n\n\t/**\n\t * The pan control. -1 = hard left, 1 = hard right.\n\t * @min -1\n\t * @max 1\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \t// pan hard right\n\t * \tconst panner = new Tone.Panner(1).toDestination();\n\t * \t// pan hard left\n\t * \tpanner.pan.setValueAtTime(-1, 0.25);\n\t * \tconst osc = new Tone.Oscillator(50, \"triangle\").connect(panner).start();\n\t * }, 0.5, 2);\n\t */\n\treadonly pan: Param<\"audioRange\">;\n\n\tconstructor(options?: Partial);\n\t/**\n\t * @param pan The initial panner value (Defaults to 0 = \"center\").\n\t */\n\tconstructor(pan?: AudioRange);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Panner.getDefaults(), arguments, [\n\t\t\t\"pan\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.pan = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.pan,\n\t\t\tvalue: options.pan,\n\t\t\tminValue: -1,\n\t\t\tmaxValue: 1,\n\t\t});\n\n\t\t// this is necessary for standardized-audio-context\n\t\t// doesn't make any difference for the native AudioContext\n\t\t// https://github.com/chrisguttandin/standardized-audio-context/issues/647\n\t\tthis._panner.channelCount = options.channelCount;\n\t\tthis._panner.channelCountMode = \"explicit\";\n\n\t\t// initial value\n\t\treadOnly(this, \"pan\");\n\t}\n\n\tstatic getDefaults(): TonePannerOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tpan: 0,\n\t\t\tchannelCount: 1,\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._panner.disconnect();\n\t\tthis.pan.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Panner3D.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Panner3D } from \"./Panner3D.js\";\n\ndescribe(\"Panner3D\", () => {\n\tBasicTests(Panner3D);\n\n\tit(\"passes the incoming signal through\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst panner = new Panner3D().toDestination();\n\t\t\tinput.connect(panner);\n\t\t});\n\t});\n\n\tit(\"can get/set the position individually\", () => {\n\t\tconst panner = new Panner3D();\n\t\tpanner.positionX.value = 10;\n\t\texpect(panner.positionX.value).to.equal(10);\n\t\tpanner.positionY.value = 20;\n\t\texpect(panner.positionY.value).to.equal(20);\n\t\tpanner.positionZ.value = -1;\n\t\texpect(panner.positionZ.value).to.equal(-1);\n\t\tpanner.dispose();\n\t});\n\n\tit(\"can get/set the orientation individually\", () => {\n\t\tconst panner = new Panner3D();\n\t\tpanner.orientationX.value = 2;\n\t\texpect(panner.orientationX.value).to.equal(2);\n\t\tpanner.orientationY.value = 4;\n\t\texpect(panner.orientationY.value).to.equal(4);\n\t\tpanner.orientationZ.value = -3;\n\t\texpect(panner.orientationZ.value).to.equal(-3);\n\t\tpanner.dispose();\n\t});\n\n\tit(\"can get/set the position through setPosition\", () => {\n\t\tconst panner = new Panner3D();\n\t\tpanner.setPosition(3, -11, 2);\n\t\texpect(panner.positionX.value).to.equal(3);\n\t\texpect(panner.positionY.value).to.equal(-11);\n\t\texpect(panner.positionZ.value).to.equal(2);\n\t\tpanner.dispose();\n\t});\n\n\tit(\"can get/set the orientation through setOrientation\", () => {\n\t\tconst panner = new Panner3D();\n\t\tpanner.setOrientation(2, -1, 0.5);\n\t\texpect(panner.orientationX.value).to.equal(2);\n\t\texpect(panner.orientationY.value).to.equal(-1);\n\t\texpect(panner.orientationZ.value).to.equal(0.5);\n\t\tpanner.dispose();\n\t});\n\n\tit(\"can get/set all of the other attributes\", () => {\n\t\tconst values = {\n\t\t\tconeInnerAngle: 120,\n\t\t\tconeOuterAngle: 280,\n\t\t\tconeOuterGain: 0.3,\n\t\t\tdistanceModel: \"exponential\",\n\t\t\tmaxDistance: 10002,\n\t\t\tpanningModel: \"HRTF\",\n\t\t\trefDistance: 0.3,\n\t\t\trolloffFactor: 3,\n\t\t};\n\t\tconst panner = new Panner3D();\n\t\tfor (const v in values) {\n\t\t\tif (v in values) {\n\t\t\t\tpanner[v] = values[v];\n\t\t\t\texpect(panner[v]).to.equal(values[v]);\n\t\t\t}\n\t\t}\n\t\tpanner.dispose();\n\t});\n});\n" }, { "path": "Tone/component/channel/Panner3D.ts", "content": "import \"../../core/context/Listener.js\";\n\nimport { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Degrees, GainFactor } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\nexport interface Panner3DOptions extends ToneAudioNodeOptions {\n\tconeInnerAngle: Degrees;\n\tconeOuterAngle: Degrees;\n\tconeOuterGain: GainFactor;\n\tdistanceModel: DistanceModelType;\n\tmaxDistance: number;\n\torientationX: number;\n\torientationY: number;\n\torientationZ: number;\n\tpanningModel: PanningModelType;\n\tpositionX: number;\n\tpositionY: number;\n\tpositionZ: number;\n\trefDistance: number;\n\trolloffFactor: number;\n}\n\n/**\n * A spatialized panner node which supports equalpower or HRTF panning.\n * @category Component\n */\nexport class Panner3D extends ToneAudioNode {\n\treadonly name: string = \"Panner3D\";\n\n\t/**\n\t * The panning object\n\t */\n\tprivate _panner: PannerNode;\n\treadonly input: PannerNode;\n\treadonly output: PannerNode;\n\n\treadonly positionX: Param<\"number\">;\n\treadonly positionY: Param<\"number\">;\n\treadonly positionZ: Param<\"number\">;\n\n\treadonly orientationX: Param<\"number\">;\n\treadonly orientationY: Param<\"number\">;\n\treadonly orientationZ: Param<\"number\">;\n\n\t/**\n\t * @param positionX The initial x position.\n\t * @param positionY The initial y position.\n\t * @param positionZ The initial z position.\n\t */\n\tconstructor(positionX: number, positionY: number, positionZ: number);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tPanner3D.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"positionX\", \"positionY\", \"positionZ\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._panner = this.input = this.output = this.context.createPanner();\n\t\t// set some values\n\t\tthis.panningModel = options.panningModel;\n\t\tthis.maxDistance = options.maxDistance;\n\t\tthis.distanceModel = options.distanceModel;\n\t\tthis.coneOuterGain = options.coneOuterGain;\n\t\tthis.coneOuterAngle = options.coneOuterAngle;\n\t\tthis.coneInnerAngle = options.coneInnerAngle;\n\t\tthis.refDistance = options.refDistance;\n\t\tthis.rolloffFactor = options.rolloffFactor;\n\n\t\tthis.positionX = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.positionX,\n\t\t\tvalue: options.positionX,\n\t\t});\n\t\tthis.positionY = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.positionY,\n\t\t\tvalue: options.positionY,\n\t\t});\n\t\tthis.positionZ = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.positionZ,\n\t\t\tvalue: options.positionZ,\n\t\t});\n\t\tthis.orientationX = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.orientationX,\n\t\t\tvalue: options.orientationX,\n\t\t});\n\t\tthis.orientationY = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.orientationY,\n\t\t\tvalue: options.orientationY,\n\t\t});\n\t\tthis.orientationZ = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._panner.orientationZ,\n\t\t\tvalue: options.orientationZ,\n\t\t});\n\t}\n\n\tstatic getDefaults(): Panner3DOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tconeInnerAngle: 360,\n\t\t\tconeOuterAngle: 360,\n\t\t\tconeOuterGain: 0,\n\t\t\tdistanceModel: \"inverse\" as DistanceModelType,\n\t\t\tmaxDistance: 10000,\n\t\t\torientationX: 0,\n\t\t\torientationY: 0,\n\t\t\torientationZ: 0,\n\t\t\tpanningModel: \"equalpower\" as PanningModelType,\n\t\t\tpositionX: 0,\n\t\t\tpositionY: 0,\n\t\t\tpositionZ: 0,\n\t\t\trefDistance: 1,\n\t\t\trolloffFactor: 1,\n\t\t});\n\t}\n\n\t/**\n\t * Sets the position of the source in 3d space.\n\t */\n\tsetPosition(x: number, y: number, z: number): this {\n\t\tthis.positionX.value = x;\n\t\tthis.positionY.value = y;\n\t\tthis.positionZ.value = z;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Sets the orientation of the source in 3d space.\n\t */\n\tsetOrientation(x: number, y: number, z: number): this {\n\t\tthis.orientationX.value = x;\n\t\tthis.orientationY.value = y;\n\t\tthis.orientationZ.value = z;\n\t\treturn this;\n\t}\n\n\t/**\n\t * The panning model. Either \"equalpower\" or \"HRTF\".\n\t */\n\tget panningModel(): PanningModelType {\n\t\treturn this._panner.panningModel;\n\t}\n\tset panningModel(val) {\n\t\tthis._panner.panningModel = val;\n\t}\n\n\t/**\n\t * A reference distance for reducing volume as source move further from the listener\n\t */\n\tget refDistance(): number {\n\t\treturn this._panner.refDistance;\n\t}\n\tset refDistance(val) {\n\t\tthis._panner.refDistance = val;\n\t}\n\n\t/**\n\t * Describes how quickly the volume is reduced as source moves away from listener.\n\t */\n\tget rolloffFactor(): number {\n\t\treturn this._panner.rolloffFactor;\n\t}\n\tset rolloffFactor(val) {\n\t\tthis._panner.rolloffFactor = val;\n\t}\n\n\t/**\n\t * The distance model used by, \"linear\", \"inverse\", or \"exponential\".\n\t */\n\tget distanceModel(): DistanceModelType {\n\t\treturn this._panner.distanceModel;\n\t}\n\tset distanceModel(val) {\n\t\tthis._panner.distanceModel = val;\n\t}\n\n\t/**\n\t * The angle, in degrees, inside of which there will be no volume reduction\n\t */\n\tget coneInnerAngle(): Degrees {\n\t\treturn this._panner.coneInnerAngle;\n\t}\n\tset coneInnerAngle(val) {\n\t\tthis._panner.coneInnerAngle = val;\n\t}\n\n\t/**\n\t * The angle, in degrees, outside of which the volume will be reduced\n\t * to a constant value of coneOuterGain\n\t */\n\tget coneOuterAngle(): Degrees {\n\t\treturn this._panner.coneOuterAngle;\n\t}\n\tset coneOuterAngle(val) {\n\t\tthis._panner.coneOuterAngle = val;\n\t}\n\n\t/**\n\t * The gain outside of the coneOuterAngle\n\t */\n\tget coneOuterGain(): GainFactor {\n\t\treturn this._panner.coneOuterGain;\n\t}\n\tset coneOuterGain(val) {\n\t\tthis._panner.coneOuterGain = val;\n\t}\n\n\t/**\n\t * The maximum distance between source and listener,\n\t * after which the volume will not be reduced any further.\n\t */\n\tget maxDistance(): number {\n\t\treturn this._panner.maxDistance;\n\t}\n\tset maxDistance(val) {\n\t\tthis._panner.maxDistance = val;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._panner.disconnect();\n\t\tthis.orientationX.dispose();\n\t\tthis.orientationY.dispose();\n\t\tthis.orientationZ.dispose();\n\t\tthis.positionX.dispose();\n\t\tthis.positionY.dispose();\n\t\tthis.positionZ.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Recorder.test.ts", "content": "import { expect } from \"chai\";\n\nimport { connectFrom } from \"../../../test/helper/Connect.js\";\nimport { Context } from \"../../core/context/Context.js\";\nimport { ToneWithContext } from \"../../core/context/ToneWithContext.js\";\nimport { Synth } from \"../../instrument/Synth.js\";\nimport { Recorder } from \"./Recorder.js\";\n\ndescribe(\"Recorder\", () => {\n\tcontext(\"basic\", () => {\n\t\tit(\"can be created and disposed\", () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"handles input connections\", () => {\n\t\t\tconst rec = new Recorder();\n\t\t\tconnectFrom().connect(rec);\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"reports if it is supported or not\", () => {\n\t\t\texpect(Recorder.supported).to.be.a(\"boolean\");\n\t\t});\n\n\t\tit(\"can get the mime type\", () => {\n\t\t\tconst rec = new Recorder();\n\t\t\texpect(rec.mimeType).to.be.a(\"string\");\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"can set a different context\", () => {\n\t\t\tconst testContext = new Context();\n\t\t\tconst rec = new Recorder({\n\t\t\t\tcontext: testContext,\n\t\t\t});\n\t\t\tfor (const member in rec) {\n\t\t\t\tif (rec[member] instanceof ToneWithContext) {\n\t\t\t\t\texpect(rec[member].context, `member: ${member}`).to.equal(\n\t\t\t\t\t\ttestContext\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\ttestContext.dispose();\n\t\t\trec.dispose();\n\t\t\treturn testContext.close();\n\t\t});\n\t});\n\n\tfunction wait(time) {\n\t\treturn new Promise((done) => setTimeout(done, time));\n\t}\n\n\tcontext(\"start/stop/pause\", () => {\n\t\tit(\"can be started\", () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.start();\n\t\t\texpect(rec.state).to.equal(\"started\");\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"can be paused after starting\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.start();\n\t\t\texpect(rec.state).to.equal(\"started\");\n\t\t\tawait wait(100);\n\t\t\trec.pause();\n\t\t\texpect(rec.state).to.equal(\"paused\");\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"can be resumed after pausing\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.start();\n\t\t\texpect(rec.state).to.equal(\"started\");\n\t\t\tawait wait(100);\n\t\t\trec.pause();\n\t\t\texpect(rec.state).to.equal(\"paused\");\n\t\t\tawait wait(100);\n\t\t\trec.start();\n\t\t\texpect(rec.state).to.equal(\"started\");\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"can be stopped after starting\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.start();\n\t\t\texpect(rec.state).to.equal(\"started\");\n\t\t\tawait wait(100);\n\t\t\trec.stop();\n\t\t\texpect(rec.state).to.equal(\"stopped\");\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"throws an error if stopped or paused before starting\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\tlet didThrow = false;\n\t\t\ttry {\n\t\t\t\tawait rec.stop();\n\t\t\t} catch (e) {\n\t\t\t\tdidThrow = true;\n\t\t\t}\n\t\t\texpect(didThrow).to.be.true;\n\t\t\texpect(() => {\n\t\t\t\trec.pause();\n\t\t\t}).to.throw(Error);\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"stop returns a blob\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\trec.start();\n\t\t\tawait wait(100);\n\t\t\tconst recording = await rec.stop();\n\t\t\texpect(recording).to.be.instanceOf(Blob);\n\t\t\trec.dispose();\n\t\t});\n\n\t\tit(\"can record some sound\", async () => {\n\t\t\tconst rec = new Recorder();\n\t\t\tconst synth = new Synth().connect(rec);\n\t\t\trec.start();\n\t\t\tsynth.triggerAttack(\"C3\");\n\t\t\tawait wait(200);\n\t\t\tconst recording = await rec.stop();\n\t\t\texpect(recording.size).to.be.greaterThan(0);\n\t\t\trec.dispose();\n\t\t\tsynth.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Recorder.ts", "content": "import { theWindow } from \"../../core/context/AudioContext.js\";\nimport { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { assert } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { PlaybackState } from \"../../core/util/StateTimeline.js\";\n\nexport interface RecorderOptions extends ToneAudioNodeOptions {\n\tmimeType?: string;\n}\n\n/**\n * A wrapper around the MediaRecorder API. Unlike the rest of Tone.js, this module does not offer\n * any sample-accurate scheduling because it is not a feature of the MediaRecorder API.\n * This is only natively supported in Chrome and Firefox.\n * For a cross-browser shim, install [audio-recorder-polyfill](https://www.npmjs.com/package/audio-recorder-polyfill).\n * @example\n * const recorder = new Tone.Recorder();\n * const synth = new Tone.Synth().connect(recorder);\n * // start recording\n * recorder.start();\n * // generate a few notes\n * synth.triggerAttackRelease(\"C3\", 0.5);\n * synth.triggerAttackRelease(\"C4\", 0.5, \"+1\");\n * synth.triggerAttackRelease(\"C5\", 0.5, \"+2\");\n * // wait for the notes to end and stop the recording\n * setTimeout(async () => {\n * \t// the recorded audio is returned as a blob\n * \tconst recording = await recorder.stop();\n * \t// download the recording by creating an anchor element and blob url\n * \tconst url = URL.createObjectURL(recording);\n * \tconst anchor = document.createElement(\"a\");\n * \tanchor.download = \"recording.webm\";\n * \tanchor.href = url;\n * \tanchor.click();\n * }, 4000);\n * @category Component\n */\nexport class Recorder extends ToneAudioNode {\n\treadonly name = \"Recorder\";\n\n\t/**\n\t * Recorder uses the Media Recorder API\n\t */\n\tprivate _recorder: MediaRecorder;\n\n\t/**\n\t * MediaRecorder requires\n\t */\n\tprivate _stream: MediaStreamAudioDestinationNode;\n\n\treadonly input: Gain;\n\treadonly output: undefined;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Recorder.getDefaults(), arguments);\n\t\tsuper(options);\n\n\t\tthis.input = new Gain({\n\t\t\tcontext: this.context,\n\t\t});\n\n\t\tassert(Recorder.supported, \"Media Recorder API is not available\");\n\n\t\tthis._stream = this.context.createMediaStreamDestination();\n\t\tthis.input.connect(this._stream);\n\t\tthis._recorder = new MediaRecorder(this._stream.stream, {\n\t\t\tmimeType: options.mimeType,\n\t\t});\n\t}\n\n\tstatic getDefaults(): RecorderOptions {\n\t\treturn ToneAudioNode.getDefaults();\n\t}\n\n\t/**\n\t * The mime type is the format that the audio is encoded in. For Chrome\n\t * that is typically webm encoded as \"vorbis\".\n\t */\n\tget mimeType(): string {\n\t\treturn this._recorder.mimeType;\n\t}\n\n\t/**\n\t * Test if your platform supports the Media Recorder API. If it's not available,\n\t * try installing this (polyfill)[https://www.npmjs.com/package/audio-recorder-polyfill].\n\t */\n\tstatic get supported(): boolean {\n\t\treturn theWindow !== null && Reflect.has(theWindow, \"MediaRecorder\");\n\t}\n\n\t/**\n\t * Get the playback state of the Recorder, either \"started\", \"stopped\" or \"paused\"\n\t */\n\tget state(): PlaybackState {\n\t\tif (this._recorder.state === \"inactive\") {\n\t\t\treturn \"stopped\";\n\t\t} else if (this._recorder.state === \"paused\") {\n\t\t\treturn \"paused\";\n\t\t} else {\n\t\t\treturn \"started\";\n\t\t}\n\t}\n\n\t/**\n\t * Start/Resume the Recorder. Returns a promise which resolves\n\t * when the recorder has started.\n\t */\n\tasync start() {\n\t\tassert(this.state !== \"started\", \"Recorder is already started\");\n\t\tconst startPromise = new Promise((done) => {\n\t\t\tconst handleStart = () => {\n\t\t\t\tthis._recorder.removeEventListener(\"start\", handleStart, false);\n\n\t\t\t\tdone();\n\t\t\t};\n\n\t\t\tthis._recorder.addEventListener(\"start\", handleStart, false);\n\t\t});\n\t\tif (this.state === \"stopped\") {\n\t\t\tthis._recorder.start();\n\t\t} else {\n\t\t\tthis._recorder.resume();\n\t\t}\n\t\treturn await startPromise;\n\t}\n\n\t/**\n\t * Stop the recorder. Returns a promise with the recorded content until this point\n\t * encoded as {@link mimeType}\n\t */\n\tasync stop(): Promise {\n\t\tassert(this.state !== \"stopped\", \"Recorder is not started\");\n\t\tconst dataPromise: Promise = new Promise((done) => {\n\t\t\tconst handleData = (e: BlobEvent) => {\n\t\t\t\tthis._recorder.removeEventListener(\n\t\t\t\t\t\"dataavailable\",\n\t\t\t\t\thandleData,\n\t\t\t\t\tfalse\n\t\t\t\t);\n\n\t\t\t\tdone(e.data);\n\t\t\t};\n\n\t\t\tthis._recorder.addEventListener(\"dataavailable\", handleData, false);\n\t\t});\n\t\tthis._recorder.stop();\n\t\treturn await dataPromise;\n\t}\n\n\t/**\n\t * Pause the recorder\n\t */\n\tpause(): this {\n\t\tassert(this.state === \"started\", \"Recorder must be started\");\n\t\tthis._recorder.pause();\n\t\treturn this;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis._stream.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Solo.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { ConstantOutput } from \"../../../test/helper/ConstantOutput.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Solo } from \"./Solo.js\";\n\ndescribe(\"Solo\", () => {\n\tBasicTests(Solo);\n\n\tcontext(\"Soloing\", () => {\n\t\tit(\"can be soloed an unsoloed\", () => {\n\t\t\tconst sol = new Solo();\n\t\t\tsol.solo = true;\n\t\t\texpect(sol.solo).to.be.true;\n\t\t\tsol.solo = false;\n\t\t\texpect(sol.solo).to.be.false;\n\t\t\tsol.dispose();\n\t\t});\n\n\t\tit(\"can be passed into the constructor\", () => {\n\t\t\tconst sol = new Solo(true);\n\t\t\texpect(sol.solo).to.be.true;\n\t\t\tsol.dispose();\n\t\t});\n\n\t\tit(\"can be passed into the constructor with an object\", () => {\n\t\t\tconst sol = new Solo({ solo: true });\n\t\t\texpect(sol.solo).to.be.true;\n\t\t\tsol.dispose();\n\t\t});\n\n\t\tit(\"other instances are unsoloed when one is soloed\", () => {\n\t\t\tconst solA = new Solo();\n\t\t\tconst solB = new Solo();\n\t\t\tsolA.solo = true;\n\t\t\tsolB.solo = false;\n\t\t\texpect(solA.solo).to.be.true;\n\t\t\texpect(solB.solo).to.be.false;\n\t\t\tsolB.solo = true;\n\t\t\texpect(solA.solo).to.be.true;\n\t\t\texpect(solB.solo).to.be.true;\n\t\t\tsolA.solo = false;\n\t\t\texpect(solA.solo).to.be.false;\n\t\t\texpect(solB.solo).to.be.true;\n\t\t\tsolA.dispose();\n\t\t\tsolB.dispose();\n\t\t});\n\n\t\tit(\"other instances report themselves as muted\", () => {\n\t\t\tconst solA = new Solo();\n\t\t\tconst solB = new Solo();\n\t\t\tsolA.solo = true;\n\t\t\tsolB.solo = false;\n\t\t\texpect(solA.muted).to.be.false;\n\t\t\texpect(solB.muted).to.be.true;\n\t\t\tsolA.dispose();\n\t\t\tsolB.dispose();\n\t\t});\n\n\t\tit(\"all instances are unmuted when there is no solo\", () => {\n\t\t\tconst solA = new Solo();\n\t\t\tconst solB = new Solo();\n\t\t\tsolA.solo = true;\n\t\t\tsolB.solo = false;\n\t\t\tsolA.solo = false;\n\t\t\texpect(solA.muted).to.be.false;\n\t\t\texpect(solB.muted).to.be.false;\n\t\t\tsolA.dispose();\n\t\t\tsolB.dispose();\n\t\t});\n\n\t\tit(\"a newly created instance will be muted if there is already a soloed instance\", () => {\n\t\t\tconst solA = new Solo(true);\n\t\t\tconst solB = new Solo();\n\t\t\texpect(solA.muted).to.be.false;\n\t\t\texpect(solB.muted).to.be.true;\n\t\t\tsolA.dispose();\n\t\t\tsolB.dispose();\n\t\t});\n\n\t\tit(\"passes both signals when nothing is soloed\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst soloA = new Solo().toDestination();\n\t\t\t\t\tconst soloB = new Solo().toDestination();\n\t\t\t\t\tnew Signal(10).connect(soloA);\n\t\t\t\t\tnew Signal(20).connect(soloB);\n\t\t\t\t},\n\t\t\t\t30,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"passes one signal when it is soloed\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst soloA = new Solo().toDestination();\n\t\t\t\t\tconst soloB = new Solo().toDestination();\n\t\t\t\t\tnew Signal(10).connect(soloA);\n\t\t\t\t\tnew Signal(20).connect(soloB);\n\t\t\t\t\tsoloA.solo = true;\n\t\t\t\t},\n\t\t\t\t10,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can solo multiple at once\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst soloA = new Solo().toDestination();\n\t\t\t\t\tconst soloB = new Solo().toDestination();\n\t\t\t\t\tnew Signal(10).connect(soloA);\n\t\t\t\t\tnew Signal(20).connect(soloB);\n\t\t\t\t\tsoloA.solo = true;\n\t\t\t\t\tsoloB.solo = true;\n\t\t\t\t},\n\t\t\t\t30,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can unsolo all\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst soloA = new Solo().toDestination();\n\t\t\t\t\tconst soloB = new Solo().toDestination();\n\t\t\t\t\tnew Signal(10).connect(soloA);\n\t\t\t\t\tnew Signal(20).connect(soloB);\n\t\t\t\t\tsoloA.solo = true;\n\t\t\t\t\tsoloB.solo = true;\n\t\t\t\t\tsoloA.solo = false;\n\t\t\t\t\tsoloB.solo = false;\n\t\t\t\t},\n\t\t\t\t30,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can solo and unsolo while keeping previous soloed\", () => {\n\t\t\treturn ConstantOutput(\n\t\t\t\t() => {\n\t\t\t\t\tconst soloA = new Solo().toDestination();\n\t\t\t\t\tconst soloB = new Solo().toDestination();\n\t\t\t\t\tnew Signal(10).connect(soloA);\n\t\t\t\t\tnew Signal(20).connect(soloB);\n\t\t\t\t\tsoloA.solo = true;\n\t\t\t\t\tsoloB.solo = true;\n\t\t\t\t\tsoloB.solo = false;\n\t\t\t\t},\n\t\t\t\t10,\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Solo.ts", "content": "import { BaseContext } from \"../../core/context/BaseContext.js\";\nimport { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\nexport interface SoloOptions extends ToneAudioNodeOptions {\n\tsolo: boolean;\n}\n\n/**\n * Solo lets you isolate a specific audio stream. When an instance is set to `solo=true`,\n * it will mute all other instances of Solo.\n * @example\n * const soloA = new Tone.Solo().toDestination();\n * const oscA = new Tone.Oscillator(\"C4\", \"sawtooth\").connect(soloA);\n * const soloB = new Tone.Solo().toDestination();\n * const oscB = new Tone.Oscillator(\"E4\", \"square\").connect(soloB);\n * soloA.solo = true;\n * // no audio will pass through soloB\n * @category Component\n */\nexport class Solo extends ToneAudioNode {\n\treadonly name: string = \"Solo\";\n\n\treadonly input: Gain;\n\treadonly output: Gain;\n\n\t/**\n\t * @param solo If the connection should be initially solo'ed.\n\t */\n\tconstructor(solo?: boolean);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Solo.getDefaults(), arguments, [\n\t\t\t\"solo\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.input = this.output = new Gain({\n\t\t\tcontext: this.context,\n\t\t});\n\n\t\tif (!Solo._allSolos.has(this.context)) {\n\t\t\tSolo._allSolos.set(this.context, new Set());\n\t\t}\n\t\t(Solo._allSolos.get(this.context) as Set).add(this);\n\n\t\t// set initially\n\t\tthis.solo = options.solo;\n\t}\n\n\tstatic getDefaults(): SoloOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tsolo: false,\n\t\t});\n\t}\n\n\t/**\n\t * Hold all of the solo'ed tracks belonging to a specific context\n\t */\n\tprivate static _allSolos: Map> = new Map();\n\n\t/**\n\t * Hold the currently solo'ed instance(s)\n\t */\n\tprivate static _soloed: Map> = new Map();\n\n\t/**\n\t * Isolates this instance and mutes all other instances of Solo.\n\t * Only one instance can be soloed at a time. A soloed\n\t * instance will report `solo=false` when another instance is soloed.\n\t */\n\tget solo(): boolean {\n\t\treturn this._isSoloed();\n\t}\n\tset solo(solo) {\n\t\tif (solo) {\n\t\t\tthis._addSolo();\n\t\t} else {\n\t\t\tthis._removeSolo();\n\t\t}\n\t\t(Solo._allSolos.get(this.context) as Set).forEach((instance) =>\n\t\t\tinstance._updateSolo()\n\t\t);\n\t}\n\n\t/**\n\t * If the current instance is muted, i.e. another instance is soloed\n\t */\n\tget muted(): boolean {\n\t\treturn this.input.gain.value === 0;\n\t}\n\n\t/**\n\t * Add this to the soloed array\n\t */\n\tprivate _addSolo(): void {\n\t\tif (!Solo._soloed.has(this.context)) {\n\t\t\tSolo._soloed.set(this.context, new Set());\n\t\t}\n\t\t(Solo._soloed.get(this.context) as Set).add(this);\n\t}\n\n\t/**\n\t * Remove this from the soloed array\n\t */\n\tprivate _removeSolo(): void {\n\t\tif (Solo._soloed.has(this.context)) {\n\t\t\t(Solo._soloed.get(this.context) as Set).delete(this);\n\t\t}\n\t}\n\n\t/**\n\t * Is this on the soloed array\n\t */\n\tprivate _isSoloed(): boolean {\n\t\treturn (\n\t\t\tSolo._soloed.has(this.context) &&\n\t\t\t(Solo._soloed.get(this.context) as Set).has(this)\n\t\t);\n\t}\n\n\t/**\n\t * Returns true if no one is soloed\n\t */\n\tprivate _noSolos(): boolean {\n\t\t// either does not have any soloed added\n\t\treturn (\n\t\t\t!Solo._soloed.has(this.context) ||\n\t\t\t// or has a solo set but doesn't include any items\n\t\t\t(Solo._soloed.has(this.context) &&\n\t\t\t\t(Solo._soloed.get(this.context) as Set).size === 0)\n\t\t);\n\t}\n\n\t/**\n\t * Solo the current instance and unsolo all other instances.\n\t */\n\tprivate _updateSolo(): void {\n\t\tif (this._isSoloed()) {\n\t\t\tthis.input.gain.value = 1;\n\t\t} else if (this._noSolos()) {\n\t\t\t// no one is soloed\n\t\t\tthis.input.gain.value = 1;\n\t\t} else {\n\t\t\tthis.input.gain.value = 0;\n\t\t}\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\t(Solo._allSolos.get(this.context) as Set).delete(this);\n\t\tthis._removeSolo();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Split.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectTo } from \"../../../test/helper/Connect.js\";\nimport { ConstantOutput } from \"../../../test/helper/ConstantOutput.js\";\nimport { StereoSignal } from \"../../../test/helper/StereoSignal.js\";\nimport { Split } from \"./Split.js\";\n\ndescribe(\"Split\", () => {\n\tBasicTests(Split);\n\n\tcontext(\"Splitting\", () => {\n\t\tit(\"defaults to two channels\", () => {\n\t\t\tconst split = new Split();\n\t\t\texpect(split.numberOfOutputs).to.equal(2);\n\t\t\tsplit.dispose();\n\t\t});\n\n\t\tit(\"can pass in more channels\", () => {\n\t\t\tconst split = new Split(4);\n\t\t\texpect(split.numberOfOutputs).to.equal(4);\n\t\t\tsplit.connect(connectTo(), 0, 0);\n\t\t\tsplit.connect(connectTo(), 1, 0);\n\t\t\tsplit.connect(connectTo(), 2, 0);\n\t\t\tsplit.connect(connectTo(), 3, 0);\n\t\t\tsplit.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through on the left side\", () => {\n\t\t\treturn ConstantOutput(({ destination }) => {\n\t\t\t\tconst split = new Split();\n\t\t\t\tconst signal = StereoSignal(1, 2).connect(split);\n\t\t\t\tsplit.connect(destination, 0, 0);\n\t\t\t}, 1);\n\t\t});\n\n\t\tit(\"passes the incoming signal through on the right side\", () => {\n\t\t\treturn ConstantOutput(({ destination }) => {\n\t\t\t\tconst split = new Split();\n\t\t\t\tconst signal = StereoSignal(1, 2).connect(split);\n\t\t\t\tsplit.connect(destination, 1, 0);\n\t\t\t}, 2);\n\t\t});\n\n\t\t// it(\"merges two signal into one stereo signal and then split them back into two signals on left side\", () => {\n\t\t// \treturn ConstantOutput(({destination}) => {\n\t\t// \t\tconst split = new Split();\n\t\t// \t\tconst signal = StereoSignal(1, 2).connect(split);\n\t\t// \t\tsplit.connect(destination, 0, 0);\n\t\t// \t}, 1);\n\t\t// });\n\n\t\t// it(\"merges two signal into one stereo signal and then split them back into two signals on right side\", () => {\n\t\t// \treturn ConstantOutput(({destination}) => {\n\t\t// \t\tconst split = new Split();\n\t\t// \t\tconst signal = StereoSignal(1, 2).connect(split);\n\t\t// \t\tsplit.connect(destination, 1, 0);\n\t\t// \t}, 2);\n\t\t// });\n\t});\n});\n" }, { "path": "Tone/component/channel/Split.ts", "content": "import {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\ninterface SplitOptions extends ToneAudioNodeOptions {\n\tchannels: number;\n}\n\n/**\n * Split splits an incoming signal into the number of given channels.\n *\n * @example\n * const split = new Tone.Split();\n * // stereoSignal.connect(split);\n * @category Component\n */\nexport class Split extends ToneAudioNode {\n\treadonly name: string = \"Split\";\n\n\t/**\n\t * The splitting node\n\t */\n\tprivate _splitter: ChannelSplitterNode;\n\n\treadonly input: ChannelSplitterNode;\n\treadonly output: ChannelSplitterNode;\n\n\t/**\n\t * @param channels The number of channels to merge.\n\t */\n\tconstructor(channels?: number);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Split.getDefaults(), arguments, [\n\t\t\t\"channels\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._splitter =\n\t\t\tthis.input =\n\t\t\tthis.output =\n\t\t\t\tthis.context.createChannelSplitter(options.channels);\n\t\tthis._internalChannels = [this._splitter];\n\t}\n\n\tstatic getDefaults(): SplitOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tchannels: 2,\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._splitter.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/channel/Volume.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Volume } from \"./Volume.js\";\n\ndescribe(\"Volume\", () => {\n\tBasicTests(Volume);\n\n\tcontext(\"Volume\", () => {\n\t\tit(\"handles input and output connections\", () => {\n\t\t\tconst vol = new Volume();\n\t\t\tvol.connect(connectTo());\n\t\t\tconnectFrom().connect(vol);\n\t\t\tconnectFrom().connect(vol.volume);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with volume value\", () => {\n\t\t\tconst vol = new Volume(-12);\n\t\t\texpect(vol.volume.value).to.be.closeTo(-12, 0.1);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst vol = new Volume({\n\t\t\t\tvolume: 2,\n\t\t\t});\n\t\t\texpect(vol.volume.value).to.be.closeTo(2, 0.1);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object and muted\", () => {\n\t\t\tconst vol = new Volume({\n\t\t\t\tmute: true,\n\t\t\t});\n\t\t\texpect(vol.mute).to.equal(true);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"can set/get with an object\", () => {\n\t\t\tconst vol = new Volume();\n\t\t\tvol.set({\n\t\t\t\tvolume: -10,\n\t\t\t});\n\t\t\texpect(vol.get().volume).to.be.closeTo(-10, 0.1);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"unmuting returns to previous volume\", () => {\n\t\t\tconst vol = new Volume(-10);\n\t\t\tvol.mute = true;\n\t\t\texpect(vol.mute).to.equal(true);\n\t\t\texpect(vol.volume.value).to.equal(-Infinity);\n\t\t\tvol.mute = false;\n\t\t\t// returns the volume to what it was\n\t\t\texpect(vol.volume.value).to.be.closeTo(-10, 0.1);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst vol = new Volume().toDestination();\n\t\t\t\tinput.connect(vol);\n\t\t\t});\n\t\t});\n\n\t\tit.skip(\"passes the incoming stereo signal through\", () => {\n\t\t\t// return PassAudioStereo(function(input) {\n\t\t\t// \tconst vol = new Volume().toDestination();\n\t\t\t// \tinput.connect(vol);\n\t\t\t// });\n\t\t});\n\n\t\tit(\"can lower the volume\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst vol = new Volume(-10).toDestination();\n\t\t\t\tnew Signal(1).connect(vol);\n\t\t\t});\n\t\t\texpect(buffer.value()).to.be.closeTo(0.315, 0.01);\n\t\t});\n\n\t\tit(\"can mute the volume\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst vol = new Volume(0).toDestination();\n\t\t\t\tnew Signal(1).connect(vol);\n\t\t\t\tvol.mute = true;\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.equal(true);\n\t\t});\n\n\t\tit(\"muted when volume is set to -Infinity\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst vol = new Volume(-Infinity).toDestination();\n\t\t\t\tnew Signal(1).connect(vol);\n\t\t\t\texpect(vol.mute).to.equal(true);\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.equal(true);\n\t\t});\n\n\t\tit(\"setting the volume unmutes it and reports itself as unmuted\", () => {\n\t\t\tconst vol = new Volume(0).toDestination();\n\t\t\tvol.mute = true;\n\t\t\texpect(vol.mute).to.equal(true);\n\t\t\tvol.volume.value = 0;\n\t\t\texpect(vol.mute).is.equal(false);\n\t\t\tvol.dispose();\n\t\t});\n\n\t\tit(\"multiple calls to mute still return the vol to the original\", () => {\n\t\t\tconst vol = new Volume(-20);\n\t\t\tvol.mute = true;\n\t\t\tvol.mute = true;\n\t\t\texpect(vol.mute).to.equal(true);\n\t\t\texpect(vol.volume.value).to.equal(-Infinity);\n\t\t\tvol.mute = false;\n\t\t\tvol.mute = false;\n\t\t\texpect(vol.volume.value).to.be.closeTo(-20, 0.5);\n\t\t\tvol.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/channel/Volume.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Decibels } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\n\ninterface VolumeOptions extends ToneAudioNodeOptions {\n\tvolume: Decibels;\n\tmute: boolean;\n}\n\n/**\n * Volume is a simple volume node, useful for creating a volume fader.\n *\n * @example\n * const vol = new Tone.Volume(-12).toDestination();\n * const osc = new Tone.Oscillator().connect(vol).start();\n * @category Component\n */\nexport class Volume extends ToneAudioNode {\n\treadonly name: string = \"Volume\";\n\n\t/**\n\t * the output node\n\t */\n\toutput: Gain<\"decibels\">;\n\n\t/**\n\t * Input and output are the same\n\t */\n\tinput: Gain<\"decibels\">;\n\n\t/**\n\t * The unmuted volume\n\t */\n\tprivate _unmutedVolume: Decibels;\n\n\t/**\n\t * The volume control in decibels.\n\t * @example\n\t * const vol = new Tone.Volume().toDestination();\n\t * const osc = new Tone.Oscillator().connect(vol).start();\n\t * vol.volume.value = -20;\n\t */\n\tvolume: Param<\"decibels\">;\n\n\t/**\n\t * @param volume the initial volume in decibels\n\t */\n\tconstructor(volume?: Decibels);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Volume.getDefaults(), arguments, [\n\t\t\t\"volume\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.input = this.output = new Gain({\n\t\t\tcontext: this.context,\n\t\t\tgain: options.volume,\n\t\t\tunits: \"decibels\",\n\t\t});\n\t\tthis.volume = this.output.gain;\n\t\treadOnly(this, \"volume\");\n\t\tthis._unmutedVolume = options.volume;\n\n\t\t// set the mute initially\n\t\tthis.mute = options.mute;\n\t}\n\n\tstatic getDefaults(): VolumeOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tmute: false,\n\t\t\tvolume: 0,\n\t\t});\n\t}\n\n\t/**\n\t * Mute the output.\n\t * @example\n\t * const vol = new Tone.Volume(-12).toDestination();\n\t * const osc = new Tone.Oscillator().connect(vol).start();\n\t * // mute the output\n\t * vol.mute = true;\n\t */\n\tget mute(): boolean {\n\t\treturn this.volume.value === -Infinity;\n\t}\n\tset mute(mute: boolean) {\n\t\tif (!this.mute && mute) {\n\t\t\tthis._unmutedVolume = this.volume.value;\n\t\t\t// maybe it should ramp here?\n\t\t\tthis.volume.value = -Infinity;\n\t\t} else if (this.mute && !mute) {\n\t\t\tthis.volume.value = this._unmutedVolume;\n\t\t}\n\t}\n\n\t/**\n\t * clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis.volume.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/dynamics/Compressor.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Compressor } from \"./Compressor.js\";\n\ndescribe(\"Compressor\", () => {\n\tBasicTests(Compressor);\n\n\tcontext(\"Compression\", () => {\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst comp = new Compressor().toDestination();\n\t\t\t\tinput.connect(comp);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst comp = new Compressor();\n\t\t\tconst values = {\n\t\t\t\tattack: 0.03,\n\t\t\t\tknee: 20,\n\t\t\t\tratio: 12,\n\t\t\t\trelease: 0.5,\n\t\t\t\tthreshold: -30,\n\t\t\t};\n\t\t\tcomp.set(values);\n\t\t\texpect(comp.get()).to.have.keys([\n\t\t\t\t\"ratio\",\n\t\t\t\t\"threshold\",\n\t\t\t\t\"release\",\n\t\t\t\t\"attack\",\n\t\t\t\t\"ratio\",\n\t\t\t]);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"can be get and constructed with an object\", () => {\n\t\t\tconst comp = new Compressor({\n\t\t\t\tattack: 0.03,\n\t\t\t\tknee: 20,\n\t\t\t\tratio: 12,\n\t\t\t\trelease: 0.5,\n\t\t\t\tthreshold: -30,\n\t\t\t});\n\t\t\texpect(comp.threshold.value).to.have.be.closeTo(-30, 1);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with args\", () => {\n\t\t\tconst comp = new Compressor(-10, 4);\n\t\t\texpect(comp.threshold.value).to.have.be.closeTo(-10, 0.1);\n\t\t\texpect(comp.ratio.value).to.have.be.closeTo(4, 0.1);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"params have correct min and max values\", () => {\n\t\t\tconst comp = new Compressor(-10, 4);\n\t\t\texpect(comp.threshold.minValue).to.equal(-100);\n\t\t\texpect(comp.threshold.maxValue).to.equal(0);\n\t\t\texpect(comp.attack.minValue).to.equal(0);\n\t\t\texpect(comp.attack.maxValue).to.equal(1);\n\t\t\texpect(comp.release.minValue).to.equal(0);\n\t\t\texpect(comp.release.maxValue).to.equal(1);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"can get/set all interfaces\", () => {\n\t\t\tconst comp = new Compressor();\n\t\t\tconst values = {\n\t\t\t\tattack: 0.03,\n\t\t\t\tknee: 18,\n\t\t\t\tratio: 12,\n\t\t\t\trelease: 0.5,\n\t\t\t\tthreshold: -30,\n\t\t\t};\n\t\t\tcomp.ratio.value = values.ratio;\n\t\t\tcomp.threshold.value = values.threshold;\n\t\t\tcomp.release.value = values.release;\n\t\t\tcomp.attack.value = values.attack;\n\t\t\tcomp.knee.value = values.knee;\n\t\t\texpect(comp.ratio.value).to.equal(values.ratio);\n\t\t\texpect(comp.threshold.value).to.equal(values.threshold);\n\t\t\texpect(comp.release.value).to.equal(values.release);\n\t\t\texpect(comp.attack.value).to.be.closeTo(values.attack, 0.01);\n\t\t\texpect(comp.knee.value).to.equal(values.knee);\n\t\t\tcomp.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/dynamics/Compressor.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Decibels, Positive, Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\n\nexport interface CompressorOptions extends ToneAudioNodeOptions {\n\tattack: Time;\n\tknee: Decibels;\n\tratio: Positive;\n\trelease: Time;\n\tthreshold: Decibels;\n}\n\n/**\n * Compressor is a thin wrapper around the Web Audio\n * [DynamicsCompressorNode](http://webaudio.github.io/web-audio-api/#the-dynamicscompressornode-interface).\n * Compression reduces the volume of loud sounds or amplifies quiet sounds\n * by narrowing or \"compressing\" an audio signal's dynamic range.\n * Read more on [Wikipedia](https://en.wikipedia.org/wiki/Dynamic_range_compression).\n * @example\n * const comp = new Tone.Compressor(-30, 3);\n * @category Component\n */\nexport class Compressor extends ToneAudioNode {\n\treadonly name: string = \"Compressor\";\n\n\t/**\n\t * the compressor node\n\t */\n\tprivate _compressor: DynamicsCompressorNode =\n\t\tthis.context.createDynamicsCompressor();\n\treadonly input = this._compressor;\n\treadonly output = this._compressor;\n\n\t/**\n\t * The decibel value above which the compression will start taking effect.\n\t * @min -100\n\t * @max 0\n\t */\n\treadonly threshold: Param<\"decibels\">;\n\n\t/**\n\t * The amount of time (in seconds) to reduce the gain by 10dB.\n\t * @min 0\n\t * @max 1\n\t */\n\treadonly attack: Param<\"time\">;\n\n\t/**\n\t * The amount of time (in seconds) to increase the gain by 10dB.\n\t * @min 0\n\t * @max 1\n\t */\n\treadonly release: Param<\"time\">;\n\n\t/**\n\t * A decibel value representing the range above the threshold where the\n\t * curve smoothly transitions to the \"ratio\" portion.\n\t * @min 0\n\t * @max 40\n\t */\n\treadonly knee: Param<\"decibels\">;\n\n\t/**\n\t * The amount of dB change in input for a 1 dB change in output.\n\t * @min 1\n\t * @max 20\n\t */\n\treadonly ratio: Param<\"positive\">;\n\n\t/**\n\t * @param threshold The value above which the compression starts to be applied.\n\t * @param ratio The gain reduction ratio.\n\t */\n\tconstructor(threshold?: Decibels, ratio?: Positive);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tCompressor.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"threshold\", \"ratio\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.threshold = new Param({\n\t\t\tminValue: this._compressor.threshold.minValue,\n\t\t\tmaxValue: this._compressor.threshold.maxValue,\n\t\t\tcontext: this.context,\n\t\t\tconvert: false,\n\t\t\tparam: this._compressor.threshold,\n\t\t\tunits: \"decibels\",\n\t\t\tvalue: options.threshold,\n\t\t});\n\n\t\tthis.attack = new Param({\n\t\t\tminValue: this._compressor.attack.minValue,\n\t\t\tmaxValue: this._compressor.attack.maxValue,\n\t\t\tcontext: this.context,\n\t\t\tparam: this._compressor.attack,\n\t\t\tunits: \"time\",\n\t\t\tvalue: options.attack,\n\t\t});\n\n\t\tthis.release = new Param({\n\t\t\tminValue: this._compressor.release.minValue,\n\t\t\tmaxValue: this._compressor.release.maxValue,\n\t\t\tcontext: this.context,\n\t\t\tparam: this._compressor.release,\n\t\t\tunits: \"time\",\n\t\t\tvalue: options.release,\n\t\t});\n\n\t\tthis.knee = new Param({\n\t\t\tminValue: this._compressor.knee.minValue,\n\t\t\tmaxValue: this._compressor.knee.maxValue,\n\t\t\tcontext: this.context,\n\t\t\tconvert: false,\n\t\t\tparam: this._compressor.knee,\n\t\t\tunits: \"decibels\",\n\t\t\tvalue: options.knee,\n\t\t});\n\n\t\tthis.ratio = new Param({\n\t\t\tminValue: this._compressor.ratio.minValue,\n\t\t\tmaxValue: this._compressor.ratio.maxValue,\n\t\t\tcontext: this.context,\n\t\t\tconvert: false,\n\t\t\tparam: this._compressor.ratio,\n\t\t\tunits: \"positive\",\n\t\t\tvalue: options.ratio,\n\t\t});\n\n\t\t// set the defaults\n\t\treadOnly(this, [\"knee\", \"release\", \"attack\", \"ratio\", \"threshold\"]);\n\t}\n\n\tstatic getDefaults(): CompressorOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tattack: 0.003,\n\t\t\tknee: 30,\n\t\t\tratio: 12,\n\t\t\trelease: 0.25,\n\t\t\tthreshold: -24,\n\t\t});\n\t}\n\n\t/**\n\t * A read-only decibel value for metering purposes, representing the current amount of gain\n\t * reduction that the compressor is applying to the signal. If fed no signal the value will be 0 (no gain reduction).\n\t */\n\tget reduction(): Decibels {\n\t\treturn this._compressor.reduction;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._compressor.disconnect();\n\t\tthis.attack.dispose();\n\t\tthis.release.dispose();\n\t\tthis.threshold.dispose();\n\t\tthis.ratio.dispose();\n\t\tthis.knee.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/dynamics/Gate.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { CompareToFile } from \"../../../test/helper/CompareToFile.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { Gate } from \"./Gate.js\";\n\ndescribe(\"Gate\", () => {\n\tBasicTests(Gate);\n\n\tit.only(\"matches a file\", () => {\n\t\treturn CompareToFile(\n\t\t\t() => {\n\t\t\t\tconst gate = new Gate(-10, 0.1).toDestination();\n\t\t\t\tconst osc = new Oscillator().connect(gate);\n\t\t\t\tosc.start(0);\n\t\t\t\tosc.volume.value = -100;\n\t\t\t\tosc.volume.exponentialRampToValueAtTime(0, 0.5);\n\t\t\t},\n\t\t\t\"gate.wav\",\n\t\t\t0.18\n\t\t);\n\t});\n\n\tcontext(\"Signal Gating\", () => {\n\t\tit(\"handles getter/setter as Object\", () => {\n\t\t\tconst gate = new Gate();\n\t\t\tconst values = {\n\t\t\t\tsmoothing: 0.2,\n\t\t\t\tthreshold: -20,\n\t\t\t};\n\t\t\tgate.set(values);\n\t\t\texpect(gate.get().smoothing).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(gate.get().threshold).to.be.closeTo(-20, 0.1);\n\t\t\tgate.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst gate = new Gate({\n\t\t\t\tsmoothing: 0.3,\n\t\t\t\tthreshold: -5,\n\t\t\t});\n\t\t\texpect(gate.smoothing).to.be.closeTo(0.3, 0.001);\n\t\t\texpect(gate.threshold).to.be.closeTo(-5, 0.1);\n\t\t\tgate.dispose();\n\t\t});\n\n\t\tit(\"gates the incoming signal when below the threshold\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst gate = new Gate(-9);\n\t\t\t\tconst sig = new Signal(-12, \"decibels\");\n\t\t\t\tsig.connect(gate);\n\t\t\t\tgate.toDestination();\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.be.true;\n\t\t});\n\n\t\tit(\"passes the incoming signal when above the threshold\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst gate = new Gate(-11);\n\t\t\t\tconst sig = new Signal(-10, \"decibels\");\n\t\t\t\tsig.connect(gate);\n\t\t\t\tgate.toDestination();\n\t\t\t});\n\t\t\texpect(buffer.min()).to.be.above(0);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/dynamics/Gate.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { dbToGain, gainToDb } from \"../../core/type/Conversions.js\";\nimport { Decibels, Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { GreaterThan } from \"../../signal/GreaterThan.js\";\nimport { Follower } from \"../analysis/Follower.js\";\n\nexport interface GateOptions extends ToneAudioNodeOptions {\n\tthreshold: Decibels;\n\tsmoothing: Time;\n}\n\n/**\n * Gate only passes a signal through when the incoming\n * signal exceeds a specified threshold. It uses {@link Follower} to follow the ampltiude\n * of the incoming signal and compares it to the {@link threshold} value using {@link GreaterThan}.\n *\n * @example\n * const gate = new Tone.Gate(-30, 0.2).toDestination();\n * const mic = new Tone.UserMedia().connect(gate);\n * // the gate will only pass through the incoming\n * // signal when it's louder than -30db\n * @category Component\n */\nexport class Gate extends ToneAudioNode {\n\treadonly name: string = \"Gate\";\n\n\treadonly input: ToneAudioNode;\n\treadonly output: ToneAudioNode;\n\n\t/**\n\t * Follow the incoming signal\n\t */\n\tprivate _follower: Follower;\n\n\t/**\n\t * Test if it's greater than the threshold\n\t */\n\tprivate _gt: GreaterThan;\n\n\t/**\n\t * Gate the incoming signal when it does not exceed the threshold\n\t */\n\tprivate _gate: Gain;\n\n\t/**\n\t * @param threshold The threshold above which the gate will open.\n\t * @param smoothing The follower's smoothing time\n\t */\n\tconstructor(threshold?: Decibels, smoothing?: Time);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Gate.getDefaults(), arguments, [\n\t\t\t\"threshold\",\n\t\t\t\"smoothing\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._follower = new Follower({\n\t\t\tcontext: this.context,\n\t\t\tsmoothing: options.smoothing,\n\t\t});\n\t\tthis._gt = new GreaterThan({\n\t\t\tcontext: this.context,\n\t\t\tvalue: dbToGain(options.threshold),\n\t\t});\n\t\tthis.input = new Gain({ context: this.context });\n\t\tthis._gate = this.output = new Gain({ context: this.context });\n\n\t\t// connections\n\t\tthis.input.connect(this._gate);\n\t\t// the control signal\n\t\tthis.input.chain(this._follower, this._gt, this._gate.gain);\n\t}\n\n\tstatic getDefaults(): GateOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tsmoothing: 0.1,\n\t\t\tthreshold: -40,\n\t\t});\n\t}\n\n\t/**\n\t * The threshold of the gate in decibels\n\t */\n\tget threshold(): Decibels {\n\t\treturn gainToDb(this._gt.value);\n\t}\n\tset threshold(thresh) {\n\t\tthis._gt.value = dbToGain(thresh);\n\t}\n\n\t/**\n\t * The attack/decay speed of the gate.\n\t * @see {@link Follower.smoothing}\n\t */\n\tget smoothing(): Time {\n\t\treturn this._follower.smoothing;\n\t}\n\tset smoothing(smoothingTime) {\n\t\tthis._follower.smoothing = smoothingTime;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis._follower.dispose();\n\t\tthis._gt.dispose();\n\t\tthis._gate.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/dynamics/Limiter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Limiter } from \"./Limiter.js\";\n\ndescribe(\"Limiter\", () => {\n\tBasicTests(Limiter);\n\n\tcontext(\"Limiting\", () => {\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst limiter = new Limiter().toDestination();\n\t\t\t\tinput.connect(limiter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst limiter = new Limiter();\n\t\t\tconst values = {\n\t\t\t\tthreshold: -30,\n\t\t\t};\n\t\t\tlimiter.set(values);\n\t\t\texpect(limiter.get().threshold).to.be.closeTo(-30, 0.1);\n\t\t\tlimiter.dispose();\n\t\t});\n\n\t\tit(\"can set the threshold\", () => {\n\t\t\tconst limiter = new Limiter();\n\t\t\tlimiter.threshold.value = -10;\n\t\t\texpect(limiter.threshold.value).to.be.closeTo(-10, 0.1);\n\t\t\tlimiter.dispose();\n\t\t});\n\n\t\tit(\"reduction is 0 when not connected\", () => {\n\t\t\tconst limiter = new Limiter();\n\t\t\texpect(limiter.reduction).to.be.closeTo(0, 0.01);\n\t\t\tlimiter.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/dynamics/Limiter.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Decibels } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly } from \"../../core/util/Interface.js\";\nimport { Compressor } from \"./Compressor.js\";\n\nexport interface LimiterOptions extends ToneAudioNodeOptions {\n\tthreshold: Decibels;\n}\n\n/**\n * Limiter will limit the loudness of an incoming signal.\n * Under the hood its composed of a {@link Compressor} with a fast attack\n * and release and max compression ratio.\n *\n * @example\n * const limiter = new Tone.Limiter(-20).toDestination();\n * const oscillator = new Tone.Oscillator().connect(limiter);\n * oscillator.start();\n * @category Component\n */\nexport class Limiter extends ToneAudioNode {\n\treadonly name: string = \"Limiter\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * The compressor which does the limiting\n\t */\n\tprivate _compressor: Compressor;\n\n\treadonly threshold: Param<\"decibels\">;\n\n\t/**\n\t * @param threshold The threshold above which the gain reduction is applied.\n\t */\n\tconstructor(threshold?: Decibels);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Limiter.getDefaults(), arguments, [\n\t\t\t\"threshold\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._compressor =\n\t\t\tthis.input =\n\t\t\tthis.output =\n\t\t\t\tnew Compressor({\n\t\t\t\t\tcontext: this.context,\n\t\t\t\t\tratio: 20,\n\t\t\t\t\tattack: 0.003,\n\t\t\t\t\trelease: 0.01,\n\t\t\t\t\tthreshold: options.threshold,\n\t\t\t\t});\n\n\t\tthis.threshold = this._compressor.threshold;\n\t\treadOnly(this, \"threshold\");\n\t}\n\n\tstatic getDefaults(): LimiterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tthreshold: -12,\n\t\t});\n\t}\n\n\t/**\n\t * A read-only decibel value for metering purposes, representing the current amount of gain\n\t * reduction that the compressor is applying to the signal.\n\t */\n\tget reduction(): Decibels {\n\t\treturn this._compressor.reduction;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._compressor.dispose();\n\t\tthis.threshold.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/dynamics/MidSideCompressor.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { MidSideCompressor } from \"./MidSideCompressor.js\";\n\ndescribe(\"MidSideCompressor\", () => {\n\tBasicTests(MidSideCompressor);\n\n\tcontext(\"Compression\", () => {\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst comp = new MidSideCompressor().toDestination();\n\t\t\t\tinput.connect(comp);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst comp = new MidSideCompressor();\n\t\t\tconst values = {\n\t\t\t\tmid: {\n\t\t\t\t\tratio: 16,\n\t\t\t\t\tthreshold: -30,\n\t\t\t\t},\n\t\t\t\tside: {\n\t\t\t\t\trelease: 0.5,\n\t\t\t\t\tattack: 0.03,\n\t\t\t\t\tknee: 20,\n\t\t\t\t},\n\t\t\t};\n\t\t\tcomp.set(values);\n\t\t\texpect(comp.get()).to.have.keys([\"mid\", \"side\"]);\n\t\t\texpect(comp.get().mid.ratio).be.closeTo(16, 0.01);\n\t\t\texpect(comp.get().side.release).be.closeTo(0.5, 0.01);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst comp = new MidSideCompressor({\n\t\t\t\tmid: {\n\t\t\t\t\tratio: 16,\n\t\t\t\t\tthreshold: -30,\n\t\t\t\t},\n\t\t\t\tside: {\n\t\t\t\t\trelease: 0.5,\n\t\t\t\t\tattack: 0.03,\n\t\t\t\t\tknee: 20,\n\t\t\t\t},\n\t\t\t});\n\t\t\texpect(comp.mid.ratio.value).be.closeTo(16, 0.01);\n\t\t\texpect(comp.mid.threshold.value).be.closeTo(-30, 0.01);\n\t\t\texpect(comp.side.release.value).be.closeTo(0.5, 0.01);\n\t\t\texpect(comp.side.attack.value).be.closeTo(0.03, 0.01);\n\t\t\tcomp.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/dynamics/MidSideCompressor.ts", "content": "import {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, RecursivePartial } from \"../../core/util/Interface.js\";\nimport { MidSideMerge } from \"../channel/MidSideMerge.js\";\nimport { MidSideSplit } from \"../channel/MidSideSplit.js\";\nimport { Compressor, CompressorOptions } from \"./Compressor.js\";\n\nexport interface MidSideCompressorOptions extends ToneAudioNodeOptions {\n\tmid: Omit;\n\tside: Omit;\n}\n\n/**\n * MidSideCompressor applies two different compressors to the {@link mid}\n * and {@link side} signal components of the input.\n * @see {@link MidSideSplit} and {@link MidSideMerge}.\n * @category Component\n */\nexport class MidSideCompressor extends ToneAudioNode {\n\treadonly name: string = \"MidSideCompressor\";\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * Split the incoming signal into Mid/Side\n\t */\n\tprivate _midSideSplit: MidSideSplit;\n\n\t/**\n\t * Merge the compressed signal back into a single stream\n\t */\n\tprivate _midSideMerge: MidSideMerge;\n\n\t/**\n\t * The compression applied to the mid signal\n\t */\n\treadonly mid: Compressor;\n\n\t/**\n\t * The compression applied to the side signal\n\t */\n\treadonly side: Compressor;\n\n\tconstructor(options?: RecursivePartial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tMidSideCompressor.getDefaults(),\n\t\t\targuments\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._midSideSplit = this.input = new MidSideSplit({\n\t\t\tcontext: this.context,\n\t\t});\n\t\tthis._midSideMerge = this.output = new MidSideMerge({\n\t\t\tcontext: this.context,\n\t\t});\n\t\tthis.mid = new Compressor(\n\t\t\tObject.assign(options.mid, { context: this.context })\n\t\t);\n\t\tthis.side = new Compressor(\n\t\t\tObject.assign(options.side, { context: this.context })\n\t\t);\n\n\t\tthis._midSideSplit.mid.chain(this.mid, this._midSideMerge.mid);\n\t\tthis._midSideSplit.side.chain(this.side, this._midSideMerge.side);\n\t\treadOnly(this, [\"mid\", \"side\"]);\n\t}\n\n\tstatic getDefaults(): MidSideCompressorOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tmid: {\n\t\t\t\tratio: 3,\n\t\t\t\tthreshold: -24,\n\t\t\t\trelease: 0.03,\n\t\t\t\tattack: 0.02,\n\t\t\t\tknee: 16,\n\t\t\t},\n\t\t\tside: {\n\t\t\t\tratio: 6,\n\t\t\t\tthreshold: -30,\n\t\t\t\trelease: 0.25,\n\t\t\t\tattack: 0.03,\n\t\t\t\tknee: 10,\n\t\t\t},\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.side.dispose();\n\t\tthis._midSideSplit.dispose();\n\t\tthis._midSideMerge.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/dynamics/MultibandCompressor.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { MultibandCompressor } from \"./MultibandCompressor.js\";\n\ndescribe(\"MultibandCompressor\", () => {\n\tBasicTests(MultibandCompressor);\n\n\tcontext(\"Compression\", () => {\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst comp = new MultibandCompressor().toDestination();\n\t\t\t\tinput.connect(comp);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst comp = new MultibandCompressor();\n\t\t\tconst values = {\n\t\t\t\tmid: {\n\t\t\t\t\tratio: 16,\n\t\t\t\t\tthreshold: -30,\n\t\t\t\t},\n\t\t\t\thigh: {\n\t\t\t\t\trelease: 0.5,\n\t\t\t\t\tattack: 0.03,\n\t\t\t\t\tknee: 20,\n\t\t\t\t},\n\t\t\t};\n\t\t\tcomp.set(values);\n\t\t\texpect(comp.get()).to.have.keys([\n\t\t\t\t\"low\",\n\t\t\t\t\"mid\",\n\t\t\t\t\"high\",\n\t\t\t\t\"lowFrequency\",\n\t\t\t\t\"highFrequency\",\n\t\t\t]);\n\t\t\texpect(comp.get().mid.ratio).be.closeTo(16, 0.01);\n\t\t\texpect(comp.get().high.release).be.closeTo(0.5, 0.01);\n\t\t\tcomp.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst comp = new MultibandCompressor({\n\t\t\t\tmid: {\n\t\t\t\t\tratio: 16,\n\t\t\t\t\tthreshold: -30,\n\t\t\t\t},\n\t\t\t\tlowFrequency: 100,\n\t\t\t});\n\t\t\texpect(comp.mid.ratio.value).be.closeTo(16, 0.01);\n\t\t\texpect(comp.mid.threshold.value).be.closeTo(-30, 0.01);\n\t\t\texpect(comp.lowFrequency.value).be.closeTo(100, 0.01);\n\t\t\tcomp.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/dynamics/MultibandCompressor.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tInputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Frequency } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, RecursivePartial } from \"../../core/util/Interface.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { MultibandSplit } from \"../channel/MultibandSplit.js\";\nimport { Compressor, CompressorOptions } from \"./Compressor.js\";\n\nexport interface MultibandCompressorOptions extends ToneAudioNodeOptions {\n\tmid: Omit;\n\tlow: Omit;\n\thigh: Omit;\n\tlowFrequency: Frequency;\n\thighFrequency: Frequency;\n}\n\n/**\n * A compressor with separate controls over low/mid/high dynamics.\n * @see {@link Compressor} and {@link MultibandSplit}\n *\n * @example\n * const multiband = new Tone.MultibandCompressor({\n * \tlowFrequency: 200,\n * \thighFrequency: 1300,\n * \tlow: {\n * \t\tthreshold: -12\n * \t}\n * });\n * @category Component\n */\nexport class MultibandCompressor extends ToneAudioNode {\n\treadonly name: string = \"MultibandCompressor\";\n\n\treadonly input: InputNode;\n\treadonly output: ToneAudioNode;\n\n\t/**\n\t * Split the incoming signal into high/mid/low\n\t */\n\tprivate _splitter: MultibandSplit;\n\n\t/**\n\t * low/mid crossover frequency.\n\t */\n\treadonly lowFrequency: Signal<\"frequency\">;\n\n\t/**\n\t * mid/high crossover frequency.\n\t */\n\treadonly highFrequency: Signal<\"frequency\">;\n\n\t/**\n\t * The compressor applied to the low frequencies\n\t */\n\treadonly low: Compressor;\n\n\t/**\n\t * The compressor applied to the mid frequencies\n\t */\n\treadonly mid: Compressor;\n\n\t/**\n\t * The compressor applied to the high frequencies\n\t */\n\treadonly high: Compressor;\n\n\tconstructor(options?: RecursivePartial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tMultibandCompressor.getDefaults(),\n\t\t\targuments\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._splitter = this.input = new MultibandSplit({\n\t\t\tcontext: this.context,\n\t\t\tlowFrequency: options.lowFrequency,\n\t\t\thighFrequency: options.highFrequency,\n\t\t});\n\t\tthis.lowFrequency = this._splitter.lowFrequency;\n\t\tthis.highFrequency = this._splitter.highFrequency;\n\t\tthis.output = new Gain({ context: this.context });\n\t\tthis.low = new Compressor(\n\t\t\tObject.assign(options.low, { context: this.context })\n\t\t);\n\t\tthis.mid = new Compressor(\n\t\t\tObject.assign(options.mid, { context: this.context })\n\t\t);\n\t\tthis.high = new Compressor(\n\t\t\tObject.assign(options.high, { context: this.context })\n\t\t);\n\n\t\t// connect the compressor\n\t\tthis._splitter.low.chain(this.low, this.output);\n\t\tthis._splitter.mid.chain(this.mid, this.output);\n\t\tthis._splitter.high.chain(this.high, this.output);\n\n\t\treadOnly(this, [\"high\", \"mid\", \"low\", \"highFrequency\", \"lowFrequency\"]);\n\t}\n\n\tstatic getDefaults(): MultibandCompressorOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tlowFrequency: 250,\n\t\t\thighFrequency: 2000,\n\t\t\tlow: {\n\t\t\t\tratio: 6,\n\t\t\t\tthreshold: -30,\n\t\t\t\trelease: 0.25,\n\t\t\t\tattack: 0.03,\n\t\t\t\tknee: 10,\n\t\t\t},\n\t\t\tmid: {\n\t\t\t\tratio: 3,\n\t\t\t\tthreshold: -24,\n\t\t\t\trelease: 0.03,\n\t\t\t\tattack: 0.02,\n\t\t\t\tknee: 16,\n\t\t\t},\n\t\t\thigh: {\n\t\t\t\tratio: 3,\n\t\t\t\tthreshold: -24,\n\t\t\t\trelease: 0.03,\n\t\t\t\tattack: 0.02,\n\t\t\t\tknee: 16,\n\t\t\t},\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._splitter.dispose();\n\t\tthis.low.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.high.dispose();\n\t\tthis.output.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/envelope/AmplitudeEnvelope.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { CompareToFile } from \"../../../test/helper/CompareToFile.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { AmplitudeEnvelope } from \"./AmplitudeEnvelope.js\";\nimport { Envelope } from \"./Envelope.js\";\n\ndescribe(\"AmplitudeEnvelope\", () => {\n\tBasicTests(AmplitudeEnvelope);\n\n\tcontext(\"Comparisons\", () => {\n\t\tit(\"matches a file\", () => {\n\t\t\treturn CompareToFile(() => {\n\t\t\t\tconst ampEnv = new AmplitudeEnvelope({\n\t\t\t\t\tattack: 0.1,\n\t\t\t\t\tdecay: 0.2,\n\t\t\t\t\trelease: 0.2,\n\t\t\t\t\tsustain: 0.1,\n\t\t\t\t}).toDestination();\n\t\t\t\tconst osc = new Oscillator().start(0).connect(ampEnv);\n\t\t\t\tampEnv.triggerAttack(0);\n\t\t\t\tampEnv.triggerRelease(0.3);\n\t\t\t}, \"ampEnvelope.wav\");\n\t\t});\n\n\t\tit(\"matches a file with multiple retriggers\", () => {\n\t\t\treturn CompareToFile(\n\t\t\t\t() => {\n\t\t\t\t\tconst ampEnv = new AmplitudeEnvelope({\n\t\t\t\t\t\tattack: 0.1,\n\t\t\t\t\t\tdecay: 0.2,\n\t\t\t\t\t\trelease: 0.2,\n\t\t\t\t\t\tsustain: 0.1,\n\t\t\t\t\t}).toDestination();\n\t\t\t\t\tconst osc = new Oscillator().start(0).connect(ampEnv);\n\t\t\t\t\tampEnv.triggerAttack(0);\n\t\t\t\t\tampEnv.triggerAttack(0.3);\n\t\t\t\t},\n\t\t\t\t\"ampEnvelope2.wav\",\n\t\t\t\t0.004\n\t\t\t);\n\t\t});\n\n\t\tit(\"matches a file with ripple attack/release\", () => {\n\t\t\treturn CompareToFile(\n\t\t\t\t() => {\n\t\t\t\t\tconst ampEnv = new AmplitudeEnvelope({\n\t\t\t\t\t\tattack: 0.5,\n\t\t\t\t\t\tattackCurve: \"ripple\",\n\t\t\t\t\t\tdecay: 0.2,\n\t\t\t\t\t\trelease: 0.3,\n\t\t\t\t\t\treleaseCurve: \"ripple\",\n\t\t\t\t\t\tsustain: 0.1,\n\t\t\t\t\t}).toDestination();\n\t\t\t\t\tconst osc = new Oscillator().start(0).connect(ampEnv);\n\t\t\t\t\tampEnv.triggerAttack(0);\n\t\t\t\t\tampEnv.triggerRelease(0.7);\n\t\t\t\t\tampEnv.triggerAttack(1);\n\t\t\t\t\tampEnv.triggerRelease(1.6);\n\t\t\t\t},\n\t\t\t\t\"ampEnvelope3.wav\",\n\t\t\t\t0.002\n\t\t\t);\n\t\t});\n\t});\n\n\tcontext(\"Envelope\", () => {\n\t\tit(\"extends envelope\", () => {\n\t\t\tconst ampEnv = new AmplitudeEnvelope();\n\t\t\texpect(ampEnv).to.be.instanceOf(Envelope);\n\t\t\tampEnv.dispose();\n\t\t});\n\n\t\tit(\"passes no signal before being triggered\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst ampEnv = new AmplitudeEnvelope().toDestination();\n\t\t\t\tnew Signal(1).connect(ampEnv);\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.be.true;\n\t\t});\n\n\t\tit(\"passes signal once triggered\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst ampEnv = new AmplitudeEnvelope().toDestination();\n\t\t\t\tnew Signal(1).connect(ampEnv);\n\t\t\t\tampEnv.triggerAttack(0.1);\n\t\t\t}, 0.2);\n\t\t\texpect(buffer.getTimeOfFirstSound()).to.be.closeTo(0.1, 0.001);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/envelope/AmplitudeEnvelope.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { NormalRange, Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Envelope, EnvelopeOptions } from \"./Envelope.js\";\n\n/**\n * AmplitudeEnvelope is a Tone.Envelope connected to a gain node.\n * Unlike Tone.Envelope, which outputs the envelope's value, AmplitudeEnvelope accepts\n * an audio signal as the input and will apply the envelope to the amplitude\n * of the signal.\n * Read more about ADSR Envelopes on [Wikipedia](https://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope).\n *\n * @example\n * return Tone.Offline(() => {\n * \tconst ampEnv = new Tone.AmplitudeEnvelope({\n * \t\tattack: 0.1,\n * \t\tdecay: 0.2,\n * \t\tsustain: 1.0,\n * \t\trelease: 0.8\n * \t}).toDestination();\n * \t// create an oscillator and connect it\n * \tconst osc = new Tone.Oscillator().connect(ampEnv).start();\n * \t// trigger the envelopes attack and release \"8t\" apart\n * \tampEnv.triggerAttackRelease(\"8t\");\n * }, 1.5, 1);\n * @category Component\n */\nexport class AmplitudeEnvelope extends Envelope {\n\treadonly name: string = \"AmplitudeEnvelope\";\n\n\tprivate _gainNode: Gain = new Gain({\n\t\tcontext: this.context,\n\t\tgain: 0,\n\t});\n\toutput: Gain = this._gainNode;\n\tinput: Gain = this._gainNode;\n\n\t/**\n\t * @param attack The amount of time it takes for the envelope to go from 0 to its maximum value.\n\t * @param decay\tThe period of time after the attack that it takes for the envelope\n\t * \tto fall to the sustain value. Value must be greater than 0.\n\t * @param sustain\tThe percent of the maximum value that the envelope rests at until\n\t * \tthe release is triggered.\n\t * @param release\tThe amount of time after the release is triggered it takes to reach 0.\n\t * \tValue must be greater than 0.\n\t */\n\tconstructor(\n\t\tattack?: Time,\n\t\tdecay?: Time,\n\t\tsustain?: NormalRange,\n\t\trelease?: Time\n\t);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper(\n\t\t\toptionsFromArguments(AmplitudeEnvelope.getDefaults(), arguments, [\n\t\t\t\t\"attack\",\n\t\t\t\t\"decay\",\n\t\t\t\t\"sustain\",\n\t\t\t\t\"release\",\n\t\t\t])\n\t\t);\n\t\tthis._sig.connect(this._gainNode.gain);\n\t\tthis.output = this._gainNode;\n\t\tthis.input = this._gainNode;\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._gainNode.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/envelope/Envelope.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectTo } from \"../../../test/helper/Connect.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { SignalConnectAndDisconnect } from \"../../../test/helper/SignalTests.js\";\nimport { Envelope, EnvelopeCurve } from \"./Envelope.js\";\n\ndescribe(\"Envelope\", () => {\n\tBasicTests(Envelope);\n\tSignalConnectAndDisconnect(Envelope);\n\n\tcontext(\"Envelope\", () => {\n\t\tit(\"has an output connections\", () => {\n\t\t\tconst env = new Envelope();\n\t\t\tenv.connect(connectTo());\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"can get and set values an Objects\", () => {\n\t\t\tconst env = new Envelope();\n\t\t\tconst values = {\n\t\t\t\tattack: 0,\n\t\t\t\tdecay: 0.5,\n\t\t\t\trelease: \"4n\",\n\t\t\t\tsustain: 1,\n\t\t\t};\n\t\t\tenv.set(values);\n\t\t\texpect(env.get()).to.contain.keys(Object.keys(values));\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"passes no signal before being triggered\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tnew Envelope().toDestination();\n\t\t\t});\n\t\t\texpect(buffer.isSilent()).to.equal(true);\n\t\t});\n\n\t\tit(\"passes signal once triggered\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope().toDestination();\n\t\t\t\tenv.triggerAttack(0.05);\n\t\t\t}, 0.1);\n\t\t\texpect(buffer.getTimeOfFirstSound()).to.be.closeTo(0.05, 0.001);\n\t\t});\n\n\t\tit(\"can take parameters as both an object and as arguments\", () => {\n\t\t\tconst env0 = new Envelope({\n\t\t\t\tattack: 0,\n\t\t\t\tdecay: 0.5,\n\t\t\t\tsustain: 1,\n\t\t\t});\n\t\t\texpect(env0.attack).to.equal(0);\n\t\t\texpect(env0.decay).to.equal(0.5);\n\t\t\texpect(env0.sustain).to.equal(1);\n\t\t\tenv0.dispose();\n\t\t\tconst env1 = new Envelope(0.1, 0.2, 0.3);\n\t\t\texpect(env1.attack).to.equal(0.1);\n\t\t\texpect(env1.decay).to.equal(0.2);\n\t\t\texpect(env1.sustain).to.equal(0.3);\n\t\t\tenv1.dispose();\n\t\t});\n\n\t\tit(\"ensures that none of the values go below 0\", () => {\n\t\t\tconst env = new Envelope();\n\t\t\texpect(() => {\n\t\t\t\tenv.attack = -1;\n\t\t\t}).to.throw(RangeError);\n\n\t\t\texpect(() => {\n\t\t\t\tenv.decay = -1;\n\t\t\t}).to.throw(RangeError);\n\n\t\t\texpect(() => {\n\t\t\t\tenv.sustain = 2;\n\t\t\t}).to.throw(RangeError);\n\n\t\t\texpect(() => {\n\t\t\t\tenv.release = -1;\n\t\t\t}).to.throw(RangeError);\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"can set attack to exponential or linear\", () => {\n\t\t\tconst env = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv.attackCurve = \"exponential\";\n\t\t\texpect(env.attackCurve).to.equal(\"exponential\");\n\t\t\tenv.triggerAttack();\n\t\t\tenv.dispose();\n\t\t\t// and can be linear\n\t\t\tconst env2 = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv2.attackCurve = \"linear\";\n\t\t\texpect(env2.attackCurve).to.equal(\"linear\");\n\t\t\tenv2.triggerAttack();\n\t\t\t// and test a non-curve\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tenv2.attackCurve = \"other\";\n\t\t\t}).to.throw(Error);\n\t\t\tenv2.dispose();\n\t\t});\n\n\t\tit(\"can set decay to exponential or linear\", () => {\n\t\t\tconst env = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv.decayCurve = \"exponential\";\n\t\t\texpect(env.decayCurve).to.equal(\"exponential\");\n\t\t\tenv.triggerAttack();\n\t\t\tenv.dispose();\n\t\t\t// and can be linear\n\t\t\tconst env2 = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv2.decayCurve = \"linear\";\n\t\t\texpect(env2.decayCurve).to.equal(\"linear\");\n\t\t\tenv2.triggerAttack();\n\t\t\t// and test a non-curve\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tenv2.decayCurve = \"other\";\n\t\t\t}).to.throw(Error);\n\t\t\tenv2.dispose();\n\t\t});\n\n\t\tit(\"can set release to exponential or linear\", () => {\n\t\t\tconst env = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv.releaseCurve = \"exponential\";\n\t\t\texpect(env.releaseCurve).to.equal(\"exponential\");\n\t\t\tenv.triggerRelease();\n\t\t\tenv.dispose();\n\t\t\t// and can be linear\n\t\t\tconst env2 = new Envelope(0.01, 0.01, 0.5, 0.3);\n\t\t\tenv2.releaseCurve = \"linear\";\n\t\t\texpect(env2.releaseCurve).to.equal(\"linear\");\n\t\t\tenv2.triggerRelease();\n\t\t\t// and test a non-curve\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tenv2.releaseCurve = \"other\";\n\t\t\t}).to.throw(Error);\n\t\t\tenv2.dispose();\n\t\t});\n\n\t\tit(\"can set release to exponential or linear\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\trelease: 0,\n\t\t\t\t});\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.4, 0);\n\t\t\t}, 0.7);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.above(0);\n\t\t\texpect(buffer.getValueAtTime(0.401)).to.equal(0);\n\t\t});\n\n\t\tit(\"schedule a release at the moment when the attack portion is done\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.5,\n\t\t\t\t\tdecay: 0.0,\n\t\t\t\t\tsustain: 1,\n\t\t\t\t\trelease: 0.5,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.5);\n\t\t\t}, 0.7);\n\t\t\t// make sure that it's got the rising edge\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.4, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0.6, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0.8, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.be.closeTo(1, 0.001);\n\t\t});\n\n\t\tit(\"correctly schedules an exponential attack\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.01,\n\t\t\t\tdecay: 0.4,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.5,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t}, 0.7);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.within(0, 1);\n\t\t\t\t},\n\t\t\t\t0,\n\t\t\t\te.attack\n\t\t\t);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.within(e.sustain - 0.001, 1);\n\t\t\t\t},\n\t\t\t\te.attack,\n\t\t\t\te.attack + e.decay\n\t\t\t);\n\t\t\tbuffer.forEachBetween((sample) => {\n\t\t\t\texpect(sample).to.be.closeTo(e.sustain, 0.01);\n\t\t\t}, e.attack + e.decay);\n\t\t});\n\n\t\tit(\"correctly schedules a linear release\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.01,\n\t\t\t\tdecay: 0.4,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.5,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t}, 0.7);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample, time) => {\n\t\t\t\t\tconst target = 1 - (time - 0.2) * 10;\n\t\t\t\t\texpect(sample).to.be.closeTo(target, 0.01);\n\t\t\t\t},\n\t\t\t\t0.2,\n\t\t\t\t0.2\n\t\t\t);\n\t\t});\n\n\t\tit(\"correctly schedules a linear decay\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.1,\n\t\t\t\tdecay: 0.5,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.decayCurve = \"linear\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t}, 0.7);\n\t\t\texpect(buffer.getValueAtTime(0.05)).to.be.closeTo(0.5, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.8, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0.6, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0.4, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.6)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"correctly schedules an exponential decay\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.1,\n\t\t\t\tdecay: 0.5,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.decayCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t}, 0.7);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.27, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0.07, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0.02, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.005, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.6)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"can schedule a very short attack\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.001,\n\t\t\t\tdecay: 0.01,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.1,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t}, 0.2);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.within(0, 1);\n\t\t\t\t},\n\t\t\t\t0,\n\t\t\t\te.attack\n\t\t\t);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.within(e.sustain - 0.001, 1);\n\t\t\t\t},\n\t\t\t\te.attack,\n\t\t\t\te.attack + e.decay\n\t\t\t);\n\t\t\tbuffer.forEachBetween((sample) => {\n\t\t\t\texpect(sample).to.be.closeTo(e.sustain, 0.01);\n\t\t\t}, e.attack + e.decay);\n\t\t});\n\n\t\tit(\"can schedule an attack of time 0\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0, 0.1);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0.1);\n\t\t\t}, 0.2);\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.001);\n\t\t\texpect(buffer.getValueAtTime(0.0999)).to.be.closeTo(0, 0.001);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(1, 0.001);\n\t\t});\n\n\t\tit(\"correctly schedule a release\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.001,\n\t\t\t\tdecay: 0.01,\n\t\t\t\trelease: 0.3,\n\t\t\t\tsustain: 0.5,\n\t\t\t};\n\t\t\tconst releaseTime = 0.2;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttackRelease(releaseTime);\n\t\t\t}, 0.6);\n\t\t\tconst sustainStart = e.attack + e.decay;\n\t\t\tconst sustainEnd = sustainStart + releaseTime;\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.below(e.sustain + 0.01);\n\t\t\t\t},\n\t\t\t\tsustainStart,\n\t\t\t\tsustainEnd\n\t\t\t);\n\t\t\tbuffer.forEachBetween((sample) => {\n\t\t\t\texpect(sample).to.be.closeTo(0, 0.01);\n\t\t\t}, releaseTime + e.release);\n\t\t});\n\n\t\tit(\"can retrigger a short attack at the same time as previous release\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.001, 0.1, 0.5);\n\t\t\t\tenv.attackCurve = \"linear\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t\tenv.triggerRelease(0.4);\n\t\t\t\tenv.triggerAttack(0.4);\n\t\t\t}, 0.6);\n\t\t\texpect(buffer.getValueAtTime(0.4)).be.closeTo(0.5, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.40025)).be.closeTo(0.75, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4005)).be.closeTo(1, 0.01);\n\t\t});\n\n\t\tit(\"is silent before and after triggering\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.001,\n\t\t\t\tdecay: 0.01,\n\t\t\t\trelease: 0.3,\n\t\t\t\tsustain: 0.5,\n\t\t\t};\n\t\t\tconst releaseTime = 0.2;\n\t\t\tconst attackTime = 0.1;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(attackTime);\n\t\t\t\tenv.triggerRelease(releaseTime);\n\t\t\t}, 0.6);\n\t\t\texpect(buffer.getValueAtTime(attackTime - 0.001)).to.equal(0);\n\t\t\texpect(\n\t\t\t\tbuffer.getValueAtTime(\n\t\t\t\t\te.attack + e.decay + releaseTime + e.release\n\t\t\t\t)\n\t\t\t).to.be.below(0.01);\n\t\t});\n\n\t\tit(\"is silent after decay if sustain is 0\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.01,\n\t\t\t\tdecay: 0.04,\n\t\t\t\tsustain: 0,\n\t\t\t};\n\t\t\tconst attackTime = 0.1;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(e.attack, e.decay, e.sustain);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(attackTime);\n\t\t\t}, 0.4);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(buffer.getValueAtTime(attackTime - 0.001)).to.equal(0);\n\t\t\t\texpect(\n\t\t\t\t\tbuffer.getValueAtTime(attackTime + e.attack + e.decay)\n\t\t\t\t).to.be.below(0.01);\n\t\t\t});\n\t\t});\n\n\t\tit(\"correctly schedule an attack release envelope\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.08,\n\t\t\t\tdecay: 0.2,\n\t\t\t\trelease: 0.2,\n\t\t\t\tsustain: 0.1,\n\t\t\t};\n\t\t\tconst releaseTime = 0.4;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t\tenv.triggerRelease(releaseTime);\n\t\t\t});\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time < e.attack) {\n\t\t\t\t\texpect(sample).to.be.within(0, 1);\n\t\t\t\t} else if (time < e.attack + e.decay) {\n\t\t\t\t\texpect(sample).to.be.within(e.sustain, 1);\n\t\t\t\t} else if (time < releaseTime) {\n\t\t\t\t\texpect(sample).to.be.closeTo(e.sustain, 0.1);\n\t\t\t\t} else if (time < releaseTime + e.release) {\n\t\t\t\t\texpect(sample).to.be.within(0, e.sustain + 0.01);\n\t\t\t\t} else {\n\t\t\t\t\texpect(sample).to.be.below(0.0001);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule a combined AttackRelease\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.1,\n\t\t\t\tdecay: 0.2,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.35,\n\t\t\t};\n\t\t\tconst releaseTime = 0.4;\n\t\t\tconst duration = 0.4;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t\tenv.triggerRelease(releaseTime);\n\t\t\t}, 0.7);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time < e.attack) {\n\t\t\t\t\texpect(sample).to.be.within(0, 1);\n\t\t\t\t} else if (time < e.attack + e.decay) {\n\t\t\t\t\texpect(sample).to.be.within(e.sustain - 0.001, 1);\n\t\t\t\t} else if (time < duration) {\n\t\t\t\t\texpect(sample).to.be.closeTo(e.sustain, 0.1);\n\t\t\t\t} else if (time < duration + e.release) {\n\t\t\t\t\texpect(sample).to.be.within(0, e.sustain + 0.01);\n\t\t\t\t} else {\n\t\t\t\t\texpect(sample).to.be.below(0.0015);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule a combined AttackRelease with velocity\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.1,\n\t\t\t\tdecay: 0.2,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.35,\n\t\t\t};\n\t\t\tconst releaseTime = 0.4;\n\t\t\tconst duration = 0.4;\n\t\t\tconst velocity = 0.4;\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0, velocity);\n\t\t\t\tenv.triggerRelease(releaseTime);\n\t\t\t}, 0.7);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time < e.attack) {\n\t\t\t\t\texpect(sample).to.be.within(0, velocity + 0.01);\n\t\t\t\t} else if (time < e.attack + e.decay) {\n\t\t\t\t\texpect(sample).to.be.within(\n\t\t\t\t\t\te.sustain * velocity - 0.01,\n\t\t\t\t\t\tvelocity + 0.01\n\t\t\t\t\t);\n\t\t\t\t} else if (time < duration) {\n\t\t\t\t\texpect(sample).to.be.closeTo(e.sustain * velocity, 0.1);\n\t\t\t\t} else if (time < duration + e.release) {\n\t\t\t\t\texpect(sample).to.be.within(0, e.sustain * velocity + 0.01);\n\t\t\t\t} else {\n\t\t\t\t\texpect(sample).to.be.below(0.01);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule multiple envelopes\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.1,\n\t\t\t\tdecay: 0.2,\n\t\t\t\trelease: 0.1,\n\t\t\t\tsustain: 0.0,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain,\n\t\t\t\t\te.release\n\t\t\t\t);\n\t\t\t\tenv.toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t\tenv.triggerAttack(0.5);\n\t\t\t}, 0.85);\n\t\t\t// first trigger\n\t\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0, 0.01);\n\t\t\t// second trigger\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.6)).to.be.closeTo(1, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.8)).to.be.closeTo(0, 0.01);\n\t\t});\n\n\t\tit(\"can schedule multiple attack/releases with no discontinuities\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 0.2, 0.4).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0, 0.4);\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.11);\n\t\t\t\tenv.triggerAttackRelease(0.45, 0.1);\n\t\t\t\tenv.triggerAttackRelease(1.1, 0.09);\n\t\t\t\tenv.triggerAttackRelease(1.5, 0.3);\n\t\t\t\tenv.triggerAttackRelease(1.8, 0.29);\n\t\t\t}, 2);\n\t\t\t// test for discontinuities\n\t\t\tlet lastSample = 0;\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(sample).to.be.at.most(1);\n\t\t\t\tconst diff = Math.abs(lastSample - sample);\n\t\t\t\texpect(diff).to.be.lessThan(0.001);\n\t\t\t\tlastSample = sample;\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule multiple 'linear' attack/releases with no discontinuities\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 0.2, 0.4).toDestination();\n\t\t\t\tenv.attackCurve = \"linear\";\n\t\t\t\tenv.releaseCurve = \"linear\";\n\t\t\t\tenv.triggerAttackRelease(0, 0.4);\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.11);\n\t\t\t\tenv.triggerAttackRelease(0.45, 0.1);\n\t\t\t\tenv.triggerAttackRelease(1.1, 0.09);\n\t\t\t\tenv.triggerAttackRelease(1.5, 0.3);\n\t\t\t\tenv.triggerAttackRelease(1.8, 0.29);\n\t\t\t}, 2);\n\t\t\t// test for discontinuities\n\t\t\tlet lastSample = 0;\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(sample).to.be.at.most(1);\n\t\t\t\tconst diff = Math.abs(lastSample - sample);\n\t\t\t\texpect(diff).to.be.lessThan(0.001);\n\t\t\t\tlastSample = sample;\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule multiple 'exponential' attack/releases with no discontinuities\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 0.2, 0.4).toDestination();\n\t\t\t\tenv.attackCurve = \"exponential\";\n\t\t\t\tenv.releaseCurve = \"exponential\";\n\t\t\t\tenv.triggerAttackRelease(0, 0.4);\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.11);\n\t\t\t\tenv.triggerAttackRelease(0.45, 0.1);\n\t\t\t\tenv.triggerAttackRelease(1.1, 0.09);\n\t\t\t\tenv.triggerAttackRelease(1.5, 0.3);\n\t\t\t\tenv.triggerAttackRelease(1.8, 0.29);\n\t\t\t}, 2);\n\t\t\t// test for discontinuities\n\t\t\tlet lastSample = 0;\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(sample).to.be.at.most(1);\n\t\t\t\tconst diff = Math.abs(lastSample - sample);\n\t\t\t\texpect(diff).to.be.lessThan(0.0035);\n\t\t\t\tlastSample = sample;\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule multiple 'sine' attack/releases with no discontinuities\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 0.2, 0.4).toDestination();\n\t\t\t\tenv.attackCurve = \"sine\";\n\t\t\t\tenv.releaseCurve = \"sine\";\n\t\t\t\tenv.triggerAttackRelease(0, 0.4);\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.11);\n\t\t\t\tenv.triggerAttackRelease(0.45, 0.1);\n\t\t\t\tenv.triggerAttackRelease(1.1, 0.09);\n\t\t\t\tenv.triggerAttackRelease(1.5, 0.3);\n\t\t\t\tenv.triggerAttackRelease(1.8, 0.29);\n\t\t\t}, 2);\n\t\t\t// test for discontinuities\n\t\t\tlet lastSample = 0;\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(sample).to.be.at.most(1);\n\t\t\t\tconst diff = Math.abs(lastSample - sample);\n\t\t\t\texpect(diff).to.be.lessThan(0.0035);\n\t\t\t\tlastSample = sample;\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule multiple 'cosine' attack/releases with no discontinuities\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 0.2, 0.4).toDestination();\n\t\t\t\tenv.attackCurve = \"cosine\";\n\t\t\t\tenv.releaseCurve = \"cosine\";\n\t\t\t\tenv.triggerAttackRelease(0, 0.4);\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.11);\n\t\t\t\tenv.triggerAttackRelease(0.45, 0.1);\n\t\t\t\tenv.triggerAttackRelease(1.1, 0.09);\n\t\t\t\tenv.triggerAttackRelease(1.5, 0.3);\n\t\t\t\tenv.triggerAttackRelease(1.8, 0.29);\n\t\t\t}, 2);\n\t\t\t// test for discontinuities\n\t\t\tlet lastSample = 0;\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\texpect(sample).to.be.at.most(1);\n\t\t\t\tconst diff = Math.abs(lastSample - sample);\n\t\t\t\texpect(diff).to.be.lessThan(0.002);\n\t\t\t\tlastSample = sample;\n\t\t\t});\n\t\t});\n\n\t\tit(\"reports its current envelope value (.value)\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(1, 0.2, 1).toDestination();\n\t\t\t\texpect(env.value).to.be.closeTo(0, 0.01);\n\t\t\t\tenv.triggerAttack();\n\t\t\t\treturn (time) => {\n\t\t\t\t\texpect(env.value).to.be.closeTo(time, 0.01);\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"can cancel a schedule envelope\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope(0.1, 0.2, 1).toDestination();\n\t\t\t\tenv.triggerAttack(0.2);\n\t\t\t\tenv.cancel(0.2);\n\t\t\t}, 0.3);\n\t\t\texpect(buffer.isSilent()).to.be.true;\n\t\t});\n\t});\n\n\tcontext(\"Attack/Release Curves\", () => {\n\t\tconst envelopeCurves: EnvelopeCurve[] = [\n\t\t\t\"linear\",\n\t\t\t\"exponential\",\n\t\t\t\"bounce\",\n\t\t\t\"cosine\",\n\t\t\t\"ripple\",\n\t\t\t\"sine\",\n\t\t\t\"step\",\n\t\t];\n\n\t\tit(\"can get set all of the types as the attackCurve\", () => {\n\t\t\tconst env = new Envelope();\n\t\t\tenvelopeCurves.forEach((type) => {\n\t\t\t\tenv.attackCurve = type;\n\t\t\t\texpect(env.attackCurve).to.equal(type);\n\t\t\t});\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"can get set all of the types as the releaseCurve\", () => {\n\t\t\tconst env = new Envelope();\n\t\t\tenvelopeCurves.forEach((type) => {\n\t\t\t\tenv.releaseCurve = type;\n\t\t\t\texpect(env.releaseCurve).to.equal(type);\n\t\t\t});\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to 'bounce'\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: \"bounce\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: \"bounce\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t},\n\t\t\t\t0.101,\n\t\t\t\t0.7\n\t\t\t);\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to 'ripple'\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: \"ripple\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: \"ripple\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t},\n\t\t\t\t0.101,\n\t\t\t\t0.7\n\t\t\t);\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to 'sine'\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: \"sine\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: \"sine\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t},\n\t\t\t\t0.101,\n\t\t\t\t0.7\n\t\t\t);\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to 'cosine'\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: \"cosine\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: \"cosine\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEachBetween(\n\t\t\t\t(sample) => {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t},\n\t\t\t\t0.101,\n\t\t\t\t0.7\n\t\t\t);\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to 'step'\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: \"step\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: \"step\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time > 0.3 && time < 0.5) {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t} else if (time < 0.1) {\n\t\t\t\t\texpect(sample).to.equal(0);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tit(\"outputs a signal when the attack/release curves are set to an array\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: [0, 1, 0, 1],\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: [1, 0, 1, 0],\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\texpect(env.attackCurve).to.deep.equal([0, 1, 0, 1]);\n\t\t\t\tenv.triggerAttackRelease(0.3, 0.1);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time > 0.4 && time < 0.5) {\n\t\t\t\t\texpect(sample).to.be.above(0);\n\t\t\t\t} else if (time < 0.1) {\n\t\t\t\t\texpect(sample).to.equal(0);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tit(\"can scale a velocity with a custom curve\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.3,\n\t\t\t\t\tattackCurve: [0, 1, 0, 1],\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.3,\n\t\t\t\t\treleaseCurve: [1, 0, 1, 0],\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttackRelease(0.4, 0.1, 0.5);\n\t\t\t}, 0.8);\n\t\t\tbuffer.forEach((sample) => {\n\t\t\t\texpect(sample).to.be.at.most(0.51);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can render the envelope to a curve\", async () => {\n\t\t\tconst env = new Envelope();\n\t\t\tconst curve = await env.asArray();\n\t\t\texpect(curve.some((v) => v > 0)).to.be.true;\n\t\t\tcurve.forEach((v) => expect(v).to.be.within(0, 1));\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"can render the envelope to an array with a given length\", async () => {\n\t\t\tconst env = new Envelope();\n\t\t\tconst curve = await env.asArray(256);\n\t\t\texpect(curve.length).to.equal(256);\n\t\t\tenv.dispose();\n\t\t});\n\n\t\tit(\"can retrigger partial envelope with custom type\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst env = new Envelope({\n\t\t\t\t\tattack: 0.5,\n\t\t\t\t\tattackCurve: \"cosine\",\n\t\t\t\t\tdecay: 0,\n\t\t\t\t\trelease: 0.5,\n\t\t\t\t\treleaseCurve: \"sine\",\n\t\t\t\t\tsustain: 1,\n\t\t\t\t}).toDestination();\n\t\t\t\tenv.triggerAttack(0);\n\t\t\t\tenv.triggerRelease(0.2);\n\t\t\t\tenv.triggerAttack(0.5);\n\t\t\t}, 1);\n\t\t\texpect(buffer.getValueAtTime(0)).to.equal(0);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.32, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.6, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0.53, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.4)).to.be.closeTo(0.38, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.6)).to.be.closeTo(0.52, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.7)).to.be.closeTo(0.78, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.8)).to.be.closeTo(0.95, 0.01);\n\t\t\texpect(buffer.getValueAtTime(0.9)).to.be.closeTo(1, 0.01);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/envelope/Envelope.ts", "content": "import { OfflineContext } from \"../../core/context/OfflineContext.js\";\nimport { InputNode, OutputNode } from \"../../core/context/ToneAudioNode.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { NormalRange, Time } from \"../../core/type/Units.js\";\nimport { assert } from \"../../core/util/Debug.js\";\nimport { range, timeRange } from \"../../core/util/Decorator.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { isArray, isObject, isString } from \"../../core/util/TypeCheck.js\";\nimport {\n\tconnectSignal,\n\tdisconnectSignal,\n\tSignal,\n} from \"../../signal/Signal.js\";\n\ntype BasicEnvelopeCurve = \"linear\" | \"exponential\";\ntype InternalEnvelopeCurve = BasicEnvelopeCurve | number[];\nexport type EnvelopeCurve = EnvelopeCurveName | number[];\n\nexport interface EnvelopeOptions extends ToneAudioNodeOptions {\n\tattack: Time;\n\tdecay: Time;\n\tsustain: NormalRange;\n\trelease: Time;\n\tattackCurve: EnvelopeCurve;\n\treleaseCurve: EnvelopeCurve;\n\tdecayCurve: BasicEnvelopeCurve;\n}\n\n/**\n * Envelope is an [ADSR](https://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope)\n * envelope generator. Envelope outputs a signal which\n * can be connected to an AudioParam or Tone.Signal.\n * ```\n * /\\\n * / \\\n * / \\\n * / \\\n * / \\___________\n * / \\\n * / \\\n * / \\\n * / \\\n * ```\n * @example\n * return Tone.Offline(() => {\n * \tconst env = new Tone.Envelope({\n * \t\tattack: 0.1,\n * \t\tdecay: 0.2,\n * \t\tsustain: 0.5,\n * \t\trelease: 0.8,\n * \t}).toDestination();\n * \tenv.triggerAttackRelease(0.5);\n * }, 1.5, 1);\n * @category Component\n */\nexport class Envelope extends ToneAudioNode {\n\treadonly name: string = \"Envelope\";\n\n\t/**\n\t * When triggerAttack is called, the attack time is the amount of\n\t * time it takes for the envelope to reach its maximum value.\n\t * ```\n\t * /\\\n\t * /X \\\n\t * /XX \\\n\t * /XXX \\\n\t * /XXXX \\___________\n\t * /XXXXX \\\n\t * /XXXXXX \\\n\t * /XXXXXXX \\\n\t * /XXXXXXXX \\\n\t * ```\n\t * @min 0\n\t * @max 2\n\t */\n\t@timeRange(0)\n\tattack: Time;\n\n\t/**\n\t * After the attack portion of the envelope, the value will fall\n\t * over the duration of the decay time to its sustain value.\n\t * ```\n\t * /\\\n\t * / X\\\n\t * / XX\\\n\t * / XXX\\\n\t * / XXXX\\___________\n\t * / XXXXX \\\n\t * / XXXXX \\\n\t * / XXXXX \\\n\t * / XXXXX \\\n\t * ```\n\t * @min 0\n\t * @max 2\n\t */\n\t@timeRange(0)\n\tdecay: Time;\n\n\t/**\n\t * The sustain value is the value\n\t * which the envelope rests at after triggerAttack is\n\t * called, but before triggerRelease is invoked.\n\t * ```\n\t * /\\\n\t * / \\\n\t * / \\\n\t * / \\\n\t * / \\___________\n\t * / XXXXXXXXXXX\\\n\t * / XXXXXXXXXXX \\\n\t * / XXXXXXXXXXX \\\n\t * / XXXXXXXXXXX \\\n\t * ```\n\t */\n\t@range(0, 1)\n\tsustain: NormalRange;\n\n\t/**\n\t * After triggerRelease is called, the envelope's\n\t * value will fall to its minimum value over the\n\t * duration of the release time.\n\t * ```\n\t * /\\\n\t * / \\\n\t * / \\\n\t * / \\\n\t * / \\___________\n\t * / X\\\n\t * / XX\\\n\t * / XXX\\\n\t * / XXXX\\\n\t * ```\n\t * @min 0\n\t * @max 5\n\t */\n\t@timeRange(0)\n\trelease: Time;\n\n\t/**\n\t * The automation curve type for the attack\n\t */\n\tprivate _attackCurve!: InternalEnvelopeCurve;\n\n\t/**\n\t * The automation curve type for the decay\n\t */\n\tprivate _decayCurve!: InternalEnvelopeCurve;\n\n\t/**\n\t * The automation curve type for the release\n\t */\n\tprivate _releaseCurve!: InternalEnvelopeCurve;\n\n\t/**\n\t * the signal which is output.\n\t */\n\tprotected _sig: Signal<\"normalRange\"> = new Signal({\n\t\tcontext: this.context,\n\t\tvalue: 0,\n\t});\n\n\t/**\n\t * The output signal of the envelope\n\t */\n\toutput: OutputNode = this._sig;\n\n\t/**\n\t * Envelope has no input\n\t */\n\tinput: InputNode | undefined = undefined;\n\n\t/**\n\t * @param attack The amount of time it takes for the envelope to go from\n\t * 0 to its maximum value.\n\t * @param decay\tThe period of time after the attack that it takes for the envelope\n\t * \tto fall to the sustain value. Value must be greater than 0.\n\t * @param sustain\tThe percent of the maximum value that the envelope rests at until\n\t * \tthe release is triggered.\n\t * @param release\tThe amount of time after the release is triggered it takes to reach 0.\n\t * \tValue must be greater than 0.\n\t */\n\tconstructor(\n\t\tattack?: Time,\n\t\tdecay?: Time,\n\t\tsustain?: NormalRange,\n\t\trelease?: Time\n\t);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tEnvelope.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"attack\", \"decay\", \"sustain\", \"release\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.attack = options.attack;\n\t\tthis.decay = options.decay;\n\t\tthis.sustain = options.sustain;\n\t\tthis.release = options.release;\n\t\tthis.attackCurve = options.attackCurve;\n\t\tthis.releaseCurve = options.releaseCurve;\n\t\tthis.decayCurve = options.decayCurve;\n\t}\n\n\tstatic getDefaults(): EnvelopeOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tattack: 0.01,\n\t\t\tattackCurve: \"linear\" as EnvelopeCurveName,\n\t\t\tdecay: 0.1,\n\t\t\tdecayCurve: \"exponential\" as BasicEnvelopeCurve,\n\t\t\trelease: 1,\n\t\t\treleaseCurve: \"exponential\" as EnvelopeCurveName,\n\t\t\tsustain: 0.5,\n\t\t});\n\t}\n\n\t/**\n\t * Read the current value of the envelope. Useful for\n\t * synchronizing visual output to the envelope.\n\t */\n\tget value(): NormalRange {\n\t\treturn this.getValueAtTime(this.now());\n\t}\n\n\t/**\n\t * Get the curve\n\t * @param curve\n\t * @param direction In/Out\n\t * @return The curve name\n\t */\n\tprivate _getCurve(\n\t\tcurve: InternalEnvelopeCurve,\n\t\tdirection: EnvelopeDirection\n\t): EnvelopeCurve {\n\t\tif (isString(curve)) {\n\t\t\treturn curve;\n\t\t} else {\n\t\t\t// look up the name in the curves array\n\t\t\tlet curveName: EnvelopeCurveName;\n\t\t\tfor (curveName in EnvelopeCurves) {\n\t\t\t\tif (EnvelopeCurves[curveName][direction] === curve) {\n\t\t\t\t\treturn curveName;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// return the custom curve\n\t\t\treturn curve;\n\t\t}\n\t}\n\n\t/**\n\t * Assign a the curve to the given name using the direction\n\t * @param name\n\t * @param direction In/Out\n\t * @param curve\n\t */\n\tprivate _setCurve(\n\t\tname: \"_attackCurve\" | \"_decayCurve\" | \"_releaseCurve\",\n\t\tdirection: EnvelopeDirection,\n\t\tcurve: EnvelopeCurve\n\t): void {\n\t\t// check if it's a valid type\n\t\tif (isString(curve) && Reflect.has(EnvelopeCurves, curve)) {\n\t\t\tconst curveDef = EnvelopeCurves[curve];\n\t\t\tif (isObject(curveDef)) {\n\t\t\t\tif (name !== \"_decayCurve\") {\n\t\t\t\t\tthis[name] = curveDef[direction];\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tthis[name] = curveDef;\n\t\t\t}\n\t\t} else if (isArray(curve) && name !== \"_decayCurve\") {\n\t\t\tthis[name] = curve;\n\t\t} else {\n\t\t\tthrow new Error(\"Envelope: invalid curve: \" + curve);\n\t\t}\n\t}\n\n\t/**\n\t * The shape of the attack.\n\t * Can be any of these strings:\n\t * * \"linear\"\n\t * * \"exponential\"\n\t * * \"sine\"\n\t * * \"cosine\"\n\t * * \"bounce\"\n\t * * \"ripple\"\n\t * * \"step\"\n\t *\n\t * Can also be an array which describes the curve. Values\n\t * in the array are evenly subdivided and linearly\n\t * interpolated over the duration of the attack.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst env = new Tone.Envelope(0.4).toDestination();\n\t * \tenv.attackCurve = \"linear\";\n\t * \tenv.triggerAttack();\n\t * }, 1, 1);\n\t */\n\tget attackCurve(): EnvelopeCurve {\n\t\treturn this._getCurve(this._attackCurve, \"In\");\n\t}\n\tset attackCurve(curve) {\n\t\tthis._setCurve(\"_attackCurve\", \"In\", curve);\n\t}\n\n\t/**\n\t * The shape of the release. See the attack curve types.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst env = new Tone.Envelope({\n\t * \t\trelease: 0.8\n\t * \t}).toDestination();\n\t * \tenv.triggerAttack();\n\t * \t// release curve could also be defined by an array\n\t * \tenv.releaseCurve = [1, 0.3, 0.4, 0.2, 0.7, 0];\n\t * \tenv.triggerRelease(0.2);\n\t * }, 1, 1);\n\t */\n\tget releaseCurve(): EnvelopeCurve {\n\t\treturn this._getCurve(this._releaseCurve, \"Out\");\n\t}\n\tset releaseCurve(curve) {\n\t\tthis._setCurve(\"_releaseCurve\", \"Out\", curve);\n\t}\n\n\t/**\n\t * The shape of the decay either \"linear\" or \"exponential\"\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst env = new Tone.Envelope({\n\t * \t\tsustain: 0.1,\n\t * \t\tdecay: 0.5\n\t * \t}).toDestination();\n\t * \tenv.decayCurve = \"linear\";\n\t * \tenv.triggerAttack();\n\t * }, 1, 1);\n\t */\n\tget decayCurve(): EnvelopeCurve {\n\t\treturn this._getCurve(this._decayCurve, \"Out\");\n\t}\n\tset decayCurve(curve) {\n\t\tthis._setCurve(\"_decayCurve\", \"Out\", curve);\n\t}\n\n\t/**\n\t * Trigger the attack/decay portion of the ADSR envelope.\n\t * @param time When the attack should start.\n\t * @param velocity The velocity of the envelope scales the vales.\n\t * number between 0-1\n\t * @example\n\t * const env = new Tone.AmplitudeEnvelope().toDestination();\n\t * const osc = new Tone.Oscillator().connect(env).start();\n\t * // trigger the attack 0.5 seconds from now with a velocity of 0.2\n\t * env.triggerAttack(\"+0.5\", 0.2);\n\t */\n\ttriggerAttack(time?: Time, velocity: NormalRange = 1): this {\n\t\tthis.log(\"triggerAttack\", time, velocity);\n\t\ttime = this.toSeconds(time);\n\t\tconst originalAttack = this.toSeconds(this.attack);\n\t\tlet attack = originalAttack;\n\t\tconst decay = this.toSeconds(this.decay);\n\t\t// check if it's not a complete attack\n\t\tconst currentValue = this.getValueAtTime(time);\n\t\tif (currentValue > 0) {\n\t\t\t// subtract the current value from the attack time\n\t\t\tconst attackRate = 1 / attack;\n\t\t\tconst remainingDistance = 1 - currentValue;\n\t\t\t// the attack is now the remaining time\n\t\t\tattack = remainingDistance / attackRate;\n\t\t}\n\t\t// attack\n\t\tif (attack < this.sampleTime) {\n\t\t\tthis._sig.cancelScheduledValues(time);\n\t\t\t// case where the attack time is 0 should set instantly\n\t\t\tthis._sig.setValueAtTime(velocity, time);\n\t\t} else if (this._attackCurve === \"linear\") {\n\t\t\tthis._sig.linearRampTo(velocity, attack, time);\n\t\t} else if (this._attackCurve === \"exponential\") {\n\t\t\tthis._sig.targetRampTo(velocity, attack, time);\n\t\t} else {\n\t\t\tthis._sig.cancelAndHoldAtTime(time);\n\t\t\tlet curve = this._attackCurve;\n\t\t\t// find the starting position in the curve\n\t\t\tfor (let i = 1; i < curve.length; i++) {\n\t\t\t\t// the starting index is between the two values\n\t\t\t\tif (curve[i - 1] <= currentValue && currentValue <= curve[i]) {\n\t\t\t\t\tcurve = this._attackCurve.slice(i);\n\t\t\t\t\t// the first index is the current value\n\t\t\t\t\tcurve[0] = currentValue;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tthis._sig.setValueCurveAtTime(curve, time, attack, velocity);\n\t\t}\n\t\t// decay\n\t\tif (decay && this.sustain < 1) {\n\t\t\tconst decayValue = velocity * this.sustain;\n\t\t\tconst decayStart = time + attack;\n\t\t\tthis.log(\"decay\", decayStart);\n\t\t\tif (this._decayCurve === \"linear\") {\n\t\t\t\tthis._sig.linearRampToValueAtTime(\n\t\t\t\t\tdecayValue,\n\t\t\t\t\tdecay + decayStart\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\tthis._sig.exponentialApproachValueAtTime(\n\t\t\t\t\tdecayValue,\n\t\t\t\t\tdecayStart,\n\t\t\t\t\tdecay\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Triggers the release of the envelope.\n\t * @param time When the release portion of the envelope should start.\n\t * @example\n\t * const env = new Tone.AmplitudeEnvelope().toDestination();\n\t * const osc = new Tone.Oscillator({\n\t * \ttype: \"sawtooth\"\n\t * }).connect(env).start();\n\t * env.triggerAttack();\n\t * // trigger the release half a second after the attack\n\t * env.triggerRelease(\"+0.5\");\n\t */\n\ttriggerRelease(time?: Time): this {\n\t\tthis.log(\"triggerRelease\", time);\n\t\ttime = this.toSeconds(time);\n\t\tconst currentValue = this.getValueAtTime(time);\n\t\tif (currentValue > 0) {\n\t\t\tconst release = this.toSeconds(this.release);\n\t\t\tif (release < this.sampleTime) {\n\t\t\t\tthis._sig.setValueAtTime(0, time);\n\t\t\t} else if (this._releaseCurve === \"linear\") {\n\t\t\t\tthis._sig.linearRampTo(0, release, time);\n\t\t\t} else if (this._releaseCurve === \"exponential\") {\n\t\t\t\tthis._sig.targetRampTo(0, release, time);\n\t\t\t} else {\n\t\t\t\tassert(\n\t\t\t\t\tisArray(this._releaseCurve),\n\t\t\t\t\t\"releaseCurve must be either 'linear', 'exponential' or an array\"\n\t\t\t\t);\n\t\t\t\tthis._sig.cancelAndHoldAtTime(time);\n\t\t\t\tthis._sig.setValueCurveAtTime(\n\t\t\t\t\tthis._releaseCurve,\n\t\t\t\t\ttime,\n\t\t\t\t\trelease,\n\t\t\t\t\tcurrentValue\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the scheduled value at the given time. This will\n\t * return the unconverted (raw) value.\n\t * @example\n\t * const env = new Tone.Envelope(0.5, 1, 0.4, 2);\n\t * env.triggerAttackRelease(2);\n\t * setInterval(() => console.log(env.getValueAtTime(Tone.now())), 100);\n\t */\n\tgetValueAtTime(time: Time): NormalRange {\n\t\treturn this._sig.getValueAtTime(time);\n\t}\n\n\t/**\n\t * triggerAttackRelease is shorthand for triggerAttack, then waiting\n\t * some duration, then triggerRelease.\n\t * @param duration The duration of the sustain.\n\t * @param time When the attack should be triggered.\n\t * @param velocity The velocity of the envelope.\n\t * @example\n\t * const env = new Tone.AmplitudeEnvelope().toDestination();\n\t * const osc = new Tone.Oscillator().connect(env).start();\n\t * // trigger the release 0.5 seconds after the attack\n\t * env.triggerAttackRelease(0.5);\n\t */\n\ttriggerAttackRelease(\n\t\tduration: Time,\n\t\ttime?: Time,\n\t\tvelocity: NormalRange = 1\n\t): this {\n\t\ttime = this.toSeconds(time);\n\t\tthis.triggerAttack(time, velocity);\n\t\tthis.triggerRelease(time + this.toSeconds(duration));\n\t\treturn this;\n\t}\n\n\t/**\n\t * Cancels all scheduled envelope changes after the given time.\n\t */\n\tcancel(after?: Time): this {\n\t\tthis._sig.cancelScheduledValues(this.toSeconds(after));\n\t\treturn this;\n\t}\n\n\t/**\n\t * Connect the envelope to a destination node.\n\t */\n\tconnect(destination: InputNode, outputNumber = 0, inputNumber = 0): this {\n\t\tconnectSignal(this, destination, outputNumber, inputNumber);\n\t\treturn this;\n\t}\n\n\t/** @inheritdoc */\n\tdisconnect(\n\t\tdestination?: InputNode,\n\t\toutputNumber = 0,\n\t\tinputNumber = 0\n\t): this {\n\t\tdisconnectSignal(this, destination, outputNumber, inputNumber);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Render the envelope curve to an array of the given length.\n\t * Good for visualizing the envelope curve. Rescales the duration of the\n\t * envelope to fit the length.\n\t */\n\tasync asArray(length = 1024): Promise {\n\t\tconst duration = length / this.context.sampleRate;\n\t\tconst context = new OfflineContext(\n\t\t\t1,\n\t\t\tduration,\n\t\t\tthis.context.sampleRate\n\t\t);\n\t\t// normalize the ADSR for the given duration with 20% sustain time\n\t\tconst attackPortion =\n\t\t\tthis.toSeconds(this.attack) + this.toSeconds(this.decay);\n\t\tconst envelopeDuration = attackPortion + this.toSeconds(this.release);\n\t\tconst sustainTime = envelopeDuration * 0.1;\n\t\tconst totalDuration = envelopeDuration + sustainTime;\n\t\t// @ts-ignore\n\t\tconst clone = new this.constructor(\n\t\t\tObject.assign(this.get(), {\n\t\t\t\tattack:\n\t\t\t\t\t(duration * this.toSeconds(this.attack)) / totalDuration,\n\t\t\t\tdecay: (duration * this.toSeconds(this.decay)) / totalDuration,\n\t\t\t\trelease:\n\t\t\t\t\t(duration * this.toSeconds(this.release)) / totalDuration,\n\t\t\t\tcontext,\n\t\t\t})\n\t\t) as Envelope;\n\t\tclone._sig.toDestination();\n\t\tclone.triggerAttackRelease(\n\t\t\t(duration * (attackPortion + sustainTime)) / totalDuration,\n\t\t\t0\n\t\t);\n\t\tconst buffer = await context.render();\n\t\treturn buffer.getChannelData(0);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._sig.dispose();\n\t\treturn this;\n\t}\n}\n\ninterface EnvelopeCurveObject {\n\tIn: number[];\n\tOut: number[];\n}\n\ntype EnvelopeDirection = keyof EnvelopeCurveObject;\n\ninterface EnvelopeCurveMap {\n\tlinear: \"linear\";\n\texponential: \"exponential\";\n\tbounce: EnvelopeCurveObject;\n\tcosine: EnvelopeCurveObject;\n\tsine: EnvelopeCurveObject;\n\tripple: EnvelopeCurveObject;\n\tstep: EnvelopeCurveObject;\n}\n\ntype EnvelopeCurveName = keyof EnvelopeCurveMap;\n\n/**\n * Generate some complex envelope curves.\n */\nconst EnvelopeCurves: EnvelopeCurveMap = (() => {\n\tconst curveLen = 128;\n\n\tlet i: number;\n\tlet k: number;\n\n\t// cosine curve\n\tconst cosineCurve: number[] = [];\n\tfor (i = 0; i < curveLen; i++) {\n\t\tcosineCurve[i] = Math.sin((i / (curveLen - 1)) * (Math.PI / 2));\n\t}\n\n\t// ripple curve\n\tconst rippleCurve: number[] = [];\n\tconst rippleCurveFreq = 6.4;\n\tfor (i = 0; i < curveLen - 1; i++) {\n\t\tk = i / (curveLen - 1);\n\t\tconst sineWave =\n\t\t\tMath.sin(k * (Math.PI * 2) * rippleCurveFreq - Math.PI / 2) + 1;\n\t\trippleCurve[i] = sineWave / 10 + k * 0.83;\n\t}\n\trippleCurve[curveLen - 1] = 1;\n\n\t// stairs curve\n\tconst stairsCurve: number[] = [];\n\tconst steps = 5;\n\tfor (i = 0; i < curveLen; i++) {\n\t\tstairsCurve[i] = Math.ceil((i / (curveLen - 1)) * steps) / steps;\n\t}\n\n\t// in-out easing curve\n\tconst sineCurve: number[] = [];\n\tfor (i = 0; i < curveLen; i++) {\n\t\tk = i / (curveLen - 1);\n\t\tsineCurve[i] = 0.5 * (1 - Math.cos(Math.PI * k));\n\t}\n\n\t// a bounce curve\n\tconst bounceCurve: number[] = [];\n\tfor (i = 0; i < curveLen; i++) {\n\t\tk = i / (curveLen - 1);\n\t\tconst freq = Math.pow(k, 3) * 4 + 0.2;\n\t\tconst val = Math.cos(freq * Math.PI * 2 * k);\n\t\tbounceCurve[i] = Math.abs(val * (1 - k));\n\t}\n\n\t/**\n\t * Invert a value curve to make it work for the release\n\t */\n\tfunction invertCurve(curve: number[]): number[] {\n\t\tconst out = new Array(curve.length);\n\t\tfor (let j = 0; j < curve.length; j++) {\n\t\t\tout[j] = 1 - curve[j];\n\t\t}\n\t\treturn out;\n\t}\n\n\t/**\n\t * reverse the curve\n\t */\n\tfunction reverseCurve(curve: number[]): number[] {\n\t\treturn curve.slice(0).reverse();\n\t}\n\n\t/**\n\t * attack and release curve arrays\n\t */\n\treturn {\n\t\tbounce: {\n\t\t\tIn: invertCurve(bounceCurve),\n\t\t\tOut: bounceCurve,\n\t\t},\n\t\tcosine: {\n\t\t\tIn: cosineCurve,\n\t\t\tOut: reverseCurve(cosineCurve),\n\t\t},\n\t\texponential: \"exponential\" as const,\n\t\tlinear: \"linear\" as const,\n\t\tripple: {\n\t\t\tIn: rippleCurve,\n\t\t\tOut: invertCurve(rippleCurve),\n\t\t},\n\t\tsine: {\n\t\t\tIn: sineCurve,\n\t\t\tOut: invertCurve(sineCurve),\n\t\t},\n\t\tstep: {\n\t\t\tIn: stairsCurve,\n\t\t\tOut: invertCurve(stairsCurve),\n\t\t},\n\t};\n})();\n" }, { "path": "Tone/component/envelope/FrequencyEnvelope.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { Envelope } from \"./Envelope.js\";\nimport { FrequencyEnvelope } from \"./FrequencyEnvelope.js\";\n\ndescribe(\"FrequencyEnvelope\", () => {\n\tBasicTests(FrequencyEnvelope);\n\n\tcontext(\"FrequencyEnvelope\", () => {\n\t\tit(\"has an output connections\", () => {\n\t\t\tconst freqEnv = new FrequencyEnvelope();\n\t\t\tfreqEnv.connect(connectTo());\n\t\t\tconnectFrom().connect(freqEnv);\n\t\t\tfreqEnv.dispose();\n\t\t});\n\n\t\tit(\"extends Envelope\", () => {\n\t\t\tconst freqEnv = new FrequencyEnvelope();\n\t\t\texpect(freqEnv).to.be.instanceOf(Envelope);\n\t\t\tfreqEnv.dispose();\n\t\t});\n\n\t\tit(\"can get and set values an Objects\", () => {\n\t\t\tconst freqEnv = new FrequencyEnvelope();\n\t\t\tconst values = {\n\t\t\t\tattack: 0,\n\t\t\t\trelease: \"4n\",\n\t\t\t\tbaseFrequency: 20,\n\t\t\t\toctaves: 4,\n\t\t\t};\n\t\t\tfreqEnv.set(values);\n\t\t\texpect(freqEnv.get()).to.contain.keys(Object.keys(values));\n\t\t\texpect(freqEnv.baseFrequency).to.equal(20);\n\t\t\texpect(freqEnv.octaves).to.equal(4);\n\t\t\tfreqEnv.dispose();\n\t\t});\n\n\t\tit(\"can take parameters as both an object and as arguments\", () => {\n\t\t\tconst env0 = new FrequencyEnvelope({\n\t\t\t\tattack: 0,\n\t\t\t\tdecay: 0.5,\n\t\t\t\tsustain: 1,\n\t\t\t\texponent: 3,\n\t\t\t});\n\t\t\texpect(env0.attack).to.equal(0);\n\t\t\texpect(env0.decay).to.equal(0.5);\n\t\t\texpect(env0.sustain).to.equal(1);\n\t\t\texpect(env0.exponent).to.equal(3);\n\t\t\tenv0.dispose();\n\t\t\tconst env1 = new FrequencyEnvelope(0.1, 0.2, 0.3);\n\t\t\texpect(env1.attack).to.equal(0.1);\n\t\t\texpect(env1.decay).to.equal(0.2);\n\t\t\texpect(env1.sustain).to.equal(0.3);\n\t\t\tenv1.exponent = 2;\n\t\t\texpect(env1.exponent).to.equal(2);\n\t\t\tenv1.dispose();\n\t\t});\n\n\t\tit(\"can set a negative octave\", () => {\n\t\t\tconst freqEnv = new FrequencyEnvelope();\n\t\t\tfreqEnv.octaves = -2;\n\t\t\tfreqEnv.dispose();\n\t\t});\n\n\t\tit(\"goes to the scaled range\", async () => {\n\t\t\tconst e = {\n\t\t\t\tattack: 0.01,\n\t\t\t\tdecay: 0.4,\n\t\t\t\tsustain: 1,\n\t\t\t};\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst freqEnv = new FrequencyEnvelope(\n\t\t\t\t\te.attack,\n\t\t\t\t\te.decay,\n\t\t\t\t\te.sustain\n\t\t\t\t);\n\t\t\t\tfreqEnv.baseFrequency = 200;\n\t\t\t\tfreqEnv.octaves = 3;\n\t\t\t\tfreqEnv.attackCurve = \"exponential\";\n\t\t\t\tfreqEnv.toDestination();\n\t\t\t\tfreqEnv.triggerAttack(0);\n\t\t\t}, 0.3);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\tif (time < e.attack) {\n\t\t\t\t\texpect(sample).to.be.within(200, 1600);\n\t\t\t\t} else if (time < e.attack + e.decay) {\n\t\t\t\t\texpect(sample).to.be.closeTo(1600, 10);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/envelope/FrequencyEnvelope.ts", "content": "import { Frequency, Hertz, NormalRange, Time } from \"../../core/type/Units.js\";\nimport { assertRange } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { Pow } from \"../../signal/Pow.js\";\nimport { Scale } from \"../../signal/Scale.js\";\nimport { Envelope, EnvelopeOptions } from \"./Envelope.js\";\n\nexport interface FrequencyEnvelopeOptions extends EnvelopeOptions {\n\tbaseFrequency: Frequency;\n\toctaves: number;\n\texponent: number;\n}\n/**\n * FrequencyEnvelope is an {@link Envelope} which ramps between {@link baseFrequency}\n * and {@link octaves}. It can also have an optional {@link exponent} to adjust the curve\n * which it ramps.\n * @example\n * const oscillator = new Tone.Oscillator().toDestination().start();\n * const freqEnv = new Tone.FrequencyEnvelope({\n * \tattack: 0.2,\n * \tbaseFrequency: \"C2\",\n * \toctaves: 4\n * });\n * freqEnv.connect(oscillator.frequency);\n * freqEnv.triggerAttack();\n * @category Component\n */\nexport class FrequencyEnvelope extends Envelope {\n\treadonly name: string = \"FrequencyEnvelope\";\n\n\t/**\n\t * Private reference to the base frequency as a number\n\t */\n\tprivate _baseFrequency: Hertz;\n\n\t/**\n\t * The number of octaves\n\t */\n\tprivate _octaves: number;\n\n\t/**\n\t * Internal scaler from 0-1 to the final output range\n\t */\n\tprivate _scale: Scale;\n\n\t/**\n\t * Apply a power curve to the output\n\t */\n\tprivate _exponent: Pow;\n\n\t/**\n\t * @param attack\tthe attack time in seconds\n\t * @param decay\t\tthe decay time in seconds\n\t * @param sustain \ta percentage (0-1) of the full amplitude\n\t * @param release\tthe release time in seconds\n\t */\n\tconstructor(\n\t\tattack?: Time,\n\t\tdecay?: Time,\n\t\tsustain?: NormalRange,\n\t\trelease?: Time\n\t);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tFrequencyEnvelope.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"attack\", \"decay\", \"sustain\", \"release\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._octaves = options.octaves;\n\t\tthis._baseFrequency = this.toFrequency(options.baseFrequency);\n\n\t\tthis._exponent = this.input = new Pow({\n\t\t\tcontext: this.context,\n\t\t\tvalue: options.exponent,\n\t\t});\n\t\tthis._scale = this.output = new Scale({\n\t\t\tcontext: this.context,\n\t\t\tmin: this._baseFrequency,\n\t\t\tmax: this._baseFrequency * Math.pow(2, this._octaves),\n\t\t});\n\t\tthis._sig.chain(this._exponent, this._scale);\n\t}\n\n\tstatic getDefaults(): FrequencyEnvelopeOptions {\n\t\treturn Object.assign(Envelope.getDefaults(), {\n\t\t\tbaseFrequency: 200,\n\t\t\texponent: 1,\n\t\t\toctaves: 4,\n\t\t});\n\t}\n\n\t/**\n\t * The envelope's minimum output value. This is the value which it\n\t * starts at.\n\t */\n\tget baseFrequency(): Frequency {\n\t\treturn this._baseFrequency;\n\t}\n\tset baseFrequency(min) {\n\t\tconst freq = this.toFrequency(min);\n\t\tassertRange(freq, 0);\n\t\tthis._baseFrequency = freq;\n\t\tthis._scale.min = this._baseFrequency;\n\t\t// update the max value when the min changes\n\t\tthis.octaves = this._octaves;\n\t}\n\n\t/**\n\t * The number of octaves above the baseFrequency that the\n\t * envelope will scale to.\n\t */\n\tget octaves(): number {\n\t\treturn this._octaves;\n\t}\n\tset octaves(octaves: number) {\n\t\tthis._octaves = octaves;\n\t\tthis._scale.max = this._baseFrequency * Math.pow(2, octaves);\n\t}\n\n\t/**\n\t * The envelope's exponent value.\n\t */\n\tget exponent(): number {\n\t\treturn this._exponent.value;\n\t}\n\tset exponent(exponent) {\n\t\tthis._exponent.value = exponent;\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._exponent.dispose();\n\t\tthis._scale.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/BiquadFilter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { BiquadFilter } from \"./BiquadFilter.js\";\n\ndescribe(\"BiquadFilter\", () => {\n\tBasicTests(BiquadFilter);\n\n\tcontext(\"BiquadFiltering\", () => {\n\t\tit(\"can be constructed with a arguments\", () => {\n\t\t\tconst filter = new BiquadFilter(200, \"highpass\");\n\t\t\texpect(filter.frequency.value).to.be.closeTo(200, 0.001);\n\t\t\texpect(filter.type).to.equal(\"highpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst filter = new BiquadFilter({\n\t\t\t\tfrequency: 340,\n\t\t\t\ttype: \"bandpass\",\n\t\t\t});\n\t\t\texpect(filter.frequency.value).to.be.closeTo(340, 0.001);\n\t\t\texpect(filter.type).to.equal(\"bandpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can set/get values as an Object\", () => {\n\t\t\tconst filter = new BiquadFilter();\n\t\t\tconst values = {\n\t\t\t\tQ: 2,\n\t\t\t\tfrequency: 440,\n\t\t\t\tgain: -6,\n\t\t\t\ttype: \"lowshelf\" as const,\n\t\t\t};\n\t\t\tfilter.set(values);\n\t\t\texpect(filter.get()).to.include.keys([\n\t\t\t\t\"type\",\n\t\t\t\t\"frequency\",\n\t\t\t\t\"Q\",\n\t\t\t\t\"gain\",\n\t\t\t]);\n\t\t\texpect(filter.type).to.equal(values.type);\n\t\t\texpect(filter.frequency.value).to.equal(values.frequency);\n\t\t\texpect(filter.Q.value).to.equal(values.Q);\n\t\t\texpect(filter.gain.value).to.be.closeTo(values.gain, 0.04);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can get the frequency response curve\", () => {\n\t\t\tconst filter = new BiquadFilter();\n\t\t\tconst curve = filter.getFrequencyResponse(32);\n\t\t\texpect(curve.length).to.equal(32);\n\t\t\texpect(curve[0]).be.closeTo(1, 0.01);\n\t\t\texpect(curve[5]).be.closeTo(0.5, 0.1);\n\t\t\texpect(curve[15]).be.closeTo(0, 0.01);\n\t\t\texpect(curve[31]).be.closeTo(0, 0.01);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst filter = new BiquadFilter().toDestination();\n\t\t\t\tinput.connect(filter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can set the basic filter types\", () => {\n\t\t\tconst filter = new BiquadFilter();\n\t\t\tconst types: BiquadFilterType[] = [\n\t\t\t\t\"lowpass\",\n\t\t\t\t\"highpass\",\n\t\t\t\t\"bandpass\",\n\t\t\t\t\"lowshelf\",\n\t\t\t\t\"highshelf\",\n\t\t\t\t\"notch\",\n\t\t\t\t\"allpass\",\n\t\t\t\t\"peaking\",\n\t\t\t];\n\t\t\tfor (const type of types) {\n\t\t\t\tfilter.type = type;\n\t\t\t\texpect(filter.type).to.equal(type);\n\t\t\t}\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tfilter.type = \"nontype\";\n\t\t\t}).to.throw(Error);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"attenuates the incoming signal\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst filter = new BiquadFilter(700, \"lowpass\").toDestination();\n\t\t\t\tfilter.Q.value = 0;\n\t\t\t\tconst osc = new Oscillator(880).connect(filter);\n\t\t\t\tosc.start(0);\n\t\t\t}, 0.2);\n\t\t\texpect(buffer.getRmsAtTime(0.05)).to.be.within(0.37, 0.53);\n\t\t\texpect(buffer.getRmsAtTime(0.1)).to.be.within(0.37, 0.53);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/BiquadFilter.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Cents, Frequency, GainFactor } from \"../../core/type/Units.js\";\nimport { assert } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\nexport interface BiquadFilterOptions extends ToneAudioNodeOptions {\n\tfrequency: Frequency;\n\tdetune: Cents;\n\tQ: number;\n\ttype: BiquadFilterType;\n\tgain: GainFactor;\n}\n\n/**\n * Thin wrapper around the native Web Audio [BiquadFilterNode](https://webaudio.github.io/web-audio-api/#biquadfilternode).\n * BiquadFilter is similar to {@link Filter} but doesn't have the option to set the \"rolloff\" value.\n * @category Component\n */\nexport class BiquadFilter extends ToneAudioNode {\n\treadonly name: string = \"BiquadFilter\";\n\n\treadonly input: BiquadFilterNode;\n\treadonly output: BiquadFilterNode;\n\n\t/**\n\t * The frequency of the filter\n\t */\n\treadonly frequency: Param<\"frequency\">;\n\n\t/**\n\t * A detune value, in cents, for the frequency.\n\t */\n\treadonly detune: Param<\"cents\">;\n\n\t/**\n\t * The Q factor of the filter.\n\t * For lowpass and highpass filters the Q value is interpreted to be in dB.\n\t * For these filters the nominal range is [−𝑄𝑙𝑖𝑚,𝑄𝑙𝑖𝑚] where 𝑄𝑙𝑖𝑚 is the largest value for which 10𝑄/20 does not overflow. This is approximately 770.63678.\n\t * For the bandpass, notch, allpass, and peaking filters, this value is a linear value.\n\t * The value is related to the bandwidth of the filter and hence should be a positive value. The nominal range is\n\t * [0,3.4028235𝑒38], the upper limit being the most-positive-single-float.\n\t * This is not used for the lowshelf and highshelf filters.\n\t */\n\treadonly Q: Param<\"number\">;\n\n\t/**\n\t * The gain of the filter. Its value is in dB units. The gain is only used for lowshelf, highshelf, and peaking filters.\n\t */\n\treadonly gain: Param<\"decibels\">;\n\n\tprivate readonly _filter: BiquadFilterNode;\n\n\t/**\n\t * @param frequency The cutoff frequency of the filter.\n\t * @param type The type of filter.\n\t */\n\tconstructor(frequency?: Frequency, type?: BiquadFilterType);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tBiquadFilter.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"frequency\", \"type\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._filter = this.context.createBiquadFilter();\n\t\tthis.input = this.output = this._filter;\n\n\t\tthis.Q = new Param({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"number\",\n\t\t\tvalue: options.Q,\n\t\t\tparam: this._filter.Q,\n\t\t});\n\n\t\tthis.frequency = new Param({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"frequency\",\n\t\t\tvalue: options.frequency,\n\t\t\tparam: this._filter.frequency,\n\t\t});\n\n\t\tthis.detune = new Param({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"cents\",\n\t\t\tvalue: options.detune,\n\t\t\tparam: this._filter.detune,\n\t\t});\n\n\t\tthis.gain = new Param({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"decibels\",\n\t\t\tconvert: false,\n\t\t\tvalue: options.gain,\n\t\t\tparam: this._filter.gain,\n\t\t});\n\n\t\tthis.type = options.type;\n\t}\n\n\tstatic getDefaults(): BiquadFilterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tQ: 1,\n\t\t\ttype: \"lowpass\" as const,\n\t\t\tfrequency: 350,\n\t\t\tdetune: 0,\n\t\t\tgain: 0,\n\t\t});\n\t}\n\n\t/**\n\t * The type of this BiquadFilterNode. For a complete list of types and their attributes, see the\n\t * [Web Audio API](https://webaudio.github.io/web-audio-api/#dom-biquadfiltertype-lowpass)\n\t */\n\tget type(): BiquadFilterType {\n\t\treturn this._filter.type;\n\t}\n\tset type(type) {\n\t\tconst types: BiquadFilterType[] = [\n\t\t\t\"lowpass\",\n\t\t\t\"highpass\",\n\t\t\t\"bandpass\",\n\t\t\t\"lowshelf\",\n\t\t\t\"highshelf\",\n\t\t\t\"notch\",\n\t\t\t\"allpass\",\n\t\t\t\"peaking\",\n\t\t];\n\t\tassert(types.indexOf(type) !== -1, `Invalid filter type: ${type}`);\n\t\tthis._filter.type = type;\n\t}\n\n\t/**\n\t * Get the frequency response curve. This curve represents how the filter\n\t * responses to frequencies between 20hz-20khz.\n\t * @param len The number of values to return\n\t * @return The frequency response curve between 20-20kHz\n\t */\n\tgetFrequencyResponse(len = 128): Float32Array {\n\t\t// start with all 1s\n\t\tconst freqValues = new Float32Array(len);\n\t\tfor (let i = 0; i < len; i++) {\n\t\t\tconst norm = Math.pow(i / len, 2);\n\t\t\tconst freq = norm * (20000 - 20) + 20;\n\t\t\tfreqValues[i] = freq;\n\t\t}\n\t\tconst magValues = new Float32Array(len);\n\t\tconst phaseValues = new Float32Array(len);\n\t\t// clone the filter to remove any connections which may be changing the value\n\t\tconst filterClone = this.context.createBiquadFilter();\n\t\tfilterClone.type = this.type;\n\t\tfilterClone.Q.value = this.Q.value;\n\t\tfilterClone.frequency.value = this.frequency.value as number;\n\t\tfilterClone.gain.value = this.gain.value as number;\n\t\tfilterClone.getFrequencyResponse(freqValues, magValues, phaseValues);\n\t\treturn magValues;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._filter.disconnect();\n\t\tthis.Q.dispose();\n\t\tthis.frequency.dispose();\n\t\tthis.gain.dispose();\n\t\tthis.detune.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/Convolver.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { ToneAudioBuffer } from \"../../core/context/ToneAudioBuffer.js\";\nimport { Convolver } from \"./Convolver.js\";\n\ndescribe(\"Convolver\", () => {\n\tBasicTests(Convolver);\n\n\tconst ir = new ToneAudioBuffer();\n\n\tconst testFile = \"./test/audio/sineStereo.wav\";\n\n\tbefore(() => {\n\t\treturn ir.load(testFile);\n\t});\n\n\tcontext(\"API\", () => {\n\t\tit(\"can pass in options in the constructor\", () => {\n\t\t\tconst convolver = new Convolver({\n\t\t\t\tnormalize: false,\n\t\t\t\turl: testFile,\n\t\t\t});\n\t\t\texpect(convolver.normalize).to.be.false;\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"can get set normalize\", () => {\n\t\t\tconst convolver = new Convolver();\n\t\t\tconvolver.normalize = false;\n\t\t\texpect(convolver.normalize).to.be.false;\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"invokes the onload function when loaded\", (done) => {\n\t\t\tconst convolver = new Convolver({\n\t\t\t\turl: testFile,\n\t\t\t\tonload(): void {\n\t\t\t\t\tconvolver.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t});\n\t\t});\n\n\t\tit(\"load returns a Promise\", async () => {\n\t\t\tconst convolver = new Convolver();\n\t\t\tawait convolver.load(testFile);\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"load invokes the second callback\", async () => {\n\t\t\tconst convolver = new Convolver();\n\t\t\tawait convolver.load(testFile);\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"can assign the buffer twice\", () => {\n\t\t\tconst convolver = new Convolver(ir);\n\t\t\tconvolver.buffer = ir;\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with a buffer\", () => {\n\t\t\tconst convolver = new Convolver(ir);\n\t\t\texpect((convolver.buffer as ToneAudioBuffer).get()).to.equal(\n\t\t\t\tir.get()\n\t\t\t);\n\t\t\tconvolver.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with loaded buffer\", (done) => {\n\t\t\tconst buffer = new ToneAudioBuffer({\n\t\t\t\turl: testFile,\n\t\t\t\tonload(): void {\n\t\t\t\t\tconst convolver = new Convolver(buffer);\n\t\t\t\t\texpect(convolver.buffer).is.not.null;\n\t\t\t\t\tbuffer.dispose();\n\t\t\t\t\tconvolver.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be constructed with unloaded buffer\", (done) => {\n\t\t\tconst convolver = new Convolver({\n\t\t\t\turl: new ToneAudioBuffer({\n\t\t\t\t\turl: testFile,\n\t\t\t\t}),\n\t\t\t\tonload(): void {\n\t\t\t\t\texpect(convolver.buffer).is.not.null;\n\t\t\t\t\tconvolver.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t});\n\t\t\t// is null before then\n\t\t\texpect(convolver.buffer).to.be.null;\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/Convolver.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { ToneAudioBuffer } from \"../../core/context/ToneAudioBuffer.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { noOp } from \"../../core/util/Interface.js\";\n\nexport interface ConvolverOptions extends ToneAudioNodeOptions {\n\tonload: () => void;\n\tnormalize: boolean;\n\turl?: string | AudioBuffer | ToneAudioBuffer;\n}\n\n/**\n * Convolver is a wrapper around the Native Web Audio\n * [ConvolverNode](http://webaudio.github.io/web-audio-api/#the-convolvernode-interface).\n * Convolution is useful for reverb and filter emulation. Read more about convolution reverb on\n * [Wikipedia](https://en.wikipedia.org/wiki/Convolution_reverb).\n *\n * @example\n * // initializing the convolver with an impulse response\n * const convolver = new Tone.Convolver(\"./path/to/ir.wav\").toDestination();\n * @category Component\n */\nexport class Convolver extends ToneAudioNode {\n\treadonly name: string = \"Convolver\";\n\n\t/**\n\t * The native ConvolverNode\n\t */\n\tprivate _convolver: ConvolverNode = this.context.createConvolver();\n\n\t/**\n\t * The Buffer belonging to the convolver\n\t */\n\tprivate _buffer: ToneAudioBuffer;\n\n\treadonly input: Gain;\n\treadonly output: Gain;\n\n\t/**\n\t * @param url The URL of the impulse response or the ToneAudioBuffer containing the impulse response.\n\t * @param onload The callback to invoke when the url is loaded.\n\t */\n\tconstructor(\n\t\turl?: string | AudioBuffer | ToneAudioBuffer,\n\t\tonload?: () => void\n\t);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tConvolver.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"url\", \"onload\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._buffer = new ToneAudioBuffer(options.url, (buffer) => {\n\t\t\tthis.buffer = buffer;\n\t\t\toptions.onload();\n\t\t});\n\n\t\tthis.input = new Gain({ context: this.context });\n\t\tthis.output = new Gain({ context: this.context });\n\n\t\t// set if it's already loaded, set it immediately\n\t\tif (this._buffer.loaded) {\n\t\t\tthis.buffer = this._buffer;\n\t\t}\n\n\t\t// initially set normalization\n\t\tthis.normalize = options.normalize;\n\n\t\t// connect it up\n\t\tthis.input.chain(this._convolver, this.output);\n\t}\n\n\tstatic getDefaults(): ConvolverOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tnormalize: true,\n\t\t\tonload: noOp,\n\t\t});\n\t}\n\n\t/**\n\t * Load an impulse response url as an audio buffer.\n\t * Decodes the audio asynchronously and invokes\n\t * the callback once the audio buffer loads.\n\t * @param url The url of the buffer to load. filetype support depends on the browser.\n\t */\n\tasync load(url: string): Promise {\n\t\tthis.buffer = await this._buffer.load(url);\n\t}\n\n\t/**\n\t * The convolver's buffer\n\t */\n\tget buffer(): ToneAudioBuffer | null {\n\t\tif (this._buffer.length) {\n\t\t\treturn this._buffer;\n\t\t} else {\n\t\t\treturn null;\n\t\t}\n\t}\n\tset buffer(buffer) {\n\t\tif (buffer) {\n\t\t\tthis._buffer.set(buffer);\n\t\t}\n\t\t// if it's already got a buffer, create a new one\n\t\tif (this._convolver.buffer) {\n\t\t\t// disconnect the old one\n\t\t\tthis.input.disconnect();\n\t\t\tthis._convolver.disconnect();\n\t\t\t// create and connect a new one\n\t\t\tthis._convolver = this.context.createConvolver();\n\t\t\tthis.input.chain(this._convolver, this.output);\n\t\t}\n\t\tconst buff = this._buffer.get();\n\t\tthis._convolver.buffer = buff ? buff : null;\n\t}\n\n\t/**\n\t * The normalize property of the ConvolverNode interface is a boolean that\n\t * controls whether the impulse response from the buffer will be scaled by\n\t * an equal-power normalization when the buffer attribute is set, or not.\n\t */\n\tget normalize(): boolean {\n\t\treturn this._convolver.normalize;\n\t}\n\tset normalize(norm) {\n\t\tthis._convolver.normalize = norm;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._buffer.dispose();\n\t\tthis._convolver.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/EQ3.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { EQ3 } from \"./EQ3.js\";\n\ndescribe(\"EQ3\", () => {\n\tBasicTests(EQ3);\n\n\tcontext(\"EQing\", () => {\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst eq3 = new EQ3({\n\t\t\t\thigh: -10,\n\t\t\t\thighFrequency: 2700,\n\t\t\t\tlow: -8,\n\t\t\t\tlowFrequency: 500,\n\t\t\t\tmid: -9,\n\t\t\t});\n\t\t\texpect(eq3.low.value).to.be.closeTo(-8, 0.1);\n\t\t\texpect(eq3.mid.value).to.be.closeTo(-9, 0.1);\n\t\t\texpect(eq3.high.value).to.be.closeTo(-10, 0.1);\n\t\t\texpect(eq3.lowFrequency.value).to.be.closeTo(500, 0.01);\n\t\t\texpect(eq3.highFrequency.value).to.be.closeTo(2700, 0.01);\n\t\t\teq3.dispose();\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst eq3 = new EQ3();\n\t\t\teq3.set({\n\t\t\t\thigh: -4,\n\t\t\t\tlowFrequency: 250,\n\t\t\t});\n\t\t\texpect(eq3.get().high).to.be.closeTo(-4, 0.1);\n\t\t\texpect(eq3.get().lowFrequency).to.be.closeTo(250, 0.01);\n\t\t\teq3.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst eq3 = new EQ3({\n\t\t\t\t\thigh: 12,\n\t\t\t\t\tlow: -20,\n\t\t\t\t}).toDestination();\n\t\t\t\tinput.connect(eq3);\n\t\t\t});\n\t\t});\n\n\t\tit.skip(\"passes the incoming stereo signal through\", () => {\n\t\t\t// return PassAudioStereo(function(input){\n\t\t\t// \tvar eq3 = new EQ3({\n\t\t\t// \t\t\"mid\" : -2,\n\t\t\t// \t\t\"high\" : 2\n\t\t\t// \t}).toDestination();\n\t\t\t// \tinput.connect(eq3);\n\t\t\t// });\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/EQ3.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { Param } from \"../../core/context/Param.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Decibels, Frequency } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, writable } from \"../../core/util/Interface.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { MultibandSplit } from \"../channel/MultibandSplit.js\";\n\ninterface EQ3Options extends ToneAudioNodeOptions {\n\tlow: Decibels;\n\tmid: Decibels;\n\thigh: Decibels;\n\tlowFrequency: Frequency;\n\thighFrequency: Frequency;\n}\n\n/**\n * EQ3 provides 3 equalizer bins: Low/Mid/High.\n * @category Component\n */\nexport class EQ3 extends ToneAudioNode {\n\treadonly name: string = \"EQ3\";\n\n\t/**\n\t * the input\n\t */\n\treadonly input: MultibandSplit;\n\n\t/**\n\t * the output\n\t */\n\treadonly output = new Gain({ context: this.context });\n\n\t/**\n\t * Splits the input into three outputs\n\t */\n\tprivate _multibandSplit: MultibandSplit;\n\n\t/**\n\t * The gain for the lower signals\n\t */\n\tprivate _lowGain: Gain<\"decibels\">;\n\n\t/**\n\t * The gain for the mid signals\n\t */\n\tprivate _midGain: Gain<\"decibels\">;\n\n\t/**\n\t * The gain for the high signals\n\t */\n\tprivate _highGain: Gain<\"decibels\">;\n\n\t/**\n\t * The gain in decibels of the low part\n\t */\n\treadonly low: Param<\"decibels\">;\n\n\t/**\n\t * The gain in decibels of the mid part\n\t */\n\treadonly mid: Param<\"decibels\">;\n\n\t/**\n\t * The gain in decibels of the high part\n\t */\n\treadonly high: Param<\"decibels\">;\n\n\t/**\n\t * The Q value for all of the filters.\n\t */\n\treadonly Q: Signal<\"positive\">;\n\n\t/**\n\t * The low/mid crossover frequency.\n\t */\n\treadonly lowFrequency: Signal<\"frequency\">;\n\n\t/**\n\t * The mid/high crossover frequency.\n\t */\n\treadonly highFrequency: Signal<\"frequency\">;\n\n\tprotected _internalChannels: ToneAudioNode[] = [];\n\n\tconstructor(lowLevel?: Decibels, midLevel?: Decibels, highLevel?: Decibels);\n\tconstructor(options: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(EQ3.getDefaults(), arguments, [\n\t\t\t\"low\",\n\t\t\t\"mid\",\n\t\t\t\"high\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.input = this._multibandSplit = new MultibandSplit({\n\t\t\tcontext: this.context,\n\t\t\thighFrequency: options.highFrequency,\n\t\t\tlowFrequency: options.lowFrequency,\n\t\t});\n\n\t\tthis._lowGain = new Gain({\n\t\t\tcontext: this.context,\n\t\t\tgain: options.low,\n\t\t\tunits: \"decibels\",\n\t\t});\n\n\t\tthis._midGain = new Gain({\n\t\t\tcontext: this.context,\n\t\t\tgain: options.mid,\n\t\t\tunits: \"decibels\",\n\t\t});\n\n\t\tthis._highGain = new Gain({\n\t\t\tcontext: this.context,\n\t\t\tgain: options.high,\n\t\t\tunits: \"decibels\",\n\t\t});\n\n\t\tthis.low = this._lowGain.gain;\n\t\tthis.mid = this._midGain.gain;\n\t\tthis.high = this._highGain.gain;\n\t\tthis.Q = this._multibandSplit.Q;\n\t\tthis.lowFrequency = this._multibandSplit.lowFrequency;\n\t\tthis.highFrequency = this._multibandSplit.highFrequency;\n\n\t\t// the frequency bands\n\t\tthis._multibandSplit.low.chain(this._lowGain, this.output);\n\t\tthis._multibandSplit.mid.chain(this._midGain, this.output);\n\t\tthis._multibandSplit.high.chain(this._highGain, this.output);\n\n\t\treadOnly(this, [\"low\", \"mid\", \"high\", \"lowFrequency\", \"highFrequency\"]);\n\t\tthis._internalChannels = [this._multibandSplit];\n\t}\n\n\tstatic getDefaults(): EQ3Options {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\thigh: 0,\n\t\t\thighFrequency: 2500,\n\t\t\tlow: 0,\n\t\t\tlowFrequency: 400,\n\t\t\tmid: 0,\n\t\t});\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\twritable(this, [\"low\", \"mid\", \"high\", \"lowFrequency\", \"highFrequency\"]);\n\t\tthis._multibandSplit.dispose();\n\t\tthis.lowFrequency.dispose();\n\t\tthis.highFrequency.dispose();\n\t\tthis._lowGain.dispose();\n\t\tthis._midGain.dispose();\n\t\tthis._highGain.dispose();\n\t\tthis.low.dispose();\n\t\tthis.mid.dispose();\n\t\tthis.high.dispose();\n\t\tthis.Q.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/FeedbackCombFilter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { BitCrusher } from \"../../effect/BitCrusher.js\";\nimport { Signal } from \"../../signal/index.js\";\nimport { FeedbackCombFilter } from \"./FeedbackCombFilter.js\";\n\ndescribe(\"FeedbackCombFilter\", () => {\n\tBasicTests(FeedbackCombFilter);\n\n\tcontext(\"Comb Filtering\", () => {\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst fbcf = new FeedbackCombFilter({\n\t\t\t\tdelayTime: 0.2,\n\t\t\t\tresonance: 0.3,\n\t\t\t});\n\t\t\texpect(fbcf.delayTime.value).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(fbcf.resonance.value).to.be.closeTo(0.3, 0.001);\n\t\t\tfbcf.dispose();\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst fbcf = new FeedbackCombFilter();\n\t\t\tfbcf.set({\n\t\t\t\tdelayTime: 0.2,\n\t\t\t\tresonance: 0.3,\n\t\t\t});\n\t\t\tconst values = fbcf.get();\n\t\t\texpect(values.delayTime).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(values.resonance).to.be.closeTo(0.3, 0.001);\n\t\t\tfbcf.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst fbcf = new FeedbackCombFilter({\n\t\t\t\t\tdelayTime: 0.0,\n\t\t\t\t\tresonance: 0,\n\t\t\t\t}).toDestination();\n\t\t\t\tinput.connect(fbcf);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can delay by the delayTime\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst fbcf = new FeedbackCombFilter({\n\t\t\t\t\tdelayTime: 0.1,\n\t\t\t\t\tresonance: 0,\n\t\t\t\t}).toDestination();\n\t\t\t\tconst sig = new Signal(0).connect(fbcf);\n\t\t\t\tsig.setValueAtTime(1, 0);\n\t\t\t}, 0.2);\n\t\t\texpect(buffer.getValueAtTime(0)).to.equal(0);\n\t\t\texpect(buffer.getValueAtTime(0.999)).to.equal(0);\n\t\t\texpect(buffer.getValueAtTime(0.101)).to.equal(1);\n\t\t\texpect(buffer.getValueAtTime(0.15)).to.equal(1);\n\t\t});\n\n\t\tit(\"can delay with feedback\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst fbcf = new FeedbackCombFilter({\n\t\t\t\t\tdelayTime: 0.1,\n\t\t\t\t\tresonance: 0.5,\n\t\t\t\t}).toDestination();\n\t\t\t\tconst sig = new Signal(0).connect(fbcf);\n\t\t\t\tsig.setValueAtTime(1, 0);\n\t\t\t\tsig.setValueAtTime(0, 0.1);\n\t\t\t}, 0.4);\n\t\t\texpect(buffer.getValueAtTime(0)).to.equal(0);\n\t\t\texpect(buffer.getValueAtTime(0.101)).to.equal(1);\n\t\t\texpect(buffer.getValueAtTime(0.201)).to.equal(0.5);\n\t\t\texpect(buffer.getValueAtTime(0.301)).to.equal(0.25);\n\t\t});\n\t});\n\n\tit(\"should be usable with the BitCrusher\", (done) => {\n\t\tnew FeedbackCombFilter();\n\t\tnew BitCrusher(4);\n\n\t\tconst handle = setTimeout(() => {\n\t\t\twindow.onunhandledrejection = null;\n\t\t\tdone();\n\t\t}, 100);\n\n\t\twindow.onunhandledrejection = (event) => {\n\t\t\tdone(event.reason);\n\t\t\tclearTimeout(handle);\n\t\t};\n\t});\n});\n" }, { "path": "Tone/component/filter/FeedbackCombFilter.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport { Param } from \"../../core/context/Param.js\";\nimport {\n\tconnectSeries,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { NormalRange, Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, RecursivePartial } from \"../../core/util/Interface.js\";\nimport { ToneAudioWorklet } from \"../../core/worklet/ToneAudioWorklet.js\";\nimport { workletName } from \"./FeedbackCombFilter.worklet.js\";\n\nexport interface FeedbackCombFilterOptions extends ToneAudioNodeOptions {\n\tdelayTime: Time;\n\tresonance: NormalRange;\n}\n\n/**\n * Comb filters are basic building blocks for physical modeling. Read more\n * about comb filters on [CCRMA's website](https://ccrma.stanford.edu/~jos/pasp/Feedback_Comb_Filters.html).\n *\n * This comb filter is implemented with the AudioWorkletNode which allows it to have feedback delays less than the\n * Web Audio processing block of 128 samples. There is a polyfill for browsers that don't yet support the\n * AudioWorkletNode, but it will add some latency and have slower performance than the AudioWorkletNode.\n * @category Component\n */\nexport class FeedbackCombFilter extends ToneAudioWorklet {\n\treadonly name = \"FeedbackCombFilter\";\n\n\t/**\n\t * The amount of delay of the comb filter.\n\t */\n\treadonly delayTime: Param<\"time\">;\n\n\t/**\n\t * The amount of feedback of the delayed signal.\n\t */\n\treadonly resonance: Param<\"normalRange\">;\n\n\treadonly input: Gain;\n\treadonly output: Gain;\n\n\t/**\n\t * @param delayTime The delay time of the filter.\n\t * @param resonance The amount of feedback the filter has.\n\t */\n\tconstructor(delayTime?: Time, resonance?: NormalRange);\n\tconstructor(options?: RecursivePartial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tFeedbackCombFilter.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"delayTime\", \"resonance\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.input = new Gain({ context: this.context });\n\t\tthis.output = new Gain({ context: this.context });\n\n\t\tthis.delayTime = new Param<\"time\">({\n\t\t\tcontext: this.context,\n\t\t\tvalue: options.delayTime,\n\t\t\tunits: \"time\",\n\t\t\tminValue: 0,\n\t\t\tmaxValue: 1,\n\t\t\tparam: this._dummyParam,\n\t\t\tswappable: true,\n\t\t});\n\n\t\tthis.resonance = new Param<\"normalRange\">({\n\t\t\tcontext: this.context,\n\t\t\tvalue: options.resonance,\n\t\t\tunits: \"normalRange\",\n\t\t\tparam: this._dummyParam,\n\t\t\tswappable: true,\n\t\t});\n\n\t\treadOnly(this, [\"resonance\", \"delayTime\"]);\n\t}\n\n\tprotected _audioWorkletName(): string {\n\t\treturn workletName;\n\t}\n\n\t/**\n\t * The default parameters\n\t */\n\tstatic getDefaults(): FeedbackCombFilterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tdelayTime: 0.1,\n\t\t\tresonance: 0.5,\n\t\t});\n\t}\n\n\tonReady(node: AudioWorkletNode) {\n\t\tconnectSeries(this.input, node, this.output);\n\t\tconst delayTime = node.parameters.get(\"delayTime\") as AudioParam;\n\t\tthis.delayTime.setParam(delayTime);\n\t\tconst feedback = node.parameters.get(\"feedback\") as AudioParam;\n\t\tthis.resonance.setParam(feedback);\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis.output.dispose();\n\t\tthis.delayTime.dispose();\n\t\tthis.resonance.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/FeedbackCombFilter.worklet.ts", "content": "import \"../../core/worklet/SingleIOProcessor.worklet.js\";\nimport \"../../core/worklet/DelayLine.worklet.js\";\n\nimport { registerProcessor } from \"../../core/worklet/WorkletGlobalScope.js\";\n\nexport const workletName = \"feedback-comb-filter\";\n\nconst feedbackCombFilter = /* javascript */ `\n\tclass FeedbackCombFilterWorklet extends SingleIOProcessor {\n\n\t\tconstructor(options) {\n\t\t\tsuper(options);\n\t\t\tthis.delayLine = new DelayLine(this.sampleRate, options.channelCount || 2);\n\t\t}\n\n\t\tstatic get parameterDescriptors() {\n\t\t\treturn [{\n\t\t\t\tname: \"delayTime\",\n\t\t\t\tdefaultValue: 0.1,\n\t\t\t\tminValue: 0,\n\t\t\t\tmaxValue: 1,\n\t\t\t\tautomationRate: \"k-rate\"\n\t\t\t}, {\n\t\t\t\tname: \"feedback\",\n\t\t\t\tdefaultValue: 0.5,\n\t\t\t\tminValue: 0,\n\t\t\t\tmaxValue: 0.9999,\n\t\t\t\tautomationRate: \"k-rate\"\n\t\t\t}];\n\t\t}\n\n\t\tgenerate(input, channel, parameters) {\n\t\t\tconst delayedSample = this.delayLine.get(channel, parameters.delayTime * this.sampleRate);\n\t\t\tthis.delayLine.push(channel, input + delayedSample * parameters.feedback);\n\t\t\treturn delayedSample;\n\t\t}\n\t}\n`;\n\nregisterProcessor(workletName, feedbackCombFilter);\n" }, { "path": "Tone/component/filter/Filter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { Filter, FilterRollOff } from \"./Filter.js\";\n\ndescribe(\"Filter\", () => {\n\tBasicTests(Filter);\n\n\tcontext(\"Filtering\", () => {\n\t\tit(\"can be constructed with a arguments\", () => {\n\t\t\tconst filter = new Filter(200, \"highpass\");\n\t\t\texpect(filter.frequency.value).to.be.closeTo(200, 0.001);\n\t\t\texpect(filter.type).to.equal(\"highpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst filter = new Filter({\n\t\t\t\tfrequency: 340,\n\t\t\t\ttype: \"bandpass\",\n\t\t\t});\n\t\t\texpect(filter.frequency.value).to.be.closeTo(340, 0.001);\n\t\t\texpect(filter.type).to.equal(\"bandpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can set/get values as an Object\", () => {\n\t\t\tconst filter = new Filter();\n\t\t\tconst values = {\n\t\t\t\tQ: 2,\n\t\t\t\tfrequency: 440,\n\t\t\t\tgain: -6,\n\t\t\t\trolloff: -24 as FilterRollOff,\n\t\t\t\ttype: \"highpass\" as BiquadFilterType,\n\t\t\t};\n\t\t\tfilter.set(values);\n\t\t\texpect(filter.get()).to.include.keys([\n\t\t\t\t\"type\",\n\t\t\t\t\"frequency\",\n\t\t\t\t\"rolloff\",\n\t\t\t\t\"Q\",\n\t\t\t\t\"gain\",\n\t\t\t]);\n\t\t\texpect(filter.type).to.equal(values.type);\n\t\t\texpect(filter.frequency.value).to.equal(values.frequency);\n\t\t\texpect(filter.rolloff).to.equal(values.rolloff);\n\t\t\texpect(filter.Q.value).to.equal(values.Q);\n\t\t\texpect(filter.gain.value).to.be.closeTo(values.gain, 0.04);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can get the frequency response curve\", () => {\n\t\t\tconst filter = new Filter();\n\t\t\tconst curve = filter.getFrequencyResponse(32);\n\t\t\texpect(curve.length).to.equal(32);\n\t\t\texpect(curve[0]).be.closeTo(1, 0.01);\n\t\t\texpect(curve[5]).be.closeTo(0.5, 0.1);\n\t\t\texpect(curve[15]).be.closeTo(0, 0.01);\n\t\t\texpect(curve[31]).be.closeTo(0, 0.01);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst filter = new Filter().toDestination();\n\t\t\t\tinput.connect(filter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"only accepts filter values -12, -24, -48 and -96\", () => {\n\t\t\tconst filter = new Filter();\n\t\t\tfilter.rolloff = -12;\n\t\t\texpect(filter.rolloff).to.equal(-12);\n\t\t\t// @ts-ignore\n\t\t\tfilter.rolloff = \"-24\";\n\t\t\texpect(filter.rolloff).to.equal(-24);\n\t\t\tfilter.rolloff = -48;\n\t\t\texpect(filter.rolloff).to.equal(-48);\n\t\t\tfilter.rolloff = -96;\n\t\t\texpect(filter.rolloff).to.equal(-96);\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tfilter.rolloff = -95;\n\t\t\t}).to.throw(Error);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can set the basic filter types\", () => {\n\t\t\tconst filter = new Filter();\n\t\t\tconst types: BiquadFilterType[] = [\n\t\t\t\t\"lowpass\",\n\t\t\t\t\"highpass\",\n\t\t\t\t\"bandpass\",\n\t\t\t\t\"lowshelf\",\n\t\t\t\t\"highshelf\",\n\t\t\t\t\"notch\",\n\t\t\t\t\"allpass\",\n\t\t\t\t\"peaking\",\n\t\t\t];\n\t\t\tfor (const type of types) {\n\t\t\t\tfilter.type = type;\n\t\t\t\texpect(filter.type).to.equal(type);\n\t\t\t}\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\tfilter.type = \"nontype\";\n\t\t\t}).to.throw(Error);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"attenuates the incoming signal\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst filter = new Filter(700, \"lowpass\").toDestination();\n\t\t\t\tfilter.Q.value = 0;\n\t\t\t\tconst osc = new Oscillator(880).connect(filter);\n\t\t\t\tosc.start(0);\n\t\t\t}, 0.2);\n\t\t\texpect(buffer.getRmsAtTime(0.05)).to.be.within(0.37, 0.53);\n\t\t\texpect(buffer.getRmsAtTime(0.1)).to.be.within(0.37, 0.53);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/Filter.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tconnectSeries,\n\tToneAudioNode,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Frequency } from \"../../core/type/Units.js\";\nimport { assert } from \"../../core/util/Debug.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { readOnly, writable } from \"../../core/util/Interface.js\";\nimport { isNumber } from \"../../core/util/TypeCheck.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { BiquadFilter, BiquadFilterOptions } from \"./BiquadFilter.js\";\n\nexport type FilterRollOff = -12 | -24 | -48 | -96;\n\nexport type FilterOptions = BiquadFilterOptions & {\n\trolloff: FilterRollOff;\n};\n\n/**\n * Tone.Filter is a filter which allows for all of the same native methods\n * as the [BiquadFilterNode](http://webaudio.github.io/web-audio-api/#the-biquadfilternode-interface).\n * Tone.Filter has the added ability to set the filter rolloff at -12\n * (default), -24 and -48.\n * @example\n * const filter = new Tone.Filter(1500, \"highpass\").toDestination();\n * filter.frequency.rampTo(20000, 10);\n * const noise = new Tone.Noise().connect(filter).start();\n * @category Component\n */\nexport class Filter extends ToneAudioNode {\n\treadonly name: string = \"Filter\";\n\n\treadonly input = new Gain({ context: this.context });\n\treadonly output = new Gain({ context: this.context });\n\tprivate _filters: BiquadFilter[] = [];\n\n\t/**\n\t * the rolloff value of the filter\n\t */\n\tprivate _rolloff!: FilterRollOff;\n\tprivate _type: BiquadFilterType;\n\n\t/**\n\t * The Q or Quality of the filter\n\t */\n\treadonly Q: Signal<\"positive\">;\n\n\t/**\n\t * The cutoff frequency of the filter.\n\t */\n\treadonly frequency: Signal<\"frequency\">;\n\n\t/**\n\t * The detune parameter\n\t */\n\treadonly detune: Signal<\"cents\">;\n\n\t/**\n\t * The gain of the filter, only used in certain filter types\n\t */\n\treadonly gain: Signal<\"decibels\">;\n\n\t/**\n\t * @param frequency The cutoff frequency of the filter.\n\t * @param type The type of filter.\n\t * @param rolloff The drop in decibels per octave after the cutoff frequency\n\t */\n\tconstructor(\n\t\tfrequency?: Frequency,\n\t\ttype?: BiquadFilterType,\n\t\trolloff?: FilterRollOff\n\t);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Filter.getDefaults(), arguments, [\n\t\t\t\"frequency\",\n\t\t\t\"type\",\n\t\t\t\"rolloff\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis._filters = [];\n\n\t\tthis.Q = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"positive\",\n\t\t\tvalue: options.Q,\n\t\t});\n\t\tthis.frequency = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"frequency\",\n\t\t\tvalue: options.frequency,\n\t\t});\n\t\tthis.detune = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"cents\",\n\t\t\tvalue: options.detune,\n\t\t});\n\t\tthis.gain = new Signal({\n\t\t\tcontext: this.context,\n\t\t\tunits: \"decibels\",\n\t\t\tconvert: false,\n\t\t\tvalue: options.gain,\n\t\t});\n\t\tthis._type = options.type;\n\t\tthis.rolloff = options.rolloff;\n\t\treadOnly(this, [\"detune\", \"frequency\", \"gain\", \"Q\"]);\n\t}\n\n\tstatic getDefaults(): FilterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tQ: 1,\n\t\t\tdetune: 0,\n\t\t\tfrequency: 350,\n\t\t\tgain: 0,\n\t\t\trolloff: -12 as FilterRollOff,\n\t\t\ttype: \"lowpass\" as BiquadFilterType,\n\t\t});\n\t}\n\n\t/**\n\t * The type of the filter. Types: \"lowpass\", \"highpass\",\n\t * \"bandpass\", \"lowshelf\", \"highshelf\", \"notch\", \"allpass\", or \"peaking\".\n\t */\n\tget type(): BiquadFilterType {\n\t\treturn this._type;\n\t}\n\tset type(type: BiquadFilterType) {\n\t\tconst types: BiquadFilterType[] = [\n\t\t\t\"lowpass\",\n\t\t\t\"highpass\",\n\t\t\t\"bandpass\",\n\t\t\t\"lowshelf\",\n\t\t\t\"highshelf\",\n\t\t\t\"notch\",\n\t\t\t\"allpass\",\n\t\t\t\"peaking\",\n\t\t];\n\t\tassert(types.indexOf(type) !== -1, `Invalid filter type: ${type}`);\n\t\tthis._type = type;\n\t\tthis._filters.forEach((filter) => (filter.type = type));\n\t}\n\n\t/**\n\t * The rolloff of the filter which is the drop in db\n\t * per octave. Implemented internally by cascading filters.\n\t * Only accepts the values -12, -24, -48 and -96.\n\t */\n\tget rolloff(): FilterRollOff {\n\t\treturn this._rolloff;\n\t}\n\tset rolloff(rolloff) {\n\t\tconst rolloffNum = isNumber(rolloff)\n\t\t\t? rolloff\n\t\t\t: (parseInt(rolloff, 10) as FilterRollOff);\n\t\tconst possibilities = [-12, -24, -48, -96];\n\t\tlet cascadingCount = possibilities.indexOf(rolloffNum);\n\t\t// check the rolloff is valid\n\t\tassert(\n\t\t\tcascadingCount !== -1,\n\t\t\t`rolloff can only be ${possibilities.join(\", \")}`\n\t\t);\n\t\tcascadingCount += 1;\n\n\t\tthis._rolloff = rolloffNum;\n\t\tthis.input.disconnect();\n\t\tthis._filters.forEach((filter) => filter.disconnect());\n\n\t\tthis._filters = new Array(cascadingCount);\n\t\tfor (let count = 0; count < cascadingCount; count++) {\n\t\t\tconst filter = new BiquadFilter({\n\t\t\t\tcontext: this.context,\n\t\t\t});\n\t\t\tfilter.type = this._type;\n\t\t\tthis.frequency.connect(filter.frequency);\n\t\t\tthis.detune.connect(filter.detune);\n\t\t\tthis.Q.connect(filter.Q);\n\t\t\tthis.gain.connect(filter.gain);\n\t\t\tthis._filters[count] = filter;\n\t\t}\n\t\tthis._internalChannels = this._filters;\n\t\tconnectSeries(this.input, ...this._internalChannels, this.output);\n\t}\n\n\t/**\n\t * Get the frequency response curve. This curve represents how the filter\n\t * responses to frequencies between 20hz-20khz.\n\t * @param len The number of values to return\n\t * @return The frequency response curve between 20-20kHz\n\t */\n\tgetFrequencyResponse(len = 128): Float32Array {\n\t\tconst filterClone = new BiquadFilter({\n\t\t\tcontext: this.context,\n\t\t\tfrequency: this.frequency.value,\n\t\t\tgain: this.gain.value,\n\t\t\tQ: this.Q.value,\n\t\t\ttype: this._type,\n\t\t\tdetune: this.detune.value,\n\t\t});\n\t\t// start with all 1s\n\t\tconst totalResponse = new Float32Array(len).map(() => 1);\n\t\tthis._filters.forEach(() => {\n\t\t\tconst response = filterClone.getFrequencyResponse(len);\n\t\t\tresponse.forEach((val, i) => (totalResponse[i] *= val));\n\t\t});\n\t\tfilterClone.dispose();\n\t\treturn totalResponse;\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._filters.forEach((filter) => {\n\t\t\tfilter.dispose();\n\t\t});\n\t\twritable(this, [\"detune\", \"frequency\", \"gain\", \"Q\"]);\n\t\tthis.frequency.dispose();\n\t\tthis.Q.dispose();\n\t\tthis.detune.dispose();\n\t\tthis.gain.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/LowpassCombFilter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { LowpassCombFilter } from \"./LowpassCombFilter.js\";\n\ndescribe(\"LowpassCombFilter\", () => {\n\tBasicTests(LowpassCombFilter);\n\n\tcontext(\"Comb Filtering\", () => {\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst lpcf = new LowpassCombFilter({\n\t\t\t\tdelayTime: 0.2,\n\t\t\t\tresonance: 0.3,\n\t\t\t\tdampening: 2400,\n\t\t\t});\n\t\t\texpect(lpcf.delayTime.value).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(lpcf.resonance.value).to.be.closeTo(0.3, 0.001);\n\t\t\texpect(lpcf.dampening).to.be.closeTo(2400, 0.001);\n\t\t\tlpcf.dispose();\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst lpcf = new LowpassCombFilter();\n\t\t\tlpcf.set({\n\t\t\t\tdelayTime: 0.2,\n\t\t\t\tresonance: 0.3,\n\t\t\t\tdampening: 2000,\n\t\t\t});\n\t\t\texpect(lpcf.get().delayTime).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(lpcf.get().resonance).to.be.closeTo(0.3, 0.001);\n\t\t\texpect(lpcf.get().dampening).to.be.closeTo(2000, 0.001);\n\t\t\tlpcf.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst lpcf = new LowpassCombFilter(0).toDestination();\n\t\t\t\tinput.connect(lpcf);\n\t\t\t});\n\t\t});\n\n\t\tit(\"produces a decay signal at high resonance\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst lpcf = new LowpassCombFilter(\n\t\t\t\t\t0.01,\n\t\t\t\t\t0.9,\n\t\t\t\t\t5000\n\t\t\t\t).toDestination();\n\t\t\t\tconst burst = new Oscillator(440).connect(lpcf);\n\t\t\t\tburst.start(0);\n\t\t\t\tburst.stop(0.1);\n\t\t\t}, 0.8);\n\t\t\texpect(buffer.getRmsAtTime(0.05)).to.be.within(0.2, 0.6);\n\t\t\texpect(buffer.getRmsAtTime(0.1)).to.be.within(0.2, 0.6);\n\t\t\texpect(buffer.getRmsAtTime(0.15)).to.be.within(0.15, 0.4);\n\t\t\texpect(buffer.getRmsAtTime(0.3)).to.be.within(0.01, 0.15);\n\t\t\texpect(buffer.getRmsAtTime(0.7)).to.be.below(0.01);\n\t\t});\n\n\t\tit(\"produces a decay signal at moderate resonance\", async () => {\n\t\t\tconst buffer = await Offline(() => {\n\t\t\t\tconst lpcf = new LowpassCombFilter(0.05, 0.5).toDestination();\n\t\t\t\tconst burst = new Oscillator(440).connect(lpcf);\n\t\t\t\tburst.start(0);\n\t\t\t\tburst.stop(0.1);\n\t\t\t}, 0.6);\n\t\t\texpect(buffer.getRmsAtTime(0.05)).to.be.closeTo(0.7, 0.1);\n\t\t\texpect(buffer.getRmsAtTime(0.1)).to.be.within(0.7, 1.1);\n\t\t\texpect(buffer.getRmsAtTime(0.2)).to.be.closeTo(0.25, 0.1);\n\t\t\texpect(buffer.getRmsAtTime(0.4)).to.be.closeTo(0.015, 0.01);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/LowpassCombFilter.ts", "content": "import { Param } from \"../../core/context/Param.js\";\nimport {\n\tInputNode,\n\tOutputNode,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Frequency, NormalRange, Time } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\nimport { RecursivePartial } from \"../../core/util/Interface.js\";\nimport { FeedbackCombFilter } from \"./FeedbackCombFilter.js\";\nimport { OnePoleFilter } from \"./OnePoleFilter.js\";\n\ninterface LowpassCombFilterOptions extends ToneAudioNodeOptions {\n\tdelayTime: Time;\n\tresonance: NormalRange;\n\tdampening: Frequency;\n}\n\n/**\n * A lowpass feedback comb filter. It is similar to\n * {@link FeedbackCombFilter}, but includes a lowpass filter.\n * @category Component\n */\nexport class LowpassCombFilter extends ToneAudioNode {\n\treadonly name = \"LowpassCombFilter\";\n\n\t/**\n\t * The delay node\n\t */\n\tprivate _combFilter: FeedbackCombFilter;\n\n\t/**\n\t * The lowpass filter\n\t */\n\tprivate _lowpass: OnePoleFilter;\n\n\t/**\n\t * The delayTime of the comb filter.\n\t */\n\treadonly delayTime: Param<\"time\">;\n\n\t/**\n\t * The amount of feedback of the delayed signal.\n\t */\n\treadonly resonance: Param<\"normalRange\">;\n\n\treadonly input: InputNode;\n\treadonly output: OutputNode;\n\n\t/**\n\t * @param delayTime The delay time of the comb filter\n\t * @param resonance The resonance (feedback) of the comb filter\n\t * @param dampening The cutoff of the lowpass filter dampens the signal as it is fed back.\n\t */\n\tconstructor(\n\t\tdelayTime?: Time,\n\t\tresonance?: NormalRange,\n\t\tdampening?: Frequency\n\t);\n\tconstructor(options?: RecursivePartial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tLowpassCombFilter.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"delayTime\", \"resonance\", \"dampening\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._combFilter = this.output = new FeedbackCombFilter({\n\t\t\tcontext: this.context,\n\t\t\tdelayTime: options.delayTime,\n\t\t\tresonance: options.resonance,\n\t\t});\n\t\tthis.delayTime = this._combFilter.delayTime;\n\t\tthis.resonance = this._combFilter.resonance;\n\n\t\tthis._lowpass = this.input = new OnePoleFilter({\n\t\t\tcontext: this.context,\n\t\t\tfrequency: options.dampening,\n\t\t\ttype: \"lowpass\",\n\t\t});\n\n\t\t// connections\n\t\tthis._lowpass.connect(this._combFilter);\n\t}\n\n\tstatic getDefaults(): LowpassCombFilterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tdampening: 3000,\n\t\t\tdelayTime: 0.1,\n\t\t\tresonance: 0.5,\n\t\t});\n\t}\n\n\t/**\n\t * The dampening control of the feedback\n\t */\n\tget dampening(): Frequency {\n\t\treturn this._lowpass.frequency;\n\t}\n\tset dampening(fq) {\n\t\tthis._lowpass.frequency = fq;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._combFilter.dispose();\n\t\tthis._lowpass.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/OnePoleFilter.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { CompareToFile } from \"../../../test/helper/CompareToFile.js\";\nimport { atTime, Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { OnePoleFilter } from \"./OnePoleFilter.js\";\n\ndescribe(\"OnePoleFilter\", () => {\n\tBasicTests(OnePoleFilter);\n\n\tit(\"matches a file when set to lowpass\", () => {\n\t\treturn CompareToFile(\n\t\t\t() => {\n\t\t\t\tconst filter = new OnePoleFilter(\n\t\t\t\t\t300,\n\t\t\t\t\t\"lowpass\"\n\t\t\t\t).toDestination();\n\t\t\t\tconst osc = new Oscillator().connect(filter);\n\t\t\t\tosc.type = \"square\";\n\t\t\t\tosc.start(0).stop(0.1);\n\t\t\t},\n\t\t\t\"onePoleLowpass.wav\",\n\t\t\t0.05\n\t\t);\n\t});\n\n\tit(\"matches a file when set to highpass\", () => {\n\t\treturn CompareToFile(\n\t\t\t() => {\n\t\t\t\tconst filter = new OnePoleFilter(\n\t\t\t\t\t700,\n\t\t\t\t\t\"highpass\"\n\t\t\t\t).toDestination();\n\t\t\t\tconst osc = new Oscillator().connect(filter);\n\t\t\t\tosc.type = \"square\";\n\t\t\t\tosc.start(0).stop(0.1);\n\t\t\t},\n\t\t\t\"onePoleHighpass.wav\",\n\t\t\t0.05\n\t\t);\n\t});\n\n\tcontext(\"Filtering\", () => {\n\t\tit(\"can set the frequency more than once\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst filter = new OnePoleFilter(200);\n\t\t\t\tfilter.frequency = 300;\n\t\t\t\treturn atTime(0.1, () => {\n\t\t\t\t\tfilter.frequency = 400;\n\t\t\t\t});\n\t\t\t}, 1);\n\t\t});\n\n\t\tit(\"can be constructed with an object\", () => {\n\t\t\tconst filter = new OnePoleFilter({\n\t\t\t\tfrequency: 400,\n\t\t\t\ttype: \"lowpass\",\n\t\t\t});\n\t\t\texpect(filter.frequency).to.be.closeTo(400, 0.1);\n\t\t\texpect(filter.type).to.equal(\"lowpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can be constructed with args\", () => {\n\t\t\tconst filter = new OnePoleFilter(120, \"highpass\");\n\t\t\texpect(filter.frequency).to.be.closeTo(120, 0.1);\n\t\t\texpect(filter.type).to.equal(\"highpass\");\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"can be get and set through object\", () => {\n\t\t\tconst filter = new OnePoleFilter();\n\t\t\tfilter.set({\n\t\t\t\tfrequency: 200,\n\t\t\t\ttype: \"highpass\",\n\t\t\t});\n\t\t\texpect(filter.get().type).to.equal(\"highpass\");\n\t\t\texpect(filter.get().frequency).to.be.closeTo(200, 0.1);\n\t\t\tfilter.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst filter = new OnePoleFilter(5000).toDestination();\n\t\t\t\tinput.connect(filter);\n\t\t\t});\n\t\t});\n\t});\n\n\tcontext(\"Response Curve\", () => {\n\t\tit(\"can get the response curve\", () => {\n\t\t\tconst filter = new OnePoleFilter();\n\t\t\tconst response = filter.getFrequencyResponse(128);\n\t\t\texpect(response.length).to.equal(128);\n\t\t\tresponse.forEach((v) => expect(v).to.be.within(0, 1));\n\t\t\tfilter.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/OnePoleFilter.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\nimport { Frequency } from \"../../core/type/Units.js\";\nimport { optionsFromArguments } from \"../../core/util/Defaults.js\";\n\nexport type OnePoleFilterType = \"highpass\" | \"lowpass\";\n\nexport interface OnePoleFilterOptions extends ToneAudioNodeOptions {\n\tfrequency: Frequency;\n\ttype: OnePoleFilterType;\n}\n\n/**\n * A one pole filter with 6db-per-octave rolloff. Either \"highpass\" or \"lowpass\".\n * Note that changing the type or frequency may result in a discontinuity which\n * can sound like a click or pop.\n * References:\n * * http://www.earlevel.com/main/2012/12/15/a-one-pole-filter/\n * * http://www.dspguide.com/ch19/2.htm\n * * https://github.com/vitaliy-bobrov/js-rocks/blob/master/src/app/audio/effects/one-pole-filters.ts\n * @category Component\n */\nexport class OnePoleFilter extends ToneAudioNode {\n\treadonly name: string = \"OnePoleFilter\";\n\n\t/**\n\t * Hold the current frequency\n\t */\n\tprivate _frequency: Frequency;\n\n\t/**\n\t * the current one pole type\n\t */\n\tprivate _type: OnePoleFilterType;\n\n\t/**\n\t * the current one pole filter\n\t */\n\tprivate _filter!: IIRFilterNode;\n\n\treadonly input: Gain;\n\treadonly output: Gain;\n\n\t/**\n\t * @param frequency The frequency\n\t * @param type The filter type, either \"lowpass\" or \"highpass\"\n\t */\n\tconstructor(frequency?: Frequency, type?: OnePoleFilterType);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tOnePoleFilter.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"frequency\", \"type\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis._frequency = options.frequency;\n\t\tthis._type = options.type;\n\t\tthis.input = new Gain({ context: this.context });\n\t\tthis.output = new Gain({ context: this.context });\n\t\tthis._createFilter();\n\t}\n\n\tstatic getDefaults(): OnePoleFilterOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tfrequency: 880,\n\t\t\ttype: \"lowpass\" as OnePoleFilterType,\n\t\t});\n\t}\n\n\t/**\n\t * Create a filter and dispose the old one\n\t */\n\tprivate _createFilter() {\n\t\tconst oldFilter = this._filter;\n\t\tconst freq = this.toFrequency(this._frequency);\n\t\tconst t = 1 / (2 * Math.PI * freq);\n\t\tif (this._type === \"lowpass\") {\n\t\t\tconst a0 = 1 / (t * this.context.sampleRate);\n\t\t\tconst b1 = a0 - 1;\n\t\t\tthis._filter = this.context.createIIRFilter([a0, 0], [1, b1]);\n\t\t} else {\n\t\t\tconst b1 = 1 / (t * this.context.sampleRate) - 1;\n\t\t\tthis._filter = this.context.createIIRFilter([1, -1], [1, b1]);\n\t\t}\n\n\t\tthis.input.chain(this._filter, this.output);\n\t\tif (oldFilter) {\n\t\t\t// dispose it on the next block\n\t\t\tthis.context.setTimeout(() => {\n\t\t\t\tif (!this.disposed) {\n\t\t\t\t\tthis.input.disconnect(oldFilter);\n\t\t\t\t\toldFilter.disconnect();\n\t\t\t\t}\n\t\t\t}, this.blockTime);\n\t\t}\n\t}\n\n\t/**\n\t * The frequency value.\n\t */\n\tget frequency(): Frequency {\n\t\treturn this._frequency;\n\t}\n\tset frequency(fq) {\n\t\tthis._frequency = fq;\n\t\tthis._createFilter();\n\t}\n\n\t/**\n\t * The OnePole Filter type, either \"highpass\" or \"lowpass\"\n\t */\n\tget type(): OnePoleFilterType {\n\t\treturn this._type;\n\t}\n\tset type(t) {\n\t\tthis._type = t;\n\t\tthis._createFilter();\n\t}\n\n\t/**\n\t * Get the frequency response curve. This curve represents how the filter\n\t * responses to frequencies between 20hz-20khz.\n\t * @param len The number of values to return\n\t * @return The frequency response curve between 20-20kHz\n\t */\n\tgetFrequencyResponse(len = 128): Float32Array {\n\t\tconst freqValues = new Float32Array(len);\n\t\tfor (let i = 0; i < len; i++) {\n\t\t\tconst norm = Math.pow(i / len, 2);\n\t\t\tconst freq = norm * (20000 - 20) + 20;\n\t\t\tfreqValues[i] = freq;\n\t\t}\n\t\tconst magValues = new Float32Array(len);\n\t\tconst phaseValues = new Float32Array(len);\n\t\tthis._filter.getFrequencyResponse(freqValues, magValues, phaseValues);\n\t\treturn magValues;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis.output.dispose();\n\t\tthis._filter.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/filter/PhaseShiftAllpass.test.ts", "content": "import { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { CompareToFile } from \"../../../test/helper/CompareToFile.js\";\nimport { connectTo } from \"../../../test/helper/Connect.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { connect } from \"../../core/context/ToneAudioNode.js\";\nimport { Subtract } from \"../../signal/Subtract.js\";\nimport { PhaseShiftAllpass } from \"./PhaseShiftAllpass.js\";\n\ndescribe(\"PhaseShiftAllpass\", () => {\n\tBasicTests(PhaseShiftAllpass);\n\n\tcontext(\"PhaseShiftAllpass\", () => {\n\t\tit(\"handles output connections\", () => {\n\t\t\tconst phaseShifter = new PhaseShiftAllpass();\n\t\t\tphaseShifter.connect(connectTo());\n\t\t\tphaseShifter.offset90.connect(connectTo());\n\t\t\tphaseShifter.dispose();\n\t\t});\n\n\t\tit(\"passes the incoming signal through\", () => {\n\t\t\treturn PassAudio((input) => {\n\t\t\t\tconst phaseShifter = new PhaseShiftAllpass().toDestination();\n\t\t\t\tinput.connect(phaseShifter);\n\t\t\t});\n\t\t});\n\n\t\tit(\"generates correct values with the phase shifted channel\", () => {\n\t\t\treturn CompareToFile(\n\t\t\t\t(context) => {\n\t\t\t\t\t// create impulse with 5 samples offset\n\t\t\t\t\tconst constantNode = context.createConstantSource();\n\t\t\t\t\tconstantNode.start(0);\n\t\t\t\t\tconst oneSampleDelay = context.createIIRFilter(\n\t\t\t\t\t\t[0.0, 1.0],\n\t\t\t\t\t\t[1.0, 0.0]\n\t\t\t\t\t);\n\t\t\t\t\tconst fiveSampleDelay = context.createIIRFilter(\n\t\t\t\t\t\t[0.0, 0.0, 0.0, 0.0, 0.0, 1.0],\n\t\t\t\t\t\t[1.0, 0.0, 0.0, 0.0, 0.0, 0.0]\n\t\t\t\t\t);\n\t\t\t\t\tconst sub = new Subtract();\n\n\t\t\t\t\tconnect(constantNode, oneSampleDelay);\n\t\t\t\t\tconnect(constantNode, sub);\n\t\t\t\t\tconnect(oneSampleDelay, sub.subtrahend);\n\t\t\t\t\tconnect(sub, fiveSampleDelay);\n\n\t\t\t\t\tconst phaseShifter = new PhaseShiftAllpass();\n\t\t\t\t\tconnect(fiveSampleDelay, phaseShifter);\n\t\t\t\t\tphaseShifter.toDestination();\n\t\t\t\t},\n\t\t\t\t\"phaseShiftAllpass.wav\",\n\t\t\t\t0.001\n\t\t\t);\n\t\t});\n\n\t\tit(\"generates correct values with the offset90 channel\", () => {\n\t\t\treturn CompareToFile(\n\t\t\t\t(context) => {\n\t\t\t\t\t// create impulse with 5 samples offset\n\t\t\t\t\tconst constantNode = context.createConstantSource();\n\t\t\t\t\tconstantNode.start(0);\n\t\t\t\t\tconst oneSampleDelay = context.createIIRFilter(\n\t\t\t\t\t\t[0.0, 1.0],\n\t\t\t\t\t\t[1.0, 0.0]\n\t\t\t\t\t);\n\t\t\t\t\tconst fiveSampleDelay = context.createIIRFilter(\n\t\t\t\t\t\t[0.0, 0.0, 0.0, 0.0, 0.0, 1.0],\n\t\t\t\t\t\t[1.0, 0.0, 0.0, 0.0, 0.0, 0.0]\n\t\t\t\t\t);\n\t\t\t\t\tconst sub = new Subtract();\n\n\t\t\t\t\tconnect(constantNode, oneSampleDelay);\n\t\t\t\t\tconnect(constantNode, sub);\n\t\t\t\t\tconnect(oneSampleDelay, sub.subtrahend);\n\t\t\t\t\tconnect(sub, fiveSampleDelay);\n\n\t\t\t\t\tconst phaseShifter = new PhaseShiftAllpass();\n\t\t\t\t\tconnect(fiveSampleDelay, phaseShifter);\n\t\t\t\t\tphaseShifter.offset90.toDestination();\n\t\t\t\t},\n\t\t\t\t\"phaseShiftAllpass1.wav\",\n\t\t\t\t0.001\n\t\t\t);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/component/filter/PhaseShiftAllpass.ts", "content": "import { Gain } from \"../../core/context/Gain.js\";\nimport {\n\tconnectSeries,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"../../core/context/ToneAudioNode.js\";\n\n/**\n * PhaseShiftAllpass is an very efficient implementation of a Hilbert Transform\n * using two Allpass filter banks whose outputs have a phase difference of 90°.\n * Here the `offset90` phase is offset by +90° in relation to `output`.\n * Coefficients and structure was developed by Olli Niemitalo.\n * For more details see: http://yehar.com/blog/?p=368\n * @category Component\n */\nexport class PhaseShiftAllpass extends ToneAudioNode {\n\treadonly name: string = \"PhaseShiftAllpass\";\n\n\treadonly input = new Gain({ context: this.context });\n\n\t/**\n\t * The Allpass filter in the first bank\n\t */\n\tprivate _bank0: IIRFilterNode[];\n\n\t/**\n\t * The Allpass filter in the seconds bank\n\t */\n\tprivate _bank1: IIRFilterNode[];\n\n\t/**\n\t * A IIR filter implementing a delay by one sample used by the first bank\n\t */\n\tprivate _oneSampleDelay: IIRFilterNode;\n\n\t/**\n\t * The phase shifted output\n\t */\n\treadonly output = new Gain({ context: this.context });\n\n\t/**\n\t * The PhaseShifted allpass output\n\t */\n\treadonly offset90 = new Gain({ context: this.context });\n\n\tconstructor(options?: Partial) {\n\t\tsuper(options);\n\n\t\tconst allpassBank1Values = [\n\t\t\t0.6923878, 0.9360654322959, 0.988229522686, 0.9987488452737,\n\t\t];\n\t\tconst allpassBank2Values = [\n\t\t\t0.4021921162426, 0.856171088242, 0.9722909545651, 0.9952884791278,\n\t\t];\n\n\t\tthis._bank0 = this._createAllPassFilterBank(allpassBank1Values);\n\t\tthis._bank1 = this._createAllPassFilterBank(allpassBank2Values);\n\t\tthis._oneSampleDelay = this.context.createIIRFilter(\n\t\t\t[0.0, 1.0],\n\t\t\t[1.0, 0.0]\n\t\t);\n\n\t\t// connect Allpass filter banks\n\t\tconnectSeries(\n\t\t\tthis.input,\n\t\t\t...this._bank0,\n\t\t\tthis._oneSampleDelay,\n\t\t\tthis.output\n\t\t);\n\t\tconnectSeries(this.input, ...this._bank1, this.offset90);\n\t}\n\n\t/**\n\t * Create all of the IIR filters from an array of values using the coefficient calculation.\n\t */\n\tprivate _createAllPassFilterBank(bankValues: number[]): IIRFilterNode[] {\n\t\tconst nodes: IIRFilterNode[] = bankValues.map((value) => {\n\t\t\tconst coefficients = [\n\t\t\t\t[value * value, 0, -1],\n\t\t\t\t[1, 0, -(value * value)],\n\t\t\t];\n\t\t\treturn this.context.createIIRFilter(\n\t\t\t\tcoefficients[0],\n\t\t\t\tcoefficients[1]\n\t\t\t);\n\t\t});\n\n\t\treturn nodes;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.input.dispose();\n\t\tthis.output.dispose();\n\t\tthis.offset90.dispose();\n\t\tthis._bank0.forEach((f) => f.disconnect());\n\t\tthis._bank1.forEach((f) => f.disconnect());\n\t\tthis._oneSampleDelay.disconnect();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/component/index.ts", "content": "export * from \"./analysis/Analyser.js\";\nexport * from \"./analysis/DCMeter.js\";\nexport * from \"./analysis/FFT.js\";\nexport * from \"./analysis/Follower.js\";\nexport * from \"./analysis/Meter.js\";\nexport * from \"./analysis/Waveform.js\";\nexport * from \"./channel/Channel.js\";\nexport * from \"./channel/CrossFade.js\";\nexport * from \"./channel/Merge.js\";\nexport * from \"./channel/MidSideMerge.js\";\nexport * from \"./channel/MidSideSplit.js\";\nexport * from \"./channel/Mono.js\";\nexport * from \"./channel/MultibandSplit.js\";\nexport * from \"./channel/Panner.js\";\nexport * from \"./channel/Panner3D.js\";\nexport * from \"./channel/PanVol.js\";\nexport * from \"./channel/Recorder.js\";\nexport * from \"./channel/Solo.js\";\nexport * from \"./channel/Split.js\";\nexport * from \"./channel/Volume.js\";\nexport * from \"./dynamics/Compressor.js\";\nexport * from \"./dynamics/Gate.js\";\nexport * from \"./dynamics/Limiter.js\";\nexport * from \"./dynamics/MidSideCompressor.js\";\nexport * from \"./dynamics/MultibandCompressor.js\";\nexport * from \"./envelope/AmplitudeEnvelope.js\";\nexport * from \"./envelope/Envelope.js\";\nexport * from \"./envelope/FrequencyEnvelope.js\";\nexport * from \"./filter/BiquadFilter.js\";\nexport * from \"./filter/Convolver.js\";\nexport * from \"./filter/EQ3.js\";\nexport * from \"./filter/FeedbackCombFilter.js\";\nexport * from \"./filter/Filter.js\";\nexport * from \"./filter/LowpassCombFilter.js\";\nexport * from \"./filter/OnePoleFilter.js\";\n" }, { "path": "Tone/core/Global.ts", "content": "import { version } from \"../version.js\";\nimport {\n\tAnyAudioContext,\n\thasAudioContext,\n\ttheWindow,\n} from \"./context/AudioContext.js\";\nimport { BaseContext } from \"./context/BaseContext.js\";\nimport { Context } from \"./context/Context.js\";\nimport { DummyContext } from \"./context/DummyContext.js\";\nimport { OfflineContext } from \"./context/OfflineContext.js\";\nimport {\n\tisAudioContext,\n\tisOfflineAudioContext,\n} from \"./util/AdvancedTypeCheck.js\";\n\n/**\n * This dummy context is used to avoid throwing immediate errors when importing in Node.js\n */\nconst dummyContext = new DummyContext();\n\n/**\n * The global audio context which is getable and assignable through\n * getContext and setContext\n */\nlet globalContext: BaseContext = dummyContext;\n\n/**\n * Returns the default system-wide {@link Context}\n * @category Core\n */\nexport function getContext(): BaseContext {\n\tif (globalContext === dummyContext && hasAudioContext) {\n\t\tsetContext(new Context());\n\t}\n\treturn globalContext;\n}\n\n/**\n * Set the default audio context\n * @param context\n * @param disposeOld Pass `true` if you don't need the old context to dispose it.\n * @category Core\n */\nexport function setContext(\n\tcontext: BaseContext | AnyAudioContext,\n\tdisposeOld = false\n): void {\n\tif (disposeOld) {\n\t\tglobalContext.dispose();\n\t}\n\n\tif (isAudioContext(context)) {\n\t\tglobalContext = new Context(context);\n\t} else if (isOfflineAudioContext(context)) {\n\t\tglobalContext = new OfflineContext(context);\n\t} else {\n\t\tglobalContext = context;\n\t}\n}\n\n/**\n * Most browsers will not play _any_ audio until a user\n * clicks something (like a play button). Invoke this method\n * on a click or keypress event handler to start the audio context.\n * More about the Autoplay policy\n * [here](https://developers.google.com/web/updates/2017/09/autoplay-policy-changes#webaudio)\n * @example\n * document.querySelector(\"button\").addEventListener(\"click\", async () => {\n * \tawait Tone.start();\n * \tconsole.log(\"context started\");\n * });\n * @category Core\n */\nexport function start(): Promise {\n\treturn globalContext.resume();\n}\n\n/**\n * Log Tone.js + version in the console.\n */\nif (theWindow && !theWindow.TONE_SILENCE_LOGGING) {\n\tlet prefix = \"v\";\n\tif (version === \"dev\") {\n\t\tprefix = \"\";\n\t}\n\tconst printString = ` * Tone.js ${prefix}${version} * `;\n\t// eslint-disable-next-line no-console\n\tconsole.log(`%c${printString}`, \"background: #000; color: #fff\");\n}\n" }, { "path": "Tone/core/Tone.ts", "content": "/**\n * Tone.js\n * @author Yotam Mann\n * @license http://opensource.org/licenses/MIT MIT License\n * @copyright 2014-2024 Yotam Mann\n */\nimport { version } from \"../version.js\";\nimport { theWindow } from \"./context/AudioContext.js\";\nimport { log } from \"./util/Debug.js\";\n\n//-------------------------------------\n// \tTONE\n//-------------------------------------\n\nexport interface BaseToneOptions {}\n\n/**\n * Tone is the base class of all other classes.\n *\n * @category Core\n * @constructor\n */\nexport abstract class Tone {\n\t/**\n\t * The version number semver\n\t */\n\tstatic version: string = version;\n\n\t/**\n\t * The name of the class\n\t */\n\tprotected abstract name: string;\n\n\t/**\n\t * Returns all of the default options belonging to the class.\n\t */\n\tstatic getDefaults(): BaseToneOptions {\n\t\treturn {};\n\t}\n\n\t//-------------------------------------\n\t// \tDEBUGGING\n\t//-------------------------------------\n\n\t/**\n\t * Set this debug flag to log all events that happen in this class.\n\t */\n\tdebug = false;\n\n\t/**\n\t * Prints the outputs to the console log for debugging purposes.\n\t * Prints the contents only if either the object has a property\n\t * called `debug` set to true, or a variable called TONE_DEBUG_CLASS\n\t * is set to the name of the class.\n\t * @example\n\t * const osc = new Tone.Oscillator();\n\t * // prints all logs originating from this oscillator\n\t * osc.debug = true;\n\t * // calls to start/stop will print in the console\n\t * osc.start();\n\t */\n\tprotected log(...args: any[]): void {\n\t\t// if the object is either set to debug = true\n\t\t// or if there is a string on the Tone.global.with the class name\n\t\tif (\n\t\t\tthis.debug ||\n\t\t\t(theWindow && this.toString() === theWindow.TONE_DEBUG_CLASS)\n\t\t) {\n\t\t\tlog(this, ...args);\n\t\t}\n\t}\n\n\t//-------------------------------------\n\t// \tDISPOSING\n\t//-------------------------------------\n\n\t/**\n\t * Indicates if the instance was disposed\n\t */\n\tprivate _wasDisposed = false;\n\n\t/**\n\t * disconnect and dispose.\n\t */\n\tdispose(): this {\n\t\tthis._wasDisposed = true;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Indicates if the instance was disposed. 'Disposing' an\n\t * instance means that all of the Web Audio nodes that were\n\t * created for the instance are disconnected and freed for garbage collection.\n\t */\n\tget disposed(): boolean {\n\t\treturn this._wasDisposed;\n\t}\n\n\t/**\n\t * Convert the class to a string\n\t * @example\n\t * const osc = new Tone.Oscillator();\n\t * console.log(osc.toString());\n\t */\n\ttoString(): string {\n\t\treturn this.name;\n\t}\n}\n" }, { "path": "Tone/core/clock/Clock.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { atTime, Offline, whenBetween } from \"../../../test/helper/Offline.js\";\nimport { noOp } from \"../util/Interface.js\";\nimport { Clock } from \"./Clock.js\";\n\ndescribe(\"Clock\", () => {\n\tBasicTests(Clock);\n\n\tcontext(\"Get/Set values\", () => {\n\t\tit(\"can get and set the frequency\", () => {\n\t\t\tconst clock = new Clock(noOp, 2);\n\t\t\texpect(clock.frequency.value).to.equal(2);\n\t\t\tclock.frequency.value = 0.2;\n\t\t\texpect(clock.frequency.value).to.be.closeTo(0.2, 0.001);\n\t\t\tclock.dispose();\n\t\t});\n\n\t\tit(\"invokes the callback when started\", (done) => {\n\t\t\tconst clock = new Clock((time) => {\n\t\t\t\tclock.dispose();\n\t\t\t\tdone();\n\t\t\t}, 10).start();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", (done) => {\n\t\t\tconst clock = new Clock({\n\t\t\t\tcallback(): void {\n\t\t\t\t\tclock.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\tfrequency: 8,\n\t\t\t}).start();\n\t\t\texpect(clock.frequency.value).to.equal(8);\n\t\t});\n\n\t\tit(\"can get and set its values with the set/get\", () => {\n\t\t\tconst clock = new Clock();\n\t\t\tclock.set({\n\t\t\t\tfrequency: 2,\n\t\t\t});\n\t\t\tconst gotValues = clock.get();\n\t\t\texpect(gotValues.frequency).to.equal(2);\n\t\t\tclock.dispose();\n\t\t});\n\t});\n\n\tcontext(\"State\", () => {\n\t\tit(\"correctly returns the scheduled play state\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock();\n\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\tclock.start(0).stop(0.2);\n\t\t\t\texpect(clock.state).to.equal(\"started\");\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0, 0.2, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"started\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.2, Infinity, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.3);\n\t\t});\n\n\t\tit(\"can start, pause, and stop\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock();\n\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\tclock.start(0).pause(0.2).stop(0.4);\n\t\t\t\texpect(clock.state).to.equal(\"started\");\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0, 0.2, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"started\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.2, 0.4, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"paused\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.4, Infinity, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"can schedule multiple start and stops\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock();\n\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\tclock.start(0).pause(0.1).stop(0.2).start(0.3).stop(0.4);\n\t\t\t\texpect(clock.state).to.equal(\"started\");\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0.1, 0.2, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"paused\");\n\t\t\t\t\t\texpect(clock.ticks).to.be.greaterThan(0);\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.2, 0.3, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\t\t\texpect(clock.ticks).to.equal(0);\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.3, 0.4, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"started\");\n\t\t\t\t\t\texpect(clock.ticks).to.be.greaterThan(0);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"stop and immediately start\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock();\n\t\t\t\texpect(clock.state).to.equal(\"stopped\");\n\t\t\t\tclock.start(0).stop(0.1).start(0.1);\n\t\t\t\texpect(clock.state).to.equal(\"started\");\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0, 0.1, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"started\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.1, 0.5, () => {\n\t\t\t\t\t\texpect(clock.state).to.equal(\"started\");\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\t});\n\n\tcontext(\"Scheduling\", () => {\n\t\tit(\"passes a time to the callback\", (done) => {\n\t\t\tconst clock = new Clock((time) => {\n\t\t\t\texpect(time).to.be.a(\"number\");\n\t\t\t\tclock.dispose();\n\t\t\t\tdone();\n\t\t\t}, 10).start();\n\t\t});\n\n\t\tit(\"invokes the callback with a time great than now\", (done) => {\n\t\t\tconst clock = new Clock((time) => {\n\t\t\t\tclock.dispose();\n\t\t\t\texpect(time).to.be.greaterThan(now);\n\t\t\t\tdone();\n\t\t\t}, 10);\n\t\t\tconst now = clock.now();\n\t\t\tconst startTime = now + 0.1;\n\t\t\tclock.start(startTime);\n\t\t});\n\n\t\tit(\"invokes the first callback at the given start time\", (done) => {\n\t\t\tconst clock = new Clock((time) => {\n\t\t\t\tclock.dispose();\n\t\t\t\texpect(time).to.be.closeTo(startTime, 0.01);\n\t\t\t\tdone();\n\t\t\t}, 10);\n\t\t\tconst startTime = clock.now() + 0.1;\n\t\t\tclock.start(startTime);\n\t\t});\n\n\t\tit(\"can be scheduled to start in the future\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline(() => {\n\t\t\t\tconst clock = new Clock((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t}, 2).start(0.1);\n\t\t\t}, 0.4);\n\t\t\texpect(invocations).to.equal(1);\n\t\t});\n\n\t\tit(\"invokes the right number of callbacks given the duration\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline(() => {\n\t\t\t\tnew Clock((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t}, 10)\n\t\t\t\t\t.start(0)\n\t\t\t\t\t.stop(0.45);\n\t\t\t}, 0.6);\n\t\t\texpect(invocations).to.equal(5);\n\t\t});\n\n\t\tit(\"can schedule the frequency of the clock\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline(() => {\n\t\t\t\tconst clock = new Clock((time, ticks) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t}, 2);\n\t\t\t\tclock.start(0).stop(1.01);\n\t\t\t\tclock.frequency.setValueAtTime(4, 0.5);\n\t\t\t}, 2);\n\t\t\texpect(invocations).to.equal(4);\n\t\t});\n\t});\n\n\tcontext(\"Seconds\", () => {\n\t\tit(\"can set the current seconds\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\texpect(clock.seconds).to.be.closeTo(0, 0.001);\n\t\t\t\tclock.seconds = 3;\n\t\t\t\texpect(clock.seconds).to.be.closeTo(3, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get the seconds\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\texpect(clock.seconds).to.be.closeTo(0, 0.001);\n\t\t\t\tclock.start(0.05);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.05) {\n\t\t\t\t\t\texpect(clock.seconds).to.be.closeTo(time - 0.05, 0.01);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can get the seconds during a bpm ramp\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\texpect(clock.seconds).to.be.closeTo(0, 0.001);\n\t\t\t\tclock.start(0.05);\n\t\t\t\tclock.frequency.linearRampTo(60, 0.5, 0.5);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.05) {\n\t\t\t\t\t\texpect(clock.seconds).to.be.closeTo(time - 0.05, 0.01);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.7);\n\t\t});\n\n\t\tit(\"can set seconds during a bpm ramp\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\texpect(clock.seconds).to.be.closeTo(0, 0.001);\n\t\t\t\tclock.start(0.05);\n\t\t\t\tclock.frequency.linearRampTo(60, 0.5, 0.5);\n\t\t\t\tconst changeSeconds = atTime(0.4, () => {\n\t\t\t\t\tclock.seconds = 0;\n\t\t\t\t});\n\t\t\t\treturn (time) => {\n\t\t\t\t\tchangeSeconds(time);\n\t\t\t\t\tif (time > 0.05 && time < 0.4) {\n\t\t\t\t\t\texpect(clock.seconds).to.be.closeTo(time - 0.05, 0.01);\n\t\t\t\t\t} else if (time > 0.4) {\n\t\t\t\t\t\texpect(clock.seconds).to.be.closeTo(time - 0.4, 0.01);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.7);\n\t\t});\n\t});\n\n\tcontext(\"Ticks\", () => {\n\t\tit(\"has 0 ticks when first created\", () => {\n\t\t\tconst clock = new Clock();\n\t\t\texpect(clock.ticks).to.equal(0);\n\t\t\tclock.dispose();\n\t\t});\n\n\t\tit(\"can set the ticks\", () => {\n\t\t\tconst clock = new Clock();\n\t\t\texpect(clock.ticks).to.equal(0);\n\t\t\tclock.ticks = 10;\n\t\t\texpect(clock.ticks).to.equal(10);\n\t\t\tclock.dispose();\n\t\t});\n\n\t\tit(\"increments 1 tick per callback\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tlet ticks = 0;\n\t\t\t\tconst clock = new Clock(() => {\n\t\t\t\t\tticks++;\n\t\t\t\t}, 2).start();\n\t\t\t\treturn atTime(0.59, () => {\n\t\t\t\t\texpect(ticks).to.equal(clock.ticks);\n\t\t\t\t});\n\t\t\t}, 0.6);\n\t\t});\n\n\t\tit(\"resets ticks on stop\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20).start(0).stop(0.1);\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0.01, 0.09, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.be.greaterThan(0);\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.1, Infinity, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.equal(0);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.2);\n\t\t});\n\n\t\tit(\"does not reset ticks on pause but stops incrementing\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20).start(0).pause(0.1);\n\t\t\t\tlet pausedTicks = 0;\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0.01, 0.1, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.be.greaterThan(0);\n\t\t\t\t\t\tpausedTicks = clock.ticks;\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.1, Infinity, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.equal(pausedTicks);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.2);\n\t\t});\n\n\t\tit(\"starts incrementing where it left off after pause\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20)\n\t\t\t\t\t.start(0)\n\t\t\t\t\t.pause(0.1)\n\t\t\t\t\t.start(0.2);\n\n\t\t\t\tlet pausedTicks = 0;\n\t\t\t\tlet tested = false;\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0.01, 0.1, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.be.greaterThan(0);\n\t\t\t\t\t\tpausedTicks = clock.ticks;\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.1, 0.19, () => {\n\t\t\t\t\t\texpect(clock.ticks).to.equal(pausedTicks);\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.21, Infinity, () => {\n\t\t\t\t\t\tif (!tested) {\n\t\t\t\t\t\t\ttested = true;\n\t\t\t\t\t\t\texpect(clock.ticks).to.equal(pausedTicks + 1);\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.3);\n\t\t});\n\n\t\tit(\"can start with a tick offset\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tlet tested = false;\n\t\t\t\tconst clock = new Clock((time, ticks) => {\n\t\t\t\t\tif (!tested) {\n\t\t\t\t\t\ttested = true;\n\t\t\t\t\t\texpect(ticks).to.equal(4);\n\t\t\t\t\t}\n\t\t\t\t}, 10);\n\t\t\t\texpect(clock.ticks).to.equal(0);\n\t\t\t\tclock.start(0, 4);\n\t\t\t});\n\t\t});\n\t});\n\n\tcontext(\"Events\", () => {\n\t\tit(\"triggers the start event on start\", (done) => {\n\t\t\tOffline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tconst startTime = 0.3;\n\t\t\t\tclock.on(\"start\", (time, offset) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime, 0.05);\n\t\t\t\t\texpect(offset).to.equal(0);\n\t\t\t\t\tdone();\n\t\t\t\t});\n\t\t\t\tclock.start(startTime);\n\t\t\t}, 0.4);\n\t\t});\n\n\t\tit(\"triggers the start event with an offset\", (done) => {\n\t\t\tOffline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tconst startTime = 0.3;\n\t\t\t\tclock.on(\"start\", (time, offset) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime, 0.05);\n\t\t\t\t\texpect(offset).to.equal(2);\n\t\t\t\t\tdone();\n\t\t\t\t});\n\t\t\t\tclock.start(startTime, 2);\n\t\t\t}, 0.4);\n\t\t});\n\n\t\tit(\"triggers stop event\", (done) => {\n\t\t\tOffline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tconst stopTime = 0.3;\n\t\t\t\tclock.on(\"stop\", (time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(stopTime, 0.05);\n\t\t\t\t\tdone();\n\t\t\t\t});\n\t\t\t\tclock.start().stop(stopTime);\n\t\t\t}, 0.4);\n\t\t});\n\n\t\tit(\"triggers pause stop event\", (done) => {\n\t\t\tOffline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock\n\t\t\t\t\t.on(\"pause\", (time) => {\n\t\t\t\t\t\texpect(time).to.be.closeTo(0.1, 0.05);\n\t\t\t\t\t})\n\t\t\t\t\t.on(\"stop\", (time) => {\n\t\t\t\t\t\texpect(time).to.be.closeTo(0.2, 0.05);\n\t\t\t\t\t\tdone();\n\t\t\t\t\t});\n\t\t\t\tclock.start().pause(0.1).stop(0.2);\n\t\t\t}, 0.4);\n\t\t});\n\n\t\tit(\"triggers events even in close proximity\", (done) => {\n\t\t\tOffline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tlet invokedStartEvent = false;\n\t\t\t\tclock.on(\"start\", () => {\n\t\t\t\t\tinvokedStartEvent = true;\n\t\t\t\t});\n\t\t\t\tclock.on(\"stop\", () => {\n\t\t\t\t\texpect(invokedStartEvent).to.equal(true);\n\t\t\t\t\tdone();\n\t\t\t\t});\n\t\t\t\tclock.start(0.09999).stop(0.1);\n\t\t\t}, 0.4);\n\t\t});\n\n\t\tit(\"triggers 'start' event when time is in the past\", (done) => {\n\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\tclock.on(\"start\", () => {\n\t\t\t\tdone();\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t\tsetTimeout(() => {\n\t\t\t\tclock.start(0);\n\t\t\t}, 100);\n\t\t});\n\n\t\tit(\"triggers 'stop' event when time is in the past\", (done) => {\n\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\tclock.on(\"stop\", () => {\n\t\t\t\tdone();\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t\tsetTimeout(() => {\n\t\t\t\tclock.start(0);\n\t\t\t}, 100);\n\t\t\tsetTimeout(() => {\n\t\t\t\tclock.stop(0);\n\t\t\t}, 200);\n\t\t});\n\n\t\tit(\"triggers 'pause' event when time is in the past\", (done) => {\n\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\tclock.on(\"pause\", () => {\n\t\t\t\tdone();\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t\tsetTimeout(() => {\n\t\t\t\tclock.start(0);\n\t\t\t}, 100);\n\t\t\tsetTimeout(() => {\n\t\t\t\tclock.pause(0);\n\t\t\t}, 200);\n\t\t});\n\t});\n\n\tcontext(\"[get/set]Ticks\", () => {\n\t\tit(\"always reports 0 if not started\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\texpect(clock.getTicksAtTime(0)).to.equal(0);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.equal(0);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.equal(0);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get ticks in the future\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(1);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(20, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"pauses on last ticks\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0).pause(1);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(20, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"resumes from paused position\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0).pause(1).start(2);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(40, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3.5)).to.be.closeTo(50, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get tick position after multiple pauses\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\tclock.start(0).pause(1).start(2).pause(3).start(4);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(5, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(4)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(5)).to.be.closeTo(30, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get tick position after multiple pauses and tempo scheduling\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\tclock.frequency.setValueAtTime(100, 3.5);\n\t\t\t\tclock.start(0).pause(1).start(2).pause(3).start(4);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(5, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(4)).to.be.closeTo(20, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(5)).to.be.closeTo(120, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get tick position after multiple pauses and setting ticks\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 10);\n\t\t\t\tclock.start(0).pause(1).start(2).pause(3).start(4);\n\t\t\t\tclock.setTicksAtTime(10, 2.5);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(5, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(15, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(4)).to.be.closeTo(15, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(5)).to.be.closeTo(25, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"resumes from paused position with tempo scheduling\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0).pause(1).start(2);\n\t\t\t\tclock.frequency.setValueAtTime(20, 0);\n\t\t\t\tclock.frequency.setValueAtTime(10, 0.5);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(15, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(15, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(25, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3.5)).to.be.closeTo(30, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can set a tick value at the given time\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0);\n\t\t\t\tclock.setTicksAtTime(0, 1);\n\t\t\t\tclock.setTicksAtTime(0, 2);\n\t\t\t\texpect(clock.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(20, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get a tick position while the frequency is scheduled with setValueAtTime\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0);\n\t\t\t\tclock.frequency.setValueAtTime(2, 1);\n\t\t\t\tclock.setTicksAtTime(0, 1);\n\t\t\t\tclock.setTicksAtTime(0, 2);\n\t\t\t\texpect(clock.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1.5)).to.be.closeTo(1, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2.5)).to.be.closeTo(1, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(2, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get a tick position while the frequency is scheduled with linearRampTo\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0);\n\t\t\t\tclock.frequency.linearRampTo(2, 1, 1);\n\t\t\t\tclock.setTicksAtTime(0, 1);\n\t\t\t\tclock.setTicksAtTime(10, 2);\n\t\t\t\texpect(clock.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1.5)).to.be.closeTo(7.75, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2.5)).to.be.closeTo(11, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(12, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get a tick position while the frequency is scheduled with exponentialRampTo\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst clock = new Clock(noOp, 20);\n\t\t\t\tclock.start(0);\n\t\t\t\tclock.frequency.exponentialRampTo(2, 1, 1);\n\t\t\t\tclock.setTicksAtTime(0, 1);\n\t\t\t\tclock.setTicksAtTime(10, 2);\n\t\t\t\texpect(clock.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(1.5)).to.be.closeTo(5.96, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(2.5)).to.be.closeTo(11, 0.01);\n\t\t\t\texpect(clock.getTicksAtTime(3)).to.be.closeTo(12, 0.01);\n\t\t\t\tclock.dispose();\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/Clock.ts", "content": "import {\n\tToneWithContext,\n\tToneWithContextOptions,\n} from \"../context/ToneWithContext.js\";\nimport { Frequency, Hertz, Seconds, Ticks, Time } from \"../type/Units.js\";\nimport { assertContextRunning } from \"../util/Debug.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { Emitter } from \"../util/Emitter.js\";\nimport { noOp, readOnly } from \"../util/Interface.js\";\nimport { PlaybackState, StateTimeline } from \"../util/StateTimeline.js\";\nimport { TickSignal } from \"./TickSignal.js\";\nimport { TickSource } from \"./TickSource.js\";\n\ntype ClockCallback = (time: Seconds, ticks?: Ticks) => void;\n\ninterface ClockOptions extends ToneWithContextOptions {\n\tfrequency: Hertz;\n\tcallback: ClockCallback;\n\tunits: \"hertz\" | \"bpm\";\n}\n\ntype ClockEvent = \"start\" | \"stop\" | \"pause\";\n\n/**\n * A sample-accurate clock that provides a callback at a given rate.\n *\n * While the callback is not sample-accurate (it is susceptible to\n * loose JavaScript timing), the time passed to the callback is precise.\n *\n * For most applications, it is better to use {@link Transport} instead of the\n * Clock by itself, since you can synchronize multiple callbacks.\n *\n * @example\n * // The callback will be invoked approximately once a second,\n * // and it will print the time exactly one second apart.\n * const clock = new Tone.Clock(time => {\n * \tconsole.log(time);\n * }, 1);\n * clock.start();\n * @category Core\n */\nexport class Clock\n\textends ToneWithContext\n\timplements Emitter\n{\n\treadonly name: string = \"Clock\";\n\n\t/**\n\t * The callback function to invoke at the scheduled tick.\n\t */\n\tcallback: ClockCallback = noOp;\n\n\t/**\n\t * The tick counter\n\t */\n\tprivate _tickSource: TickSource;\n\n\t/**\n\t * The last time the loop callback was invoked\n\t */\n\tprivate _lastUpdate = 0;\n\n\t/**\n\t * Keep track of the playback state\n\t */\n\tprivate _state: StateTimeline = new StateTimeline(\"stopped\");\n\n\t/**\n\t * Context bound reference to the _loop method\n\t * This is necessary to remove the event in the end.\n\t */\n\tprivate _boundLoop: () => void = this._loop.bind(this);\n\n\t/**\n\t * The rate the callback function should be invoked.\n\t */\n\tfrequency: TickSignal;\n\n\t/**\n\t * @param callback The callback to be invoked with the time of the audio event\n\t * @param frequency The rate of the callback\n\t */\n\tconstructor(callback?: ClockCallback, frequency?: Frequency);\n\tconstructor(options: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Clock.getDefaults(), arguments, [\n\t\t\t\"callback\",\n\t\t\t\"frequency\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.callback = options.callback;\n\t\tthis._tickSource = new TickSource({\n\t\t\tcontext: this.context,\n\t\t\tfrequency: options.frequency,\n\t\t\tunits: options.units,\n\t\t});\n\t\tthis._lastUpdate = 0;\n\t\tthis.frequency = this._tickSource.frequency;\n\t\treadOnly(this, \"frequency\");\n\n\t\t// add an initial state\n\t\tthis._state.setStateAtTime(\"stopped\", 0);\n\n\t\t// bind a callback to the worker thread\n\t\tthis.context.on(\"tick\", this._boundLoop);\n\t}\n\n\tstatic getDefaults(): ClockOptions {\n\t\treturn Object.assign(ToneWithContext.getDefaults(), {\n\t\t\tcallback: noOp as ClockCallback,\n\t\t\tfrequency: 1,\n\t\t\tunits: \"hertz\",\n\t\t}) as ClockOptions;\n\t}\n\n\t/**\n\t * The playback state of the clock, either \"started\", \"stopped\", or \"paused\".\n\t */\n\tget state(): PlaybackState {\n\t\treturn this._state.getValueAtTime(this.now());\n\t}\n\n\t/**\n\t * Start the clock at the given time.\n\t * @param time The time the clock should start.\n\t * @param offset The number of ticks to start the clock from.\n\t */\n\tstart(time?: Time, offset?: Ticks): this {\n\t\t// make sure the context is running\n\t\tassertContextRunning(this.context);\n\t\t// start the loop\n\t\tconst computedTime = this.toSeconds(time);\n\t\tthis.log(\"start\", computedTime);\n\t\tif (this._state.getValueAtTime(computedTime) !== \"started\") {\n\t\t\tthis._state.setStateAtTime(\"started\", computedTime);\n\t\t\tthis._tickSource.start(computedTime, offset);\n\t\t\tif (computedTime < this._lastUpdate) {\n\t\t\t\tthis.emit(\"start\", computedTime, offset);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop the clock. Stopping the clock resets the tick counter to 0.\n\t * @param time The time when the clock should stop.\n\t * @example\n\t * const clock = new Tone.Clock(time => {\n\t * \tconsole.log(time);\n\t * }, 1);\n\t * clock.start();\n\t * // Stop the clock after 10 seconds.\n\t * clock.stop(\"+10\");\n\t */\n\tstop(time?: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tthis.log(\"stop\", computedTime);\n\t\tthis._state.cancel(computedTime);\n\t\tthis._state.setStateAtTime(\"stopped\", computedTime);\n\t\tthis._tickSource.stop(computedTime);\n\t\tif (computedTime < this._lastUpdate) {\n\t\t\tthis.emit(\"stop\", computedTime);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Pause the clock. Pausing does not reset the tick counter.\n\t * @param time The time when the clock should pause.\n\t */\n\tpause(time?: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tif (this._state.getValueAtTime(computedTime) === \"started\") {\n\t\t\tthis._state.setStateAtTime(\"paused\", computedTime);\n\t\t\tthis._tickSource.pause(computedTime);\n\t\t\tif (computedTime < this._lastUpdate) {\n\t\t\t\tthis.emit(\"pause\", computedTime);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * The number of times the callback has been invoked.\n\t *\n\t * Starts counting at 0 and increments after the callback is invoked.\n\t */\n\tget ticks(): Ticks {\n\t\treturn Math.ceil(this.getTicksAtTime(this.now()));\n\t}\n\tset ticks(t: Ticks) {\n\t\tthis._tickSource.ticks = t;\n\t}\n\n\t/**\n\t * The time since ticks=0 that the clock has been running.\n\t *\n\t * Accounts for tempo curves.\n\t */\n\tget seconds(): Seconds {\n\t\treturn this._tickSource.seconds;\n\t}\n\tset seconds(s: Seconds) {\n\t\tthis._tickSource.seconds = s;\n\t}\n\n\t/**\n\t * Return the elapsed seconds at the given time.\n\t * @param time When to get the elapsed seconds.\n\t * @return The number of elapsed seconds.\n\t */\n\tgetSecondsAtTime(time: Time): Seconds {\n\t\treturn this._tickSource.getSecondsAtTime(time);\n\t}\n\n\t/**\n\t * Set the clock's ticks at the given time.\n\t * @param ticks The tick value to set.\n\t * @param time When to set the tick value.\n\t */\n\tsetTicksAtTime(ticks: Ticks, time: Time): this {\n\t\tthis._tickSource.setTicksAtTime(ticks, time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the time of the given tick.\n\t *\n\t * The second argument is when to test before. Since ticks can be set\n\t * (with {@link setTicksAtTime}), there may be multiple times for a given\n\t * tick value.\n\t *\n\t * @param tick The tick number.\n\t * @param before When to measure the tick value from.\n\t * @return The time of the tick\n\t */\n\tgetTimeOfTick(tick: Ticks, before = this.now()): Seconds {\n\t\treturn this._tickSource.getTimeOfTick(tick, before);\n\t}\n\n\t/**\n\t * Get the clock's ticks at the given time.\n\t * @param time When to get the tick value.\n\t * @return The tick value at the given time.\n\t */\n\tgetTicksAtTime(time?: Time): Ticks {\n\t\treturn this._tickSource.getTicksAtTime(time);\n\t}\n\n\t/**\n\t * Get the time of the next tick.\n\t * @param offset The tick number.\n\t */\n\tnextTickTime(offset: Ticks, when: Time): Seconds {\n\t\tconst computedTime = this.toSeconds(when);\n\t\tconst currentTick = this.getTicksAtTime(computedTime);\n\t\treturn this._tickSource.getTimeOfTick(\n\t\t\tcurrentTick + offset,\n\t\t\tcomputedTime\n\t\t);\n\t}\n\n\t/**\n\t * The scheduling loop.\n\t */\n\tprivate _loop(): void {\n\t\tconst startTime = this._lastUpdate;\n\t\tconst endTime = this.now();\n\t\tthis._lastUpdate = endTime;\n\t\tthis.log(\"loop\", startTime, endTime);\n\n\t\tif (startTime !== endTime) {\n\t\t\t// the state change events\n\t\t\tthis._state.forEachBetween(startTime, endTime, (e) => {\n\t\t\t\tswitch (e.state) {\n\t\t\t\t\tcase \"started\":\n\t\t\t\t\t\tconst offset = this._tickSource.getTicksAtTime(e.time);\n\t\t\t\t\t\tthis.emit(\"start\", e.time, offset);\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase \"stopped\":\n\t\t\t\t\t\tif (e.time !== 0) {\n\t\t\t\t\t\t\tthis.emit(\"stop\", e.time);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase \"paused\":\n\t\t\t\t\t\tthis.emit(\"pause\", e.time);\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t});\n\t\t\t// the tick callbacks\n\t\t\tthis._tickSource.forEachTickBetween(\n\t\t\t\tstartTime,\n\t\t\t\tendTime,\n\t\t\t\t(time, ticks) => {\n\t\t\t\t\tthis.callback(time, ticks);\n\t\t\t\t}\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Returns the scheduled state at the given time.\n\t * @param time The time to query.\n\t * @return The name of the state input in setStateAtTime.\n\t * @example\n\t * const clock = new Tone.Clock();\n\t * clock.start(\"+0.1\");\n\t * clock.getStateAtTime(\"+0.1\"); // returns \"started\"\n\t */\n\tgetStateAtTime(time: Time): PlaybackState {\n\t\tconst computedTime = this.toSeconds(time);\n\t\treturn this._state.getValueAtTime(computedTime);\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.context.off(\"tick\", this._boundLoop);\n\t\tthis._tickSource.dispose();\n\t\tthis._state.dispose();\n\t\treturn this;\n\t}\n\n\t//-------------------------------------\n\t// EMITTER MIXIN TO SATISFY COMPILER\n\t//-------------------------------------\n\n\ton!: (event: ClockEvent, callback: (...args: any[]) => void) => this;\n\tonce!: (event: ClockEvent, callback: (...args: any[]) => void) => this;\n\toff!: (\n\t\tevent: ClockEvent,\n\t\tcallback?: ((...args: any[]) => void) | undefined\n\t) => this;\n\temit!: (event: any, ...args: any[]) => this;\n}\n\nEmitter.mixin(Clock);\n" }, { "path": "Tone/core/clock/TickParam.test.ts", "content": "import { BasicTests, testAudioContext } from \"../../../test/helper/Basic.js\";\n// import { atTime, Offline } from \"../../../test/helper/Offline\";\nimport { TickParam } from \"./TickParam.js\";\n\ndescribe(\"TickParam\", () => {\n\t// sanity checks\n\tBasicTests(TickParam, {\n\t\tcontext: testAudioContext,\n\t\tparam: testAudioContext.createOscillator().frequency,\n\t});\n});\n" }, { "path": "Tone/core/clock/TickParam.ts", "content": "import { AutomationEvent, Param, ParamOptions } from \"../context/Param.js\";\nimport { Seconds, Ticks, Time, UnitMap, UnitName } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { Timeline } from \"../util/Timeline.js\";\nimport { isUndef } from \"../util/TypeCheck.js\";\n\ntype TickAutomationEvent = AutomationEvent & {\n\tticks: number;\n};\n\ninterface TickParamOptions\n\textends ParamOptions {\n\tmultiplier: number;\n}\n\n/**\n * A Param class just for computing ticks. Similar to the {@link Param} class,\n * but offers conversion to BPM values as well as ability to compute tick\n * duration and elapsed ticks\n */\nexport class TickParam<\n\tTypeName extends \"hertz\" | \"bpm\",\n> extends Param {\n\treadonly name: string = \"TickParam\";\n\n\t/**\n\t * The timeline which tracks all of the automations.\n\t */\n\tprotected _events: Timeline = new Timeline(Infinity);\n\n\t/**\n\t * The internal holder for the multiplier value\n\t */\n\tprivate _multiplier = 1;\n\n\t/**\n\t * @param param The AudioParam to wrap\n\t * @param units The unit name\n\t * @param convert Whether or not to convert the value to the target units\n\t */\n\t/**\n\t * @param value The initial value of the signal\n\t */\n\tconstructor(value?: number);\n\tconstructor(options: Partial>);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tTickParam.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"value\"]\n\t\t);\n\t\tsuper(options);\n\n\t\t// set the multiplier\n\t\tthis._multiplier = options.multiplier;\n\n\t\t// clear the ticks from the beginning\n\t\tthis._events.cancel(0);\n\t\t// set an initial event\n\t\tthis._events.add({\n\t\t\tticks: 0,\n\t\t\ttime: 0,\n\t\t\ttype: \"setValueAtTime\",\n\t\t\tvalue: this._fromType(options.value),\n\t\t});\n\t\tthis.setValueAtTime(options.value, 0);\n\t}\n\n\tstatic getDefaults(): TickParamOptions {\n\t\treturn Object.assign(Param.getDefaults(), {\n\t\t\tmultiplier: 1,\n\t\t\tunits: \"hertz\",\n\t\t\tvalue: 1,\n\t\t});\n\t}\n\n\tsetTargetAtTime(\n\t\tvalue: UnitMap[TypeName],\n\t\ttime: Time,\n\t\tconstant: number\n\t): this {\n\t\t// approximate it with multiple linear ramps\n\t\ttime = this.toSeconds(time);\n\t\tthis.setRampPoint(time);\n\t\tconst computedValue = this._fromType(value);\n\n\t\t// start from previously scheduled value\n\t\tconst prevEvent = this._events.get(time) as TickAutomationEvent;\n\t\tconst segments = Math.round(Math.max(1 / constant, 1));\n\t\tfor (let i = 0; i <= segments; i++) {\n\t\t\tconst segTime = constant * i + time;\n\t\t\tconst rampVal = this._exponentialApproach(\n\t\t\t\tprevEvent.time,\n\t\t\t\tprevEvent.value,\n\t\t\t\tcomputedValue,\n\t\t\t\tconstant,\n\t\t\t\tsegTime\n\t\t\t);\n\t\t\tthis.linearRampToValueAtTime(this._toType(rampVal), segTime);\n\t\t}\n\t\treturn this;\n\t}\n\n\tsetValueAtTime(value: UnitMap[TypeName], time: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tsuper.setValueAtTime(value, time);\n\t\tconst event = this._events.get(computedTime) as TickAutomationEvent;\n\t\tconst previousEvent = this._events.previousEvent(event);\n\t\tconst ticksUntilTime = this._getTicksUntilEvent(\n\t\t\tpreviousEvent,\n\t\t\tcomputedTime\n\t\t);\n\t\tevent.ticks = Math.max(ticksUntilTime, 0);\n\t\treturn this;\n\t}\n\n\tlinearRampToValueAtTime(value: UnitMap[TypeName], time: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tsuper.linearRampToValueAtTime(value, time);\n\t\tconst event = this._events.get(computedTime) as TickAutomationEvent;\n\t\tconst previousEvent = this._events.previousEvent(event);\n\t\tconst ticksUntilTime = this._getTicksUntilEvent(\n\t\t\tpreviousEvent,\n\t\t\tcomputedTime\n\t\t);\n\t\tevent.ticks = Math.max(ticksUntilTime, 0);\n\t\treturn this;\n\t}\n\n\texponentialRampToValueAtTime(value: UnitMap[TypeName], time: Time): this {\n\t\t// approximate it with multiple linear ramps\n\t\ttime = this.toSeconds(time);\n\t\tconst computedVal = this._fromType(value);\n\n\t\t// start from previously scheduled value\n\t\tconst prevEvent = this._events.get(time) as TickAutomationEvent;\n\t\t// approx 10 segments per second\n\t\tconst segments = Math.round(Math.max((time - prevEvent.time) * 10, 1));\n\t\tconst segmentDur = (time - prevEvent.time) / segments;\n\t\tfor (let i = 0; i <= segments; i++) {\n\t\t\tconst segTime = segmentDur * i + prevEvent.time;\n\t\t\tconst rampVal = this._exponentialInterpolate(\n\t\t\t\tprevEvent.time,\n\t\t\t\tprevEvent.value,\n\t\t\t\ttime,\n\t\t\t\tcomputedVal,\n\t\t\t\tsegTime\n\t\t\t);\n\t\t\tthis.linearRampToValueAtTime(this._toType(rampVal), segTime);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Returns the tick value at the time. Takes into account\n\t * any automation curves scheduled on the signal.\n\t * @param event The time to get the tick count at\n\t * @return The number of ticks which have elapsed at the time given any automations.\n\t */\n\tprivate _getTicksUntilEvent(\n\t\tevent: TickAutomationEvent | null,\n\t\ttime: number\n\t): Ticks {\n\t\tif (event === null) {\n\t\t\tevent = {\n\t\t\t\tticks: 0,\n\t\t\t\ttime: 0,\n\t\t\t\ttype: \"setValueAtTime\",\n\t\t\t\tvalue: 0,\n\t\t\t};\n\t\t} else if (isUndef(event.ticks)) {\n\t\t\tconst previousEvent = this._events.previousEvent(event);\n\t\t\tevent.ticks = this._getTicksUntilEvent(previousEvent, event.time);\n\t\t}\n\t\tconst val0 = this._fromType(this.getValueAtTime(event.time));\n\t\tlet val1 = this._fromType(this.getValueAtTime(time));\n\t\t// if it's right on the line, take the previous value\n\t\tconst onTheLineEvent = this._events.get(time);\n\t\tif (\n\t\t\tonTheLineEvent &&\n\t\t\tonTheLineEvent.time === time &&\n\t\t\tonTheLineEvent.type === \"setValueAtTime\"\n\t\t) {\n\t\t\tval1 = this._fromType(this.getValueAtTime(time - this.sampleTime));\n\t\t}\n\t\treturn 0.5 * (time - event.time) * (val0 + val1) + event.ticks;\n\t}\n\n\t/**\n\t * Returns the tick value at the time. Takes into account\n\t * any automation curves scheduled on the signal.\n\t * @param time The time to get the tick count at\n\t * @return The number of ticks which have elapsed at the time given any automations.\n\t */\n\tgetTicksAtTime(time: Time): Ticks {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tconst event = this._events.get(computedTime);\n\t\treturn Math.max(this._getTicksUntilEvent(event, computedTime), 0);\n\t}\n\n\t/**\n\t * Return the elapsed time of the number of ticks from the given time\n\t * @param ticks The number of ticks to calculate\n\t * @param time The time to get the next tick from\n\t * @return The duration of the number of ticks from the given time in seconds\n\t */\n\tgetDurationOfTicks(ticks: Ticks, time: Time): Seconds {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tconst currentTick = this.getTicksAtTime(time);\n\t\treturn this.getTimeOfTick(currentTick + ticks) - computedTime;\n\t}\n\n\t/**\n\t * Given a tick, returns the time that tick occurs at.\n\t * @return The time that the tick occurs.\n\t */\n\tgetTimeOfTick(tick: Ticks): Seconds {\n\t\tconst before = this._events.get(tick, \"ticks\");\n\t\tconst after = this._events.getAfter(tick, \"ticks\");\n\t\tif (before && before.ticks === tick) {\n\t\t\treturn before.time;\n\t\t} else if (\n\t\t\tbefore &&\n\t\t\tafter &&\n\t\t\tafter.type === \"linearRampToValueAtTime\" &&\n\t\t\tbefore.value !== after.value\n\t\t) {\n\t\t\tconst val0 = this._fromType(this.getValueAtTime(before.time));\n\t\t\tconst val1 = this._fromType(this.getValueAtTime(after.time));\n\t\t\tconst delta = (val1 - val0) / (after.time - before.time);\n\t\t\tconst k = Math.sqrt(\n\t\t\t\tMath.pow(val0, 2) - 2 * delta * (before.ticks - tick)\n\t\t\t);\n\t\t\tconst sol1 = (-val0 + k) / delta;\n\t\t\tconst sol2 = (-val0 - k) / delta;\n\t\t\treturn (sol1 > 0 ? sol1 : sol2) + before.time;\n\t\t} else if (before) {\n\t\t\tif (before.value === 0) {\n\t\t\t\treturn Infinity;\n\t\t\t} else {\n\t\t\t\treturn before.time + (tick - before.ticks) / before.value;\n\t\t\t}\n\t\t} else {\n\t\t\treturn tick / this._initialValue;\n\t\t}\n\t}\n\n\t/**\n\t * Convert some number of ticks their the duration in seconds accounting\n\t * for any automation curves starting at the given time.\n\t * @param ticks The number of ticks to convert to seconds.\n\t * @param when When along the automation timeline to convert the ticks.\n\t * @return The duration in seconds of the ticks.\n\t */\n\tticksToTime(ticks: Ticks, when: Time): Seconds {\n\t\treturn this.getDurationOfTicks(ticks, when);\n\t}\n\n\t/**\n\t * The inverse of {@link ticksToTime}. Convert a duration in\n\t * seconds to the corresponding number of ticks accounting for any\n\t * automation curves starting at the given time.\n\t * @param duration The time interval to convert to ticks.\n\t * @param when When along the automation timeline to convert the ticks.\n\t * @return The duration in ticks.\n\t */\n\ttimeToTicks(duration: Time, when: Time): Ticks {\n\t\tconst computedTime = this.toSeconds(when);\n\t\tconst computedDuration = this.toSeconds(duration);\n\t\tconst startTicks = this.getTicksAtTime(computedTime);\n\t\tconst endTicks = this.getTicksAtTime(computedTime + computedDuration);\n\t\treturn endTicks - startTicks;\n\t}\n\n\t/**\n\t * Convert from the type when the unit value is BPM\n\t */\n\tprotected _fromType(val: UnitMap[TypeName]): number {\n\t\tif (this.units === \"bpm\" && this.multiplier) {\n\t\t\treturn 1 / (60 / val / this.multiplier);\n\t\t} else {\n\t\t\treturn super._fromType(val);\n\t\t}\n\t}\n\n\t/**\n\t * Special case of type conversion where the units === \"bpm\"\n\t */\n\tprotected _toType(val: number): UnitMap[TypeName] {\n\t\tif (this.units === \"bpm\" && this.multiplier) {\n\t\t\treturn ((val / this.multiplier) * 60) as UnitMap[TypeName];\n\t\t} else {\n\t\t\treturn super._toType(val);\n\t\t}\n\t}\n\t/**\n\t * A multiplier on the bpm value. Useful for setting a PPQ relative to the base frequency value.\n\t */\n\tget multiplier(): number {\n\t\treturn this._multiplier;\n\t}\n\tset multiplier(m: number) {\n\t\t// get and reset the current value with the new multiplier\n\t\t// might be necessary to clear all the previous values\n\t\tconst currentVal = this.value;\n\t\tthis._multiplier = m;\n\t\tthis.cancelScheduledValues(0);\n\t\tthis.setValueAtTime(currentVal, 0);\n\t}\n}\n" }, { "path": "Tone/core/clock/TickSignal.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { TickSignal } from \"./TickSignal.js\";\n\ndescribe(\"TickSignal\", () => {\n\tBasicTests(TickSignal);\n\n\tit(\"can be created and disposed\", () => {\n\t\tconst tickSignal = new TickSignal();\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"can schedule a change in the future\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(2, 0.2);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"can schedule a ramp in the future\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(2, 0);\n\t\ttickSignal.linearRampToValueAtTime(0.1, 0.2);\n\t\ttickSignal.exponentialRampToValueAtTime(1, 0.4);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks when no changes are scheduled\", () => {\n\t\tconst tickSignal0 = new TickSignal(2);\n\t\texpect(tickSignal0.getTicksAtTime(1)).to.be.closeTo(2, 0.01);\n\t\texpect(tickSignal0.getTicksAtTime(2)).to.be.closeTo(4, 0.01);\n\t\texpect(tickSignal0.getTimeOfTick(4)).to.be.closeTo(2, 0.01);\n\t\ttickSignal0.dispose();\n\n\t\tconst tickSignal1 = new TickSignal(1);\n\t\texpect(tickSignal1.getTicksAtTime(1)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal1.getTicksAtTime(2)).to.be.closeTo(2, 0.01);\n\t\texpect(tickSignal1.getTimeOfTick(2)).to.be.closeTo(2, 0.01);\n\t\ttickSignal1.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when a setValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(2, 0.5);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.75)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1.5, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1.5)).to.be.closeTo(1, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when multiple setValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(2, 1);\n\t\ttickSignal.setValueAtTime(4, 2);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1.5)).to.be.closeTo(2, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(3, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(2.5)).to.be.closeTo(5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(3)).to.be.closeTo(7, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(7)).to.be.closeTo(3, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"if ticks are 0, getTicksAtTime will return 0\", () => {\n\t\tconst tickSignal = new TickSignal(0);\n\t\ttickSignal.setValueAtTime(0, 1);\n\t\ttickSignal.linearRampToValueAtTime(0, 2);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.equal(0);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.equal(0);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.equal(0);\n\t\texpect(tickSignal.getTicksAtTime(3)).to.equal(0);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when a linearRampToValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.linearRampToValueAtTime(2, 1);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.62, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1.5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(3.5, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when multiple linearRampToValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.linearRampToValueAtTime(2, 1);\n\t\ttickSignal.linearRampToValueAtTime(0, 2);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.62, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1.5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(2.5, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(3)).to.be.closeTo(2.5, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when a exponentialRampToValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.exponentialRampToValueAtTime(2, 1);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.6, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1.5, 0.1);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(3.5, 0.1);\n\t\texpect(tickSignal.getTicksAtTime(3)).to.be.closeTo(5.5, 0.1);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"calculates the ticks in the future when multiple exponentialRampToValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.exponentialRampToValueAtTime(2, 1);\n\t\ttickSignal.exponentialRampToValueAtTime(0, 2);\n\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(0.6, 0.01);\n\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(1.5, 0.1);\n\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(1.54, 0.1);\n\t\texpect(tickSignal.getTicksAtTime(3)).to.be.closeTo(1.54, 0.1);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when setTargetAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setTargetAtTime(0.5, 0, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(1.89, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(3.89, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when multiple setTargetAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setTargetAtTime(0.5, 0, 0.1);\n\t\ttickSignal.setTargetAtTime(2, 1, 1);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(1.5, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(2.28, 0.1);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when nothing is scheduled\", () => {\n\t\tconst tickSignal0 = new TickSignal(1);\n\t\texpect(tickSignal0.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal0.getTimeOfTick(1)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal0.getTimeOfTick(2)).to.be.closeTo(2, 0.01);\n\t\texpect(tickSignal0.getTimeOfTick(3)).to.be.closeTo(3, 0.01);\n\t\ttickSignal0.dispose();\n\n\t\tconst tickSignal = new TickSignal(2);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(0.5, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.be.closeTo(1.5, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when setValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(0.5, 1);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(3, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.be.closeTo(5, 0.01);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"returns Infinity if the tick interval is 0\", () => {\n\t\tconst tickSignal = new TickSignal(0);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.equal(Infinity);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when multiple setValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(0.5, 1);\n\t\ttickSignal.setValueAtTime(0, 2);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1.499)).to.be.closeTo(2, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.equal(Infinity);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when a linearRampToValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.linearRampToValueAtTime(2, 1);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(0.75, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(1.25, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.be.closeTo(1.75, 0.1);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when multiple linearRampToValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.linearRampToValueAtTime(2, 1);\n\t\ttickSignal.linearRampToValueAtTime(0, 2);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(1)).to.be.closeTo(0.75, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(1.25, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.equal(Infinity);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when a exponentialRampToValueAtTime is scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.exponentialRampToValueAtTime(2, 1);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(2)).to.be.closeTo(1.25, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.be.closeTo(1.75, 0.1);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"computes the time of a given tick when multiple exponentialRampToValueAtTime are scheduled\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.exponentialRampToValueAtTime(2, 1);\n\t\ttickSignal.exponentialRampToValueAtTime(0, 2);\n\t\texpect(tickSignal.getTimeOfTick(0)).to.be.closeTo(0, 0.01);\n\t\texpect(tickSignal.getTimeOfTick(0.5)).to.be.closeTo(0.5, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(1.5)).to.be.closeTo(1, 0.1);\n\t\texpect(tickSignal.getTimeOfTick(3)).to.equal(Infinity);\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"can schedule multiple types of curves\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(1, 0);\n\t\ttickSignal.exponentialRampToValueAtTime(4, 1);\n\t\ttickSignal.linearRampToValueAtTime(0.2, 2);\n\t\ttickSignal.setValueAtTime(2, 3);\n\t\ttickSignal.linearRampToValueAtTime(2, 4);\n\t\ttickSignal.setTargetAtTime(8, 5, 0.2);\n\n\t\tfor (let time = 0; time < 5; time += 0.2) {\n\t\t\tconst tick = tickSignal.getTicksAtTime(time);\n\t\t\texpect(tickSignal.getTimeOfTick(tick)).to.be.closeTo(time, 0.1);\n\t\t}\n\n\t\ttickSignal.dispose();\n\t});\n\n\tit(\"can get the duration of a tick at any point in time\", () => {\n\t\tconst tickSignal = new TickSignal(1);\n\t\ttickSignal.setValueAtTime(2, 1);\n\t\ttickSignal.setValueAtTime(10, 2);\n\t\texpect(tickSignal.getDurationOfTicks(1, 0)).to.be.closeTo(1, 0.01);\n\t\texpect(tickSignal.getDurationOfTicks(1, 1)).to.be.closeTo(0.5, 0.01);\n\t\texpect(tickSignal.getDurationOfTicks(1, 2)).to.be.closeTo(0.1, 0.01);\n\t\texpect(tickSignal.getDurationOfTicks(2, 1.5)).to.be.closeTo(0.6, 0.01);\n\t});\n\n\tcontext(\"BPM / PPQ\", () => {\n\t\tit(\"can be set as PPQ\", () => {\n\t\t\tconst tickSignal = new TickSignal({\n\t\t\t\tmultiplier: 10,\n\t\t\t\tunits: \"bpm\",\n\t\t\t\tvalue: 120,\n\t\t\t});\n\t\t\texpect(tickSignal.multiplier).to.equal(10);\n\t\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(20, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(40, 0.01);\n\t\t\texpect(tickSignal.getTimeOfTick(40)).to.be.closeTo(2, 0.01);\n\t\t\ttickSignal.dispose();\n\t\t});\n\n\t\tit(\"calculates the ticks in the future when multiple setValueAtTime are scheduled\", () => {\n\t\t\tconst tickSignal = new TickSignal({\n\t\t\t\tmultiplier: 20,\n\t\t\t\tunits: \"bpm\",\n\t\t\t\tvalue: 60,\n\t\t\t});\n\t\t\ttickSignal.setValueAtTime(120, 1);\n\t\t\ttickSignal.setValueAtTime(180, 2);\n\t\t\texpect(tickSignal.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(0.5)).to.be.closeTo(10, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(1)).to.be.closeTo(20, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(1.5)).to.be.closeTo(40, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(2)).to.be.closeTo(60, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(2.5)).to.be.closeTo(90, 0.01);\n\t\t\texpect(tickSignal.getTicksAtTime(3)).to.be.closeTo(120, 0.01);\n\t\t\texpect(tickSignal.getTimeOfTick(120)).to.be.closeTo(3, 0.01);\n\t\t\ttickSignal.dispose();\n\t\t});\n\t});\n\n\tit(\"outputs a signal\", async () => {\n\t\tconst buffer = await Offline((context) => {\n\t\t\tconst sched = new TickSignal(1).connect(context.destination);\n\t\t\tsched.linearRampTo(3, 1, 0);\n\t\t}, 1.01);\n\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(1, 0.01);\n\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(2, 0.01);\n\t\texpect(buffer.getValueAtTime(1)).to.be.closeTo(3, 0.01);\n\t});\n\n\tit(\"outputs a signal with bpm units\", async () => {\n\t\tconst buffer = await Offline((context) => {\n\t\t\tconst sched = new TickSignal({\n\t\t\t\tunits: \"bpm\",\n\t\t\t\tvalue: 120,\n\t\t\t}).connect(context.destination);\n\t\t\tsched.linearRampTo(60, 1, 0);\n\t\t}, 1.01);\n\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(2, 0.01);\n\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(1.5, 0.01);\n\t\texpect(buffer.getValueAtTime(1)).to.be.closeTo(1, 0.01);\n\t});\n\n\tit(\"outputs a signal with bpm units and a multiplier\", async () => {\n\t\tconst buffer = await Offline((context) => {\n\t\t\tconst sched = new TickSignal({\n\t\t\t\tmultiplier: 10,\n\t\t\t\tunits: \"bpm\",\n\t\t\t\tvalue: 60,\n\t\t\t}).connect(context.destination);\n\t\t\tsched.linearRampTo(120, 1, 0);\n\t\t}, 1.01);\n\t\texpect(buffer.getValueAtTime(0)).to.be.closeTo(10, 0.01);\n\t\texpect(buffer.getValueAtTime(0.5)).to.be.closeTo(15, 0.01);\n\t\texpect(buffer.getValueAtTime(1)).to.be.closeTo(20, 0.01);\n\t});\n\n\tcontext(\"Ticks <-> Time\", () => {\n\t\tit(\"converts from time to ticks\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(20);\n\t\t\t\texpect(tickSignal.ticksToTime(20, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(10, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(10, 10).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from time to ticks with a linear ramp on the tempo\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.linearRampTo(2, 2, 1);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.82,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(2, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.82,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 3).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from time to ticks with a setValueAtTime\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.setValueAtTime(2, 1);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(2, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 3).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 0.5).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.75,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from time to ticks with an exponential ramp\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.exponentialRampTo(2, 1, 1);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.75,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(2, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.75,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 3).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from time to ticks with a setTargetAtTime\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.setTargetAtTime(2, 1, 1);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.79,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(2, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.79,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.ticksToTime(1, 3).valueOf()).to.be.closeTo(\n\t\t\t\t\t0.61,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from ticks to time\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(20);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t20,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(0.5, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t10,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(0.5, 2).valueOf()).to.be.closeTo(\n\t\t\t\t\t10,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from ticks to time with a setValueAtTime\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.setValueAtTime(2, 1);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t2,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 2).valueOf()).to.be.closeTo(\n\t\t\t\t\t2,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0.5).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from ticks to time with a linear ramp\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.linearRampTo(2, 1, 1);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 2).valueOf()).to.be.closeTo(\n\t\t\t\t\t2,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0.5).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.12,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from ticks to time with an exponential ramp\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.exponentialRampTo(2, 1, 1);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.44,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 2).valueOf()).to.be.closeTo(\n\t\t\t\t\t2,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0.5).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.09,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"converts from ticks to time with a setTargetAtTime\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst tickSignal = new TickSignal(1);\n\t\t\t\ttickSignal.setTargetAtTime(2, 1, 1);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0).valueOf()).to.be.closeTo(\n\t\t\t\t\t1,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 1).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.31,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 2).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.63,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\texpect(tickSignal.timeToTicks(1, 0.5).valueOf()).to.be.closeTo(\n\t\t\t\t\t1.07,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t\ttickSignal.dispose();\n\t\t\t});\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/TickSignal.ts", "content": "import { Signal, SignalOptions } from \"../../signal/Signal.js\";\nimport { InputNode } from \"../context/ToneAudioNode.js\";\nimport { Seconds, Ticks, Time, UnitMap, UnitName } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { TickParam } from \"./TickParam.js\";\n\ninterface TickSignalOptions\n\textends SignalOptions {\n\tvalue: UnitMap[TypeName];\n\tmultiplier: number;\n}\n\n/**\n * TickSignal extends Tone.Signal, but adds the capability\n * to calculate the number of elapsed ticks. exponential and target curves\n * are approximated with multiple linear ramps.\n *\n * Thank you Bruno Dias, H. Sofia Pinto, and David M. Matos,\n * for your [WAC paper](https://smartech.gatech.edu/bitstream/handle/1853/54588/WAC2016-49.pdf)\n * describing integrating timing functions for tempo calculations.\n */\nexport class TickSignal<\n\tTypeName extends \"hertz\" | \"bpm\",\n> extends Signal {\n\treadonly name: string = \"TickSignal\";\n\n\t/**\n\t * The param which controls the output signal value\n\t */\n\tprotected _param: TickParam;\n\treadonly input: InputNode;\n\n\t/**\n\t * @param value The initial value of the signal\n\t */\n\tconstructor(value?: UnitMap[TypeName]);\n\tconstructor(options: Partial>);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tTickSignal.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"value\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.input = this._param = new TickParam({\n\t\t\tcontext: this.context,\n\t\t\tconvert: options.convert,\n\t\t\tmultiplier: options.multiplier,\n\t\t\tparam: this._constantSource.offset,\n\t\t\tunits: options.units,\n\t\t\tvalue: options.value,\n\t\t});\n\t}\n\n\tstatic getDefaults(): TickSignalOptions {\n\t\treturn Object.assign(Signal.getDefaults(), {\n\t\t\tmultiplier: 1,\n\t\t\tunits: \"hertz\",\n\t\t\tvalue: 1,\n\t\t});\n\t}\n\n\tticksToTime(ticks: Ticks, when: Time): Seconds {\n\t\treturn this._param.ticksToTime(ticks, when);\n\t}\n\n\ttimeToTicks(duration: Time, when: Time): Ticks {\n\t\treturn this._param.timeToTicks(duration, when);\n\t}\n\n\tgetTimeOfTick(tick: Ticks): Seconds {\n\t\treturn this._param.getTimeOfTick(tick);\n\t}\n\n\tgetDurationOfTicks(ticks: Ticks, time: Time): Seconds {\n\t\treturn this._param.getDurationOfTicks(ticks, time);\n\t}\n\n\tgetTicksAtTime(time: Time): Ticks {\n\t\treturn this._param.getTicksAtTime(time);\n\t}\n\n\t/**\n\t * A multiplier on the bpm value. Useful for setting a PPQ relative to the base frequency value.\n\t */\n\tget multiplier(): number {\n\t\treturn this._param.multiplier;\n\t}\n\tset multiplier(m: number) {\n\t\tthis._param.multiplier = m;\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._param.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/clock/TickSource.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { TickSource } from \"./TickSource.js\";\n\ndescribe(\"TickSource\", () => {\n\tBasicTests(TickSource);\n\n\tcontext(\"Constructor\", () => {\n\t\tit(\"can pass in the frequency\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\texpect(source.frequency.value).to.equal(2);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"initially returns stop\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\texpect(source.state).to.equal(\"stopped\");\n\t\t\tsource.dispose();\n\t\t});\n\t});\n\n\tcontext(\"Ticks\", () => {\n\t\tit(\"ticks are 0 before started\", () => {\n\t\t\tconst source = new TickSource();\n\t\t\texpect(source.ticks).to.equal(0);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can set ticks\", () => {\n\t\t\tconst source = new TickSource();\n\t\t\texpect(source.ticks).to.equal(0);\n\t\t\tsource.ticks = 10;\n\t\t\texpect(source.ticks).to.equal(10);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks increment at the rate of the frequency after started\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst source = new TickSource();\n\t\t\t\tsource.start(0);\n\t\t\t\treturn (time) => {\n\t\t\t\t\texpect(source.ticks).to.be.closeTo(time, 0.1);\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"ticks return to 0 after stopped\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst source = new TickSource(2);\n\t\t\t\tsource.start(0).stop(0.4);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time < 0.399) {\n\t\t\t\t\t\texpect(source.ticks).to.be.closeTo(2 * time, 0.01);\n\t\t\t\t\t} else if (time > 0.4) {\n\t\t\t\t\t\texpect(source.ticks).to.be.equal(0);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"returns the paused ticks when paused\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst source = new TickSource(2);\n\t\t\t\tsource.start(0).pause(0.4);\n\t\t\t\tlet pausedTicks = -1;\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time < 0.4) {\n\t\t\t\t\t\tpausedTicks = source.ticks;\n\t\t\t\t\t\texpect(source.ticks).to.be.closeTo(2 * time, 0.01);\n\t\t\t\t\t} else {\n\t\t\t\t\t\texpect(source.ticks).to.be.closeTo(pausedTicks, 0.01);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.5);\n\t\t});\n\n\t\tit(\"ticks restart at 0 when started after stop\", () => {\n\t\t\tconst source = new TickSource(3);\n\t\t\tsource.start(0).stop(1).start(2);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(1.5, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(3, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks remain the same after paused\", () => {\n\t\t\tconst source = new TickSource(3);\n\t\t\tsource.start(0).pause(1);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(1.5, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(3, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks resume where they were paused\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0).pause(1).start(2);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(6, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks return to 0 after pause then stopped\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0).pause(1).start(2).stop(3);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(0, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"handles multiple starts/stops\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(0.3).start(0.4).stop(0.5).start(0.6);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.1)).to.be.closeTo(0.1, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.2)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.4)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.6)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.7)).to.be.closeTo(0.1, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.8)).to.be.closeTo(0.2, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can get ticks when started with an offset\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0, 2).stop(3).start(5, 1);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(6)).to.be.closeTo(2, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can invoke stop multiple times, takes the last invocation\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(3).stop(2).stop(4);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(6)).to.be.closeTo(0, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can set multiple setTicksAtTime\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0, 1).pause(3);\n\t\t\tsource.setTicksAtTime(1, 4);\n\t\t\tsource.stop(5).start(6);\n\t\t\tsource.setTicksAtTime(2, 7);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(3.5)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(6)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(6.5)).to.be.closeTo(0.5, 0.01);\n\t\t\texpect(source.getTicksAtTime(7)).to.be.closeTo(2, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can pass start offset\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0, 2).pause(1).start(2, 1);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(5, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can set ticks at any point\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0, 2).pause(1).start(2);\n\t\t\tsource.setTicksAtTime(10, 1.5);\n\t\t\tsource.setTicksAtTime(2, 3.5);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(10, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(12, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(5, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"get the time of the ticks\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0, 2).pause(1).start(2);\n\t\t\tsource.setTicksAtTime(10, 1.5);\n\t\t\tsource.setTicksAtTime(2, 3.5);\n\t\t\texpect(source.getTimeOfTick(2, 0.9)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTimeOfTick(4, 0.9)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTimeOfTick(10, 3)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTimeOfTick(12, 3)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTimeOfTick(3, 4)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTimeOfTick(5, 4)).to.be.closeTo(5, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can cancel scheduled events\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(3);\n\t\t\tsource.setTicksAtTime(10, 2);\n\t\t\tsource.cancel(1);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(5, 0.01);\n\t\t\texpect(source.getTicksAtTime(6)).to.be.closeTo(6, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"will recompute memoized values when events are modified\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(3).pause(4);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(1, 0.01);\n\t\t\tsource.start(1).pause(2);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(2, 0.01);\n\t\t\tsource.setTicksAtTime(3, 1);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(5, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(5, 0.01);\n\t\t\tsource.cancel(4);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(3, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(5, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(6, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\t});\n\n\tcontext(\"forEachTickBetween\", () => {\n\t\tit(\"invokes a callback function when started\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0);\n\t\t\tlet wasCalled = false;\n\t\t\tsource.forEachTickBetween(0, 2, () => {\n\t\t\t\twasCalled = true;\n\t\t\t});\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"does not invoke callback when not overlapping with tick\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0);\n\t\t\tlet wasCalled = false;\n\t\t\tsource.forEachTickBetween(1.1, 2, () => {\n\t\t\t\twasCalled = true;\n\t\t\t});\n\t\t\texpect(wasCalled).to.equal(false);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"iterates only at times when the state is 'started'\", () => {\n\t\t\tconst source = new TickSource(4);\n\t\t\tsource.start(0.2).pause(2).start(3.5).stop(5);\n\t\t\tlet iterations = 0;\n\t\t\tconst expectedTimes = [\n\t\t\t\t1.2, 1.45, 1.7, 1.95, 3.5, 3.75, 4, 4.25, 4.5, 4.75,\n\t\t\t];\n\t\t\tconst expectedTicks = [4, 5, 6, 7, 7, 8, 9, 10, 11, 12];\n\t\t\tsource.forEachTickBetween(1, 7, (time, ticks) => {\n\t\t\t\texpect(time).to.be.closeTo(expectedTimes[iterations], 0.001);\n\t\t\t\texpect(ticks).to.equal(expectedTicks[iterations]);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(expectedTimes.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can start at time = 0\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0);\n\t\t\tlet iterations = 0;\n\t\t\tsource.forEachTickBetween(0, 0.1, () => {\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(1);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can throw an error in the callback but still invokes all loops\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0);\n\t\t\texpect(() => {\n\t\t\t\tsource.forEachTickBetween(0, 3, () => {\n\t\t\t\t\tthrow new Error(\"should throw\");\n\t\t\t\t});\n\t\t\t}).throws(Error);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"iterates once per tick\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.5);\n\t\t\tlet iterations = 0;\n\t\t\tsource.forEachTickBetween(0, 2, () => {\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(2);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"passes time and tick into the callback\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0.5);\n\t\t\tlet iterations = 0;\n\t\t\tconst times = [0.5, 1.0, 1.5];\n\t\t\tsource.forEachTickBetween(0, 2, (time, ticks) => {\n\t\t\t\texpect(times[ticks]).to.be.closeTo(time, 0.001);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(3);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks = 0 when restarted\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.5).stop(1).start(2);\n\t\t\tlet iterations = 0;\n\t\t\tconst expectedTicks = [0, 0, 1];\n\t\t\tconst expectedTimes = [0.5, 2, 3];\n\t\t\tsource.forEachTickBetween(0, 3.1, (time, ticks) => {\n\t\t\t\texpect(time).to.be.closeTo(expectedTimes[iterations], 0.001);\n\t\t\t\texpect(ticks).to.equal(expectedTicks[iterations]);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(expectedTicks.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"ticks resume after pause when restarted\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.5).pause(2).start(3);\n\t\t\tlet iterations = 0;\n\t\t\tconst expectedTicks = [0, 1, 2];\n\t\t\tconst expectedTimes = [0.5, 1.5, 3];\n\t\t\tsource.forEachTickBetween(0, 3.1, (time, ticks) => {\n\t\t\t\texpect(time).to.be.closeTo(expectedTimes[iterations], 0.001);\n\t\t\t\texpect(ticks).to.equal(expectedTicks[iterations]);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(expectedTicks.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"handles start and stop\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0.5).stop(2);\n\t\t\tlet iterations = 0;\n\t\t\tconst times = [0.5, 1.0, 1.5];\n\t\t\tsource.forEachTickBetween(0, 3, (time, ticks) => {\n\t\t\t\texpect(times[ticks]).to.be.closeTo(time, 0.001);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(3);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"handles multiple start and stop\", () => {\n\t\t\tconst source = new TickSource(2);\n\t\t\tsource.start(0.5).stop(2).start(2.5).stop(4.1);\n\t\t\tlet iterations = 0;\n\t\t\tconst times = [0.5, 1.0, 1.5, 2.5, 3, 3.5, 4];\n\t\t\tsource.forEachTickBetween(0, 10, (time) => {\n\t\t\t\texpect(times[iterations]).to.be.closeTo(time, 0.001);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(times.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"works with a frequency ramp\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.frequency.setValueAtTime(1, 0);\n\t\t\tsource.frequency.linearRampToValueAtTime(4, 1);\n\t\t\tsource.start(0.5);\n\t\t\tlet iterations = 0;\n\t\t\tconst times = [0.5, 0.833, 1.094, 1.344, 1.594, 1.844];\n\t\t\tsource.forEachTickBetween(0, 2, (time, ticks) => {\n\t\t\t\texpect(time).to.be.closeTo(times[ticks], 0.001);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(times.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can start with a tick offset\", () => {\n\t\t\tconst source = new TickSource(10);\n\t\t\tsource.start(0.5, 5);\n\t\t\tlet iterations = 0;\n\t\t\tsource.forEachTickBetween(0, 2, (time, ticks) => {\n\t\t\t\texpect(ticks).to.be.gte(5);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(15);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can handle multiple starts with tick offsets\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.5, 10).stop(2).start(3, 1);\n\t\t\tlet iterations = 0;\n\t\t\tconst expectedTimes = [0.5, 1.5, 3];\n\t\t\tconst expectedTicks = [10, 11, 1];\n\t\t\tsource.forEachTickBetween(0, 4, (time, ticks) => {\n\t\t\t\texpect(time).to.be.closeTo(expectedTimes[iterations], 0.001);\n\t\t\t\texpect(ticks).to.equal(expectedTicks[iterations]);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(expectedTicks.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can set ticks after start\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.4, 3);\n\t\t\tsource.setTicksAtTime(1, 1.4);\n\t\t\tsource.setTicksAtTime(10, 3);\n\t\t\tlet iterations = 0;\n\t\t\tconst expectedTicks = [3, 1, 2, 10];\n\t\t\tsource.forEachTickBetween(0, 4, (time, ticks) => {\n\t\t\t\texpect(ticks).to.equal(expectedTicks[iterations]);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(expectedTicks.length);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can pass in the frequency\", () => {\n\t\t\tconst source = new TickSource(20);\n\t\t\tsource.start(0.5);\n\t\t\tlet iterations = 0;\n\t\t\tlet lastTime = 0.5;\n\t\t\tsource.forEachTickBetween(0.51, 2.01, (time) => {\n\t\t\t\texpect(time - lastTime).to.be.closeTo(0.05, 0.001);\n\t\t\t\tlastTime = time;\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(30);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can iterate from later in the timeline\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0.2);\n\t\t\tlet iterations = 0;\n\t\t\tsource.forEachTickBetween(100, 101, (time, ticks) => {\n\t\t\t\texpect(ticks).to.equal(100);\n\t\t\t\texpect(time).to.be.closeTo(100.2, 0.001);\n\t\t\t\titerations++;\n\t\t\t});\n\t\t\texpect(iterations).to.equal(1);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"always increments by 1 at a fixed rate\", () => {\n\t\t\tconst source = new TickSource(960);\n\t\t\tsource.start(0);\n\t\t\tlet previousTick = -1;\n\t\t\tlet previousTime = -1;\n\t\t\tsource.forEachTickBetween(1000, 1010, (time, ticks) => {\n\t\t\t\texpect(time).to.be.gt(previousTime);\n\t\t\t\tif (previousTick !== -1) {\n\t\t\t\t\texpect(ticks - previousTick).to.equal(1);\n\t\t\t\t}\n\t\t\t\tpreviousTick = ticks;\n\t\t\t\tpreviousTime = time;\n\t\t\t});\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"always increments by 1 when linearly changing rate\", () => {\n\t\t\tconst source = new TickSource(200);\n\t\t\tsource.frequency.setValueAtTime(200, 0);\n\t\t\tsource.frequency.linearRampToValueAtTime(1000, 100);\n\t\t\tsource.start(10);\n\t\t\tlet previousTick = -1;\n\t\t\tlet previousTime = -1;\n\t\t\tsource.forEachTickBetween(10, 30, (time, ticks) => {\n\t\t\t\texpect(time).to.be.gt(previousTime);\n\t\t\t\texpect(ticks - previousTick).to.equal(1);\n\t\t\t\tpreviousTick = ticks;\n\t\t\t\tpreviousTime = time;\n\t\t\t});\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"always increments by 1 when setting values\", () => {\n\t\t\tconst source = new TickSource(200);\n\t\t\tsource.frequency.setValueAtTime(300, 0);\n\t\t\tsource.frequency.setValueAtTime(3, 0.1);\n\t\t\tsource.frequency.setValueAtTime(100, 0.2);\n\t\t\tsource.frequency.setValueAtTime(10, 0.3);\n\t\t\tsource.frequency.setValueAtTime(1000, 0.4);\n\t\t\tsource.frequency.setValueAtTime(1, 0.5);\n\t\t\tsource.frequency.setValueAtTime(50, 0.6);\n\t\t\tsource.start(0);\n\t\t\tlet previousTick = -1;\n\t\t\tlet previousTime = -1;\n\t\t\tsource.forEachTickBetween(0, 10, (time, ticks) => {\n\t\t\t\texpect(time).to.be.gt(previousTime);\n\t\t\t\texpect(ticks - previousTick).to.equal(1);\n\t\t\t\tpreviousTick = ticks;\n\t\t\t\tpreviousTime = time;\n\t\t\t});\n\t\t\tsource.dispose();\n\t\t});\n\t});\n\n\tcontext(\"Seconds\", () => {\n\t\tit(\"get the elapsed time in seconds\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst source = new TickSource(1).start(0);\n\t\t\t\treturn (time) => {\n\t\t\t\t\texpect(source.seconds).to.be.closeTo(time, 0.01);\n\t\t\t\t};\n\t\t\t}, 2);\n\t\t});\n\n\t\tit(\"seconds is 0 before starting\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\texpect(source.seconds).to.be.closeTo(0, 0.001);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can set the seconds\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\texpect(source.seconds).to.be.closeTo(0, 0.001);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"seconds pauses at last second count\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).pause(1);\n\t\t\texpect(source.getSecondsAtTime(0)).to.be.closeTo(0, 0.001);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(1, 0.001);\n\t\t\texpect(source.getSecondsAtTime(2)).to.be.closeTo(1, 0.001);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can handle multiple pauses\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).pause(1).start(2).pause(3).start(4).stop(6);\n\t\t\texpect(source.getSecondsAtTime(0)).to.be.closeTo(0, 0.001);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(1, 0.001);\n\t\t\texpect(source.getSecondsAtTime(2)).to.be.closeTo(1, 0.001);\n\t\t\texpect(source.getSecondsAtTime(2.5)).to.be.closeTo(1.5, 0.001);\n\t\t\texpect(source.getSecondsAtTime(3)).to.be.closeTo(2, 0.001);\n\t\t\texpect(source.getSecondsAtTime(4.5)).to.be.closeTo(2.5, 0.001);\n\t\t\texpect(source.getSecondsAtTime(5)).to.be.closeTo(3, 0.001);\n\t\t\texpect(source.getSecondsAtTime(6)).to.be.closeTo(0, 0.001);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"get the elapsed time in seconds when starting in the future\", () => {\n\t\t\treturn Offline(() => {\n\t\t\t\tconst source = new TickSource(1).start(0.1);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time < 0.1) {\n\t\t\t\t\t\texpect(source.seconds).to.be.closeTo(0, 0.001);\n\t\t\t\t\t} else {\n\t\t\t\t\t\texpect(source.seconds).to.be.closeTo(time - 0.1, 0.01);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 2);\n\t\t});\n\n\t\tit(\"handles multiple starts and stops\", () => {\n\t\t\tconst source = new TickSource(1)\n\t\t\t\t.start(0)\n\t\t\t\t.stop(0.5)\n\t\t\t\t.start(1)\n\t\t\t\t.stop(1.5);\n\t\t\texpect(source.getSecondsAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(0.4)).to.be.closeTo(0.4, 0.01);\n\t\t\texpect(source.getSecondsAtTime(0.5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(0.9)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(1.4)).to.be.closeTo(0.4, 0.01);\n\t\t\texpect(source.getSecondsAtTime(1.5)).to.be.closeTo(0, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"will recompute memoized values when events are modified\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(3).pause(4);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(4)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getSecondsAtTime(5)).to.be.closeTo(1, 0.01);\n\t\t\tsource.start(1).pause(2);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(2)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getSecondsAtTime(3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getSecondsAtTime(4)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getSecondsAtTime(5)).to.be.closeTo(2, 0.01);\n\t\t\tsource.cancel(4);\n\t\t\texpect(source.getSecondsAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getSecondsAtTime(2)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getSecondsAtTime(3)).to.be.closeTo(1, 0.01);\n\t\t\texpect(source.getSecondsAtTime(4)).to.be.closeTo(2, 0.01);\n\t\t\texpect(source.getSecondsAtTime(5)).to.be.closeTo(3, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\t});\n\n\tcontext(\"Frequency\", () => {\n\t\tit(\"can automate frequency with setValueAtTime\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(0.3).start(0.4).stop(0.5).start(0.6);\n\t\t\tsource.frequency.setValueAtTime(2, 0.3);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.1)).to.be.closeTo(0.1, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.2)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.3)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.4)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.45)).to.be.closeTo(0.1, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.6)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.7)).to.be.closeTo(0.2, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.8)).to.be.closeTo(0.4, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can automate frequency with linearRampToValueAtTime\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(1).start(2);\n\t\t\tsource.frequency.linearRampToValueAtTime(2, 2);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(0.56, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(2, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can automate frequency with exponentialRampToValueAtTime\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(1).start(2).stop(5);\n\t\t\tsource.frequency.exponentialRampToValueAtTime(4, 2);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(0.6, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(4, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(8, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\n\t\tit(\"can automate frequency with setTargetAtTime\", () => {\n\t\t\tconst source = new TickSource(1);\n\t\t\tsource.start(0).stop(1).start(2).stop(5);\n\t\t\tsource.frequency.setTargetAtTime(2, 1, 0.5);\n\t\t\texpect(source.getTicksAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(0.5)).to.be.closeTo(0.5, 0.01);\n\t\t\texpect(source.getTicksAtTime(1)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(2)).to.be.closeTo(0, 0.01);\n\t\t\texpect(source.getTicksAtTime(3)).to.be.closeTo(1.86, 0.01);\n\t\t\texpect(source.getTicksAtTime(4)).to.be.closeTo(3.73, 0.01);\n\t\t\texpect(source.getTicksAtTime(5)).to.be.closeTo(0, 0.01);\n\t\t\tsource.dispose();\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/TickSource.ts", "content": "import {\n\tToneWithContext,\n\tToneWithContextOptions,\n} from \"../context/ToneWithContext.js\";\nimport { Seconds, Ticks, Time } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { readOnly } from \"../util/Interface.js\";\nimport { EQ } from \"../util/Math.js\";\nimport {\n\tPlaybackState,\n\tStateTimeline,\n\tStateTimelineEvent,\n} from \"../util/StateTimeline.js\";\nimport { Timeline, TimelineEvent } from \"../util/Timeline.js\";\nimport { isDefined } from \"../util/TypeCheck.js\";\nimport { TickSignal } from \"./TickSignal.js\";\n\ninterface TickSourceOptions extends ToneWithContextOptions {\n\tfrequency: number;\n\tunits: \"bpm\" | \"hertz\";\n}\n\ninterface TickSourceOffsetEvent extends TimelineEvent {\n\tticks: number;\n\ttime: number;\n\tseconds: number;\n}\n\ninterface TickSourceTicksAtTimeEvent extends TimelineEvent {\n\tstate: PlaybackState;\n\ttime: number;\n\tticks: number;\n}\n\ninterface TickSourceSecondsAtTimeEvent extends TimelineEvent {\n\tstate: PlaybackState;\n\ttime: number;\n\tseconds: number;\n}\n\n/**\n * Uses [TickSignal](TickSignal) to track elapsed ticks with complex automation curves.\n */\nexport class TickSource<\n\tTypeName extends \"bpm\" | \"hertz\",\n> extends ToneWithContext {\n\treadonly name: string = \"TickSource\";\n\n\t/**\n\t * The frequency the callback function should be invoked.\n\t */\n\treadonly frequency: TickSignal;\n\n\t/**\n\t * The state timeline\n\t */\n\tprivate _state: StateTimeline = new StateTimeline();\n\n\t/**\n\t * The offset values of the ticks\n\t */\n\tprivate _tickOffset: Timeline = new Timeline();\n\n\t/**\n\t * Memoized values of getTicksAtTime at events with state other than \"started\"\n\t */\n\tprivate _ticksAtTime: Timeline =\n\t\tnew Timeline();\n\n\t/**\n\t * Memoized values of getSecondsAtTime at events with state other than \"started\"\n\t */\n\tprivate _secondsAtTime: Timeline =\n\t\tnew Timeline();\n\n\t/**\n\t * @param frequency The initial frequency that the signal ticks at\n\t */\n\tconstructor(frequency?: number);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tTickSource.getDefaults(),\n\t\t\targuments,\n\t\t\t[\"frequency\"]\n\t\t);\n\t\tsuper(options);\n\n\t\tthis.frequency = new TickSignal({\n\t\t\tcontext: this.context,\n\t\t\tunits: options.units as TypeName,\n\t\t\tvalue: options.frequency,\n\t\t});\n\t\treadOnly(this, \"frequency\");\n\n\t\t// set the initial state\n\t\tthis._state.setStateAtTime(\"stopped\", 0);\n\t\t// add the first event\n\t\tthis.setTicksAtTime(0, 0);\n\t}\n\n\tstatic getDefaults(): TickSourceOptions {\n\t\treturn Object.assign(\n\t\t\t{\n\t\t\t\tfrequency: 1,\n\t\t\t\tunits: \"hertz\" as const,\n\t\t\t},\n\t\t\tToneWithContext.getDefaults()\n\t\t);\n\t}\n\n\t/**\n\t * Returns the playback state of the source, either \"started\", \"stopped\" or \"paused\".\n\t */\n\tget state(): PlaybackState {\n\t\treturn this.getStateAtTime(this.now());\n\t}\n\n\t/**\n\t * Start the clock at the given time. Optionally pass in an offset\n\t * of where to start the tick counter from.\n\t * @param time The time the clock should start\n\t * @param offset The number of ticks to start the source at\n\t */\n\tstart(time: Time, offset?: Ticks): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tif (this._state.getValueAtTime(computedTime) !== \"started\") {\n\t\t\tthis._state.setStateAtTime(\"started\", computedTime);\n\t\t\tif (isDefined(offset)) {\n\t\t\t\tthis.setTicksAtTime(offset, computedTime);\n\t\t\t}\n\t\t\tthis._ticksAtTime.cancel(computedTime);\n\t\t\tthis._secondsAtTime.cancel(computedTime);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop the clock. Stopping the clock resets the tick counter to 0.\n\t * @param time The time when the clock should stop.\n\t */\n\tstop(time: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\t// cancel the previous stop\n\t\tif (this._state.getValueAtTime(computedTime) === \"stopped\") {\n\t\t\tconst event = this._state.get(computedTime);\n\t\t\tif (event && event.time > 0) {\n\t\t\t\tthis._tickOffset.cancel(event.time);\n\t\t\t\tthis._state.cancel(event.time);\n\t\t\t}\n\t\t}\n\t\tthis._state.cancel(computedTime);\n\t\tthis._state.setStateAtTime(\"stopped\", computedTime);\n\t\tthis.setTicksAtTime(0, computedTime);\n\t\tthis._ticksAtTime.cancel(computedTime);\n\t\tthis._secondsAtTime.cancel(computedTime);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Pause the clock. Pausing does not reset the tick counter.\n\t * @param time The time when the clock should stop.\n\t */\n\tpause(time: Time): this {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tif (this._state.getValueAtTime(computedTime) === \"started\") {\n\t\t\tthis._state.setStateAtTime(\"paused\", computedTime);\n\t\t\tthis._ticksAtTime.cancel(computedTime);\n\t\t\tthis._secondsAtTime.cancel(computedTime);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Cancel start/stop/pause and setTickAtTime events scheduled after the given time.\n\t * @param time When to clear the events after\n\t */\n\tcancel(time: Time): this {\n\t\ttime = this.toSeconds(time);\n\t\tthis._state.cancel(time);\n\t\tthis._tickOffset.cancel(time);\n\t\tthis._ticksAtTime.cancel(time);\n\t\tthis._secondsAtTime.cancel(time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the elapsed ticks at the given time\n\t * @param time When to get the tick value\n\t * @return The number of ticks\n\t */\n\tgetTicksAtTime(time?: Time): Ticks {\n\t\tconst computedTime = this.toSeconds(time);\n\t\tconst stopEvent = this._state.getLastState(\n\t\t\t\"stopped\",\n\t\t\tcomputedTime\n\t\t) as StateTimelineEvent;\n\n\t\t// get previously memoized ticks if available\n\t\tconst memoizedEvent = this._ticksAtTime.get(computedTime);\n\n\t\t// this event allows forEachBetween to iterate until the current time\n\t\tconst tmpEvent: StateTimelineEvent = {\n\t\t\tstate: \"paused\",\n\t\t\ttime: computedTime,\n\t\t};\n\t\tthis._state.add(tmpEvent);\n\n\t\t// keep track of the previous offset event\n\t\tlet lastState = memoizedEvent ? memoizedEvent : stopEvent;\n\t\tlet elapsedTicks = memoizedEvent ? memoizedEvent.ticks : 0;\n\t\tlet eventToMemoize: TickSourceTicksAtTimeEvent | null = null;\n\n\t\t// iterate through all the events since the last stop\n\t\tthis._state.forEachBetween(\n\t\t\tlastState.time,\n\t\t\tcomputedTime + this.sampleTime,\n\t\t\t(e) => {\n\t\t\t\tlet periodStartTime = lastState.time;\n\t\t\t\t// if there is an offset event in this period use that\n\t\t\t\tconst offsetEvent = this._tickOffset.get(e.time);\n\t\t\t\tif (offsetEvent && offsetEvent.time >= lastState.time) {\n\t\t\t\t\telapsedTicks = offsetEvent.ticks;\n\t\t\t\t\tperiodStartTime = offsetEvent.time;\n\t\t\t\t}\n\t\t\t\tif (lastState.state === \"started\" && e.state !== \"started\") {\n\t\t\t\t\telapsedTicks +=\n\t\t\t\t\t\tthis.frequency.getTicksAtTime(e.time) -\n\t\t\t\t\t\tthis.frequency.getTicksAtTime(periodStartTime);\n\t\t\t\t\t// do not memoize the temporary event\n\t\t\t\t\tif (e.time !== tmpEvent.time) {\n\t\t\t\t\t\teventToMemoize = {\n\t\t\t\t\t\t\tstate: e.state,\n\t\t\t\t\t\t\ttime: e.time,\n\t\t\t\t\t\t\tticks: elapsedTicks,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlastState = e;\n\t\t\t}\n\t\t);\n\n\t\t// remove the temporary event\n\t\tthis._state.remove(tmpEvent);\n\n\t\t// memoize the ticks at the most recent event with state other than \"started\"\n\t\tif (eventToMemoize) {\n\t\t\tthis._ticksAtTime.add(eventToMemoize);\n\t\t}\n\n\t\t// return the ticks\n\t\treturn elapsedTicks;\n\t}\n\n\t/**\n\t * The number of times the callback was invoked. Starts counting at 0\n\t * and increments after the callback was invoked. Returns -1 when stopped.\n\t */\n\tget ticks(): Ticks {\n\t\treturn this.getTicksAtTime(this.now());\n\t}\n\tset ticks(t: Ticks) {\n\t\tthis.setTicksAtTime(t, this.now());\n\t}\n\n\t/**\n\t * The time since ticks=0 that the TickSource has been running. Accounts\n\t * for tempo curves\n\t */\n\tget seconds(): Seconds {\n\t\treturn this.getSecondsAtTime(this.now());\n\t}\n\tset seconds(s: Seconds) {\n\t\tconst now = this.now();\n\t\tconst ticks = this.frequency.timeToTicks(s, now);\n\t\tthis.setTicksAtTime(ticks, now);\n\t}\n\n\t/**\n\t * Return the elapsed seconds at the given time.\n\t * @param time When to get the elapsed seconds\n\t * @return The number of elapsed seconds\n\t */\n\tgetSecondsAtTime(time: Time): Seconds {\n\t\ttime = this.toSeconds(time);\n\t\tconst stopEvent = this._state.getLastState(\n\t\t\t\"stopped\",\n\t\t\ttime\n\t\t) as StateTimelineEvent;\n\t\t// this event allows forEachBetween to iterate until the current time\n\t\tconst tmpEvent: StateTimelineEvent = { state: \"paused\", time };\n\t\tthis._state.add(tmpEvent);\n\n\t\t// get previously memoized seconds if available\n\t\tconst memoizedEvent = this._secondsAtTime.get(time);\n\n\t\t// keep track of the previous offset event\n\t\tlet lastState = memoizedEvent ? memoizedEvent : stopEvent;\n\t\tlet elapsedSeconds = memoizedEvent ? memoizedEvent.seconds : 0;\n\t\tlet eventToMemoize: TickSourceSecondsAtTimeEvent | null = null;\n\n\t\t// iterate through all the events since the last stop\n\t\tthis._state.forEachBetween(\n\t\t\tlastState.time,\n\t\t\ttime + this.sampleTime,\n\t\t\t(e) => {\n\t\t\t\tlet periodStartTime = lastState.time;\n\t\t\t\t// if there is an offset event in this period use that\n\t\t\t\tconst offsetEvent = this._tickOffset.get(e.time);\n\t\t\t\tif (offsetEvent && offsetEvent.time >= lastState.time) {\n\t\t\t\t\telapsedSeconds = offsetEvent.seconds;\n\t\t\t\t\tperiodStartTime = offsetEvent.time;\n\t\t\t\t}\n\t\t\t\tif (lastState.state === \"started\" && e.state !== \"started\") {\n\t\t\t\t\telapsedSeconds += e.time - periodStartTime;\n\t\t\t\t\t// do not memoize the temporary event\n\t\t\t\t\tif (e.time !== tmpEvent.time) {\n\t\t\t\t\t\teventToMemoize = {\n\t\t\t\t\t\t\tstate: e.state,\n\t\t\t\t\t\t\ttime: e.time,\n\t\t\t\t\t\t\tseconds: elapsedSeconds,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlastState = e;\n\t\t\t}\n\t\t);\n\n\t\t// remove the temporary event\n\t\tthis._state.remove(tmpEvent);\n\n\t\t// memoize the seconds at the most recent event with state other than \"started\"\n\t\tif (eventToMemoize) {\n\t\t\tthis._secondsAtTime.add(eventToMemoize);\n\t\t}\n\n\t\t// return the seconds\n\t\treturn elapsedSeconds;\n\t}\n\n\t/**\n\t * Set the clock's ticks at the given time.\n\t * @param ticks The tick value to set\n\t * @param time When to set the tick value\n\t */\n\tsetTicksAtTime(ticks: Ticks, time: Time): this {\n\t\ttime = this.toSeconds(time);\n\t\tthis._tickOffset.cancel(time);\n\t\tthis._tickOffset.add({\n\t\t\tseconds: this.frequency.getDurationOfTicks(ticks, time),\n\t\t\tticks,\n\t\t\ttime,\n\t\t});\n\t\tthis._ticksAtTime.cancel(time);\n\t\tthis._secondsAtTime.cancel(time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Returns the scheduled state at the given time.\n\t * @param time The time to query.\n\t */\n\tgetStateAtTime(time: Time): PlaybackState {\n\t\ttime = this.toSeconds(time);\n\t\treturn this._state.getValueAtTime(time);\n\t}\n\n\t/**\n\t * Get the time of the given tick. The second argument\n\t * is when to test before. Since ticks can be set (with setTicksAtTime)\n\t * there may be multiple times for a given tick value.\n\t * @param tick The tick number.\n\t * @param before When to measure the tick value from.\n\t * @return The time of the tick\n\t */\n\tgetTimeOfTick(tick: Ticks, before = this.now()): Seconds {\n\t\tconst offset = this._tickOffset.get(before) as TickSourceOffsetEvent;\n\t\tconst event = this._state.get(before) as StateTimelineEvent;\n\t\tconst startTime = Math.max(offset.time, event.time);\n\t\tconst absoluteTicks =\n\t\t\tthis.frequency.getTicksAtTime(startTime) + tick - offset.ticks;\n\t\treturn this.frequency.getTimeOfTick(absoluteTicks);\n\t}\n\n\t/**\n\t * Invoke the callback event at all scheduled ticks between the\n\t * start time and the end time\n\t * @param startTime The beginning of the search range\n\t * @param endTime The end of the search range\n\t * @param callback The callback to invoke with each tick\n\t */\n\tforEachTickBetween(\n\t\tstartTime: number,\n\t\tendTime: number,\n\t\tcallback: (when: Seconds, ticks: Ticks) => void\n\t): this {\n\t\t// only iterate through the sections where it is \"started\"\n\t\tlet lastStateEvent = this._state.get(startTime);\n\t\tthis._state.forEachBetween(startTime, endTime, (event) => {\n\t\t\tif (\n\t\t\t\tlastStateEvent &&\n\t\t\t\tlastStateEvent.state === \"started\" &&\n\t\t\t\tevent.state !== \"started\"\n\t\t\t) {\n\t\t\t\tthis.forEachTickBetween(\n\t\t\t\t\tMath.max(lastStateEvent.time, startTime),\n\t\t\t\t\tevent.time - this.sampleTime,\n\t\t\t\t\tcallback\n\t\t\t\t);\n\t\t\t}\n\t\t\tlastStateEvent = event;\n\t\t});\n\n\t\tlet error: Error | null = null;\n\n\t\tif (lastStateEvent && lastStateEvent.state === \"started\") {\n\t\t\tconst maxStartTime = Math.max(lastStateEvent.time, startTime);\n\t\t\t// figure out the difference between the frequency ticks and the\n\t\t\tconst startTicks = this.frequency.getTicksAtTime(maxStartTime);\n\t\t\tconst ticksAtStart = this.frequency.getTicksAtTime(\n\t\t\t\tlastStateEvent.time\n\t\t\t);\n\t\t\tconst diff = startTicks - ticksAtStart;\n\t\t\tlet offset = Math.ceil(diff) - diff;\n\t\t\t// guard against floating point issues\n\t\t\toffset = EQ(offset, 1) ? 0 : offset;\n\t\t\tlet nextTickTime = this.frequency.getTimeOfTick(\n\t\t\t\tstartTicks + offset\n\t\t\t);\n\t\t\twhile (nextTickTime < endTime) {\n\t\t\t\ttry {\n\t\t\t\t\tcallback(\n\t\t\t\t\t\tnextTickTime,\n\t\t\t\t\t\tMath.round(this.getTicksAtTime(nextTickTime))\n\t\t\t\t\t);\n\t\t\t\t} catch (e) {\n\t\t\t\t\terror = e;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tnextTickTime += this.frequency.getDurationOfTicks(\n\t\t\t\t\t1,\n\t\t\t\t\tnextTickTime\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (error) {\n\t\t\tthrow error;\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._state.dispose();\n\t\tthis._tickOffset.dispose();\n\t\tthis._ticksAtTime.dispose();\n\t\tthis._secondsAtTime.dispose();\n\t\tthis.frequency.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/clock/Ticker.test.ts", "content": "import { expect } from \"chai\";\n\nimport { Ticker } from \"./Ticker.js\";\n\ndescribe(\"Ticker\", () => {\n\tfunction empty(): void {\n\t\t// do nothing\n\t}\n\n\tit(\"can be created and disposed\", () => {\n\t\tconst ticker = new Ticker(empty, \"offline\", 1);\n\t\tticker.dispose();\n\t});\n\n\tit(\"can adjust the type\", () => {\n\t\tconst ticker = new Ticker(empty, \"worker\", 0.1);\n\t\texpect(ticker.type).to.equal(\"worker\");\n\t\tticker.type = \"timeout\";\n\t\texpect(ticker.type).to.equal(\"timeout\");\n\t\tticker.type = \"offline\";\n\t\texpect(ticker.type).to.equal(\"offline\");\n\t\tticker.dispose();\n\t});\n\n\tit(\"can get/set the updateInterval\", () => {\n\t\tconst ticker = new Ticker(empty, \"worker\", 0.1);\n\t\texpect(ticker.updateInterval).to.equal(0.1);\n\t\tticker.updateInterval = 0.5;\n\t\texpect(ticker.updateInterval).to.equal(0.5);\n\t\tticker.dispose();\n\t});\n\n\tcontext(\"timeout\", () => {\n\t\tit(\"provides a callback when set to timeout\", (done) => {\n\t\t\tconst ticker = new Ticker(\n\t\t\t\t() => {\n\t\t\t\t\tticker.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\t\"timeout\",\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can adjust the interval when set to timeout\", (done) => {\n\t\t\tconst ticker = new Ticker(\n\t\t\t\t() => {\n\t\t\t\t\tticker.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\t\"timeout\",\n\t\t\t\t0.01\n\t\t\t);\n\t\t\tticker.updateInterval = 0.1;\n\t\t});\n\t});\n\n\tcontext(\"worker\", () => {\n\t\tit(\"provides a callback when set to worker\", (done) => {\n\t\t\tconst ticker = new Ticker(\n\t\t\t\t() => {\n\t\t\t\t\tticker.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\t\"worker\",\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"falls back to timeout if the constructor throws an error\", (done) => {\n\t\t\tconst URL = window.URL;\n\t\t\t// @ts-ignore\n\t\t\twindow.URL = null;\n\t\t\tconst ticker = new Ticker(\n\t\t\t\t() => {\n\t\t\t\t\texpect(ticker.type).to.equal(\"timeout\");\n\t\t\t\t\tticker.dispose();\n\t\t\t\t\twindow.URL = URL;\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\t\"worker\",\n\t\t\t\t0.01\n\t\t\t);\n\t\t});\n\n\t\tit(\"can adjust the interval when set to worker\", (done) => {\n\t\t\tconst ticker = new Ticker(\n\t\t\t\t() => {\n\t\t\t\t\tticker.dispose();\n\t\t\t\t\tdone();\n\t\t\t\t},\n\t\t\t\t\"worker\",\n\t\t\t\t0.01\n\t\t\t);\n\t\t\tticker.updateInterval = 0.1;\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/Ticker.ts", "content": "import { Seconds } from \"../type/Units.js\";\n\nexport type TickerClockSource = \"worker\" | \"timeout\" | \"offline\";\n\n/**\n * A class which provides a reliable callback using either\n * a Web Worker, or if that isn't supported, falls back to setTimeout.\n */\nexport class Ticker {\n\t/**\n\t * Either \"worker\" or \"timeout\" or \"offline\"\n\t */\n\tprivate _type: TickerClockSource;\n\n\t/**\n\t * The update interval of the worker\n\t */\n\tprivate _updateInterval!: Seconds;\n\n\t/**\n\t * The lowest allowable interval, preferably calculated from context sampleRate\n\t */\n\tprivate _minimumUpdateInterval: Seconds;\n\n\t/**\n\t * The callback to invoke at regular intervals\n\t */\n\tprivate _callback: () => void;\n\n\t/**\n\t * track the callback interval\n\t */\n\tprivate _timeout!: ReturnType;\n\n\t/**\n\t * private reference to the worker\n\t */\n\tprivate _worker!: Worker;\n\n\tconstructor(\n\t\tcallback: () => void,\n\t\ttype: TickerClockSource,\n\t\tupdateInterval: Seconds,\n\t\tcontextSampleRate?: number\n\t) {\n\t\tthis._callback = callback;\n\t\tthis._type = type;\n\t\tthis._minimumUpdateInterval = Math.max(\n\t\t\t128 / (contextSampleRate || 44100),\n\t\t\t0.001\n\t\t);\n\t\tthis.updateInterval = updateInterval;\n\n\t\t// create the clock source for the first time\n\t\tthis._createClock();\n\t}\n\n\t/**\n\t * Generate a web worker\n\t */\n\tprivate _createWorker(): void {\n\t\tconst blob = new Blob(\n\t\t\t[\n\t\t\t\t/* javascript */ `\n\t\t\t// the initial timeout time\n\t\t\tlet timeoutTime = ${(this._updateInterval * 1000).toFixed(1)};\n\t\t\t// onmessage callback\n\t\t\tself.onmessage = function(msg){\n\t\t\t\ttimeoutTime = parseInt(msg.data);\n\t\t\t};\n\t\t\t// the tick function which posts a message\n\t\t\t// and schedules a new tick\n\t\t\tfunction tick(){\n\t\t\t\tsetTimeout(tick, timeoutTime);\n\t\t\t\tself.postMessage('tick');\n\t\t\t}\n\t\t\t// call tick initially\n\t\t\ttick();\n\t\t\t`,\n\t\t\t],\n\t\t\t{ type: \"text/javascript\" }\n\t\t);\n\t\tconst blobUrl = URL.createObjectURL(blob);\n\t\tconst worker = new Worker(blobUrl);\n\n\t\tworker.onmessage = this._callback.bind(this);\n\n\t\tthis._worker = worker;\n\t}\n\n\t/**\n\t * Create a timeout loop\n\t */\n\tprivate _createTimeout(): void {\n\t\tthis._timeout = setTimeout(() => {\n\t\t\tthis._createTimeout();\n\t\t\tthis._callback();\n\t\t}, this._updateInterval * 1000);\n\t}\n\n\t/**\n\t * Create the clock source.\n\t */\n\tprivate _createClock(): void {\n\t\tif (this._type === \"worker\") {\n\t\t\ttry {\n\t\t\t\tthis._createWorker();\n\t\t\t\t// eslint-disable-next-line unused-imports/no-unused-vars\n\t\t\t} catch (e) {\n\t\t\t\t// workers not supported, fallback to timeout\n\t\t\t\tthis._type = \"timeout\";\n\t\t\t\tthis._createClock();\n\t\t\t}\n\t\t} else if (this._type === \"timeout\") {\n\t\t\tthis._createTimeout();\n\t\t}\n\t}\n\n\t/**\n\t * Clean up the current clock source\n\t */\n\tprivate _disposeClock(): void {\n\t\tif (this._timeout) {\n\t\t\tclearTimeout(this._timeout);\n\t\t}\n\t\tif (this._worker) {\n\t\t\tthis._worker.terminate();\n\t\t\tthis._worker.onmessage = null;\n\t\t}\n\t}\n\n\t/**\n\t * The rate in seconds the ticker will update\n\t */\n\tget updateInterval(): Seconds {\n\t\treturn this._updateInterval;\n\t}\n\tset updateInterval(interval: Seconds) {\n\t\tthis._updateInterval = Math.max(interval, this._minimumUpdateInterval);\n\t\tif (this._type === \"worker\") {\n\t\t\tthis._worker?.postMessage(this._updateInterval * 1000);\n\t\t}\n\t}\n\n\t/**\n\t * The type of the ticker, either a worker or a timeout\n\t */\n\tget type(): TickerClockSource {\n\t\treturn this._type;\n\t}\n\tset type(type: TickerClockSource) {\n\t\tthis._disposeClock();\n\t\tthis._type = type;\n\t\tthis._createClock();\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): void {\n\t\tthis._disposeClock();\n\t}\n}\n" }, { "path": "Tone/core/clock/Transport.test.ts", "content": "// importing for side affects\nimport \"../context/Destination.js\";\n\nimport { expect } from \"chai\";\n\nimport { warns } from \"../../../test/helper/Basic.js\";\nimport { atTime, Offline, whenBetween } from \"../../../test/helper/Offline.js\";\nimport { Synth } from \"../../instrument/Synth.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { Time } from \"../type/Time.js\";\nimport { TransportTime } from \"../type/TransportTime.js\";\nimport { noOp } from \"../util/Interface.js\";\nimport { TransportInstance } from \"./Transport.js\";\n\ndescribe(\"Transport\", () => {\n\tcontext(\"BPM and timeSignature\", () => {\n\t\tit(\"can get and set bpm\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.bpm.value = 125;\n\t\t\t\texpect(transport.bpm.value).to.be.closeTo(125, 0.001);\n\t\t\t\ttransport.bpm.value = 120;\n\t\t\t\texpect(transport.bpm.value).to.equal(120);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get and set timeSignature as both an array or number\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.timeSignature = [6, 8];\n\t\t\t\texpect(transport.timeSignature).to.equal(3);\n\t\t\t\ttransport.timeSignature = 5;\n\t\t\t\texpect(transport.timeSignature).to.equal(5);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get and set timeSignature as both an array or number\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.timeSignature = [6, 8];\n\t\t\t\texpect(transport.timeSignature).to.equal(3);\n\t\t\t\ttransport.timeSignature = 5;\n\t\t\t\texpect(transport.timeSignature).to.equal(5);\n\t\t\t});\n\t\t});\n\t});\n\n\tcontext(\"looping\", () => {\n\t\tit(\"can get and set loop points\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.loopStart = 0.2;\n\t\t\t\ttransport.loopEnd = 0.4;\n\t\t\t\texpect(transport.loopStart).to.be.closeTo(0.2, 0.01);\n\t\t\t\texpect(transport.loopEnd).to.be.closeTo(0.4, 0.01);\n\t\t\t\ttransport.setLoopPoints(0, \"1m\");\n\t\t\t\texpect(transport.loopStart).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(transport.loopEnd).to.be.closeTo(\n\t\t\t\t\ttransport.toSeconds(\"1m\"),\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can loop events scheduled on the transport\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t}, 0);\n\t\t\t\ttransport.setLoopPoints(0, 0.1).start(0);\n\t\t\t\ttransport.loop = true;\n\t\t\t}, 0.41);\n\t\t\texpect(invocations).to.equal(5);\n\t\t});\n\n\t\tit(\"jumps to the loopStart after the loopEnd point\", async () => {\n\t\t\tlet looped = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.on(\"loop\", () => {\n\t\t\t\t\tlooped = true;\n\t\t\t\t});\n\t\t\t\ttransport.loop = true;\n\t\t\t\ttransport.loopEnd = 1;\n\t\t\t\ttransport.seconds = 2;\n\t\t\t\ttransport.start();\n\t\t\t}, 0.4);\n\t\t\texpect(looped).to.equal(true);\n\t\t});\n\t});\n\n\tcontext(\"nextSubdivision\", () => {\n\t\tit(\"returns 0 if the transports not started\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.nextSubdivision()).to.equal(0);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get the next subdivision of the transport\", async () => {\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0);\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0.05, 0.07, () => {\n\t\t\t\t\t\texpect(transport.nextSubdivision(0.5)).to.be.closeTo(\n\t\t\t\t\t\t\t0.5,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(transport.nextSubdivision(0.04)).to.be.closeTo(\n\t\t\t\t\t\t\t0.08,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(transport.nextSubdivision(2)).to.be.closeTo(\n\t\t\t\t\t\t\t2,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t\twhenBetween(time, 0.09, 0.1, () => {\n\t\t\t\t\t\texpect(transport.nextSubdivision(0.04)).to.be.closeTo(\n\t\t\t\t\t\t\t0.12,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(transport.nextSubdivision(\"8n\")).to.be.closeTo(\n\t\t\t\t\t\t\t0.25,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\t});\n\n\tcontext(\"PPQ\", () => {\n\t\tit(\"can get and set pulses per quarter\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.PPQ = 96;\n\t\t\t\texpect(transport.PPQ).to.equal(96);\n\t\t\t});\n\t\t});\n\n\t\tit(\"schedules a quarter note at the same time with a different PPQ\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.PPQ = 1;\n\t\t\t\tconst id = transport.schedule((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(transport.toSeconds(\"4n\"), 0.1);\n\t\t\t\t\ttransport.clear(id);\n\t\t\t\t}, \"4n\");\n\t\t\t\ttransport.start();\n\t\t\t});\n\t\t});\n\n\t\tit(\"invokes the right number of ticks with a different PPQ\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.bpm.value = 120;\n\t\t\t\tconst ppq = 20;\n\t\t\t\ttransport.PPQ = ppq;\n\t\t\t\ttransport.start();\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.5) {\n\t\t\t\t\t\texpect(transport.ticks).to.be.within(ppq, ppq * 1.2);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.55);\n\t\t});\n\t});\n\n\tcontext(\"position\", () => {\n\t\tit(\"can jump to a specific tick number\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.ticks = 200;\n\t\t\t\texpect(transport.ticks).to.equal(200);\n\t\t\t\ttransport.start(0);\n\t\t\t\tlet tested = false;\n\t\t\t\treturn () => {\n\t\t\t\t\tif (!tested) {\n\t\t\t\t\t\texpect(transport.ticks).to.at.least(200);\n\t\t\t\t\t\ttested = true;\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can get the current position in BarsBeatsSixteenths\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.position).to.equal(\"0:0:0\");\n\t\t\t\ttransport.start(0);\n\t\t\t\treturn atTime(0.05, () => {\n\t\t\t\t\texpect(transport.position).to.not.equal(\"0:0:0\");\n\t\t\t\t});\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can get the current position in seconds\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.seconds).to.equal(0);\n\t\t\t\ttransport.start(0.05);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.05) {\n\t\t\t\t\t\texpect(transport.seconds).to.be.closeTo(\n\t\t\t\t\t\t\ttime - 0.05,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can get the current position in seconds during a bpm ramp\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.seconds).to.equal(0);\n\t\t\t\ttransport.start(0.05);\n\t\t\t\ttransport.bpm.linearRampTo(60, 0.5, 0.5);\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.05) {\n\t\t\t\t\t\texpect(transport.seconds).to.be.closeTo(\n\t\t\t\t\t\t\ttime - 0.05,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.7);\n\t\t});\n\n\t\tit(\"can set the current position in seconds\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.seconds).to.equal(0);\n\t\t\t\ttransport.seconds = 3;\n\t\t\t\texpect(transport.seconds).to.be.closeTo(3, 0.01);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule the current seconds position\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start();\n\n\t\t\t\tlet scheduled = false;\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.5 && !scheduled) {\n\t\t\t\t\t\tscheduled = true;\n\t\t\t\t\t\ttransport.setSecondsAtTime(3, 0.5);\n\t\t\t\t\t}\n\n\t\t\t\t\twhenBetween(time, 0, 0.5, () => {\n\t\t\t\t\t\texpect(transport.seconds).to.be.closeTo(time, 0.01);\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.5, 1, () => {\n\t\t\t\t\t\texpect(transport.seconds).to.be.closeTo(\n\t\t\t\t\t\t\t2.5 + time,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 1);\n\t\t});\n\n\t\tit(\"can set the current position in BarsBeatsSixteenths\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\texpect(transport.position).to.equal(\"0:0:0\");\n\t\t\t\ttransport.position = \"3:0\";\n\t\t\t\texpect(transport.position).to.equal(\"3:0:0\");\n\t\t\t\ttransport.position = \"0:0\";\n\t\t\t\texpect(transport.position).to.equal(\"0:0:0\");\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get the progress of the loop\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.setLoopPoints(0, \"1m\").start();\n\t\t\t\ttransport.loop = true;\n\t\t\t\texpect(transport.progress).to.be.equal(0);\n\t\t\t\ttransport.position = \"2n\";\n\t\t\t\texpect(transport.progress).to.be.closeTo(0.5, 0.001);\n\t\t\t\ttransport.position =\n\t\t\t\t\tTime(\"2n\").valueOf() + Time(\"4n\").valueOf();\n\t\t\t\texpect(transport.progress).to.be.closeTo(0.75, 0.001);\n\t\t\t});\n\t\t});\n\n\t\tit(\"progress is always 0 when not looping\", () => {\n\t\t\treturn Offline(({ transport }) => {\n\t\t\t\ttransport.loop = false;\n\t\t\t\ttransport.start();\n\t\t\t\treturn atTime(0.1, () => {\n\t\t\t\t\texpect(transport.progress).to.be.equal(0);\n\t\t\t\t});\n\t\t\t}, 0.2);\n\t\t});\n\n\t\tit(\"invokes the first callback time when the scheduled time is a non-integer tick time\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline(({ transport }) => {\n\t\t\t\t// choose a value which is not cleanly representable as ticks\n\t\t\t\tconst problemValue = Time(100, \"i\").toSeconds() + 0.01;\n\t\t\t\ttransport.seconds = problemValue;\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\twasCalled = true;\n\t\t\t\t}, problemValue);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.2);\n\t\t\texpect(wasCalled).to.be.true;\n\t\t});\n\n\t\tit(\"setting the same ticks value twice does not emit twice\", async () => {\n\t\t\tawait Offline(({ transport }) => {\n\t\t\t\tlet callCount = 0;\n\t\t\t\ttransport.on(\"ticks\", () => {\n\t\t\t\t\tcallCount++;\n\t\t\t\t});\n\t\t\t\ttransport.ticks = 100;\n\t\t\t\texpect(transport.ticks).to.equal(100);\n\t\t\t\texpect(callCount).to.equal(1);\n\n\t\t\t\t// set it to the same value again has no change\n\t\t\t\ttransport.ticks = 100;\n\t\t\t\texpect(callCount).to.equal(1);\n\t\t\t}, 0.1);\n\t\t});\n\t});\n\n\tcontext(\"state\", () => {\n\t\tit(\"can start, pause, and restart\", async () => {\n\t\t\tconst buffer = await Offline(({ transport }) => {\n\t\t\t\ttransport.start(0).pause(0.2).start(0.4);\n\n\t\t\t\tconst pulse = new Signal(0).toDestination();\n\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tpulse.setValueAtTime(1, time);\n\t\t\t\t\tpulse.setValueAtTime(0, time + 0.1);\n\t\t\t\t}, 0);\n\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tpulse.setValueAtTime(1, time);\n\t\t\t\t\tpulse.setValueAtTime(0, time + 0.1);\n\t\t\t\t}, 0.3);\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0, 0.2, () => {\n\t\t\t\t\t\texpect(transport.state).to.equal(\"started\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.2, 0.4, () => {\n\t\t\t\t\t\texpect(transport.state).to.equal(\"paused\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.4, Infinity, () => {\n\t\t\t\t\t\texpect(transport.state).to.equal(\"started\");\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.6);\n\t\t\tbuffer.forEach((sample, time) => {\n\t\t\t\twhenBetween(time, 0, 0.01, () => {\n\t\t\t\t\texpect(sample).to.equal(1);\n\t\t\t\t});\n\t\t\t\twhenBetween(time, 0.1, 0.11, () => {\n\t\t\t\t\texpect(sample).to.equal(0);\n\t\t\t\t});\n\t\t\t\twhenBetween(time, 0.502, 0.51, () => {\n\t\t\t\t\texpect(sample).to.equal(1);\n\t\t\t\t});\n\t\t\t});\n\t\t});\n\t});\n\n\tcontext(\"ticks\", () => {\n\t\tit(\"resets ticks on stop but not on pause\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0).pause(0.1).stop(0.2);\n\t\t\t\texpect(transport.getTicksAtTime(0)).to.be.equal(\n\t\t\t\t\tMath.floor(transport.PPQ * 0)\n\t\t\t\t);\n\t\t\t\texpect(transport.getTicksAtTime(0.05)).to.be.closeTo(\n\t\t\t\t\tMath.floor(transport.PPQ * 0.1),\n\t\t\t\t\t0.5\n\t\t\t\t);\n\t\t\t\texpect(transport.getTicksAtTime(0.1)).to.be.closeTo(\n\t\t\t\t\tMath.floor(transport.PPQ * 0.2),\n\t\t\t\t\t0.5\n\t\t\t\t);\n\t\t\t\texpect(transport.getTicksAtTime(0.15)).to.be.closeTo(\n\t\t\t\t\tMath.floor(transport.PPQ * 0.2),\n\t\t\t\t\t0.5\n\t\t\t\t);\n\t\t\t\texpect(transport.getTicksAtTime(0.2)).to.be.equal(0);\n\t\t\t}, 0.3);\n\t\t});\n\n\t\tit(\"tracks ticks after start\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.bpm.value = 120;\n\t\t\t\tconst ppq = transport.PPQ;\n\t\t\t\ttransport.start();\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.5) {\n\t\t\t\t\t\texpect(transport.ticks).to.at.least(ppq);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.6);\n\t\t});\n\n\t\tit(\"can start with a tick offset\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0, \"200i\");\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time < 0.01) {\n\t\t\t\t\t\texpect(transport.ticks).to.at.least(200);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can toggle the state of the transport\", async () => {\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.toggle(0);\n\t\t\t\ttransport.toggle(0.2);\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\twhenBetween(time, 0, 0.2, () => {\n\t\t\t\t\t\texpect(transport.state).to.equal(\"started\");\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.2, Infinity, () => {\n\t\t\t\t\t\texpect(transport.state).to.equal(\"stopped\");\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"tracks ticks correctly with a different PPQ and BPM\", async () => {\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.PPQ = 96;\n\t\t\t\ttransport.bpm.value = 90;\n\t\t\t\ttransport.start();\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.5) {\n\t\t\t\t\t\texpect(transport.ticks).to.at.least(72);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.6);\n\t\t});\n\n\t\tit(\"can set the ticks while started\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tconst times = [0, 1.5];\n\t\t\tawait Offline(({ transport }) => {\n\t\t\t\ttransport.PPQ = 1;\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(times[invocations], 0.01);\n\t\t\t\t\tinvocations++;\n\t\t\t\t}, 0);\n\t\t\t\ttransport.start(0);\n\t\t\t\treturn atTime(1.1, () => {\n\t\t\t\t\ttransport.ticks = 0;\n\t\t\t\t});\n\t\t\t}, 2.5);\n\t\t\texpect(invocations).to.equal(2);\n\t\t});\n\n\t\tit(\"can schedule the ticks\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start();\n\n\t\t\t\tlet scheduled = false;\n\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.5 && !scheduled) {\n\t\t\t\t\t\tscheduled = true;\n\t\t\t\t\t\ttransport.setTicksAtTime(0, 0.5);\n\t\t\t\t\t}\n\n\t\t\t\t\twhenBetween(time, 0, 0.5, () => {\n\t\t\t\t\t\texpect(transport.ticks).to.be.closeTo(\n\t\t\t\t\t\t\ttransport.toTicks(time),\n\t\t\t\t\t\t\t1\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\n\t\t\t\t\twhenBetween(time, 0.5, 1, () => {\n\t\t\t\t\t\texpect(transport.ticks).to.be.closeTo(\n\t\t\t\t\t\t\ttransport.toTicks(time - 0.5),\n\t\t\t\t\t\t\t1\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t};\n\t\t\t}, 1);\n\t\t});\n\t});\n\n\tcontext(\"schedule\", () => {\n\t\tit(\"can schedule an event on the timeline\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.schedule(() => {}, 0);\n\t\t\t\texpect(eventID).to.be.a(\"number\");\n\t\t\t});\n\t\t});\n\n\t\tit(\"scheduled event gets invoked with the time of the event\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime, 0.01);\n\t\t\t\t\twasCalled = true;\n\t\t\t\t}, 0);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.2);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"can schedule events with TransportTime\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eighth = transport.toSeconds(\"8n\");\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime + eighth, 0.01);\n\t\t\t\t\twasCalled = true;\n\t\t\t\t}, TransportTime(\"8n\"));\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.5);\n\t\t\texpect(wasCalled).to.be.true;\n\t\t});\n\n\t\tit(\"can clear a scheduled event\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.schedule(() => {\n\t\t\t\t\tthrow new Error(\"should not call this function\");\n\t\t\t\t}, 0);\n\t\t\t\ttransport.clear(eventID);\n\t\t\t\ttransport.start();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can cancel the timeline of scheduled object\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\tthrow new Error(\"should not call this\");\n\t\t\t\t}, 0);\n\t\t\t\ttransport.cancel(0);\n\t\t\t\ttransport.start(0);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can cancel the timeline of scheduleOnce object\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.scheduleOnce(() => {\n\t\t\t\t\tthrow new Error(\"should not call this\");\n\t\t\t\t}, 0);\n\t\t\t\ttransport.cancel(0);\n\t\t\t\ttransport.start(0);\n\t\t\t});\n\t\t});\n\n\t\tit(\"scheduled event anywhere along the timeline\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = transport.now();\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime + 0.5, 0.001);\n\t\t\t\t\twasCalled = true;\n\t\t\t\t}, 0.5);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.6);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"can schedule multiple events and invoke them in the right order\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tlet first = false;\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\tfirst = true;\n\t\t\t\t}, 0.1);\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\texpect(first).to.equal(true);\n\t\t\t\t\twasCalled = true;\n\t\t\t\t}, 0.11);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.2);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"invokes the event again if the timeline is restarted\", async () => {\n\t\t\tlet iterations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\titerations++;\n\t\t\t\t}, 0.05);\n\t\t\t\ttransport.start(0).stop(0.1).start(0.2);\n\t\t\t}, 0.3);\n\t\t\texpect(iterations).to.be.equal(2);\n\t\t});\n\n\t\tit(\"can add an event after the Transport is started\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0);\n\t\t\t\tlet wasScheduled = false;\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.1 && !wasScheduled) {\n\t\t\t\t\t\twasScheduled = true;\n\t\t\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\t\t\twasCalled = true;\n\t\t\t\t\t\t}, 0.15);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.3);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"warns if the scheduled time was not used in the callback\", async () => {\n\t\t\tawait Offline(({ transport }) => {\n\t\t\t\tconst synth = new Synth();\n\t\t\t\ttransport.schedule(() => {\n\t\t\t\t\twarns(() => {\n\t\t\t\t\t\tsynth.triggerAttackRelease(\"C2\", 0.1);\n\t\t\t\t\t});\n\t\t\t\t}, 0);\n\t\t\t\ttransport.start(0);\n\t\t\t}, 0.3);\n\t\t});\n\t});\n\n\tcontext(\"scheduleRepeat\", () => {\n\t\tit(\"can schedule a repeated event\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.scheduleRepeat(noOp, 1);\n\t\t\t\texpect(eventID).to.be.a(\"number\");\n\t\t\t});\n\t\t});\n\n\t\tit(\"scheduled event gets invoked with the time of the event\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eventID = transport.scheduleRepeat(\n\t\t\t\t\t(time) => {\n\t\t\t\t\t\texpect(time).to.be.closeTo(startTime, 0.01);\n\t\t\t\t\t\tinvoked = true;\n\t\t\t\t\t\ttransport.clear(eventID);\n\t\t\t\t\t},\n\t\t\t\t\t1,\n\t\t\t\t\t0\n\t\t\t\t);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.3);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"can cancel the timeline of scheduleRepeat\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t() => {\n\t\t\t\t\t\tthrow new Error(\"should not call this\");\n\t\t\t\t\t},\n\t\t\t\t\t0.01,\n\t\t\t\t\t0\n\t\t\t\t);\n\t\t\t\ttransport.cancel(0);\n\t\t\t\ttransport.start(0);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can schedule events with TransportTime\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eighth = transport.toSeconds(\"8n\");\n\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t(time) => {\n\t\t\t\t\t\texpect(time).to.be.closeTo(startTime + eighth, 0.01);\n\t\t\t\t\t\tinvoked = true;\n\t\t\t\t\t},\n\t\t\t\t\t\"1n\",\n\t\t\t\t\tTransportTime(\"8n\")\n\t\t\t\t);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.4);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"can clear a scheduled event\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.scheduleRepeat(\n\t\t\t\t\t() => {\n\t\t\t\t\t\tthrow new Error(\"should not call this function\");\n\t\t\t\t\t},\n\t\t\t\t\t1,\n\t\t\t\t\t0\n\t\t\t\t);\n\t\t\t\ttransport.clear(eventID);\n\t\t\t\ttransport.stop();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be scheduled in the future\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eventID = transport.scheduleRepeat(\n\t\t\t\t\t(time) => {\n\t\t\t\t\t\ttransport.clear(eventID);\n\t\t\t\t\t\texpect(time).to.be.closeTo(startTime + 0.2, 0.01);\n\t\t\t\t\t\tinvoked = true;\n\t\t\t\t\t},\n\t\t\t\t\t1,\n\t\t\t\t\t0.2\n\t\t\t\t);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.5);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"repeats a repeat event\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t() => {\n\t\t\t\t\t\tinvocations++;\n\t\t\t\t\t},\n\t\t\t\t\t0.1,\n\t\t\t\t\t0\n\t\t\t\t);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.51);\n\t\t\texpect(invocations).to.equal(6);\n\t\t});\n\n\t\tit(\"repeats at the repeat interval\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tlet repeatTime = -1;\n\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t(time) => {\n\t\t\t\t\t\tif (repeatTime !== -1) {\n\t\t\t\t\t\t\texpect(time - repeatTime).to.be.closeTo(0.1, 0.01);\n\t\t\t\t\t\t}\n\t\t\t\t\t\trepeatTime = time;\n\t\t\t\t\t\twasCalled = true;\n\t\t\t\t\t},\n\t\t\t\t\t0.1,\n\t\t\t\t\t0\n\t\t\t\t);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.5);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"can schedule multiple events and invoke them in the right order\", async () => {\n\t\t\tlet first = false;\n\t\t\tlet second = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst firstID = transport.scheduleRepeat(\n\t\t\t\t\t() => {\n\t\t\t\t\t\tfirst = true;\n\t\t\t\t\t\ttransport.clear(firstID);\n\t\t\t\t\t},\n\t\t\t\t\t1,\n\t\t\t\t\t0.1\n\t\t\t\t);\n\t\t\t\tconst secondID = transport.scheduleRepeat(\n\t\t\t\t\t() => {\n\t\t\t\t\t\ttransport.clear(secondID);\n\t\t\t\t\t\texpect(first).to.equal(true);\n\t\t\t\t\t\tsecond = true;\n\t\t\t\t\t},\n\t\t\t\t\t1,\n\t\t\t\t\t0.11\n\t\t\t\t);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.3);\n\t\t\texpect(first);\n\t\t\texpect(second);\n\t\t});\n\n\t\tit(\"repeats for the given interval\", async () => {\n\t\t\tlet repeatCount = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t(time) => {\n\t\t\t\t\t\trepeatCount++;\n\t\t\t\t\t},\n\t\t\t\t\t0.1,\n\t\t\t\t\t0,\n\t\t\t\t\t0.5\n\t\t\t\t);\n\t\t\t\ttransport.start();\n\t\t\t}, 0.61);\n\t\t\texpect(repeatCount).to.equal(5);\n\t\t});\n\n\t\tit(\"can add an event after the Transport is started\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0);\n\t\t\t\tlet wasScheduled = false;\n\t\t\t\tconst times = [0.15, 0.3];\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time > 0.1 && !wasScheduled) {\n\t\t\t\t\t\twasScheduled = true;\n\t\t\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t\t\t(repeatedTime) => {\n\t\t\t\t\t\t\t\texpect(repeatedTime).to.be.closeTo(\n\t\t\t\t\t\t\t\t\ttimes[invocations],\n\t\t\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tinvocations++;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t0.15,\n\t\t\t\t\t\t\t0.15\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.31);\n\t\t\texpect(invocations).to.equal(2);\n\t\t});\n\n\t\tit(\"can add an event to the past after the Transport is started\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.start(0);\n\t\t\t\tlet wasScheduled = false;\n\t\t\t\tconst times = [0.15, 0.25];\n\t\t\t\treturn (time) => {\n\t\t\t\t\tif (time >= 0.12 && !wasScheduled) {\n\t\t\t\t\t\twasScheduled = true;\n\t\t\t\t\t\ttransport.scheduleRepeat(\n\t\t\t\t\t\t\t(repeatedTime) => {\n\t\t\t\t\t\t\t\texpect(repeatedTime).to.be.closeTo(\n\t\t\t\t\t\t\t\t\ttimes[invocations],\n\t\t\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tinvocations++;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t0.1,\n\t\t\t\t\t\t\t0.05\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}, 0.3);\n\t\t\texpect(invocations).to.equal(2);\n\t\t});\n\t});\n\n\tcontext(\"scheduleOnce\", () => {\n\t\tit(\"can schedule a single event on the timeline\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.scheduleOnce(() => {}, 0);\n\t\t\t\texpect(eventID).to.be.a(\"number\");\n\t\t\t});\n\t\t});\n\n\t\tit(\"scheduled event gets invoked with the time of the event\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eventID = transport.scheduleOnce((time) => {\n\t\t\t\t\tinvoked = true;\n\t\t\t\t\ttransport.clear(eventID);\n\t\t\t\t\texpect(time).to.be.closeTo(startTime, 0.01);\n\t\t\t\t}, 0);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.2);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"can schedule events with TransportTime\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = 0.1;\n\t\t\t\tconst eighth = transport.toSeconds(\"8n\");\n\t\t\t\ttransport.scheduleOnce((time) => {\n\t\t\t\t\texpect(time).to.be.closeTo(startTime + eighth, 0.01);\n\t\t\t\t\tinvoked = true;\n\t\t\t\t}, TransportTime(\"8n\"));\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.5);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"can clear a scheduled event\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst eventID = transport.scheduleOnce(() => {\n\t\t\t\t\tthrow new Error(\"should not call this function\");\n\t\t\t\t}, 0);\n\t\t\t\ttransport.clear(eventID);\n\t\t\t\ttransport.start();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can be scheduled in the future\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst startTime = transport.now() + 0.1;\n\t\t\t\tconst eventID = transport.scheduleOnce((time) => {\n\t\t\t\t\ttransport.clear(eventID);\n\t\t\t\t\texpect(time).to.be.closeTo(startTime + 0.3, 0.01);\n\t\t\t\t\tinvoked = true;\n\t\t\t\t}, 0.3);\n\t\t\t\ttransport.start(startTime);\n\t\t\t}, 0.5);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"the event is removed after is is invoked\", async () => {\n\t\t\tlet iterations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.scheduleOnce(() => {\n\t\t\t\t\titerations++;\n\t\t\t\t}, 0);\n\t\t\t\ttransport.start().stop(\"+0.1\").start(\"+0.2\");\n\t\t\t}, 0.5);\n\t\t\texpect(iterations).to.be.lessThan(2);\n\t\t});\n\t});\n\n\tcontext(\"events\", () => {\n\t\tit(\"invokes start/stop/pause events\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.on(\"start\", () => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t});\n\t\t\t\ttransport.on(\"stop\", () => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t});\n\t\t\t\ttransport.on(\"pause\", () => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t});\n\t\t\t\ttransport.start().stop(0.1).start(0.2);\n\t\t\t}, 0.5);\n\t\t\texpect(invocations).to.equal(3);\n\t\t});\n\n\t\tit(\"invokes start event with correct offset\", async () => {\n\t\t\tlet wasCalled = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.on(\"start\", (time, offset) => {\n\t\t\t\t\texpect(time).to.be.closeTo(0.2, 0.01);\n\t\t\t\t\texpect(offset).to.be.closeTo(0.5, 0.001);\n\t\t\t\t\twasCalled = true;\n\t\t\t\t});\n\t\t\t\ttransport.start(0.2, \"4n\");\n\t\t\t}, 0.3);\n\t\t\texpect(wasCalled).to.equal(true);\n\t\t});\n\n\t\tit(\"invokes the event just before the scheduled time\", async () => {\n\t\t\tlet invoked = false;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.on(\"start\", (time, offset) => {\n\t\t\t\t\texpect(time - transport.context.currentTime).to.be.closeTo(\n\t\t\t\t\t\t0,\n\t\t\t\t\t\t0.01\n\t\t\t\t\t);\n\t\t\t\t\texpect(offset).to.equal(0);\n\t\t\t\t\tinvoked = true;\n\t\t\t\t});\n\t\t\t\ttransport.start(0.2);\n\t\t\t}, 0.3);\n\t\t\texpect(invoked).to.equal(true);\n\t\t});\n\n\t\tit(\"passes in the time argument to the events\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst now = transport.now();\n\t\t\t\ttransport.on(\"start\", (time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).to.be.closeTo(now + 0.1, 0.01);\n\t\t\t\t});\n\t\t\t\ttransport.on(\"stop\", (time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).to.be.closeTo(now + 0.2, 0.01);\n\t\t\t\t});\n\t\t\t\ttransport.start(\"+0.1\").stop(\"+0.2\");\n\t\t\t}, 0.3);\n\t\t\texpect(invocations).to.equal(2);\n\t\t});\n\n\t\tit(\"invokes the 'loop' method on loop\", async () => {\n\t\t\tlet loops = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\tconst sixteenth = transport.toSeconds(\"16n\");\n\t\t\t\ttransport.setLoopPoints(0, sixteenth);\n\t\t\t\ttransport.loop = true;\n\t\t\t\tlet lastLoop = -1;\n\t\t\t\ttransport.on(\"loop\", (time) => {\n\t\t\t\t\tloops++;\n\t\t\t\t\tif (lastLoop !== -1) {\n\t\t\t\t\t\texpect(time - lastLoop).to.be.closeTo(sixteenth, 0.001);\n\t\t\t\t\t}\n\t\t\t\t\tlastLoop = time;\n\t\t\t\t});\n\t\t\t\ttransport.start(0).stop(sixteenth * 5.1);\n\t\t\t}, 0.7);\n\t\t\texpect(loops).to.equal(5);\n\t\t});\n\t});\n\n\tcontext(\"swing\", () => {\n\t\tit(\"can get/set the swing subdivision\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.swingSubdivision = \"8n\";\n\t\t\t\texpect(transport.swingSubdivision).to.equal(\"8n\");\n\t\t\t\ttransport.swingSubdivision = \"4n\";\n\t\t\t\texpect(transport.swingSubdivision).to.equal(\"4n\");\n\t\t\t});\n\t\t});\n\n\t\tit(\"can get/set the swing amount\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.swing = 0.5;\n\t\t\t\texpect(transport.swing).to.equal(0.5);\n\t\t\t\ttransport.swing = 0;\n\t\t\t\texpect(transport.swing).to.equal(0);\n\t\t\t});\n\t\t});\n\n\t\tit(\"can swing\", async () => {\n\t\t\tlet invocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.swing = 1;\n\t\t\t\ttransport.swingSubdivision = \"8n\";\n\t\t\t\tconst eightNote = transport.toSeconds(\"8n\");\n\t\t\t\t// downbeat, no swing\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).is.closeTo(0, 0.001);\n\t\t\t\t}, 0);\n\t\t\t\t// eighth note has swing\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).is.closeTo((eightNote * 5) / 3, 0.001);\n\t\t\t\t}, \"8n\");\n\t\t\t\t// sixteenth note is also swung\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).is.closeTo(eightNote, 0.05);\n\t\t\t\t}, \"16n\");\n\t\t\t\t// no swing on the quarter\n\t\t\t\ttransport.schedule((time) => {\n\t\t\t\t\tinvocations++;\n\t\t\t\t\texpect(time).is.closeTo(eightNote * 2, 0.001);\n\t\t\t\t}, \"4n\");\n\t\t\t\ttransport.start(0).stop(0.7);\n\t\t\t}, 0.7);\n\t\t\texpect(invocations).to.equal(4);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/Transport.ts", "content": "import { ToneAudioNode } from \"../../core/context/ToneAudioNode.js\";\nimport { TimeClass } from \"../../core/type/Time.js\";\nimport { PlaybackState } from \"../../core/util/StateTimeline.js\";\nimport { TimelineValue } from \"../../core/util/TimelineValue.js\";\nimport { Pow } from \"../../signal/Pow.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport {\n\tonContextClose,\n\tonContextInit,\n} from \"../context/ContextInitialization.js\";\nimport { Gain } from \"../context/Gain.js\";\nimport {\n\tToneWithContext,\n\tToneWithContextOptions,\n} from \"../context/ToneWithContext.js\";\nimport { TicksClass } from \"../type/Ticks.js\";\nimport { TransportTimeClass } from \"../type/TransportTime.js\";\nimport {\n\tBarsBeatsSixteenths,\n\tBPM,\n\tNormalRange,\n\tSeconds,\n\tSubdivision,\n\tTicks,\n\tTime,\n\tTimeSignature,\n\tTransportTime,\n} from \"../type/Units.js\";\nimport { enterScheduledCallback } from \"../util/Debug.js\";\nimport { assertUsedScheduleTime } from \"../util/Debug.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { Emitter } from \"../util/Emitter.js\";\nimport { readOnly, writable } from \"../util/Interface.js\";\nimport { IntervalTimeline } from \"../util/IntervalTimeline.js\";\nimport { Timeline } from \"../util/Timeline.js\";\nimport { isArray, isDefined } from \"../util/TypeCheck.js\";\nimport { Clock } from \"./Clock.js\";\nimport { TickParam } from \"./TickParam.js\";\nimport { TransportEvent } from \"./TransportEvent.js\";\nimport { TransportRepeatEvent } from \"./TransportRepeatEvent.js\";\n\ninterface TransportOptions extends ToneWithContextOptions {\n\tbpm: BPM;\n\tswing: NormalRange;\n\tswingSubdivision: Subdivision;\n\ttimeSignature: number;\n\tloopStart: Time;\n\tloopEnd: Time;\n\tppq: number;\n}\n\ntype TransportEventNames =\n\t| \"start\"\n\t| \"stop\"\n\t| \"pause\"\n\t| \"loop\"\n\t| \"loopEnd\"\n\t| \"loopStart\"\n\t| \"ticks\";\n\ninterface SyncedSignalEvent {\n\tsignal: Signal;\n\tinitial: number;\n\tnodes: ToneAudioNode[];\n}\n\ntype TransportCallback = (time: Seconds) => void;\n\n/**\n * Transport for timing musical events.\n *\n * Supports tempo curves and time changes.\n *\n * Unlike browser-based timing (setInterval, requestAnimationFrame),\n * Transport timing events pass in the exact time of the scheduled event\n * in the argument of the callback function.\n *\n * A single transport is created for you when the library is initialized.\n *\n * The transport emits \"start\", \"stop\", \"pause\", and \"loop\" events.\n *\n * @example\n * const osc = new Tone.Oscillator().toDestination();\n * // Repeated event every 8th note.\n * Tone.getTransport().scheduleRepeat((time) => {\n * \t// Use the callback time to schedule events.\n * \tosc.start(time).stop(time + 0.1);\n * }, \"8n\");\n * // Transport must be started before it starts invoking events.\n * Tone.getTransport().start();\n * @category Core\n */\nexport class TransportInstance\n\textends ToneWithContext\n\timplements Emitter\n{\n\treadonly name: string = \"Transport\";\n\n\t//-------------------------------------\n\t// \tLOOPING\n\t//-------------------------------------\n\n\t/**\n\t * If the transport loops or not.\n\t */\n\tprivate _loop: TimelineValue = new TimelineValue(false);\n\n\t/**\n\t * The loop start position in ticks\n\t */\n\tprivate _loopStart: Ticks = 0;\n\n\t/**\n\t * The loop end position in ticks\n\t */\n\tprivate _loopEnd: Ticks = 0;\n\n\t//-------------------------------------\n\t// \tCLOCK/TEMPO\n\t//-------------------------------------\n\n\t/**\n\t * Pulses per quarter is the number of ticks per quarter note.\n\t */\n\tprivate _ppq: number;\n\n\t/**\n\t * watches the main oscillator for timing ticks\n\t * initially starts at 120bpm\n\t */\n\tprivate _clock: Clock<\"bpm\">;\n\n\t/**\n\t * The Beats Per Minute of the Transport.\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination();\n\t * Tone.getTransport().bpm.value = 80;\n\t * // start/stop the oscillator every quarter note\n\t * Tone.getTransport().scheduleRepeat(time => {\n\t * \tosc.start(time).stop(time + 0.1);\n\t * }, \"4n\");\n\t * Tone.getTransport().start();\n\t * // ramp the bpm to 120 over 10 seconds\n\t * Tone.getTransport().bpm.rampTo(120, 10);\n\t */\n\tbpm: TickParam<\"bpm\">;\n\n\t/**\n\t * The time signature, or more accurately the numerator\n\t * of the time signature over a denominator of 4.\n\t */\n\tprivate _timeSignature: number;\n\n\t//-------------------------------------\n\t// \tTIMELINE EVENTS\n\t//-------------------------------------\n\n\t/**\n\t * All the events in an object to keep track by ID\n\t */\n\tprivate _scheduledEvents = {};\n\n\t/**\n\t * The scheduled events.\n\t */\n\tprivate _timeline: Timeline = new Timeline();\n\n\t/**\n\t * Repeated events\n\t */\n\tprivate _repeatedEvents: IntervalTimeline = new IntervalTimeline();\n\n\t/**\n\t * All of the synced Signals\n\t */\n\tprivate _syncedSignals: SyncedSignalEvent[] = [];\n\n\t//-------------------------------------\n\t// \tSWING\n\t//-------------------------------------\n\n\t/**\n\t * The subdivision of the swing\n\t */\n\tprivate _swingTicks: Ticks;\n\n\t/**\n\t * The swing amount\n\t */\n\tprivate _swingAmount: NormalRange = 0;\n\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tTransportInstance.getDefaults(),\n\t\t\targuments\n\t\t);\n\t\tsuper(options);\n\n\t\t// CLOCK/TEMPO\n\t\tthis._ppq = options.ppq;\n\t\tthis._clock = new Clock({\n\t\t\tcallback: this._processTick.bind(this),\n\t\t\tcontext: this.context,\n\t\t\tfrequency: 0,\n\t\t\tunits: \"bpm\",\n\t\t});\n\t\tthis._bindClockEvents();\n\t\tthis.bpm = this._clock.frequency as unknown as TickParam<\"bpm\">;\n\t\tthis._clock.frequency.multiplier = options.ppq;\n\t\tthis.bpm.setValueAtTime(options.bpm, 0);\n\t\treadOnly(this, \"bpm\");\n\t\tthis._timeSignature = options.timeSignature;\n\n\t\t// SWING\n\t\tthis._swingTicks = options.ppq / 2; // 8n\n\t}\n\n\tstatic getDefaults(): TransportOptions {\n\t\treturn Object.assign(ToneWithContext.getDefaults(), {\n\t\t\tbpm: 120,\n\t\t\tloopEnd: \"4m\" as Subdivision,\n\t\t\tloopStart: 0,\n\t\t\tppq: 192,\n\t\t\tswing: 0,\n\t\t\tswingSubdivision: \"8n\" as Subdivision,\n\t\t\ttimeSignature: 4,\n\t\t});\n\t}\n\n\t//-------------------------------------\n\t// \tTICKS\n\t//-------------------------------------\n\n\t/**\n\t * called on every tick\n\t * @param tickTime clock relative tick time\n\t */\n\tprivate _processTick(tickTime: Seconds, ticks: Ticks): void {\n\t\t// do the loop test\n\t\tif (this._loop.get(tickTime)) {\n\t\t\tif (ticks >= this._loopEnd) {\n\t\t\t\tthis.emit(\"loopEnd\", tickTime);\n\t\t\t\tthis._clock.setTicksAtTime(this._loopStart, tickTime);\n\t\t\t\tticks = this._loopStart;\n\t\t\t\tthis.emit(\n\t\t\t\t\t\"loopStart\",\n\t\t\t\t\ttickTime,\n\t\t\t\t\tthis._clock.getSecondsAtTime(tickTime)\n\t\t\t\t);\n\t\t\t\tthis.emit(\"loop\", tickTime);\n\t\t\t}\n\t\t}\n\t\t// handle swing\n\t\tif (\n\t\t\tthis._swingAmount > 0 &&\n\t\t\tticks % this._ppq !== 0 && // not on a downbeat\n\t\t\tticks % (this._swingTicks * 2) !== 0\n\t\t) {\n\t\t\t// add some swing\n\t\t\tconst progress =\n\t\t\t\t(ticks % (this._swingTicks * 2)) / (this._swingTicks * 2);\n\t\t\tconst amount = Math.sin(progress * Math.PI) * this._swingAmount;\n\t\t\ttickTime +=\n\t\t\t\tnew TicksClass(\n\t\t\t\t\tthis.context,\n\t\t\t\t\t(this._swingTicks * 2) / 3\n\t\t\t\t).toSeconds() * amount;\n\t\t}\n\t\t// invoke the timeline events scheduled on this tick\n\t\tenterScheduledCallback(true);\n\t\tthis._timeline.forEachAtTime(ticks, (event) => event.invoke(tickTime));\n\t\tenterScheduledCallback(false);\n\t}\n\n\t//-------------------------------------\n\t// \tSCHEDULABLE EVENTS\n\t//-------------------------------------\n\n\t/**\n\t * Schedule an event to be invoked at a specific time.\n\t * @param callback The callback to invoke at the given time.\n\t * @param time The time to invoke the callback at.\n\t * @return The ID of the event, which can be used to cancel the event.\n\t * @example\n\t * // Schedule an event on the 16th measure.\n\t * Tone.getTransport().schedule((time) => {\n\t * \t// Invoked on measure 16.\n\t * \tconsole.log(\"measure 16!\");\n\t * }, \"16:0:0\");\n\t */\n\tschedule(\n\t\tcallback: TransportCallback,\n\t\ttime: TransportTime | TransportTimeClass\n\t): number {\n\t\tconst event = new TransportEvent(this, {\n\t\t\tcallback,\n\t\t\ttime: new TransportTimeClass(this.context, time).toTicks(),\n\t\t});\n\t\treturn this._addEvent(event, this._timeline);\n\t}\n\n\t/**\n\t * Schedule a repeated event.\n\t *\n\t * The event will fire at the `interval` starting at the `startTime` and for the specified `duration`.\n\t *\n\t * @param callback The callback to invoke.\n\t * @param interval The duration between successive callbacks.\n\t * @param startTime When the event should start.\n\t * @param duration How long the event should repeat.\n\t * @return The ID of the scheduled event. Use this to cancel the event.\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination().start();\n\t * // A callback invoked every eighth note after the first measure.\n\t * Tone.getTransport().scheduleRepeat((time) => {\n\t * \tosc.start(time).stop(time + 0.1);\n\t * }, \"8n\", \"1m\");\n\t */\n\tscheduleRepeat(\n\t\tcallback: TransportCallback,\n\t\tinterval: Time | TimeClass,\n\t\tstartTime?: TransportTime | TransportTimeClass,\n\t\tduration: Time = Infinity\n\t): number {\n\t\tconst event = new TransportRepeatEvent(this, {\n\t\t\tcallback,\n\t\t\tduration: new TimeClass(this.context, duration).toTicks(),\n\t\t\tinterval: new TimeClass(this.context, interval).toTicks(),\n\t\t\ttime: new TransportTimeClass(this.context, startTime).toTicks(),\n\t\t});\n\t\t// kick it off if the Transport is started\n\t\t// @ts-ignore\n\t\treturn this._addEvent(event, this._repeatedEvents);\n\t}\n\n\t/**\n\t * Schedule an event that will be removed after it is invoked.\n\t * @param callback The callback to invoke once.\n\t * @param time The time the callback should be invoked.\n\t * @returns The ID of the scheduled event.\n\t */\n\tscheduleOnce(\n\t\tcallback: TransportCallback,\n\t\ttime: TransportTime | TransportTimeClass\n\t): number {\n\t\tconst event = new TransportEvent(this, {\n\t\t\tcallback,\n\t\t\tonce: true,\n\t\t\ttime: new TransportTimeClass(this.context, time).toTicks(),\n\t\t});\n\t\treturn this._addEvent(event, this._timeline);\n\t}\n\n\t/**\n\t * Clear the passed in event id from the timeline\n\t * @param eventId The id of the event.\n\t */\n\tclear(eventId: number): this {\n\t\tif (this._scheduledEvents.hasOwnProperty(eventId)) {\n\t\t\tconst item = this._scheduledEvents[eventId.toString()];\n\t\t\titem.timeline.remove(item.event);\n\t\t\titem.event.dispose();\n\t\t\tdelete this._scheduledEvents[eventId.toString()];\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add an event to the correct timeline. Keep track of the\n\t * timeline it was added to.\n\t * @returns the event id which was just added\n\t */\n\tprivate _addEvent(\n\t\tevent: TransportEvent,\n\t\ttimeline: Timeline\n\t): number {\n\t\tthis._scheduledEvents[event.id.toString()] = {\n\t\t\tevent,\n\t\t\ttimeline,\n\t\t};\n\t\ttimeline.add(event);\n\t\treturn event.id;\n\t}\n\n\t/**\n\t * Remove scheduled events from the timeline after\n\t * the given time. Repeated events will be removed\n\t * if their startTime is after the given time\n\t * @param after Clear all events after this time.\n\t */\n\tcancel(after: TransportTime = 0): this {\n\t\tconst computedAfter = this.toTicks(after);\n\t\tthis._timeline.forEachFrom(computedAfter, (event) =>\n\t\t\tthis.clear(event.id)\n\t\t);\n\t\tthis._repeatedEvents.forEachFrom(computedAfter, (event) =>\n\t\t\tthis.clear(event.id)\n\t\t);\n\t\treturn this;\n\t}\n\n\t//-------------------------------------\n\t// \tSTART/STOP/PAUSE\n\t//-------------------------------------\n\n\t/**\n\t * Bind start/stop/pause events from the clock and emit them.\n\t */\n\tprivate _bindClockEvents(): void {\n\t\tthis._clock.on(\"start\", (time, offset) => {\n\t\t\toffset = new TicksClass(this.context, offset).toSeconds();\n\t\t\tthis.emit(\"start\", time, offset);\n\t\t});\n\n\t\tthis._clock.on(\"stop\", (time) => {\n\t\t\tthis.emit(\"stop\", time);\n\t\t});\n\n\t\tthis._clock.on(\"pause\", (time) => {\n\t\t\tthis.emit(\"pause\", time);\n\t\t});\n\t}\n\n\t/**\n\t * The playback state of the transport, either \"started\", \"stopped\", or \"paused\".\n\t */\n\tget state(): PlaybackState {\n\t\treturn this._clock.getStateAtTime(this.now());\n\t}\n\n\t/**\n\t * Start the transport and all sources synced to the transport.\n\t * @param time The time when the transport should start.\n\t * @param offset The timeline offset to start the transport from.\n\t * @example\n\t * // Start the transport in one second, beginning at the start of the 5th measure.\n\t * Tone.getTransport().start(\"+1\", \"4:0:0\");\n\t */\n\tstart(time?: Time, offset?: TransportTime): this {\n\t\t// start the context\n\t\tthis.context.resume();\n\t\tlet offsetTicks;\n\t\tif (isDefined(offset)) {\n\t\t\toffsetTicks = this.toTicks(offset);\n\t\t}\n\t\t// start the clock\n\t\tthis._clock.start(time, offsetTicks);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Stop the transport and all sources synced to the transport.\n\t * @param time The time when the transport should stop.\n\t * @example\n\t * Tone.getTransport().stop();\n\t */\n\tstop(time?: Time): this {\n\t\tthis._clock.stop(time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Pause the transport and all sources synced to the transport.\n\t */\n\tpause(time?: Time): this {\n\t\tthis._clock.pause(time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Toggle the current state of the transport.\n\t *\n\t * If it is started, it will stop it. If it is stopped, it will start it.\n\t *\n\t * @param time The time of the event.\n\t */\n\ttoggle(time?: Time): this {\n\t\ttime = this.toSeconds(time);\n\t\tif (this._clock.getStateAtTime(time) !== \"started\") {\n\t\t\tthis.start(time);\n\t\t} else {\n\t\t\tthis.stop(time);\n\t\t}\n\t\treturn this;\n\t}\n\n\t//-------------------------------------\n\t// \tSETTERS/GETTERS\n\t//-------------------------------------\n\n\t/**\n\t * The time signature as just the numerator over 4.\n\t * For example 4/4 would be just 4 and 6/8 would be 3.\n\t * @example\n\t * // common time\n\t * Tone.getTransport().timeSignature = 4;\n\t * // 7/8\n\t * Tone.getTransport().timeSignature = [7, 8];\n\t * // this will be reduced to a single number\n\t * Tone.getTransport().timeSignature; // returns 3.5\n\t */\n\tget timeSignature(): TimeSignature {\n\t\treturn this._timeSignature;\n\t}\n\tset timeSignature(timeSig: TimeSignature) {\n\t\tif (isArray(timeSig)) {\n\t\t\ttimeSig = (timeSig[0] / timeSig[1]) * 4;\n\t\t}\n\t\tthis._timeSignature = timeSig;\n\t}\n\n\t/**\n\t * When the Transport.loop = true, this is the starting position of the loop.\n\t */\n\tget loopStart(): Time {\n\t\treturn new TimeClass(this.context, this._loopStart, \"i\").toSeconds();\n\t}\n\tset loopStart(startPosition: Time) {\n\t\tthis._loopStart = this.toTicks(startPosition);\n\t}\n\n\t/**\n\t * When the Transport.loop = true, this is the ending position of the loop.\n\t */\n\tget loopEnd(): Time {\n\t\treturn new TimeClass(this.context, this._loopEnd, \"i\").toSeconds();\n\t}\n\tset loopEnd(endPosition: Time) {\n\t\tthis._loopEnd = this.toTicks(endPosition);\n\t}\n\n\t/**\n\t * If the transport loops or not.\n\t */\n\tget loop(): boolean {\n\t\treturn this._loop.get(this.now());\n\t}\n\tset loop(loop) {\n\t\tthis._loop.set(loop, this.now());\n\t}\n\n\t/**\n\t * Set the loop start and stop at the same time.\n\t * @example\n\t * // loop over the first measure\n\t * Tone.getTransport().setLoopPoints(0, \"1m\");\n\t * Tone.getTransport().loop = true;\n\t */\n\tsetLoopPoints(\n\t\tstartPosition: TransportTime,\n\t\tendPosition: TransportTime\n\t): this {\n\t\tthis.loopStart = startPosition;\n\t\tthis.loopEnd = endPosition;\n\t\treturn this;\n\t}\n\n\t/**\n\t * The swing value. Between 0-1 where 1 equal to the note + half the subdivision.\n\t */\n\tget swing(): NormalRange {\n\t\treturn this._swingAmount;\n\t}\n\tset swing(amount: NormalRange) {\n\t\t// scale the values to a normal range\n\t\tthis._swingAmount = amount;\n\t}\n\n\t/**\n\t * Set the subdivision which the swing will be applied to.\n\t * The default value is an 8th note. Value must be less\n\t * than a quarter note.\n\t */\n\tget swingSubdivision(): Subdivision {\n\t\treturn new TicksClass(this.context, this._swingTicks).toNotation();\n\t}\n\tset swingSubdivision(subdivision: Subdivision) {\n\t\tthis._swingTicks = this.toTicks(subdivision);\n\t}\n\n\t/**\n\t * The Transport's position in Bars:Beats:Sixteenths.\n\t * Setting the value will jump to that position right away.\n\t */\n\tget position(): BarsBeatsSixteenths | Time {\n\t\tconst now = this.now();\n\t\tconst ticks = this._clock.getTicksAtTime(now);\n\t\treturn new TicksClass(this.context, ticks).toBarsBeatsSixteenths();\n\t}\n\tset position(progress: Time) {\n\t\tconst ticks = this.toTicks(progress);\n\t\tthis.ticks = ticks;\n\t}\n\n\t/**\n\t * The Transport's position in seconds.\n\t * Setting the value will jump to that position right away.\n\t */\n\tget seconds(): Seconds {\n\t\treturn this._clock.seconds;\n\t}\n\tset seconds(s: Seconds) {\n\t\tconst now = this.now();\n\t\tconst ticks = this._clock.frequency.timeToTicks(s, now);\n\t\tthis.ticks = ticks;\n\t}\n\n\t/**\n\t * The Transport's loop position as a normalized value. Always\n\t * returns 0 if the Transport.loop = false.\n\t */\n\tget progress(): NormalRange {\n\t\tif (this.loop) {\n\t\t\tconst now = this.now();\n\t\t\tconst ticks = this._clock.getTicksAtTime(now);\n\t\t\treturn (\n\t\t\t\t(ticks - this._loopStart) / (this._loopEnd - this._loopStart)\n\t\t\t);\n\t\t} else {\n\t\t\treturn 0;\n\t\t}\n\t}\n\n\t/**\n\t * The Transport's current tick position.\n\t */\n\tget ticks(): Ticks {\n\t\treturn this._clock.ticks;\n\t}\n\tset ticks(t: Ticks) {\n\t\tassertUsedScheduleTime();\n\n\t\t// \"floor\" ensures that any events scheduled on this tick will be called.\n\t\tt = Math.floor(t);\n\n\t\tif (this._clock.ticks === t) {\n\t\t\treturn;\n\t\t}\n\t\tconst now = this.now();\n\t\t// stop everything synced to the transport\n\t\tif (this.state === \"started\") {\n\t\t\tconst ticks = this._clock.getTicksAtTime(now);\n\t\t\t// schedule to start on the next tick, #573\n\t\t\tconst remainingTick = this._clock.frequency.getDurationOfTicks(\n\t\t\t\tMath.ceil(ticks) - ticks,\n\t\t\t\tnow\n\t\t\t);\n\t\t\tconst time = now + remainingTick;\n\t\t\tthis.emit(\"stop\", time);\n\t\t\tthis._clock.setTicksAtTime(t, time);\n\t\t\t// restart it with the new time\n\t\t\tthis.emit(\"start\", time, this._clock.getSecondsAtTime(time));\n\t\t} else {\n\t\t\tthis.emit(\"ticks\", now);\n\t\t\tthis._clock.setTicksAtTime(t, now);\n\t\t}\n\t}\n\n\t/**\n\t * Get the clock's ticks at the given time.\n\t * @param time When to get the tick value\n\t * @return The tick value at the given time.\n\t */\n\tgetTicksAtTime(time?: Time): Ticks {\n\t\treturn this._clock.getTicksAtTime(time);\n\t}\n\n\t/**\n\t * Set the Transport's {@link ticks} value at the given time\n\t * @param ticks The tick value to set\n\t * @param time The Context time at which to set the seconds value\n\t */\n\tsetTicksAtTime(ticks: Ticks, time: Time): this {\n\t\tthis._clock.setTicksAtTime(ticks, time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Return the elapsed seconds at the given time.\n\t * @param time When to get the elapsed seconds\n\t * @return The number of elapsed seconds\n\t */\n\tgetSecondsAtTime(time: Time): Seconds {\n\t\treturn this._clock.getSecondsAtTime(time);\n\t}\n\n\t/**\n\t * Set the Transport's {@link seconds} value at the given time.\n\t * @param seconds The seconds value to set\n\t * @param time The Context time at which to set the seconds value\n\t */\n\tsetSecondsAtTime(seconds: Seconds, time: Time): this {\n\t\tthis.setTicksAtTime(this.toTicks(seconds), time);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Pulses Per Quarter note. This is the smallest resolution\n\t * the Transport timing supports. This should be set once\n\t * on initialization and not set again. Changing this value\n\t * after other objects have been created can cause problems.\n\t */\n\tget PPQ(): number {\n\t\treturn this._clock.frequency.multiplier;\n\t}\n\tset PPQ(ppq: number) {\n\t\tthis._clock.frequency.multiplier = ppq;\n\t}\n\n\t//-------------------------------------\n\t// \tSYNCING\n\t//-------------------------------------\n\n\t/**\n\t * Returns the time aligned to the next subdivision\n\t * of the Transport. If the Transport is not started,\n\t * it will return 0.\n\t * Note: this will not work precisely during tempo ramps.\n\t * @param subdivision The subdivision to quantize to\n\t * @return The context time of the next subdivision.\n\t * @example\n\t * // the transport must be started, otherwise returns 0\n\t * Tone.getTransport().start();\n\t * Tone.getTransport().nextSubdivision(\"4n\");\n\t */\n\tnextSubdivision(subdivision?: Time): Seconds {\n\t\tsubdivision = this.toTicks(subdivision);\n\t\tif (this.state !== \"started\") {\n\t\t\t// if the transport's not started, return 0\n\t\t\treturn 0;\n\t\t} else {\n\t\t\tconst now = this.now();\n\t\t\t// the remainder of the current ticks and the subdivision\n\t\t\tconst transportPos = this.getTicksAtTime(now);\n\t\t\tconst remainingTicks = subdivision - (transportPos % subdivision);\n\t\t\treturn this._clock.nextTickTime(remainingTicks, now);\n\t\t}\n\t}\n\n\t/**\n\t * Attaches the signal to the tempo control signal so that\n\t * any changes in the tempo will change the signal in the same\n\t * ratio.\n\t *\n\t * @param signal\n\t * @param ratio Optionally pass in the ratio between the two signals.\n\t * \t\t\tOtherwise it will be computed based on their current values.\n\t */\n\tsyncSignal(signal: Signal, ratio?: number): this {\n\t\tconst now = this.now();\n\t\tlet source: TickParam<\"bpm\"> | ToneAudioNode = this.bpm;\n\t\tlet sourceValue = 1 / (60 / source.getValueAtTime(now) / this.PPQ);\n\t\tlet nodes: ToneAudioNode[] = [];\n\t\t// If the signal is in the time domain, sync it to the reciprocal of\n\t\t// the tempo instead of the tempo.\n\t\tif (signal.units === \"time\") {\n\t\t\t// The input to Pow should be in the range [1 / 4096, 1], where\n\t\t\t// where 4096 is half of the buffer size of Pow's waveshaper.\n\t\t\t// Pick a scaling factor based on the initial tempo that ensures\n\t\t\t// that the initial input is in this range, while leaving room for\n\t\t\t// tempo changes.\n\t\t\tconst scaleFactor = 1 / 64 / sourceValue;\n\t\t\tconst scaleBefore = new Gain(scaleFactor);\n\t\t\tconst reciprocal = new Pow(-1);\n\t\t\tconst scaleAfter = new Gain(scaleFactor);\n\t\t\t// @ts-ignore\n\t\t\tsource.chain(scaleBefore, reciprocal, scaleAfter);\n\t\t\tsource = scaleAfter;\n\t\t\tsourceValue = 1 / sourceValue;\n\t\t\tnodes = [scaleBefore, reciprocal, scaleAfter];\n\t\t}\n\t\tif (!ratio) {\n\t\t\t// get the sync ratio\n\t\t\tif (signal.getValueAtTime(now) !== 0) {\n\t\t\t\tratio = signal.getValueAtTime(now) / sourceValue;\n\t\t\t} else {\n\t\t\t\tratio = 0;\n\t\t\t}\n\t\t}\n\t\tconst ratioSignal = new Gain(ratio);\n\t\t// @ts-ignore\n\t\tsource.connect(ratioSignal);\n\t\t// @ts-ignore\n\t\tratioSignal.connect(signal._param);\n\t\tnodes.push(ratioSignal);\n\t\tthis._syncedSignals.push({\n\t\t\tinitial: signal.value,\n\t\t\tnodes: nodes,\n\t\t\tsignal,\n\t\t});\n\t\tsignal.value = 0;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Unsyncs a previously synced signal from the transport's control.\n\t * @see {@link syncSignal}.\n\t */\n\tunsyncSignal(signal: Signal): this {\n\t\tfor (let i = this._syncedSignals.length - 1; i >= 0; i--) {\n\t\t\tconst syncedSignal = this._syncedSignals[i];\n\t\t\tif (syncedSignal.signal === signal) {\n\t\t\t\tsyncedSignal.nodes.forEach((node) => node.dispose());\n\t\t\t\tsyncedSignal.signal.value = syncedSignal.initial;\n\t\t\t\tthis._syncedSignals.splice(i, 1);\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._clock.dispose();\n\t\twritable(this, \"bpm\");\n\t\tthis._timeline.dispose();\n\t\tthis._repeatedEvents.dispose();\n\t\treturn this;\n\t}\n\n\t//-------------------------------------\n\t// EMITTER MIXIN TO SATISFY COMPILER\n\t//-------------------------------------\n\n\ton!: (\n\t\tevent: TransportEventNames,\n\t\tcallback: (...args: any[]) => void\n\t) => this;\n\tonce!: (\n\t\tevent: TransportEventNames,\n\t\tcallback: (...args: any[]) => void\n\t) => this;\n\toff!: (\n\t\tevent: TransportEventNames,\n\t\tcallback?: ((...args: any[]) => void) | undefined\n\t) => this;\n\temit!: (event: any, ...args: any[]) => this;\n}\n\nEmitter.mixin(TransportInstance);\n\n//-------------------------------------\n// \tINITIALIZATION\n//-------------------------------------\n\nonContextInit((context) => {\n\tcontext.transport = new TransportInstance({ context });\n});\n\nonContextClose((context) => {\n\tcontext.transport.dispose();\n});\n" }, { "path": "Tone/core/clock/TransportEvent.test.ts", "content": "import { expect } from \"chai\";\n\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { TransportInstance } from \"./Transport.js\";\nimport { TransportEvent } from \"./TransportEvent.js\";\n\ndescribe(\"TransportEvent\", () => {\n\tit(\"can be created and disposed\", () => {\n\t\treturn Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportEvent(transport, {\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\tevent.dispose();\n\t\t});\n\t});\n\n\tit(\"has a unique id\", () => {\n\t\treturn Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportEvent(transport, {\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\texpect(event.id).to.be.a(\"number\");\n\t\t\tevent.dispose();\n\t\t});\n\t});\n\n\tit(\"can invoke the callback\", async () => {\n\t\tlet wasInvoked = false;\n\t\tawait Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportEvent(transport, {\n\t\t\t\tcallback: (time) => {\n\t\t\t\t\texpect(time).to.equal(100);\n\t\t\t\t\twasInvoked = true;\n\t\t\t\t},\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\tevent.invoke(100);\n\t\t});\n\t\texpect(wasInvoked).to.equal(true);\n\t});\n});\n" }, { "path": "Tone/core/clock/TransportEvent.ts", "content": "import { Seconds, Ticks } from \"../type/Units.js\";\nimport { noOp } from \"../util/Interface.js\";\nimport type { TransportInstance as Transport } from \"./Transport.js\";\n\nexport interface TransportEventOptions {\n\tcallback: (time: number) => void;\n\tonce: boolean;\n\ttime: Ticks;\n}\n\n/**\n * TransportEvent is an internal class used by {@link TransportInstance}\n * to schedule events. Do no invoke this class directly, it is\n * handled from within Tone.Transport.\n */\nexport class TransportEvent {\n\t/**\n\t * Reference to the Transport that created it\n\t */\n\tprotected transport: Transport;\n\n\t/**\n\t * The unique id of the event\n\t */\n\tid: number = TransportEvent._eventId++;\n\n\t/**\n\t * The time the event starts\n\t */\n\ttime: Ticks;\n\n\t/**\n\t * The callback to invoke\n\t */\n\tprivate callback?: (time: Seconds) => void;\n\n\t/**\n\t * If the event should be removed after being invoked.\n\t */\n\tprivate _once: boolean;\n\n\t/**\n\t * The remaining value between the passed in time, and Math.floor(time).\n\t * This value is later added back when scheduling to get sub-tick precision.\n\t */\n\tprotected _remainderTime = 0;\n\n\t/**\n\t * @param transport The transport object which the event belongs to\n\t */\n\tconstructor(transport: Transport, opts: Partial) {\n\t\tconst options: TransportEventOptions = Object.assign(\n\t\t\tTransportEvent.getDefaults(),\n\t\t\topts\n\t\t);\n\n\t\tthis.transport = transport;\n\t\tthis.callback = options.callback;\n\t\tthis._once = options.once;\n\t\tthis.time = Math.floor(options.time);\n\t\tthis._remainderTime = options.time - this.time;\n\t}\n\n\tstatic getDefaults(): TransportEventOptions {\n\t\treturn {\n\t\t\tcallback: noOp,\n\t\t\tonce: false,\n\t\t\ttime: 0,\n\t\t};\n\t}\n\n\t/**\n\t * Current ID counter\n\t */\n\tprivate static _eventId = 0;\n\n\t/**\n\t * Get the time and remainder time.\n\t */\n\tprotected get floatTime(): number {\n\t\treturn this.time + this._remainderTime;\n\t}\n\n\t/**\n\t * Invoke the event callback.\n\t * @param time The AudioContext time in seconds of the event\n\t */\n\tinvoke(time: Seconds): void {\n\t\tif (this.callback) {\n\t\t\tconst tickDuration = this.transport.bpm.getDurationOfTicks(1, time);\n\t\t\tthis.callback(time + this._remainderTime * tickDuration);\n\t\t\tif (this._once) {\n\t\t\t\tthis.transport.clear(this.id);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tthis.callback = undefined;\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/clock/TransportRepeatEvent.test.ts", "content": "import { expect } from \"chai\";\n\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { TransportInstance } from \"./Transport.js\";\nimport { TransportRepeatEvent } from \"./TransportRepeatEvent.js\";\n\ndescribe(\"TransportRepeatEvent\", () => {\n\tit(\"can be created and disposed\", async () => {\n\t\tawait Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportRepeatEvent(transport, {\n\t\t\t\tduration: 100,\n\t\t\t\tinterval: 4,\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\tevent.dispose();\n\t\t});\n\t});\n\n\tit(\"generates a unique event ID\", async () => {\n\t\tawait Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportRepeatEvent(transport, {\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\texpect(event.id).to.be.a(\"number\");\n\t\t\tevent.dispose();\n\t\t});\n\t});\n\n\tit(\"is removed from the Transport when disposed\", async () => {\n\t\tawait Offline((context) => {\n\t\t\tconst transport = new TransportInstance({ context });\n\t\t\tconst event = new TransportRepeatEvent(transport, {\n\t\t\t\ttime: 0,\n\t\t\t});\n\t\t\tevent.dispose();\n\t\t\t// @ts-ignore\n\t\t\texpect(transport._timeline.length).to.equal(0);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/clock/TransportRepeatEvent.ts", "content": "import { BaseContext } from \"../context/BaseContext.js\";\nimport { TicksClass } from \"../type/Ticks.js\";\nimport { Seconds, Ticks, Time } from \"../type/Units.js\";\nimport { GT, LT } from \"../util/Math.js\";\nimport type { TransportInstance as Transport } from \"./Transport.js\";\nimport { TransportEvent, TransportEventOptions } from \"./TransportEvent.js\";\n\ninterface TransportRepeatEventOptions extends TransportEventOptions {\n\tinterval: Ticks;\n\tduration: Ticks;\n}\n\n/**\n * TransportRepeatEvent is an internal class used by Tone.Transport\n * to schedule repeat events. This class should not be instantiated directly.\n */\nexport class TransportRepeatEvent extends TransportEvent {\n\t/**\n\t * When the event should stop repeating\n\t */\n\tprivate duration: Ticks;\n\n\t/**\n\t * The interval of the repeated event\n\t */\n\tprivate _interval: Ticks;\n\n\t/**\n\t * The ID of the current timeline event\n\t */\n\tprivate _currentId = -1;\n\n\t/**\n\t * The ID of the next timeline event\n\t */\n\tprivate _nextId = -1;\n\n\t/**\n\t * The time of the next event\n\t */\n\tprivate _nextTick = this.time;\n\n\t/**\n\t * a reference to the bound start method\n\t */\n\tprivate _boundRestart = this._restart.bind(this);\n\n\t/**\n\t * The audio context belonging to this event\n\t */\n\tprotected context: BaseContext;\n\n\t/**\n\t * @param transport The transport object which the event belongs to\n\t */\n\tconstructor(\n\t\ttransport: Transport,\n\t\topts: Partial\n\t) {\n\t\tsuper(transport, opts);\n\n\t\tconst options = Object.assign(TransportRepeatEvent.getDefaults(), opts);\n\n\t\tthis.duration = options.duration;\n\t\tthis._interval = options.interval;\n\t\tthis._nextTick = options.time;\n\t\tthis.transport.on(\"start\", this._boundRestart);\n\t\tthis.transport.on(\"loopStart\", this._boundRestart);\n\t\tthis.transport.on(\"ticks\", this._boundRestart);\n\t\tthis.context = this.transport.context;\n\t\tthis._restart();\n\t}\n\n\tstatic getDefaults(): TransportRepeatEventOptions {\n\t\treturn Object.assign({}, TransportEvent.getDefaults(), {\n\t\t\tduration: Infinity,\n\t\t\tinterval: 1,\n\t\t\tonce: false,\n\t\t});\n\t}\n\n\t/**\n\t * Invoke the callback. Returns the tick time which\n\t * the next event should be scheduled at.\n\t * @param time The AudioContext time in seconds of the event\n\t */\n\tinvoke(time: Seconds): void {\n\t\t// create more events if necessary\n\t\tthis._createEvents();\n\t\t// call the super class\n\t\tsuper.invoke(time);\n\t}\n\n\t/**\n\t * Create an event on the transport on the nextTick\n\t */\n\tprivate _createEvent(): number {\n\t\tif (LT(this._nextTick, this.floatTime + this.duration)) {\n\t\t\treturn this.transport.scheduleOnce(\n\t\t\t\tthis.invoke.bind(this),\n\t\t\t\tnew TicksClass(this.context, this._nextTick).toSeconds()\n\t\t\t);\n\t\t}\n\t\treturn -1;\n\t}\n\n\t/**\n\t * Push more events onto the timeline to keep up with the position of the timeline\n\t */\n\tprivate _createEvents(): void {\n\t\t// if the next tick is within the bounds set by \"duration\"\n\t\tif (\n\t\t\tLT(this._nextTick + this._interval, this.floatTime + this.duration)\n\t\t) {\n\t\t\tthis._nextTick += this._interval;\n\t\t\tthis._currentId = this._nextId;\n\t\t\tthis._nextId = this.transport.scheduleOnce(\n\t\t\t\tthis.invoke.bind(this),\n\t\t\t\tnew TicksClass(this.context, this._nextTick).toSeconds()\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Re-compute the events when the transport time has changed from a start/ticks/loopStart event\n\t */\n\tprivate _restart(time?: Time): void {\n\t\tthis.transport.clear(this._currentId);\n\t\tthis.transport.clear(this._nextId);\n\t\t// start at the first event\n\t\tthis._nextTick = this.floatTime;\n\t\tconst ticks = this.transport.getTicksAtTime(time);\n\t\tif (GT(ticks, this.time)) {\n\t\t\t// the event is not being scheduled from the beginning and should be offset\n\t\t\tthis._nextTick =\n\t\t\t\tthis.floatTime +\n\t\t\t\tMath.ceil((ticks - this.floatTime) / this._interval) *\n\t\t\t\t\tthis._interval;\n\t\t}\n\t\tthis._currentId = this._createEvent();\n\t\tthis._nextTick += this._interval;\n\t\tthis._nextId = this._createEvent();\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.transport.clear(this._currentId);\n\t\tthis.transport.clear(this._nextId);\n\t\tthis.transport.off(\"start\", this._boundRestart);\n\t\tthis.transport.off(\"loopStart\", this._boundRestart);\n\t\tthis.transport.off(\"ticks\", this._boundRestart);\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/context/AbstractParam.ts", "content": "import { Time, UnitMap, UnitName } from \"../type/Units.js\";\n\n/**\n * Abstract base class for {@link Param} and {@link Signal}\n */\nexport abstract class AbstractParam {\n\t/**\n\t * Schedules a parameter value change at the given time.\n\t * @param value The value to set the signal.\n\t * @param time The time when the change should occur.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst osc = new Tone.Oscillator(20).toDestination().start();\n\t * \t// set the frequency to 40 at exactly 0.25 seconds\n\t * \tosc.frequency.setValueAtTime(40, 0.25);\n\t * }, 0.5, 1);\n\t */\n\tabstract setValueAtTime(value: UnitMap[TypeName], time: Time): this;\n\n\t/**\n\t * Get the signals value at the given time. Subsequent scheduling\n\t * may invalidate the returned value.\n\t * @param time When to get the value\n\t * @example\n\t * const signal = new Tone.Signal().toDestination();\n\t * // ramp up to '8' over 3 seconds\n\t * signal.rampTo(8, 3);\n\t * // ramp back down to '0' over 3 seconds\n\t * signal.rampTo(0, 3, \"+3\");\n\t * setInterval(() => {\n\t * \t// check the value every 100 ms\n\t * \tconsole.log(signal.getValueAtTime(Tone.now()));\n\t * }, 100);\n\t */\n\tabstract getValueAtTime(time: Time): UnitMap[TypeName];\n\n\t/**\n\t * Creates a schedule point with the current value at the current time.\n\t * Automation methods like {@link linearRampToValueAtTime} and {@link exponentialRampToValueAtTime}\n\t * require a starting automation value usually set by {@link setValueAtTime}. This method\n\t * is useful since it will do a `setValueAtTime` with whatever the currently computed\n\t * value at the given time is.\n\t * @param time When to add a ramp point.\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination().start();\n\t * // set the frequency to \"G4\" in exactly 1 second from now.\n\t * osc.frequency.setRampPoint(\"+1\");\n\t * osc.frequency.linearRampToValueAtTime(\"C1\", \"+2\");\n\t */\n\tabstract setRampPoint(time: Time): this;\n\n\t/**\n\t * Schedules a linear continuous change in parameter value from the\n\t * previous scheduled parameter value to the given value.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(0).toDestination();\n\t * \t// the ramp starts from the previously scheduled value\n\t * \tsignal.setValueAtTime(0, 0.1);\n\t * \tsignal.linearRampToValueAtTime(1, 0.4);\n\t * }, 0.5, 1);\n\t */\n\tabstract linearRampToValueAtTime(\n\t\tvalue: UnitMap[TypeName],\n\t\ttime: Time\n\t): this;\n\n\t/**\n\t * Schedules an exponential continuous change in parameter value from\n\t * the previous scheduled parameter value to the given value.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(1).toDestination();\n\t * \t// the ramp starts from the previously scheduled value, which must be positive\n\t * \tsignal.setValueAtTime(1, 0.1);\n\t * \tsignal.exponentialRampToValueAtTime(0, 0.4);\n\t * }, 0.5, 1);\n\t */\n\tabstract exponentialRampToValueAtTime(\n\t\tvalue: UnitMap[TypeName],\n\t\ttime: Time\n\t): this;\n\n\t/**\n\t * Schedules an exponential continuous change in parameter value from\n\t * the current time and current value to the given value over the\n\t * duration of the rampTime.\n\t * @param value The value to ramp to.\n\t * @param rampTime the time that it takes the\n\t * value to ramp from its current value\n\t * @param startTime When the ramp should start.\n\t * @example\n\t * const delay = new Tone.FeedbackDelay(0.5, 0.98).toDestination();\n\t * // a short burst of noise through the feedback delay\n\t * const noise = new Tone.Noise().connect(delay).start().stop(\"+0.1\");\n\t * // making the delay time shorter over time will also make the pitch rise\n\t * delay.delayTime.exponentialRampTo(0.01, 20);\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(.1).toDestination();\n\t * \tsignal.exponentialRampTo(5, 0.3, 0.1);\n\t * }, 0.5, 1);\n\t */\n\tabstract exponentialRampTo(\n\t\tvalue: UnitMap[TypeName],\n\t\trampTime: Time,\n\t\tstartTime?: Time\n\t): this;\n\n\t/**\n\t * Schedules an linear continuous change in parameter value from\n\t * the current time and current value to the given value over the\n\t * duration of the rampTime.\n\t *\n\t * @param value The value to ramp to.\n\t * @param rampTime the time that it takes the\n\t * value to ramp from its current value\n\t * @param startTime \tWhen the ramp should start.\n\t * @returns {Param} this\n\t * @example\n\t * const delay = new Tone.FeedbackDelay(0.5, 0.98).toDestination();\n\t * // a short burst of noise through the feedback delay\n\t * const noise = new Tone.Noise().connect(delay).start().stop(\"+0.1\");\n\t * // making the delay time shorter over time will also make the pitch rise\n\t * delay.delayTime.linearRampTo(0.01, 20);\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(1).toDestination();\n\t * \tsignal.linearRampTo(0, 0.3, 0.1);\n\t * }, 0.5, 1);\n\t */\n\tabstract linearRampTo(\n\t\tvalue: UnitMap[TypeName],\n\t\trampTime: Time,\n\t\tstartTime?: Time\n\t): this;\n\n\t/**\n\t * Start exponentially approaching the target value at the given time. Since it\n\t * is an exponential approach it will continue approaching after the ramp duration. The\n\t * rampTime is the time that it takes to reach over 99% of the way towards the value.\n\t * @param value The value to ramp to.\n\t * @param rampTime the time that it takes the\n\t * value to ramp from its current value\n\t * @param startTime \tWhen the ramp should start.\n\t * @example\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(1).toDestination();\n\t * \tsignal.targetRampTo(0, 0.3, 0.1);\n\t * }, 0.5, 1);\n\t */\n\tabstract targetRampTo(\n\t\tvalue: UnitMap[TypeName],\n\t\trampTime: Time,\n\t\tstartTime?: Time\n\t): this;\n\n\t/**\n\t * Start exponentially approaching the target value at the given time. Since it\n\t * is an exponential approach it will continue approaching after the ramp duration. The\n\t * rampTime is the time that it takes to reach over 99% of the way towards the value. This methods\n\t * is similar to setTargetAtTime except the third argument is a time instead of a 'timeConstant'\n\t * @param value The value to ramp to.\n\t * @param time \tWhen the ramp should start.\n\t * @param rampTime the time that it takes the value to ramp from its current value\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination().start();\n\t * // exponential approach over 4 seconds starting in 1 second\n\t * osc.frequency.exponentialApproachValueAtTime(\"C4\", \"+1\", 4);\n\t */\n\tabstract exponentialApproachValueAtTime(\n\t\tvalue: UnitMap[TypeName],\n\t\ttime: Time,\n\t\trampTime: Time\n\t): this;\n\n\t/**\n\t * Start exponentially approaching the target value at the given time with\n\t * a rate having the given time constant.\n\t * @param value\n\t * @param startTime\n\t * @param timeConstant\n\t */\n\tabstract setTargetAtTime(\n\t\tvalue: UnitMap[TypeName],\n\t\tstartTime: Time,\n\t\ttimeConstant: number\n\t): this;\n\n\t/**\n\t * Sets an array of arbitrary parameter values starting at the given time\n\t * for the given duration.\n\t *\n\t * @param values\n\t * @param startTime\n\t * @param duration\n\t * @param scaling If the values in the curve should be scaled by some value\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(1).toDestination();\n\t * \tsignal.setValueCurveAtTime([1, 0.2, 0.8, 0.1, 0], 0.2, 0.3);\n\t * }, 0.5, 1);\n\t */\n\tabstract setValueCurveAtTime(\n\t\tvalues: UnitMap[TypeName][],\n\t\tstartTime: Time,\n\t\tduration: Time,\n\t\tscaling?: number\n\t): this;\n\n\t/**\n\t * Cancels all scheduled parameter changes with times greater than or\n\t * equal to startTime.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(0).toDestination();\n\t * \tsignal.setValueAtTime(0.1, 0.1);\n\t * \tsignal.setValueAtTime(0.2, 0.2);\n\t * \tsignal.setValueAtTime(0.3, 0.3);\n\t * \tsignal.setValueAtTime(0.4, 0.4);\n\t * \t// cancels the last two scheduled changes\n\t * \tsignal.cancelScheduledValues(0.3);\n\t * }, 0.5, 1);\n\t */\n\tabstract cancelScheduledValues(time: Time): this;\n\n\t/**\n\t * This is similar to {@link cancelScheduledValues} except\n\t * it holds the automated value at time until the next automated event.\n\t * @example\n\t * return Tone.Offline(() => {\n\t * \tconst signal = new Tone.Signal(0).toDestination();\n\t * \tsignal.linearRampTo(1, 0.5, 0);\n\t * \tsignal.cancelAndHoldAtTime(0.3);\n\t * }, 0.5, 1);\n\t */\n\tabstract cancelAndHoldAtTime(time: Time): this;\n\n\t/**\n\t * Ramps to the given value over the duration of the rampTime.\n\t * Automatically selects the best ramp type (exponential or linear)\n\t * depending on the `units` of the signal\n\t *\n\t * @param value\n\t * @param rampTime The time that it takes the value to ramp from its current value\n\t * @param startTime When the ramp should start.\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination().start();\n\t * // schedule it to ramp either linearly or exponentially depending on the units\n\t * osc.frequency.rampTo(\"A2\", 10);\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination().start();\n\t * // schedule it to ramp starting at a specific time\n\t * osc.frequency.rampTo(\"A2\", 10, \"+2\");\n\t */\n\tabstract rampTo(\n\t\tvalue: UnitMap[TypeName],\n\t\trampTime: Time,\n\t\tstartTime?: Time\n\t): this;\n\n\t/**\n\t * The current value of the parameter. Setting this value\n\t * is equivalent to setValueAtTime(value, context.currentTime)\n\t */\n\tabstract value: UnitMap[TypeName];\n\n\t/**\n\t * If the value should be converted or not\n\t */\n\tabstract convert: boolean;\n\n\t/**\n\t * The unit type\n\t */\n\tabstract readonly units: UnitName;\n\n\t/**\n\t * True if the signal value is being overridden by\n\t * a connected signal. Internal use only.\n\t */\n\tabstract overridden: boolean;\n\n\t/**\n\t * The minimum value of the output given the units\n\t */\n\tabstract readonly minValue: number;\n\n\t/**\n\t * The maximum value of the output given the units\n\t */\n\tabstract readonly maxValue: number;\n}\n" }, { "path": "Tone/core/context/AudioContext.ts", "content": "import {\n\tAudioContext as stdAudioContext,\n\tAudioWorkletNode as stdAudioWorkletNode,\n\tOfflineAudioContext as stdOfflineAudioContext,\n} from \"standardized-audio-context\";\n\nimport { assert } from \"../util/Debug.js\";\nimport { isDefined } from \"../util/TypeCheck.js\";\n\n/**\n * Create a new AudioContext\n */\nexport function createAudioContext(\n\toptions?: AudioContextOptions\n): AudioContext {\n\treturn new stdAudioContext(options) as unknown as AudioContext;\n}\n\n/**\n * Create a new OfflineAudioContext\n */\nexport function createOfflineAudioContext(\n\tchannels: number,\n\tlength: number,\n\tsampleRate: number\n): OfflineAudioContext {\n\treturn new stdOfflineAudioContext(\n\t\tchannels,\n\t\tlength,\n\t\tsampleRate\n\t) as unknown as OfflineAudioContext;\n}\n\n/**\n * Either the online or offline audio context\n */\nexport type AnyAudioContext = AudioContext | OfflineAudioContext;\n\n/**\n * Interface for things that Tone.js adds to the window\n */\ninterface ToneWindow extends Window {\n\tTONE_SILENCE_LOGGING?: boolean;\n\tTONE_DEBUG_CLASS?: string;\n\tBaseAudioContext: any;\n\tAudioWorkletNode: any;\n}\n\n/**\n * A reference to the window object\n * @hidden\n */\nexport const theWindow: ToneWindow | null =\n\ttypeof self === \"object\" ? self : null;\n\n/**\n * If the browser has a window object which has an AudioContext\n * @hidden\n */\nexport const hasAudioContext =\n\ttheWindow &&\n\t(theWindow.hasOwnProperty(\"AudioContext\") ||\n\t\ttheWindow.hasOwnProperty(\"webkitAudioContext\"));\n\nexport function createAudioWorkletNode(\n\tcontext: AnyAudioContext,\n\tname: string,\n\toptions?: Partial\n): AudioWorkletNode {\n\tassert(\n\t\tisDefined(stdAudioWorkletNode),\n\t\t\"AudioWorkletNode only works in a secure context (https or localhost)\"\n\t);\n\treturn new (\n\t\tcontext instanceof theWindow?.BaseAudioContext\n\t\t\t? theWindow?.AudioWorkletNode\n\t\t\t: stdAudioWorkletNode\n\t)(context, name, options);\n}\n\n/**\n * This promise resolves to a boolean which indicates if the\n * functionality is supported within the currently used browse.\n * Taken from [standardized-audio-context](https://github.com/chrisguttandin/standardized-audio-context#issupported)\n */\nexport { isSupported as supported } from \"standardized-audio-context\";\n" }, { "path": "Tone/core/context/BaseContext.ts", "content": "import type { TransportInstance as Transport } from \"../clock/Transport.js\";\nimport { Seconds } from \"../type/Units.js\";\nimport type { DrawInstance as Draw } from \"../util/Draw.js\";\nimport { Emitter } from \"../util/Emitter.js\";\nimport { AnyAudioContext } from \"./AudioContext.js\";\nimport type { DestinationInstance as Destination } from \"./Destination.js\";\nimport type { ListenerInstance as Listener } from \"./Listener.js\";\n\n// these are either not used in Tone.js or deprecated and not implemented.\nexport type ExcludedFromBaseAudioContext =\n\t| \"onstatechange\"\n\t| \"addEventListener\"\n\t| \"removeEventListener\"\n\t| \"listener\"\n\t| \"dispatchEvent\"\n\t| \"audioWorklet\"\n\t| \"destination\"\n\t| \"createScriptProcessor\";\n\n// the subset of the BaseAudioContext which Tone.Context implements.\nexport type BaseAudioContextSubset = Omit<\n\tBaseAudioContext,\n\tExcludedFromBaseAudioContext\n>;\n\nexport type ContextLatencyHint = AudioContextLatencyCategory;\n\n/**\n * Shared class for both Offline and Online Audio Context's\n */\nexport abstract class BaseContext\n\textends Emitter<\"statechange\" | \"tick\">\n\timplements BaseAudioContextSubset\n{\n\t//---------------------------\n\t// BASE AUDIO CONTEXT METHODS\n\t//---------------------------\n\tabstract createAnalyser(): AnalyserNode;\n\n\tabstract createOscillator(): OscillatorNode;\n\n\tabstract createBufferSource(): AudioBufferSourceNode;\n\n\tabstract createBiquadFilter(): BiquadFilterNode;\n\n\tabstract createBuffer(\n\t\t_numberOfChannels: number,\n\t\t_length: number,\n\t\t_sampleRate: number\n\t): AudioBuffer;\n\n\tabstract createChannelMerger(\n\t\t_numberOfInputs?: number | undefined\n\t): ChannelMergerNode;\n\n\tabstract createChannelSplitter(\n\t\t_numberOfOutputs?: number | undefined\n\t): ChannelSplitterNode;\n\n\tabstract createConstantSource(): ConstantSourceNode;\n\n\tabstract createConvolver(): ConvolverNode;\n\n\tabstract createDelay(_maxDelayTime?: number | undefined): DelayNode;\n\n\tabstract createDynamicsCompressor(): DynamicsCompressorNode;\n\n\tabstract createGain(): GainNode;\n\n\tabstract createIIRFilter(\n\t\t_feedForward: number[] | Float32Array,\n\t\t_feedback: number[] | Float32Array\n\t): IIRFilterNode;\n\n\tabstract createPanner(): PannerNode;\n\n\tabstract createPeriodicWave(\n\t\t_real: number[] | Float32Array,\n\t\t_imag: number[] | Float32Array,\n\t\t_constraints?: PeriodicWaveConstraints | undefined\n\t): PeriodicWave;\n\n\tabstract createStereoPanner(): StereoPannerNode;\n\n\tabstract createWaveShaper(): WaveShaperNode;\n\n\tabstract createMediaStreamSource(\n\t\t_stream: MediaStream\n\t): MediaStreamAudioSourceNode;\n\n\tabstract createMediaElementSource(\n\t\t_element: HTMLMediaElement\n\t): MediaElementAudioSourceNode;\n\n\tabstract createMediaStreamDestination(): MediaStreamAudioDestinationNode;\n\n\tabstract decodeAudioData(_audioData: ArrayBuffer): Promise;\n\n\t//---------------------------\n\t// TONE AUDIO CONTEXT METHODS\n\t//---------------------------\n\n\tabstract createAudioWorkletNode(\n\t\t_name: string,\n\t\t_options?: Partial\n\t): AudioWorkletNode;\n\n\tabstract get rawContext(): AnyAudioContext;\n\n\tabstract addAudioWorkletModule(_url: string): Promise;\n\n\tabstract lookAhead: number;\n\n\tabstract latencyHint: ContextLatencyHint | Seconds;\n\n\tabstract resume(): Promise;\n\n\tabstract setTimeout(\n\t\t_fn: (...args: any[]) => void,\n\t\t_timeout: Seconds\n\t): number;\n\n\tabstract clearTimeout(_id: number): this;\n\n\tabstract setInterval(\n\t\t_fn: (...args: any[]) => void,\n\t\t_interval: Seconds\n\t): number;\n\n\tabstract clearInterval(_id: number): this;\n\n\t/**\n\t * @deprecated use ToneConstantSource instead\n\t */\n\tabstract getConstant(_val: number): AudioBufferSourceNode;\n\n\tabstract get currentTime(): Seconds;\n\n\tabstract get state(): AudioContextState;\n\n\tabstract get sampleRate(): number;\n\n\tabstract get listener(): Listener;\n\n\tabstract get transport(): Transport;\n\n\tabstract get draw(): Draw;\n\n\tabstract get destination(): Destination;\n\n\tabstract now(): Seconds;\n\n\tabstract immediate(): Seconds;\n\n\t/*\n\t * This is a placeholder so that JSON.stringify does not throw an error\n\t * This matches what JSON.stringify(audioContext) returns on a native\n\t * audioContext instance.\n\t */\n\ttoJSON(): Record {\n\t\treturn {};\n\t}\n\n\treadonly isOffline: boolean = false;\n}\n" }, { "path": "Tone/core/context/Context.test.ts", "content": "import { expect } from \"chai\";\n\nimport { ConstantOutput } from \"../../../test/helper/ConstantOutput.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { TransportInstance } from \"../clock/Transport.js\";\nimport { getContext } from \"../Global.js\";\nimport { DrawInstance } from \"../util/Draw.js\";\nimport { createAudioContext } from \"./AudioContext.js\";\nimport { Context } from \"./Context.js\";\nimport { DestinationInstance } from \"./Destination.js\";\nimport { ListenerInstance } from \"./Listener.js\";\nimport { connect } from \"./ToneAudioNode.js\";\n\ndescribe(\"Context\", () => {\n\tit(\"creates and disposes the classes attached to the context\", async () => {\n\t\tconst ac = createAudioContext();\n\t\tconst context = new Context(ac);\n\t\tconst ctxDest = context.destination;\n\t\tconst ctxDraw = context.draw;\n\t\tconst ctxTransport = context.transport;\n\t\tconst ctxListener = context.listener;\n\t\texpect(context.destination).is.instanceOf(DestinationInstance);\n\t\texpect(context.draw).is.instanceOf(DrawInstance);\n\t\texpect(context.listener).is.instanceOf(ListenerInstance);\n\t\tawait context.close();\n\t\texpect(ctxDest.disposed).to.be.true;\n\t\texpect(ctxDraw.disposed).to.be.true;\n\t\texpect(ctxTransport.disposed).to.be.true;\n\t\texpect(ctxListener.disposed).to.be.true;\n\t\tcontext.dispose();\n\t});\n\n\tcontext(\"AudioContext\", () => {\n\t\tit(\"extends the AudioContext methods\", () => {\n\t\t\tconst ctx = new Context(createAudioContext());\n\t\t\texpect(ctx).to.have.property(\"createGain\");\n\t\t\texpect(ctx.createGain()).to.have.property(\"gain\");\n\t\t\texpect(ctx).to.have.property(\"createOscillator\");\n\t\t\texpect(ctx.createOscillator()).to.be.have.property(\"frequency\");\n\t\t\texpect(ctx).to.have.property(\"createDelay\");\n\t\t\texpect(ctx.createDelay()).to.be.have.property(\"delayTime\");\n\t\t\texpect(ctx).to.have.property(\"createConstantSource\");\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can be stringified\", () => {\n\t\t\tconst ctx = new Context(createAudioContext());\n\t\t\texpect(JSON.stringify(ctx)).to.equal(\"{}\");\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"clock is running\", (done) => {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tif (getContext().currentTime > 0.5) {\n\t\t\t\t\tclearInterval(interval);\n\t\t\t\t\tdone();\n\t\t\t\t}\n\t\t\t}, 20);\n\t\t});\n\n\t\tit(\"has a rawContext\", () => {\n\t\t\tconst ctx = new Context(createAudioContext());\n\t\t\texpect(ctx.rawContext).has.property(\"destination\");\n\t\t\texpect(ctx.rawContext).has.property(\"sampleRate\");\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can be constructed with an options object\", () => {\n\t\t\tconst ctx = new Context({\n\t\t\t\tclockSource: \"timeout\",\n\t\t\t\tlatencyHint: \"playback\",\n\t\t\t\tlookAhead: 0.2,\n\t\t\t\tupdateInterval: 0.1,\n\t\t\t\tsampleRate: 32000,\n\t\t\t});\n\t\t\texpect(ctx.lookAhead).to.equal(0.2);\n\t\t\texpect(ctx.updateInterval).to.equal(0.1);\n\t\t\texpect(ctx.latencyHint).to.equal(\"playback\");\n\t\t\texpect(ctx.clockSource).to.equal(\"timeout\");\n\t\t\texpect(ctx.sampleRate).to.equal(32000);\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"returns 'now' and 'immediate' time\", () => {\n\t\t\tconst ctx = new Context();\n\t\t\texpect(ctx.now()).to.be.a(\"number\");\n\t\t\texpect(ctx.immediate()).to.be.a(\"number\");\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\t});\n\n\tcontext(\"state\", () => {\n\t\tit(\"can suspend and resume the state\", async () => {\n\t\t\tconst ac = createAudioContext();\n\t\t\tconst context = new Context(ac);\n\t\t\texpect(context.rawContext).to.equal(ac);\n\t\t\tawait ac.suspend();\n\t\t\texpect(context.state).to.equal(\"suspended\");\n\t\t\tawait context.resume();\n\t\t\texpect(context.state).to.equal(\"running\");\n\t\t\tcontext.dispose();\n\t\t\treturn context.close();\n\t\t});\n\n\t\tit(\"invokes the statechange event\", async () => {\n\t\t\tconst ac = createAudioContext();\n\t\t\tconst context = new Context(ac);\n\t\t\tlet triggerChange = false;\n\t\t\tcontext.on(\"statechange\", (state) => {\n\t\t\t\tif (!triggerChange) {\n\t\t\t\t\ttriggerChange = true;\n\t\t\t\t\texpect(state).to.equal(\"running\");\n\t\t\t\t}\n\t\t\t});\n\t\t\tawait context.resume();\n\t\t\tawait new Promise((done) => setTimeout(() => done(), 10));\n\t\t\texpect(triggerChange).to.equal(true);\n\t\t\treturn context.dispose();\n\t\t});\n\t});\n\n\tcontext(\"clockSource\", () => {\n\t\tlet ctx;\n\t\tbeforeEach(() => {\n\t\t\tctx = new Context();\n\t\t\treturn ctx.resume();\n\t\t});\n\n\t\tafterEach(() => {\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"defaults to 'worker'\", () => {\n\t\t\texpect(ctx.clockSource).to.equal(\"worker\");\n\t\t});\n\n\t\tit(\"provides callback\", (done) => {\n\t\t\texpect(ctx.clockSource).to.equal(\"worker\");\n\t\t\tctx.setTimeout(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can be set to 'timeout'\", (done) => {\n\t\t\tctx.clockSource = \"timeout\";\n\t\t\texpect(ctx.clockSource).to.equal(\"timeout\");\n\t\t\tctx.setTimeout(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"can be set to 'offline'\", (done) => {\n\t\t\tctx.clockSource = \"offline\";\n\t\t\texpect(ctx.clockSource).to.equal(\"offline\");\n\t\t\t// provides no callback\n\t\t\tctx.setTimeout(() => {\n\t\t\t\tthrow new Error(\"shouldn't be called\");\n\t\t\t}, 0.1);\n\t\t\tsetTimeout(() => {\n\t\t\t\tdone();\n\t\t\t}, 200);\n\t\t});\n\t});\n\tcontext(\"setTimeout\", () => {\n\t\tlet ctx;\n\t\tbeforeEach(() => {\n\t\t\tctx = new Context();\n\t\t\treturn ctx.resume();\n\t\t});\n\n\t\tafterEach(() => {\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can set a timeout\", (done) => {\n\t\t\tctx.setTimeout(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"returns an id\", () => {\n\t\t\texpect(ctx.setTimeout(() => {}, 0.1)).to.be.a(\"number\");\n\t\t\t// try clearing a random ID, shouldn't cause any errors\n\t\t\tctx.clearTimeout(-2);\n\t\t});\n\n\t\tit(\"timeout is not invoked when cancelled\", (done) => {\n\t\t\tconst id = ctx.setTimeout(() => {\n\t\t\t\tthrow new Error(\"shouldn't be invoked\");\n\t\t\t}, 0.01);\n\t\t\tctx.clearTimeout(id);\n\t\t\tctx.setTimeout(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.02);\n\t\t});\n\n\t\tit(\"order is maintained\", (done) => {\n\t\t\tlet wasInvoked = false;\n\t\t\tctx.setTimeout(() => {\n\t\t\t\texpect(wasInvoked).to.equal(true);\n\t\t\t\tdone();\n\t\t\t}, 0.02);\n\t\t\tctx.setTimeout(() => {\n\t\t\t\twasInvoked = true;\n\t\t\t}, 0.01);\n\t\t});\n\n\t\tit(\"is invoked in the offline context\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst transport = new TransportInstance({ context });\n\t\t\t\ttransport.context.setTimeout(() => {\n\t\t\t\t\texpect(transport.now()).to.be.closeTo(0.01, 0.005);\n\t\t\t\t}, 0.01);\n\t\t\t}, 0.05);\n\t\t});\n\n\t\tit(\"is robust against altering the timeline within the callback fn\", (done) => {\n\t\t\tlet invokeCount = 0;\n\t\t\tfunction checkDone(id: number) {\n\t\t\t\t// clearing the current event alters the timeline and should not cause an issue\n\t\t\t\tctx.clearTimeout(id);\n\t\t\t\tinvokeCount++;\n\t\t\t\tif (invokeCount === 3) {\n\t\t\t\t\tdone();\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst id0 = ctx.setTimeout(() => checkDone(id0), 0.01);\n\t\t\tconst id1 = ctx.setTimeout(() => checkDone(id1), 0.01);\n\t\t\tconst id2 = ctx.setTimeout(() => checkDone(id2), 0.01);\n\t\t});\n\t});\n\n\tcontext(\"setInterval\", () => {\n\t\tlet ctx;\n\t\tbeforeEach(() => {\n\t\t\tctx = new Context();\n\t\t\treturn ctx.resume();\n\t\t});\n\n\t\tafterEach(() => {\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can set an interval\", (done) => {\n\t\t\tctx.setInterval(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.1);\n\t\t});\n\n\t\tit(\"returns an id\", () => {\n\t\t\texpect(ctx.setInterval(() => {}, 0.1)).to.be.a(\"number\");\n\t\t\t// try clearing a random ID, shouldn't cause any errors\n\t\t\tctx.clearInterval(-2);\n\t\t});\n\n\t\tit(\"timeout is not invoked when cancelled\", (done) => {\n\t\t\tconst id = ctx.setInterval(() => {\n\t\t\t\tthrow new Error(\"shouldn't be invoked\");\n\t\t\t}, 0.01);\n\t\t\tctx.clearInterval(id);\n\t\t\tctx.setInterval(() => {\n\t\t\t\tdone();\n\t\t\t}, 0.02);\n\t\t});\n\n\t\tit(\"order is maintained\", (done) => {\n\t\t\tlet wasInvoked = false;\n\t\t\tctx.setInterval(() => {\n\t\t\t\texpect(wasInvoked).to.equal(true);\n\t\t\t\tdone();\n\t\t\t}, 0.02);\n\t\t\tctx.setInterval(() => {\n\t\t\t\twasInvoked = true;\n\t\t\t}, 0.01);\n\t\t});\n\n\t\tit(\"is invoked in the offline context\", async () => {\n\t\t\tlet invocationCount = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tcontext.setInterval(() => {\n\t\t\t\t\tinvocationCount++;\n\t\t\t\t}, 0.01);\n\t\t\t}, 0.051);\n\t\t\texpect(invocationCount).to.equal(4);\n\t\t});\n\n\t\tit(\"is invoked with the right interval\", async () => {\n\t\t\tlet numberOfInvocations = 0;\n\t\t\tawait Offline((context) => {\n\t\t\t\tlet intervalTime = context.now();\n\t\t\t\tcontext.setInterval(() => {\n\t\t\t\t\texpect(context.now() - intervalTime).to.be.closeTo(\n\t\t\t\t\t\t0.01,\n\t\t\t\t\t\t0.005\n\t\t\t\t\t);\n\t\t\t\t\tintervalTime = context.now();\n\t\t\t\t\tnumberOfInvocations++;\n\t\t\t\t}, 0.01);\n\t\t\t}, 0.051);\n\t\t\texpect(numberOfInvocations).to.equal(4);\n\t\t});\n\t});\n\n\tcontext(\"get/set\", () => {\n\t\tlet ctx;\n\t\tbeforeEach(() => {\n\t\t\tctx = new Context();\n\t\t\treturn ctx.resume();\n\t\t});\n\n\t\tafterEach(() => {\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can set the lookAhead\", () => {\n\t\t\tctx.lookAhead = 0.05;\n\t\t\texpect(ctx.lookAhead).to.equal(0.05);\n\t\t});\n\n\t\tit(\"can set the updateInterval\", () => {\n\t\t\tctx.updateInterval = 0.05;\n\t\t\texpect(ctx.updateInterval).to.equal(0.05);\n\t\t});\n\n\t\tit(\"gets a constant signal\", () => {\n\t\t\treturn ConstantOutput((context) => {\n\t\t\t\tconst bufferSrc = context.getConstant(1);\n\t\t\t\tconnect(bufferSrc, context.destination);\n\t\t\t}, 1);\n\t\t});\n\n\t\tit(\"multiple calls return the same buffer source\", () => {\n\t\t\tconst bufferA = ctx.getConstant(2);\n\t\t\tconst bufferB = ctx.getConstant(2);\n\t\t\texpect(bufferA).to.equal(bufferB);\n\t\t});\n\t});\n\n\tcontext(\"Methods\", () => {\n\t\tlet ctx;\n\t\tbeforeEach(() => {\n\t\t\tctx = new Context();\n\t\t\treturn ctx.resume();\n\t\t});\n\n\t\tafterEach(() => {\n\t\t\tctx.dispose();\n\t\t\treturn ctx.close();\n\t\t});\n\n\t\tit(\"can create a MediaElementAudioSourceNode\", () => {\n\t\t\tconst audioNode = document.createElement(\"audio\");\n\t\t\tconst node = ctx.createMediaElementSource(audioNode);\n\t\t\texpect(node).is.not.undefined;\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/context/Context.ts", "content": "import { Ticker, TickerClockSource } from \"../clock/Ticker.js\";\nimport type { TransportInstance as Transport } from \"../clock/Transport.js\";\nimport { Seconds } from \"../type/Units.js\";\nimport { isAudioContext } from \"../util/AdvancedTypeCheck.js\";\nimport { assert } from \"../util/Debug.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport type { DrawInstance as Draw } from \"../util/Draw.js\";\nimport { Timeline } from \"../util/Timeline.js\";\nimport { isDefined } from \"../util/TypeCheck.js\";\nimport {\n\tAnyAudioContext,\n\tcreateAudioContext,\n\tcreateAudioWorkletNode,\n} from \"./AudioContext.js\";\nimport { BaseContext, ContextLatencyHint } from \"./BaseContext.js\";\nimport { closeContext, initializeContext } from \"./ContextInitialization.js\";\nimport type { DestinationInstance as Destination } from \"./Destination.js\";\nimport type { ListenerInstance as Listener } from \"./Listener.js\";\n\nexport interface ContextOptions {\n\tclockSource: TickerClockSource;\n\tlatencyHint: ContextLatencyHint;\n\tlookAhead: Seconds;\n\tupdateInterval: Seconds;\n\tcontext: AnyAudioContext;\n\tsampleRate: number;\n}\n\nexport interface ContextTimeoutEvent {\n\tcallback: (...args: any[]) => void;\n\tid: number;\n\ttime: Seconds;\n}\n\n/**\n * Wraps the native AudioContext.\n * @category Core\n */\nexport class Context extends BaseContext {\n\treadonly name: string = \"Context\";\n\n\t/**\n\t * A private reference to the BaseAudioContext.\n\t */\n\tprotected readonly _context: AnyAudioContext;\n\n\t/**\n\t * A reliable callback method.\n\t */\n\tprivate readonly _ticker: Ticker;\n\n\t/**\n\t * The default latency hint.\n\t */\n\tprivate _latencyHint!: ContextLatencyHint | Seconds;\n\n\t/**\n\t * An object containing all of the AudioBufferSourceNodes with constant values.\n\t */\n\tprivate _constants = new Map();\n\n\t/**\n\t * All of the setTimeout events.\n\t */\n\tprivate _timeouts: Timeline = new Timeline();\n\n\t/**\n\t * The timeout id counter\n\t */\n\tprivate _timeoutIds = 0;\n\n\t/**\n\t * A reference the Transport singleton belonging to this context\n\t */\n\tprivate _transport!: Transport;\n\n\t/**\n\t * A reference the Listener singleton belonging to this context\n\t */\n\tprivate _listener!: Listener;\n\n\t/**\n\t * A reference the Destination singleton belonging to this context\n\t */\n\tprivate _destination!: Destination;\n\n\t/**\n\t * A reference the Transport singleton belonging to this context\n\t */\n\tprivate _draw!: Draw;\n\n\t/**\n\t * Private indicator if the context has been initialized\n\t */\n\tprivate _initialized = false;\n\n\t/**\n\t * Private indicator if a close() has been called on the context, since close is async\n\t */\n\tprivate _closeStarted = false;\n\n\t/**\n\t * Indicates if the context is an OfflineAudioContext or an AudioContext\n\t */\n\treadonly isOffline: boolean = false;\n\n\tconstructor(context?: AnyAudioContext);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tsuper();\n\t\tconst options = optionsFromArguments(Context.getDefaults(), arguments, [\n\t\t\t\"context\",\n\t\t]);\n\n\t\tif (options.context) {\n\t\t\tthis._context = options.context;\n\t\t\t// custom context provided, latencyHint unknown (unless explicitly provided in options)\n\t\t\tthis._latencyHint = arguments[0]?.latencyHint || \"\";\n\t\t} else {\n\t\t\tthis._context = createAudioContext(\n\t\t\t\toptions.sampleRate\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tlatencyHint: options.latencyHint,\n\t\t\t\t\t\t\tsampleRate: options.sampleRate,\n\t\t\t\t\t\t}\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tlatencyHint: options.latencyHint,\n\t\t\t\t\t\t}\n\t\t\t);\n\t\t\tthis._latencyHint = options.latencyHint;\n\t\t}\n\n\t\tthis._ticker = new Ticker(\n\t\t\tthis.emit.bind(this, \"tick\"),\n\t\t\toptions.clockSource,\n\t\t\toptions.updateInterval,\n\t\t\tthis._context.sampleRate\n\t\t);\n\t\tthis.on(\"tick\", this._timeoutLoop.bind(this));\n\n\t\t// fwd events from the context\n\t\tthis._context.onstatechange = () => {\n\t\t\tthis.emit(\"statechange\", this.state);\n\t\t};\n\n\t\t// if no custom updateInterval provided, updateInterval will be derived by lookAhead setter\n\t\tthis[\n\t\t\targuments[0]?.hasOwnProperty(\"updateInterval\")\n\t\t\t\t? \"_lookAhead\"\n\t\t\t\t: \"lookAhead\"\n\t\t] = options.lookAhead;\n\t}\n\n\tstatic getDefaults(): ContextOptions {\n\t\treturn {\n\t\t\tclockSource: \"worker\",\n\t\t\tlatencyHint: \"interactive\",\n\t\t\tlookAhead: 0.1,\n\t\t\tupdateInterval: 0.05,\n\t\t} as ContextOptions;\n\t}\n\n\t/**\n\t * Finish setting up the context. **You usually do not need to do this manually.**\n\t */\n\tprivate initialize(): this {\n\t\tif (!this._initialized) {\n\t\t\t// add any additional modules\n\t\t\tinitializeContext(this);\n\t\t\tthis._initialized = true;\n\t\t}\n\t\treturn this;\n\t}\n\n\t//---------------------------\n\t// BASE AUDIO CONTEXT METHODS\n\t//---------------------------\n\n\tcreateAnalyser(): AnalyserNode {\n\t\treturn this._context.createAnalyser();\n\t}\n\tcreateOscillator(): OscillatorNode {\n\t\treturn this._context.createOscillator();\n\t}\n\tcreateBufferSource(): AudioBufferSourceNode {\n\t\treturn this._context.createBufferSource();\n\t}\n\tcreateBiquadFilter(): BiquadFilterNode {\n\t\treturn this._context.createBiquadFilter();\n\t}\n\tcreateBuffer(\n\t\tnumberOfChannels: number,\n\t\tlength: number,\n\t\tsampleRate: number\n\t): AudioBuffer {\n\t\treturn this._context.createBuffer(numberOfChannels, length, sampleRate);\n\t}\n\tcreateChannelMerger(\n\t\tnumberOfInputs?: number | undefined\n\t): ChannelMergerNode {\n\t\treturn this._context.createChannelMerger(numberOfInputs);\n\t}\n\tcreateChannelSplitter(\n\t\tnumberOfOutputs?: number | undefined\n\t): ChannelSplitterNode {\n\t\treturn this._context.createChannelSplitter(numberOfOutputs);\n\t}\n\tcreateConstantSource(): ConstantSourceNode {\n\t\treturn this._context.createConstantSource();\n\t}\n\tcreateConvolver(): ConvolverNode {\n\t\treturn this._context.createConvolver();\n\t}\n\tcreateDelay(maxDelayTime?: number | undefined): DelayNode {\n\t\treturn this._context.createDelay(maxDelayTime);\n\t}\n\tcreateDynamicsCompressor(): DynamicsCompressorNode {\n\t\treturn this._context.createDynamicsCompressor();\n\t}\n\tcreateGain(): GainNode {\n\t\treturn this._context.createGain();\n\t}\n\tcreateIIRFilter(\n\t\tfeedForward: number[] | Float32Array,\n\t\tfeedback: number[] | Float32Array\n\t): IIRFilterNode {\n\t\t// @ts-ignore\n\t\treturn this._context.createIIRFilter(feedForward, feedback);\n\t}\n\tcreatePanner(): PannerNode {\n\t\treturn this._context.createPanner();\n\t}\n\tcreatePeriodicWave(\n\t\treal: number[] | Float32Array,\n\t\timag: number[] | Float32Array,\n\t\tconstraints?: PeriodicWaveConstraints | undefined\n\t): PeriodicWave {\n\t\treturn this._context.createPeriodicWave(real, imag, constraints);\n\t}\n\tcreateStereoPanner(): StereoPannerNode {\n\t\treturn this._context.createStereoPanner();\n\t}\n\tcreateWaveShaper(): WaveShaperNode {\n\t\treturn this._context.createWaveShaper();\n\t}\n\tcreateMediaStreamSource(stream: MediaStream): MediaStreamAudioSourceNode {\n\t\tassert(\n\t\t\tisAudioContext(this._context),\n\t\t\t\"Not available if OfflineAudioContext\"\n\t\t);\n\t\tconst context = this._context as AudioContext;\n\t\treturn context.createMediaStreamSource(stream);\n\t}\n\tcreateMediaElementSource(\n\t\telement: HTMLMediaElement\n\t): MediaElementAudioSourceNode {\n\t\tassert(\n\t\t\tisAudioContext(this._context),\n\t\t\t\"Not available if OfflineAudioContext\"\n\t\t);\n\t\tconst context = this._context as AudioContext;\n\t\treturn context.createMediaElementSource(element);\n\t}\n\tcreateMediaStreamDestination(): MediaStreamAudioDestinationNode {\n\t\tassert(\n\t\t\tisAudioContext(this._context),\n\t\t\t\"Not available if OfflineAudioContext\"\n\t\t);\n\t\tconst context = this._context as AudioContext;\n\t\treturn context.createMediaStreamDestination();\n\t}\n\tdecodeAudioData(audioData: ArrayBuffer): Promise {\n\t\treturn this._context.decodeAudioData(audioData);\n\t}\n\n\t/**\n\t * The current time in seconds of the AudioContext.\n\t */\n\tget currentTime(): Seconds {\n\t\treturn this._context.currentTime;\n\t}\n\t/**\n\t * The current time in seconds of the AudioContext.\n\t */\n\tget state(): AudioContextState {\n\t\treturn this._context.state;\n\t}\n\t/**\n\t * The current time in seconds of the AudioContext.\n\t */\n\tget sampleRate(): number {\n\t\treturn this._context.sampleRate;\n\t}\n\n\t/**\n\t * The listener\n\t */\n\tget listener(): Listener {\n\t\tthis.initialize();\n\t\treturn this._listener;\n\t}\n\tset listener(l) {\n\t\tassert(\n\t\t\t!this._initialized,\n\t\t\t\"The listener cannot be set after initialization.\"\n\t\t);\n\t\tthis._listener = l;\n\t}\n\n\t/**\n\t * There is only one Transport per Context. It is created on initialization.\n\t */\n\tget transport(): Transport {\n\t\tthis.initialize();\n\t\treturn this._transport;\n\t}\n\tset transport(t: Transport) {\n\t\tassert(\n\t\t\t!this._initialized,\n\t\t\t\"The transport cannot be set after initialization.\"\n\t\t);\n\t\tthis._transport = t;\n\t}\n\n\t/**\n\t * This is the Draw object for the context which is useful for synchronizing the draw frame with the Tone.js clock.\n\t */\n\tget draw(): Draw {\n\t\tthis.initialize();\n\t\treturn this._draw;\n\t}\n\tset draw(d) {\n\t\tassert(!this._initialized, \"Draw cannot be set after initialization.\");\n\t\tthis._draw = d;\n\t}\n\n\t/**\n\t * A reference to the Context's destination node.\n\t */\n\tget destination(): Destination {\n\t\tthis.initialize();\n\t\treturn this._destination;\n\t}\n\tset destination(d: Destination) {\n\t\tassert(\n\t\t\t!this._initialized,\n\t\t\t\"The destination cannot be set after initialization.\"\n\t\t);\n\t\tthis._destination = d;\n\t}\n\n\t//--------------------------------------------\n\t// AUDIO WORKLET\n\t//--------------------------------------------\n\n\t/**\n\t * A set of unsettled promises returned by the addModule method\n\t */\n\tprivate _workletPromises = new Set>();\n\n\t/**\n\t * Create an audio worklet node from a name and options. The module\n\t * must first be loaded using {@link addAudioWorkletModule}.\n\t */\n\tcreateAudioWorkletNode(\n\t\tname: string,\n\t\toptions?: Partial\n\t): AudioWorkletNode {\n\t\treturn createAudioWorkletNode(this.rawContext, name, options);\n\t}\n\n\t/**\n\t * Add an AudioWorkletProcessor module\n\t * @param url The url of the module\n\t */\n\tasync addAudioWorkletModule(url: string): Promise {\n\t\tassert(\n\t\t\tisDefined(this.rawContext.audioWorklet),\n\t\t\t\"AudioWorkletNode is only available in a secure context (https or localhost)\"\n\t\t);\n\t\tconst workletPromise = this.rawContext.audioWorklet.addModule(url);\n\n\t\tthis._workletPromises.add(workletPromise);\n\t\tworkletPromise.finally(() =>\n\t\t\tthis._workletPromises.delete(workletPromise)\n\t\t);\n\n\t\treturn workletPromise;\n\t}\n\n\t/**\n\t * Returns a promise which resolves when all of the worklets have been loaded on this context\n\t */\n\tprotected async workletsAreReady(): Promise {\n\t\tawait Promise.all(this._workletPromises);\n\t}\n\n\t//---------------------------\n\t// TICKER\n\t//---------------------------\n\n\t/**\n\t * How often the interval callback is invoked.\n\t * This number corresponds to how responsive the scheduling\n\t * can be. Setting to 0 will result in the lowest practical interval\n\t * based on context properties. context.updateInterval + context.lookAhead\n\t * gives you the total latency between scheduling an event and hearing it.\n\t */\n\tget updateInterval(): Seconds {\n\t\treturn this._ticker.updateInterval;\n\t}\n\tset updateInterval(interval: Seconds) {\n\t\tthis._ticker.updateInterval = interval;\n\t}\n\n\t/**\n\t * What the source of the clock is, either \"worker\" (default),\n\t * \"timeout\", or \"offline\" (none).\n\t */\n\tget clockSource(): TickerClockSource {\n\t\treturn this._ticker.type;\n\t}\n\tset clockSource(type: TickerClockSource) {\n\t\tthis._ticker.type = type;\n\t}\n\n\t/**\n\t * The amount of time into the future events are scheduled. Giving Web Audio\n\t * a short amount of time into the future to schedule events can reduce clicks and\n\t * improve performance. This value can be set to 0 to get the lowest latency.\n\t * Adjusting this value also affects the {@link updateInterval}.\n\t */\n\tget lookAhead(): Seconds {\n\t\treturn this._lookAhead;\n\t}\n\tset lookAhead(time: Seconds) {\n\t\tthis._lookAhead = time;\n\t\t// if lookAhead is 0, default to .01 updateInterval\n\t\tthis.updateInterval = time ? time / 2 : 0.01;\n\t}\n\tprivate _lookAhead!: Seconds;\n\n\t/**\n\t * The type of playback, which affects tradeoffs between audio\n\t * output latency and responsiveness.\n\t * In addition to setting the value in seconds, the latencyHint also\n\t * accepts the strings \"interactive\" (prioritizes low latency),\n\t * \"playback\" (prioritizes sustained playback), \"balanced\" (balances\n\t * latency and performance).\n\t * @example\n\t * // prioritize sustained playback\n\t * const context = new Tone.Context({ latencyHint: \"playback\" });\n\t * // set this context as the global Context\n\t * Tone.setContext(context);\n\t * // the global context is gettable with Tone.getContext()\n\t * console.log(Tone.getContext().latencyHint);\n\t */\n\tget latencyHint(): ContextLatencyHint | Seconds {\n\t\treturn this._latencyHint;\n\t}\n\n\t/**\n\t * The unwrapped AudioContext or OfflineAudioContext\n\t */\n\tget rawContext(): AnyAudioContext {\n\t\treturn this._context;\n\t}\n\n\t/**\n\t * The current audio context time plus a short {@link lookAhead}.\n\t * @example\n\t * setInterval(() => {\n\t * \tconsole.log(\"now\", Tone.now());\n\t * }, 100);\n\t */\n\tnow(): Seconds {\n\t\treturn this._context.currentTime + this._lookAhead;\n\t}\n\n\t/**\n\t * The current audio context time without the {@link lookAhead}.\n\t * In most cases it is better to use {@link now} instead of {@link immediate} since\n\t * with {@link now} the {@link lookAhead} is applied equally to _all_ components including internal components,\n\t * to making sure that everything is scheduled in sync. Mixing {@link now} and {@link immediate}\n\t * can cause some timing issues. If no lookAhead is desired, you can set the {@link lookAhead} to `0`.\n\t */\n\timmediate(): Seconds {\n\t\treturn this._context.currentTime;\n\t}\n\n\t/**\n\t * Starts the audio context from a suspended state. This is required\n\t * to initially start the AudioContext.\n\t * @see {@link start}\n\t */\n\tresume(): Promise {\n\t\tif (isAudioContext(this._context)) {\n\t\t\treturn this._context.resume();\n\t\t} else {\n\t\t\treturn Promise.resolve();\n\t\t}\n\t}\n\n\t/**\n\t * Close the context. Once closed, the context can no longer be used and\n\t * any AudioNodes created from the context will be silent.\n\t */\n\tasync close(): Promise {\n\t\tif (\n\t\t\tisAudioContext(this._context) &&\n\t\t\tthis.state !== \"closed\" &&\n\t\t\t!this._closeStarted\n\t\t) {\n\t\t\tthis._closeStarted = true;\n\t\t\tawait this._context.close();\n\t\t}\n\t\tif (this._initialized) {\n\t\t\tcloseContext(this);\n\t\t}\n\t}\n\n\t/**\n\t * **Internal** Generate a looped buffer at some constant value.\n\t * @deprecated\n\t */\n\tgetConstant(val: number): AudioBufferSourceNode {\n\t\tif (this._constants.has(val)) {\n\t\t\treturn this._constants.get(val) as AudioBufferSourceNode;\n\t\t} else {\n\t\t\tconst buffer = this._context.createBuffer(\n\t\t\t\t1,\n\t\t\t\t128,\n\t\t\t\tthis._context.sampleRate\n\t\t\t);\n\t\t\tconst arr = buffer.getChannelData(0);\n\t\t\tfor (let i = 0; i < arr.length; i++) {\n\t\t\t\tarr[i] = val;\n\t\t\t}\n\t\t\tconst constant = this._context.createBufferSource();\n\t\t\tconstant.channelCount = 1;\n\t\t\tconstant.channelCountMode = \"explicit\";\n\t\t\tconstant.buffer = buffer;\n\t\t\tconstant.loop = true;\n\t\t\tconstant.start(0);\n\t\t\tthis._constants.set(val, constant);\n\t\t\treturn constant;\n\t\t}\n\t}\n\n\t/**\n\t * Clean up. Also closes the audio context.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._ticker.dispose();\n\t\tthis._timeouts.dispose();\n\t\tObject.keys(this._constants).map((val) =>\n\t\t\tthis._constants[val].disconnect()\n\t\t);\n\t\tthis.close();\n\t\treturn this;\n\t}\n\n\t//---------------------------\n\t// TIMEOUTS\n\t//---------------------------\n\n\t/**\n\t * The private loop which keeps track of the context scheduled timeouts\n\t * Is invoked from the clock source\n\t */\n\tprivate _timeoutLoop(): void {\n\t\tconst now = this.now();\n\t\tthis._timeouts.forEachBefore(now, (event) => {\n\t\t\ttry {\n\t\t\t\tevent.callback();\n\t\t\t} finally {\n\t\t\t\tthis._timeouts.remove(event);\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * A `setTimeout` which is guaranteed by the clock source.\n\t *\n\t * Also runs in the offline context.\n\t *\n\t * @param fn The callback to invoke.\n\t * @param timeout The timeout in seconds.\n\t * @returns ID to use when invoking {@link clearTimeout}.\n\t */\n\tsetTimeout(fn: (...args: any[]) => void, timeout: Seconds): number {\n\t\tthis._timeoutIds++;\n\t\tconst now = this.now();\n\t\tthis._timeouts.add({\n\t\t\tcallback: fn,\n\t\t\tid: this._timeoutIds,\n\t\t\ttime: now + timeout,\n\t\t});\n\t\treturn this._timeoutIds;\n\t}\n\n\t/**\n\t * Clears a previously scheduled timeout with {@link setTimeout}.\n\t * @param id The ID returned from {@link setTimeout}.\n\t */\n\tclearTimeout(id: number): this {\n\t\tthis._timeouts.forEach((event) => {\n\t\t\tif (event.id === id) {\n\t\t\t\tthis._timeouts.remove(event);\n\t\t\t}\n\t\t});\n\t\treturn this;\n\t}\n\n\t/**\n\t * Clear the function scheduled by {@link setInterval}.\n\t * @param id The ID returned from {@link setInterval}.\n\t */\n\tclearInterval(id: number): this {\n\t\treturn this.clearTimeout(id);\n\t}\n\n\t/**\n\t * Adds a repeating event to the context's callback clock.\n\t * @param fn The callback to invoke.\n\t * @param interval The timeout in seconds.\n\t * @returns ID to use when invoking {@link clearInterval}.\n\t */\n\tsetInterval(fn: (...args: any[]) => void, interval: Seconds): number {\n\t\tconst id = ++this._timeoutIds;\n\t\tconst intervalFn = () => {\n\t\t\tconst now = this.now();\n\t\t\tthis._timeouts.add({\n\t\t\t\tcallback: () => {\n\t\t\t\t\t// invoke the callback\n\t\t\t\t\tfn();\n\t\t\t\t\t// invoke the event to repeat it\n\t\t\t\t\tintervalFn();\n\t\t\t\t},\n\t\t\t\tid,\n\t\t\t\ttime: now + interval,\n\t\t\t});\n\t\t};\n\t\t// kick it off\n\t\tintervalFn();\n\t\treturn id;\n\t}\n}\n" }, { "path": "Tone/core/context/ContextInitialization.ts", "content": "//-------------------------------------\n// INITIALIZING NEW CONTEXT\n//-------------------------------------\nimport type { Context } from \"./Context.js\";\n\n/**\n * Array of callbacks to invoke when a new context is created\n */\nconst notifyNewContext: Array<(ctx: Context) => void> = [];\n\n/**\n * Used internally to setup a new Context\n */\nexport function onContextInit(cb: (ctx: Context) => void): void {\n\tnotifyNewContext.push(cb);\n}\n\n/**\n * Invoke any classes which need to also be initialized when a new context is created.\n */\nexport function initializeContext(ctx: Context): void {\n\t// add any additional modules\n\tnotifyNewContext.forEach((cb) => cb(ctx));\n}\n\n/**\n * Array of callbacks to invoke when a new context is closed\n */\nconst notifyCloseContext: Array<(ctx: Context) => void> = [];\n\n/**\n * Used internally to tear down a Context\n */\nexport function onContextClose(cb: (ctx: Context) => void): void {\n\tnotifyCloseContext.push(cb);\n}\n\nexport function closeContext(ctx: Context): void {\n\t// remove any additional modules\n\tnotifyCloseContext.forEach((cb) => cb(ctx));\n}\n" }, { "path": "Tone/core/context/Delay.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { connect } from \"../context/ToneAudioNode.js\";\nimport { Delay } from \"./Delay.js\";\n\ndescribe(\"Delay\", () => {\n\tBasicTests(Delay);\n\n\tit(\"can be created and disposed\", () => {\n\t\tconst delay = new Delay();\n\t\tdelay.dispose();\n\t});\n\n\tit(\"handles input and output connections\", () => {\n\t\tconst delay = new Delay();\n\t\tdelay.connect(connectTo());\n\t\tconnectFrom().connect(delay);\n\t\tconnectFrom().connect(delay.delayTime);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can be constructed with an options object\", () => {\n\t\tconst delay = new Delay({\n\t\t\tdelayTime: 0.3,\n\t\t\tmaxDelay: 2,\n\t\t});\n\t\texpect(delay.delayTime.value).to.be.closeTo(0.3, 0.001);\n\t\texpect(delay.maxDelay).to.equal(2);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"if the constructor delay time is greater than maxDelay, use that as the maxDelay time\", () => {\n\t\tconst delay = new Delay(3);\n\t\texpect(delay.delayTime.value).to.be.closeTo(3, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"clamps the delayTime range between 0 and maxDelay\", () => {\n\t\tconst delay = new Delay({\n\t\t\tmaxDelay: 1,\n\t\t});\n\t\texpect(() => {\n\t\t\tdelay.delayTime.value = 2;\n\t\t}).to.throw(RangeError);\n\t\texpect(() => {\n\t\t\tdelay.delayTime.value = -1;\n\t\t}).to.throw(RangeError);\n\t\texpect(delay.delayTime.value).to.be.closeTo(0, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can set the delayTime value\", () => {\n\t\tconst delay = new Delay();\n\t\texpect(delay.delayTime.value).to.be.closeTo(0, 0.001);\n\t\tdelay.delayTime.value = 0.2;\n\t\texpect(delay.delayTime.value).to.be.closeTo(0.2, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can be constructed with options object\", () => {\n\t\tconst delay = new Delay({\n\t\t\tdelayTime: 0.4,\n\t\t});\n\t\texpect(delay.delayTime.value).to.be.closeTo(0.4, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can be constructed with an initial value\", () => {\n\t\tconst delay = new Delay(0.3);\n\t\texpect(delay.delayTime.value).to.be.closeTo(0.3, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can set the units\", () => {\n\t\tconst delay = new Delay(0);\n\t\texpect(delay.delayTime.value).to.be.closeTo(0, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can get the value using 'get'\", () => {\n\t\tconst delay = new Delay(2);\n\t\tconst value = delay.get();\n\t\texpect(value.delayTime).to.be.closeTo(2, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"can set the value using 'set'\", () => {\n\t\tconst delay = new Delay(5);\n\t\tdelay.set({\n\t\t\tdelayTime: 4,\n\t\t});\n\t\texpect(delay.delayTime.value).to.be.closeTo(4, 0.001);\n\t\tdelay.dispose();\n\t});\n\n\tit(\"passes audio through\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst delay = new Delay().toDestination();\n\t\t\tconnect(input, delay);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/context/Delay.ts", "content": "import { Param } from \"../context/Param.js\";\nimport { Seconds, Time } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { readOnly } from \"../util/Interface.js\";\nimport { ToneAudioNode, ToneAudioNodeOptions } from \"./ToneAudioNode.js\";\n\nexport interface DelayOptions extends ToneAudioNodeOptions {\n\tdelayTime: Time;\n\tmaxDelay: Time;\n}\n\n/**\n * Wrapper around Web Audio's native [DelayNode](http://webaudio.github.io/web-audio-api/#the-delaynode-interface).\n * @category Core\n * @example\n * return Tone.Offline(() => {\n * \tconst delay = new Tone.Delay(0.1).toDestination();\n * \t// connect the signal to both the delay and the destination\n * \tconst pulse = new Tone.PulseOscillator().connect(delay).toDestination();\n * \t// start and stop the pulse\n * \tpulse.start(0).stop(0.01);\n * }, 0.5, 1);\n */\nexport class Delay extends ToneAudioNode {\n\treadonly name: string = \"Delay\";\n\n\t/**\n\t * Private holder of the max delay time\n\t */\n\tprivate _maxDelay: Seconds;\n\n\t/**\n\t * The amount of time the incoming signal is delayed.\n\t * @example\n\t * const delay = new Tone.Delay().toDestination();\n\t * // modulate the delayTime between 0.1 and 1 seconds\n\t * const delayLFO = new Tone.LFO(0.5, 0.1, 1).start().connect(delay.delayTime);\n\t * const pulse = new Tone.PulseOscillator().connect(delay).start();\n\t * // the change in delayTime causes the pitch to go up and down\n\t */\n\treadonly delayTime: Param<\"time\">;\n\n\t/**\n\t * Private reference to the internal DelayNode\n\t */\n\tprivate _delayNode: DelayNode;\n\treadonly input: DelayNode;\n\treadonly output: DelayNode;\n\n\t/**\n\t * @param delayTime The delay applied to the incoming signal.\n\t * @param maxDelay The maximum delay time.\n\t */\n\tconstructor(delayTime?: Time, maxDelay?: Time);\n\tconstructor(options?: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Delay.getDefaults(), arguments, [\n\t\t\t\"delayTime\",\n\t\t\t\"maxDelay\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tconst maxDelayInSeconds = this.toSeconds(options.maxDelay);\n\t\tthis._maxDelay = Math.max(\n\t\t\tmaxDelayInSeconds,\n\t\t\tthis.toSeconds(options.delayTime)\n\t\t);\n\n\t\tthis._delayNode =\n\t\t\tthis.input =\n\t\t\tthis.output =\n\t\t\t\tthis.context.createDelay(maxDelayInSeconds);\n\n\t\tthis.delayTime = new Param({\n\t\t\tcontext: this.context,\n\t\t\tparam: this._delayNode.delayTime,\n\t\t\tunits: \"time\",\n\t\t\tvalue: options.delayTime,\n\t\t\tminValue: 0,\n\t\t\tmaxValue: this.maxDelay,\n\t\t});\n\n\t\treadOnly(this, \"delayTime\");\n\t}\n\n\tstatic getDefaults(): DelayOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tdelayTime: 0,\n\t\t\tmaxDelay: 1,\n\t\t});\n\t}\n\n\t/**\n\t * The maximum delay time. This cannot be changed after\n\t * the value is passed into the constructor.\n\t */\n\tget maxDelay(): Seconds {\n\t\treturn this._maxDelay;\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._delayNode.disconnect();\n\t\tthis.delayTime.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/context/Destination.test.ts", "content": "import { expect } from \"chai\";\n\nimport { warns } from \"../../../test/helper/Basic.js\";\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Oscillator } from \"../../source/oscillator/Oscillator.js\";\nimport { getContext } from \"../Global.js\";\nimport { DestinationInstance } from \"./Destination.js\";\n\ndescribe(\"Destination\", () => {\n\tit(\"creates itself on the context\", () => {\n\t\texpect(getContext().destination).instanceOf(DestinationInstance);\n\t});\n\n\tit(\"can be muted and unmuted\", () => {\n\t\treturn Offline((context) => {\n\t\t\tcontext.destination.mute = false;\n\t\t\texpect(context.destination.mute).to.equal(false);\n\t\t\tcontext.destination.mute = true;\n\t\t\texpect(context.destination.mute).to.equal(true);\n\t\t});\n\t});\n\n\tit(\"passes audio through\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tinput.toDestination();\n\t\t});\n\t});\n\n\tit(\"passes no audio when muted\", async () => {\n\t\tconst buffer = await Offline((context) => {\n\t\t\tnew Oscillator().toDestination().start(0);\n\t\t\tcontext.destination.mute = true;\n\t\t});\n\t\texpect(buffer.isSilent()).to.equal(true);\n\t});\n\n\tit(\"has a master volume control\", () => {\n\t\treturn Offline((context) => {\n\t\t\tcontext.destination.volume.value = -20;\n\t\t\texpect(context.destination.volume.value).to.be.closeTo(-20, 0.1);\n\t\t});\n\t});\n\n\tit(\"warns when toMaster is called\", () => {\n\t\twarns(() => {\n\t\t\tconst osc = new Oscillator().toMaster();\n\t\t\tosc.dispose();\n\t\t});\n\t});\n\n\tit(\"can get the maxChannelCount\", () => {\n\t\treturn Offline(\n\t\t\t(context) => {\n\t\t\t\texpect(context.destination.maxChannelCount).to.equal(4);\n\t\t\t},\n\t\t\t0.1,\n\t\t\t4\n\t\t);\n\t});\n\n\tit.skip(\"can set the audio channel configuration\", () => {\n\t\treturn Offline(\n\t\t\t(context) => {\n\t\t\t\texpect(context.destination.channelCount).to.equal(4);\n\t\t\t\tcontext.destination.channelCountMode = \"explicit\";\n\t\t\t\tcontext.destination.channelInterpretation = \"discrete\";\n\t\t\t\texpect(context.destination.channelCountMode).to.equal(\n\t\t\t\t\t\"explicit\"\n\t\t\t\t);\n\t\t\t\texpect(context.destination.channelInterpretation).to.equal(\n\t\t\t\t\t\"discrete\"\n\t\t\t\t);\n\t\t\t},\n\t\t\t0.1,\n\t\t\t4\n\t\t);\n\t});\n\n\tit(\"can pass audio through chained nodes\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst gain = input.context.createGain();\n\t\t\tinput.connect(gain);\n\t\t\tinput.context.destination.chain(gain);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/context/Destination.ts", "content": "import { Volume } from \"../../component/channel/Volume.js\";\nimport { Decibels } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { onContextClose, onContextInit } from \"./ContextInitialization.js\";\nimport { Gain } from \"./Gain.js\";\nimport { Param } from \"./Param.js\";\nimport {\n\tconnectSeries,\n\tToneAudioNode,\n\tToneAudioNodeOptions,\n} from \"./ToneAudioNode.js\";\n\ninterface DestinationOptions extends ToneAudioNodeOptions {\n\tvolume: Decibels;\n\tmute: boolean;\n}\n\n/**\n * A single master output that is connected to the\n * AudioDestinationNode (i.e. your speakers).\n *\n * It provides useful conveniences, such as the ability\n * to set the volume and mute the entire application.\n *\n * It also gives you the ability to apply master effects to your application.\n *\n * @example\n * const oscillator = new Tone.Oscillator().start();\n * // The audio will go from the oscillator to the speakers.\n * oscillator.connect(Tone.getDestination());\n * // A convenience for connecting to the master output is also provided:\n * oscillator.toDestination();\n * @category Core\n */\nexport class DestinationInstance extends ToneAudioNode {\n\treadonly name: string = \"Destination\";\n\n\tinput: Volume = new Volume({ context: this.context });\n\toutput: Gain = new Gain({ context: this.context });\n\n\t/**\n\t * The volume of the master output in decibels.\n\t *\n\t * -Infinity is silent, and 0 is no change.\n\t *\n\t * @example\n\t * const osc = new Tone.Oscillator().toDestination();\n\t * osc.start();\n\t * // Ramp the volume down to silent over 10 seconds.\n\t * Tone.getDestination().volume.rampTo(-Infinity, 10);\n\t */\n\tvolume: Param<\"decibels\"> = this.input.volume;\n\n\tconstructor(options: Partial);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(\n\t\t\tDestinationInstance.getDefaults(),\n\t\t\targuments\n\t\t);\n\t\tsuper(options);\n\n\t\tconnectSeries(\n\t\t\tthis.input,\n\t\t\tthis.output,\n\t\t\tthis.context.rawContext.destination\n\t\t);\n\n\t\tthis.mute = options.mute;\n\t\tthis._internalChannels = [\n\t\t\tthis.input,\n\t\t\tthis.context.rawContext.destination,\n\t\t\tthis.output,\n\t\t];\n\t}\n\n\tstatic getDefaults(): DestinationOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tmute: false,\n\t\t\tvolume: 0,\n\t\t});\n\t}\n\n\t/**\n\t * Mute the output.\n\t * @example\n\t * const oscillator = new Tone.Oscillator().start().toDestination();\n\t * setTimeout(() => {\n\t * \t// Mute the output.\n\t * \tTone.Destination.mute = true;\n\t * }, 1000);\n\t */\n\tget mute(): boolean {\n\t\treturn this.input.mute;\n\t}\n\tset mute(mute: boolean) {\n\t\tthis.input.mute = mute;\n\t}\n\n\t/**\n\t * Add a master effects chain.\n\t *\n\t * NOTE: This will disconnect any nodes that were previously chained in the master effects chain.\n\t *\n\t * @param args All arguments will be connected in a row, and the master output will be routed through it.\n\t * @example\n\t * // Route all audio through a filter and compressor.\n\t * const lowpass = new Tone.Filter(800, \"lowpass\");\n\t * const compressor = new Tone.Compressor(-18);\n\t * Tone.Destination.chain(lowpass, compressor);\n\t */\n\tchain(...args: Array): this {\n\t\tthis.input.disconnect();\n\t\targs.unshift(this.input);\n\t\targs.push(this.output);\n\t\tconnectSeries(...args);\n\t\treturn this;\n\t}\n\n\t/**\n\t * The maximum number of channels the system can output.\n\t * @example\n\t * console.log(Tone.Destination.maxChannelCount);\n\t */\n\tget maxChannelCount(): number {\n\t\treturn this.context.rawContext.destination.maxChannelCount;\n\t}\n\n\t/**\n\t * Clean up\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.volume.dispose();\n\t\treturn this;\n\t}\n}\n\n//-------------------------------------\n// \tINITIALIZATION\n//-------------------------------------\n\nonContextInit((context) => {\n\tcontext.destination = new DestinationInstance({ context });\n});\n\nonContextClose((context) => {\n\tcontext.destination.dispose();\n});\n" }, { "path": "Tone/core/context/DummyContext.test.ts", "content": "import { DummyContext } from \"./DummyContext.js\";\n\ndescribe(\"DummyContext\", () => {\n\tit(\"has all the methods and members\", () => {\n\t\tconst context = new DummyContext();\n\t\tcontext.createAnalyser();\n\t\tcontext.createOscillator();\n\t\tcontext.createBufferSource();\n\t\tcontext.createBiquadFilter();\n\t\tcontext.createBuffer(2, 1024, 44100);\n\t\tcontext.createChannelMerger();\n\t\tcontext.createChannelSplitter();\n\t\tcontext.createConstantSource();\n\t\tcontext.createConvolver();\n\t\tcontext.createDelay();\n\t\tcontext.createDynamicsCompressor();\n\t\tcontext.createGain();\n\t\tcontext.createIIRFilter([1, 1, 1], [1, 1, 1]);\n\t\tcontext.createPanner();\n\t\tcontext.createPeriodicWave([1, 1, 1], [1, 1, 1]);\n\t\tcontext.createStereoPanner();\n\t\tcontext.createWaveShaper();\n\t\t// @ts-ignore\n\t\tcontext.createMediaStreamSource();\n\t\tcontext.decodeAudioData(new Float32Array(100));\n\t\tcontext.createAudioWorkletNode(\"test.js\");\n\t\tcontext.rawContext;\n\t\tcontext.addAudioWorkletModule(\"test.js\");\n\t\tcontext.resume();\n\t\tcontext.setTimeout(() => {}, 1);\n\t\tcontext.clearTimeout(1);\n\t\tcontext.setInterval(() => {}, 1);\n\t\tcontext.clearInterval(1);\n\t\tcontext.getConstant(1);\n\t\tcontext.currentTime;\n\t\tcontext.state;\n\t\tcontext.sampleRate;\n\t\tcontext.listener;\n\t\tcontext.transport;\n\t\tcontext.draw;\n\t\tcontext.draw;\n\t\tcontext.destination;\n\t\tcontext.now();\n\t\tcontext.immediate();\n\t});\n});\n" }, { "path": "Tone/core/context/DummyContext.ts", "content": "import type { TransportInstance as Transport } from \"../clock/Transport.js\";\nimport { Seconds } from \"../type/Units.js\";\nimport type { DrawInstance as Draw } from \"../util/Draw.js\";\nimport { AnyAudioContext } from \"./AudioContext.js\";\nimport { BaseContext } from \"./BaseContext.js\";\nimport type { DestinationInstance as Destination } from \"./Destination.js\";\nimport type { ListenerInstance as Listener } from \"./Listener.js\";\n\nexport class DummyContext extends BaseContext {\n\t//---------------------------\n\t// BASE AUDIO CONTEXT METHODS\n\t//---------------------------\n\tcreateAnalyser(): AnalyserNode {\n\t\treturn {} as AnalyserNode;\n\t}\n\n\tcreateOscillator(): OscillatorNode {\n\t\treturn {} as OscillatorNode;\n\t}\n\n\tcreateBufferSource() {\n\t\treturn {} as AudioBufferSourceNode;\n\t}\n\n\tcreateBiquadFilter(): BiquadFilterNode {\n\t\treturn {} as BiquadFilterNode;\n\t}\n\n\tcreateBuffer(\n\t\t_numberOfChannels: number,\n\t\t_length: number,\n\t\t_sampleRate: number\n\t): AudioBuffer {\n\t\treturn {} as AudioBuffer;\n\t}\n\n\tcreateChannelMerger(\n\t\t_numberOfInputs?: number | undefined\n\t): ChannelMergerNode {\n\t\treturn {} as ChannelMergerNode;\n\t}\n\n\tcreateChannelSplitter(\n\t\t_numberOfOutputs?: number | undefined\n\t): ChannelSplitterNode {\n\t\treturn {} as ChannelSplitterNode;\n\t}\n\n\tcreateConstantSource(): ConstantSourceNode {\n\t\treturn {} as ConstantSourceNode;\n\t}\n\n\tcreateConvolver(): ConvolverNode {\n\t\treturn {} as ConvolverNode;\n\t}\n\n\tcreateDelay(_maxDelayTime?: number | undefined): DelayNode {\n\t\treturn {} as DelayNode;\n\t}\n\n\tcreateDynamicsCompressor(): DynamicsCompressorNode {\n\t\treturn {} as DynamicsCompressorNode;\n\t}\n\n\tcreateGain(): GainNode {\n\t\treturn {} as GainNode;\n\t}\n\n\tcreateIIRFilter(\n\t\t_feedForward: number[] | Float32Array,\n\t\t_feedback: number[] | Float32Array\n\t): IIRFilterNode {\n\t\treturn {} as IIRFilterNode;\n\t}\n\n\tcreatePanner(): PannerNode {\n\t\treturn {} as PannerNode;\n\t}\n\n\tcreatePeriodicWave(\n\t\t_real: number[] | Float32Array,\n\t\t_imag: number[] | Float32Array,\n\t\t_constraints?: PeriodicWaveConstraints | undefined\n\t): PeriodicWave {\n\t\treturn {} as PeriodicWave;\n\t}\n\n\tcreateStereoPanner(): StereoPannerNode {\n\t\treturn {} as StereoPannerNode;\n\t}\n\n\tcreateWaveShaper(): WaveShaperNode {\n\t\treturn {} as WaveShaperNode;\n\t}\n\n\tcreateMediaStreamSource(_stream: MediaStream): MediaStreamAudioSourceNode {\n\t\treturn {} as MediaStreamAudioSourceNode;\n\t}\n\n\tcreateMediaElementSource(\n\t\t_element: HTMLMediaElement\n\t): MediaElementAudioSourceNode {\n\t\treturn {} as MediaElementAudioSourceNode;\n\t}\n\n\tcreateMediaStreamDestination(): MediaStreamAudioDestinationNode {\n\t\treturn {} as MediaStreamAudioDestinationNode;\n\t}\n\n\tdecodeAudioData(_audioData: ArrayBuffer): Promise {\n\t\treturn Promise.resolve({} as AudioBuffer);\n\t}\n\n\t//---------------------------\n\t// TONE AUDIO CONTEXT METHODS\n\t//---------------------------\n\n\tcreateAudioWorkletNode(\n\t\t_name: string,\n\t\t_options?: Partial\n\t): AudioWorkletNode {\n\t\treturn {} as AudioWorkletNode;\n\t}\n\n\tget rawContext(): AnyAudioContext {\n\t\treturn {} as AnyAudioContext;\n\t}\n\n\tasync addAudioWorkletModule(_url: string): Promise {\n\t\treturn Promise.resolve();\n\t}\n\n\tlookAhead = 0;\n\n\tlatencyHint = 0;\n\n\tresume(): Promise {\n\t\treturn Promise.resolve();\n\t}\n\n\tsetTimeout(_fn: (...args: any[]) => void, _timeout: Seconds): number {\n\t\treturn 0;\n\t}\n\n\tclearTimeout(_id: number): this {\n\t\treturn this;\n\t}\n\n\tsetInterval(_fn: (...args: any[]) => void, _interval: Seconds): number {\n\t\treturn 0;\n\t}\n\n\tclearInterval(_id: number): this {\n\t\treturn this;\n\t}\n\n\tgetConstant(_val: number): AudioBufferSourceNode {\n\t\treturn {} as AudioBufferSourceNode;\n\t}\n\n\tget currentTime(): Seconds {\n\t\treturn 0;\n\t}\n\n\tget state(): AudioContextState {\n\t\treturn {} as AudioContextState;\n\t}\n\n\tget sampleRate(): number {\n\t\treturn 0;\n\t}\n\n\tget listener(): Listener {\n\t\treturn {} as Listener;\n\t}\n\n\tget transport(): Transport {\n\t\treturn {} as Transport;\n\t}\n\n\tget draw(): Draw {\n\t\treturn {} as Draw;\n\t}\n\tset draw(_d) {}\n\n\tget destination(): Destination {\n\t\treturn {} as Destination;\n\t}\n\tset destination(_d: Destination) {}\n\n\tnow() {\n\t\treturn 0;\n\t}\n\n\timmediate() {\n\t\treturn 0;\n\t}\n\n\treadonly isOffline: boolean = false;\n}\n" }, { "path": "Tone/core/context/Gain.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests } from \"../../../test/helper/Basic.js\";\nimport { connectFrom, connectTo } from \"../../../test/helper/Connect.js\";\nimport { PassAudio } from \"../../../test/helper/PassAudio.js\";\nimport { Gain } from \"./Gain.js\";\n\ndescribe(\"Gain\", () => {\n\tBasicTests(Gain);\n\n\tit(\"can be created and disposed\", () => {\n\t\tconst gainNode = new Gain();\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"handles input and output connections\", () => {\n\t\tconst gainNode = new Gain();\n\t\tgainNode.connect(connectTo());\n\t\tconnectFrom().connect(gainNode);\n\t\tconnectFrom().connect(gainNode.gain);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can set the gain value\", () => {\n\t\tconst gainNode = new Gain();\n\t\texpect(gainNode.gain.value).to.be.closeTo(1, 0.001);\n\t\tgainNode.gain.value = 0.2;\n\t\texpect(gainNode.gain.value).to.be.closeTo(0.2, 0.001);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can be constructed with options object\", () => {\n\t\tconst gainNode = new Gain({\n\t\t\tgain: 0.4,\n\t\t});\n\t\texpect(gainNode.gain.value).to.be.closeTo(0.4, 0.001);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can be constructed with an initial value\", () => {\n\t\tconst gainNode = new Gain(3);\n\t\texpect(gainNode.gain.value).to.be.closeTo(3, 0.001);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can set the units\", () => {\n\t\tconst gainNode = new Gain(0, \"decibels\");\n\t\texpect(gainNode.gain.value).to.be.closeTo(0, 0.001);\n\t\texpect(gainNode.gain.units).to.equal(\"decibels\");\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can get the value using 'get'\", () => {\n\t\tconst gainNode = new Gain(5);\n\t\tconst value = gainNode.get();\n\t\texpect(value.gain).to.be.closeTo(5, 0.001);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"can set the value using 'set'\", () => {\n\t\tconst gainNode = new Gain(5);\n\t\tgainNode.set({\n\t\t\tgain: 4,\n\t\t});\n\t\texpect(gainNode.gain.value).to.be.closeTo(4, 0.001);\n\t\tgainNode.dispose();\n\t});\n\n\tit(\"passes audio through\", () => {\n\t\treturn PassAudio((input) => {\n\t\t\tconst gainNode = new Gain().toDestination();\n\t\t\tinput.connect(gainNode);\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/context/Gain.ts", "content": "import { Param } from \"../context/Param.js\";\nimport { UnitMap, UnitName } from \"../type/Units.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { readOnly } from \"../util/Interface.js\";\nimport { ToneAudioNode, ToneAudioNodeOptions } from \"./ToneAudioNode.js\";\n\ninterface GainOptions extends ToneAudioNodeOptions {\n\tgain: UnitMap[TypeName];\n\tunits: TypeName;\n\tconvert: boolean;\n\tminValue?: number;\n\tmaxValue?: number;\n}\n\n/**\n * A thin wrapper around the Native Web Audio GainNode.\n * The GainNode is a basic building block of the Web Audio\n * API and is useful for routing audio and adjusting gains.\n * @category Core\n * @example\n * return Tone.Offline(() => {\n * \tconst gainNode = new Tone.Gain(0).toDestination();\n * \tconst osc = new Tone.Oscillator(30).connect(gainNode).start();\n * \tgainNode.gain.rampTo(1, 0.1);\n * \tgainNode.gain.rampTo(0, 0.4, 0.2);\n * }, 0.7, 1);\n */\nexport class Gain<\n\tTypeName extends \"gain\" | \"decibels\" | \"normalRange\" = \"gain\",\n> extends ToneAudioNode> {\n\treadonly name: string = \"Gain\";\n\n\t/**\n\t * The gain parameter of the gain node.\n\t * @example\n\t * const gainNode = new Tone.Gain(0).toDestination();\n\t * const osc = new Tone.Oscillator().connect(gainNode).start();\n\t * gainNode.gain.rampTo(1, 0.1);\n\t * gainNode.gain.rampTo(0, 2, \"+0.5\");\n\t */\n\treadonly gain: Param;\n\n\t/**\n\t * The wrapped GainNode.\n\t */\n\tprivate _gainNode: GainNode = this.context.createGain();\n\n\t// input = output\n\treadonly input: GainNode = this._gainNode;\n\treadonly output: GainNode = this._gainNode;\n\n\t/**\n\t * @param gain The initial gain of the GainNode\n\t * @param units The units of the gain parameter.\n\t */\n\tconstructor(gain?: UnitMap[TypeName], units?: TypeName);\n\tconstructor(options?: Partial>);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Gain.getDefaults(), arguments, [\n\t\t\t\"gain\",\n\t\t\t\"units\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tthis.gain = new Param({\n\t\t\tcontext: this.context,\n\t\t\tconvert: options.convert,\n\t\t\tparam: this._gainNode.gain,\n\t\t\tunits: options.units,\n\t\t\tvalue: options.gain,\n\t\t\tminValue: options.minValue,\n\t\t\tmaxValue: options.maxValue,\n\t\t});\n\t\treadOnly(this, \"gain\");\n\t}\n\n\tstatic getDefaults(): GainOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tconvert: true,\n\t\t\tgain: 1,\n\t\t\tunits: \"gain\",\n\t\t});\n\t}\n\n\t/**\n\t * Clean up.\n\t */\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis._gainNode.disconnect();\n\t\tthis.gain.dispose();\n\t\treturn this;\n\t}\n}\n" }, { "path": "Tone/core/context/Listener.test.ts", "content": "import { expect } from \"chai\";\n\nimport { Offline } from \"../../../test/helper/Offline.js\";\nimport { getContext } from \"../Global.js\";\nimport { ListenerInstance } from \"./Listener.js\";\n\ndescribe(\"Listener\", () => {\n\tit(\"creates itself on the context\", () => {\n\t\texpect(getContext().listener).instanceOf(ListenerInstance);\n\t});\n\n\tit(\"can get and set values as an object\", () => {\n\t\t// can get and set some values\n\t\tOffline(({ listener }) => {\n\t\t\texpect(listener.get()).to.have.property(\"positionX\");\n\t\t\texpect(listener.get()).to.have.property(\"positionY\");\n\t\t\texpect(listener.get()).to.have.property(\"positionZ\");\n\t\t\texpect(listener.get()).to.have.property(\"forwardZ\");\n\t\t\texpect(listener.get()).to.have.property(\"upY\");\n\t\t});\n\t});\n});\n" }, { "path": "Tone/core/context/Listener.ts", "content": "import { onContextClose, onContextInit } from \"./ContextInitialization.js\";\nimport { Param } from \"./Param.js\";\nimport { ToneAudioNode, ToneAudioNodeOptions } from \"./ToneAudioNode.js\";\n\nexport interface ListenerOptions extends ToneAudioNodeOptions {\n\tpositionX: number;\n\tpositionY: number;\n\tpositionZ: number;\n\tforwardX: number;\n\tforwardY: number;\n\tforwardZ: number;\n\tupX: number;\n\tupY: number;\n\tupZ: number;\n}\n\n/**\n * Tone.Listener is a thin wrapper around the AudioListener. Listener combined\n * with {@link Panner3D} makes up the Web Audio API's 3D panning system. Panner3D allows you\n * to place sounds in 3D and Listener allows you to navigate the 3D sound environment from\n * a first-person perspective. There is only one listener per audio context.\n * @category Core\n */\nexport class ListenerInstance extends ToneAudioNode {\n\treadonly name: string = \"Listener\";\n\n\t/**\n\t * The listener has no inputs or outputs.\n\t */\n\toutput: undefined;\n\tinput: undefined;\n\n\treadonly positionX: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.positionX,\n\t});\n\n\treadonly positionY: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.positionY,\n\t});\n\n\treadonly positionZ: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.positionZ,\n\t});\n\n\treadonly forwardX: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.forwardX,\n\t});\n\n\treadonly forwardY: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.forwardY,\n\t});\n\n\treadonly forwardZ: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.forwardZ,\n\t});\n\n\treadonly upX: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.upX,\n\t});\n\n\treadonly upY: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.upY,\n\t});\n\n\treadonly upZ: Param = new Param({\n\t\tcontext: this.context,\n\t\tparam: this.context.rawContext.listener.upZ,\n\t});\n\n\tstatic getDefaults(): ListenerOptions {\n\t\treturn Object.assign(ToneAudioNode.getDefaults(), {\n\t\t\tpositionX: 0,\n\t\t\tpositionY: 0,\n\t\t\tpositionZ: 0,\n\t\t\tforwardX: 0,\n\t\t\tforwardY: 0,\n\t\t\tforwardZ: -1,\n\t\t\tupX: 0,\n\t\t\tupY: 1,\n\t\t\tupZ: 0,\n\t\t});\n\t}\n\n\tdispose(): this {\n\t\tsuper.dispose();\n\t\tthis.positionX.dispose();\n\t\tthis.positionY.dispose();\n\t\tthis.positionZ.dispose();\n\t\tthis.forwardX.dispose();\n\t\tthis.forwardY.dispose();\n\t\tthis.forwardZ.dispose();\n\t\tthis.upX.dispose();\n\t\tthis.upY.dispose();\n\t\tthis.upZ.dispose();\n\t\treturn this;\n\t}\n}\n\n//-------------------------------------\n// \tINITIALIZATION\n//-------------------------------------\n\nonContextInit((context) => {\n\tcontext.listener = new ListenerInstance({ context });\n});\n\nonContextClose((context) => {\n\tcontext.listener.dispose();\n});\n" }, { "path": "Tone/core/context/Offline.test.ts", "content": "import { expect } from \"chai\";\n\nimport { TestAudioBuffer } from \"../../../test/helper/compare/TestAudioBuffer.js\";\nimport { ToneOscillatorNode } from \"../../source/oscillator/ToneOscillatorNode.js\";\nimport { noOp } from \"../util/Interface.js\";\nimport { Offline } from \"./Offline.js\";\nimport { ToneAudioBuffer } from \"./ToneAudioBuffer.js\";\n\ndescribe(\"Offline\", () => {\n\tit(\"accepts a callback and a duration\", () => {\n\t\treturn Offline(noOp, 0.01);\n\t});\n\n\tit(\"returns a promise\", () => {\n\t\tconst ret = Offline(noOp, 0.01);\n\t\texpect(ret).to.have.property(\"then\");\n\t\treturn ret;\n\t});\n\n\tit(\"generates a buffer\", async () => {\n\t\tconst buffer = await Offline(noOp, 0.01);\n\t\texpect(buffer).to.be.instanceOf(ToneAudioBuffer);\n\t});\n\n\tit(\"silent by default\", async () => {\n\t\tconst buffer = await Offline(noOp, 0.01, 1);\n\t\tconst isSilent = buffer.toArray().every((sample) => sample === 0);\n\t\texpect(isSilent).to.equal(true);\n\t});\n\n\tit(\"records the master output\", async () => {\n\t\tconst buffer = await Offline(() => {\n\t\t\tnew ToneOscillatorNode().toDestination().start();\n\t\t}, 0.01);\n\t\tconst testBuff = new TestAudioBuffer(buffer.get() as AudioBuffer);\n\t\texpect(testBuff.isSilent()).is.equal(false);\n\t});\n\n\tit(\"returning a promise defers the rendering till the promise resolves\", async () => {\n\t\tlet wasInvoked = false;\n\t\tconst buffer = await Offline(() => {\n\t\t\tnew ToneOscillatorNode().toDestination().start();\n\t\t\treturn new Promise((done) => {\n\t\t\t\tsetTimeout(done, 100);\n\t\t\t}).then(() => {\n\t\t\t\twasInvoked = true;\n\t\t\t});\n\t\t}, 0.01);\n\t\tconst testBuff = new TestAudioBuffer(buffer.get() as AudioBuffer);\n\t\texpect(wasInvoked).is.equal(true);\n\t\texpect(testBuff.isSilent()).to.equal(false);\n\t});\n\n\tit(\"can schedule specific timing outputs\", async () => {\n\t\tconst buffer = await Offline(() => {\n\t\t\tnew ToneOscillatorNode().toDestination().start(0.05);\n\t\t}, 0.1);\n\t\tconst testBuff = new TestAudioBuffer(buffer.get() as AudioBuffer);\n\t\texpect(testBuff.getTimeOfFirstSound()).to.be.closeTo(0.05, 0.0001);\n\t});\n});\n" }, { "path": "Tone/core/context/Offline.ts", "content": "import \"./Destination.js\";\nimport \"./Listener.js\";\n\nimport { getContext, setContext } from \"../Global.js\";\nimport { Seconds } from \"../type/Units.js\";\nimport { OfflineContext } from \"./OfflineContext.js\";\nimport { ToneAudioBuffer } from \"./ToneAudioBuffer.js\";\n\n/**\n * Generate a buffer by rendering all of the Tone.js code within the callback using the OfflineAudioContext.\n * The OfflineAudioContext is capable of rendering much faster than real time in many cases.\n * The callback function also passes in an offline instance of {@link Context} which can be used\n * to schedule events along the Transport.\n * @param callback All Tone.js nodes which are created and scheduled within this callback are recorded into the output Buffer.\n * @param duration the amount of time to record for.\n * @return The promise which is invoked with the ToneAudioBuffer of the recorded output.\n * @example\n * // render 2 seconds of the oscillator\n * Tone.Offline(() => {\n * \t// only nodes created in this callback will be recorded\n * \tconst oscillator = new Tone.Oscillator().toDestination().start(0);\n * }, 2).then((buffer) => {\n * \t// do something with the output buffer\n * \tconsole.log(buffer);\n * });\n * @example\n * // can also schedule events along the Transport\n * // using the passed in Offline Transport\n * Tone.Offline(({ transport }) => {\n * \tconst osc = new Tone.Oscillator().toDestination();\n * \ttransport.schedule(time => {\n * \t\tosc.start(time).stop(time + 0.1);\n * \t}, 1);\n * \t// make sure to start the transport\n * \ttransport.start(0.2);\n * }, 4).then((buffer) => {\n * \t// do something with the output buffer\n * \tconsole.log(buffer);\n * });\n * @category Core\n */\nexport async function Offline(\n\tcallback: (context: OfflineContext) => Promise | void,\n\tduration: Seconds,\n\tchannels = 2,\n\tsampleRate: number = getContext().sampleRate\n): Promise {\n\t// set the OfflineAudioContext based on the current context\n\tconst originalContext = getContext();\n\n\tconst context = new OfflineContext(channels, duration, sampleRate);\n\tsetContext(context);\n\n\t// invoke the callback/scheduling\n\tawait callback(context);\n\n\t// then render the audio\n\tconst bufferPromise = context.render();\n\n\t// return the original AudioContext\n\tsetContext(originalContext);\n\n\t// await the rendering\n\tconst buffer = await bufferPromise;\n\n\t// return the audio\n\treturn new ToneAudioBuffer(buffer);\n}\n" }, { "path": "Tone/core/context/OfflineContext.test.ts", "content": "import { expect } from \"chai\";\n\nimport { OfflineContext } from \"./OfflineContext.js\";\n\ncontext(\"OfflineContext\", () => {\n\tit(\"can be created an disposed\", () => {\n\t\tconst ctx = new OfflineContext(1, 0.1, 44100);\n\t\tctx.dispose();\n\t});\n\n\tit(\"is setup with 0 lookAhead and offline clockSource\", () => {\n\t\tconst ctx = new OfflineContext(1, 0.1, 44100);\n\t\texpect(ctx.lookAhead).to.equal(0);\n\t\texpect(ctx.clockSource).to.equal(\"offline\");\n\t\treturn ctx.dispose();\n\t});\n\n\tit(\"now = currentTime\", () => {\n\t\tconst ctx = new OfflineContext(1, 0.1, 44100);\n\t\texpect(ctx.currentTime).to.equal(ctx.now());\n\t\treturn ctx.dispose();\n\t});\n\n\tit(\"closing shouldn't do anything\", () => {\n\t\tconst ctx = new OfflineContext(1, 0.1, 44100);\n\t\treturn ctx.close();\n\t});\n\n\tit(\"can render audio\", async () => {\n\t\tconst ctx = new OfflineContext(1, 0.2, 44100);\n\t\tconst osc = ctx.createOscillator();\n\t\tosc.connect(ctx.rawContext.destination);\n\t\tosc.start(0.1);\n\t\tconst buffer = await ctx.render();\n\t\texpect(buffer).to.have.property(\"length\");\n\t\texpect(buffer).to.have.property(\"sampleRate\");\n\t\tconst array = buffer.getChannelData(0);\n\t\tfor (let i = 0; i < array.length; i++) {\n\t\t\tif (array[i] !== 0) {\n\t\t\t\texpect(i / array.length).to.be.closeTo(0.5, 0.01);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t});\n\n\tit(\"can render audio not async\", async () => {\n\t\tconst ctx = new OfflineContext(1, 0.2, 44100);\n\t\tconst osc = ctx.createOscillator();\n\t\tosc.connect(ctx.rawContext.destination);\n\t\tosc.start(0.1);\n\t\tconst buffer = await ctx.render(false);\n\t\texpect(buffer).to.have.property(\"length\");\n\t\texpect(buffer).to.have.property(\"sampleRate\");\n\t\tconst array = buffer.getChannelData(0);\n\t\tfor (let i = 0; i < array.length; i++) {\n\t\t\tif (array[i] !== 0) {\n\t\t\t\texpect(i / array.length).to.be.closeTo(0.5, 0.01);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t});\n});\n" }, { "path": "Tone/core/context/OfflineContext.ts", "content": "import { createOfflineAudioContext } from \"../context/AudioContext.js\";\nimport { Context } from \"../context/Context.js\";\nimport { Seconds } from \"../type/Units.js\";\nimport { isOfflineAudioContext } from \"../util/AdvancedTypeCheck.js\";\nimport { ToneAudioBuffer } from \"./ToneAudioBuffer.js\";\n\n/**\n * Wrapper around the OfflineAudioContext\n * @category Core\n * @example\n * // generate a single channel, 0.5 second buffer\n * const context = new Tone.OfflineContext(1, 0.5, 44100);\n * const osc = new Tone.Oscillator({ context });\n * context.render().then(buffer => {\n * \tconsole.log(buffer.numberOfChannels, buffer.duration);\n * });\n */\nexport class OfflineContext extends Context {\n\treadonly name: string = \"OfflineContext\";\n\n\t/**\n\t * A private reference to the duration\n\t */\n\tprivate readonly _duration: Seconds;\n\n\t/**\n\t * An artificial clock source\n\t */\n\tprivate _currentTime: Seconds = 0;\n\n\t/**\n\t * Private reference to the OfflineAudioContext.\n\t */\n\tprotected _context!: OfflineAudioContext;\n\n\treadonly isOffline: boolean = true;\n\n\t/**\n\t * @param channels The number of channels to render\n\t * @param duration The duration to render in seconds\n\t * @param sampleRate the sample rate to render at\n\t */\n\tconstructor(channels: number, duration: Seconds, sampleRate: number);\n\tconstructor(context: OfflineAudioContext);\n\tconstructor() {\n\t\tsuper({\n\t\t\tclockSource: \"offline\",\n\t\t\tcontext: isOfflineAudioContext(arguments[0])\n\t\t\t\t? arguments[0]\n\t\t\t\t: createOfflineAudioContext(\n\t\t\t\t\t\targuments[0],\n\t\t\t\t\t\targuments[1] * arguments[2],\n\t\t\t\t\t\targuments[2]\n\t\t\t\t\t),\n\t\t\tlookAhead: 0,\n\t\t\tupdateInterval: isOfflineAudioContext(arguments[0])\n\t\t\t\t? 128 / arguments[0].sampleRate\n\t\t\t\t: 128 / arguments[2],\n\t\t});\n\n\t\tthis._duration = isOfflineAudioContext(arguments[0])\n\t\t\t? arguments[0].length / arguments[0].sampleRate\n\t\t\t: arguments[1];\n\t}\n\n\t/**\n\t * Override the now method to point to the internal clock time\n\t */\n\tnow(): Seconds {\n\t\treturn this._currentTime;\n\t}\n\n\t/**\n\t * Same as this.now()\n\t */\n\tget currentTime(): Seconds {\n\t\treturn this._currentTime;\n\t}\n\n\t/**\n\t * Render just the clock portion of the audio context.\n\t */\n\tprivate async _renderClock(asynchronous: boolean): Promise {\n\t\tlet index = 0;\n\t\twhile (this._duration - this._currentTime >= 0) {\n\t\t\t// invoke all the callbacks on that time\n\t\t\tthis.emit(\"tick\");\n\n\t\t\t// increment the clock in block-sized chunks\n\t\t\tthis._currentTime += 128 / this.sampleRate;\n\n\t\t\t// yield once a second of audio\n\t\t\tindex++;\n\t\t\tconst yieldEvery = Math.floor(this.sampleRate / 128);\n\t\t\tif (asynchronous && index % yieldEvery === 0) {\n\t\t\t\tawait new Promise((done) => setTimeout(done, 1));\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Render the output of the OfflineContext\n\t * @param asynchronous If the clock should be rendered asynchronously, which will not block the main thread, but be slightly slower.\n\t */\n\tasync render(asynchronous = true): Promise {\n\t\tawait this.workletsAreReady();\n\t\tawait this._renderClock(asynchronous);\n\t\tconst buffer = await this._context.startRendering();\n\t\treturn new ToneAudioBuffer(buffer);\n\t}\n\n\t/**\n\t * Close the context\n\t */\n\tclose(): Promise {\n\t\treturn Promise.resolve();\n\t}\n}\n" }, { "path": "Tone/core/context/OnRunning.test.ts", "content": "import { expect } from \"chai\";\n\nimport { Context } from \"./Context.js\";\nimport { OfflineContext } from \"./OfflineContext.js\";\nimport { onContextRunning } from \"./OnRunning.js\";\n\ncontext(\"onContextRunning\", () => {\n\tit(\"callback is invoked immediately when offline context is used\", () => {\n\t\tconst ctx = new OfflineContext(1, 0.1, 44100);\n\t\tlet wasInvoked = false;\n\n\t\tonContextRunning(ctx, () => {\n\t\t\twasInvoked = true;\n\t\t});\n\n\t\texpect(wasInvoked).to.be.true;\n\t\tctx.dispose();\n\t});\n\n\tit(\"callback is invoked immediately when context is already running\", async () => {\n\t\tconst ctx = new Context();\n\t\tawait ctx.resume();\n\t\tlet wasInvoked = false;\n\n\t\tonContextRunning(ctx, () => {\n\t\t\twasInvoked = true;\n\t\t});\n\n\t\texpect(wasInvoked).to.be.true;\n\t\tctx.dispose();\n\t});\n\n\tit(\"callback is invoked when the context starts running\", async () => {\n\t\tconst ctx = new Context();\n\t\tlet wasInvoked = false;\n\n\t\tonContextRunning(ctx, () => {\n\t\t\twasInvoked = true;\n\t\t});\n\n\t\texpect(wasInvoked).to.be.false;\n\n\t\tawait ctx.resume();\n\t\texpect(wasInvoked).to.be.true;\n\n\t\tctx.dispose();\n\t});\n\n\tit(\"can remove the callback with the returned function\", async () => {\n\t\tconst ctx = new Context();\n\t\tlet wasInvoked = false;\n\t\tconst remove = onContextRunning(ctx, () => {\n\t\t\twasInvoked = true;\n\t\t});\n\t\texpect(wasInvoked).to.be.false;\n\t\tremove();\n\n\t\tawait ctx.resume();\n\n\t\texpect(wasInvoked).to.be.false;\n\t\tctx.dispose();\n\t});\n});\n" }, { "path": "Tone/core/context/OnRunning.ts", "content": "import { BaseContext } from \"./BaseContext.js\";\n\n/**\n * Invoked when the context is started. The callback is invoked immediately\n * if the context is already started or when the context is an OfflineContext.\n * Returns a function which can be called to remove the listener.\n * @internal Used to trigger certain events when the context has been started.\n */\nexport function onContextRunning(\n\tcontext: BaseContext,\n\tcallback: () => void\n): () => void {\n\tconst listener = (state: AudioContextState) => {\n\t\tif (state === \"running\") {\n\t\t\tcallback();\n\t\t\tcontext.off(\"statechange\", listener);\n\t\t}\n\t};\n\tif (context.isOffline || context.state === \"running\") {\n\t\tcallback();\n\t\treturn () => {};\n\t}\n\n\tcontext.on(\"statechange\", listener);\n\treturn () => context.off(\"statechange\", listener);\n}\n" }, { "path": "Tone/core/context/Param.test.ts", "content": "import { expect } from \"chai\";\n\nimport { BasicTests, testAudioContext } from \"../../../test/helper/Basic.js\";\nimport { Plot } from \"../../../test/helper/compare/index.js\";\nimport { atTime, Offline } from \"../../../test/helper/Offline.js\";\nimport { Signal } from \"../../signal/Signal.js\";\nimport { getContext } from \"../Global.js\";\nimport { UnitName } from \"../type/Units.js\";\nimport { Gain } from \"./Gain.js\";\nimport { Param } from \"./Param.js\";\nimport { connect } from \"./ToneAudioNode.js\";\n\nconst audioContext = getContext();\n\ndescribe(\"Param\", () => {\n\tBasicTests(Param, {\n\t\tcontext: testAudioContext,\n\t\tparam: testAudioContext.createOscillator().frequency,\n\t});\n\n\tcontext(\"constructor\", () => {\n\t\tit(\"can be created and disposed\", async () => {\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst param = new Param<\"time\">({\n\t\t\t\t\tcontext,\n\t\t\t\t\tparam: context.createConstantSource().offset,\n\t\t\t\t\tunits: \"time\",\n\t\t\t\t});\n\t\t\t\texpect(param.getValueAtTime(0)).to.equal(1);\n\t\t\t\tparam.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"can pass in a value\", async () => {\n\t\t\tawait Offline((context) => {\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tcontext,\n\t\t\t\t\tparam: context.createConstantSource().offset,\n\t\t\t\t\tvalue: 1.1,\n\t\t\t\t});\n\t\t\t\texpect(param.getValueAtTime(0)).to.equal(1.1);\n\t\t\t\tparam.dispose();\n\t\t\t});\n\t\t});\n\n\t\tit(\"requires a param in the constructor\", () => {\n\t\t\texpect(() => {\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tvalue: 1.1,\n\t\t\t\t});\n\t\t\t}).throws(Error);\n\t\t});\n\t});\n\n\tcontext(\"Scheduling Curves\", () => {\n\t\tconst sampleRate = 11025;\n\t\tfunction matchesOutputCurve(param, outBuffer): void {\n\t\t\toutBuffer.toArray()[0].forEach((sample, index) => {\n\t\t\t\ttry {\n\t\t\t\t\texpect(\n\t\t\t\t\t\tparam.getValueAtTime(index / sampleRate)\n\t\t\t\t\t).to.be.closeTo(sample, 0.1);\n\t\t\t\t} catch (e) {\n\t\t\t\t\tthrow e;\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\tit(\"correctly handles setTargetAtTime followed by a ramp\", async () => {\n\t\t\tlet param;\n\t\t\t// this fails on FF\n\t\t\tconst testBuffer = await Offline(\n\t\t\t\t(context) => {\n\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\tsource.start(0);\n\t\t\t\t\tparam = new Param({\n\t\t\t\t\t\tcontext,\n\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t});\n\t\t\t\t\tparam.setTargetAtTime(2, 0.5, 0.1);\n\t\t\t\t\texpect(param.getValueAtTime(0.6)).to.be.closeTo(1.6, 0.1);\n\t\t\t\t\tparam.linearRampToValueAtTime(0.5, 0.7);\n\t\t\t\t\texpect(param.getValueAtTime(0.6)).to.be.closeTo(0.75, 0.1);\n\t\t\t\t},\n\t\t\t\t1.5,\n\t\t\t\t1,\n\t\t\t\tsampleRate\n\t\t\t);\n\t\t\tdocument.body.appendChild(await Plot.signal(testBuffer));\n\t\t\tmatchesOutputCurve(param, testBuffer);\n\t\t});\n\n\t\tit(\"schedules a value curve\", async () => {\n\t\t\tlet param;\n\t\t\tconst testBuffer = await Offline(\n\t\t\t\t(context) => {\n\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\tsource.start(0);\n\t\t\t\t\tparam = new Param({\n\t\t\t\t\t\tcontext,\n\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\tunits: \"number\",\n\t\t\t\t\t\tvalue: 0,\n\t\t\t\t\t});\n\t\t\t\t\tparam.setValueCurveAtTime(\n\t\t\t\t\t\t[0, 0.5, 0, 1, 1.5],\n\t\t\t\t\t\t0.1,\n\t\t\t\t\t\t0.8,\n\t\t\t\t\t\t0.5\n\t\t\t\t\t);\n\t\t\t\t\texpect(param.getValueAtTime(0.91)).to.be.closeTo(\n\t\t\t\t\t\t0.75,\n\t\t\t\t\t\t0.01\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\t1,\n\t\t\t\t1,\n\t\t\t\tsampleRate\n\t\t\t);\n\t\t\tmatchesOutputCurve(param, testBuffer);\n\t\t});\n\n\t\tit(\"a mixture of scheduling curves\", async () => {\n\t\t\tlet param;\n\t\t\tconst testBuffer = await Offline(\n\t\t\t\t(context) => {\n\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\tsource.start(0);\n\t\t\t\t\tparam = new Param({\n\t\t\t\t\t\tcontext,\n\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\tvalue: 0.1,\n\t\t\t\t\t});\n\t\t\t\t\tparam.setValueAtTime(0, 0);\n\t\t\t\t\tparam.setValueAtTime(1, 0.1);\n\t\t\t\t\tparam.linearRampToValueAtTime(3, 0.2);\n\t\t\t\t\tparam.exponentialRampToValueAtTime(0.01, 0.3);\n\t\t\t\t\tparam.setTargetAtTime(-1, 0.35, 0.2);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.6);\n\t\t\t\t\tparam.rampTo(1.1, 0.2, 0.7);\n\t\t\t\t\tparam.exponentialRampTo(0, 0.1, 0.85);\n\t\t\t\t\tparam.setValueAtTime(0, 1);\n\t\t\t\t\tparam.linearRampTo(1, 0.2, 1);\n\t\t\t\t\tparam.targetRampTo(0, 0.1, 1.1);\n\t\t\t\t\tparam.setValueAtTime(4, 1.2);\n\t\t\t\t\tparam.cancelScheduledValues(1.2);\n\t\t\t\t\tparam.linearRampToValueAtTime(1, 1.3);\n\t\t\t\t},\n\t\t\t\t1.5,\n\t\t\t\t1,\n\t\t\t\tsampleRate\n\t\t\t);\n\t\t\tmatchesOutputCurve(param, testBuffer);\n\t\t});\n\n\t\tit.skip(\"can cancel and hold\", async () => {\n\t\t\tlet param;\n\t\t\tconst testBuffer = await Offline(\n\t\t\t\t(context) => {\n\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\tsource.start(0);\n\t\t\t\t\tparam = new Param({\n\t\t\t\t\t\tcontext,\n\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\tvalue: 0.1,\n\t\t\t\t\t});\n\t\t\t\t\tparam.setValueAtTime(0, 0);\n\t\t\t\t\tparam.setValueAtTime(1, 0.2);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.1);\n\t\t\t\t\tparam.linearRampToValueAtTime(1, 0.3);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.2);\n\t\t\t\t\texpect(param.getValueAtTime(0.2)).to.be.closeTo(0.5, 0.001);\n\t\t\t\t\tparam.exponentialRampToValueAtTime(0, 0.4);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.25);\n\t\t\t\t\texpect(param.getValueAtTime(0.25)).to.be.closeTo(\n\t\t\t\t\t\t0.033,\n\t\t\t\t\t\t0.001\n\t\t\t\t\t);\n\t\t\t\t\tparam.setTargetAtTime(1, 0.3, 0.1);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.4);\n\t\t\t\t\texpect(param.getValueAtTime(0.4)).to.be.closeTo(\n\t\t\t\t\t\t0.644,\n\t\t\t\t\t\t0.001\n\t\t\t\t\t);\n\t\t\t\t\tparam.setValueAtTime(0, 0.45);\n\t\t\t\t\tparam.setValueAtTime(1, 0.48);\n\t\t\t\t\tparam.cancelAndHoldAtTime(0.45);\n\t\t\t\t\texpect(param.getValueAtTime(0.45)).to.be.closeTo(0, 0.001);\n\t\t\t\t},\n\t\t\t\t0.5,\n\t\t\t\t1,\n\t\t\t\tsampleRate\n\t\t\t);\n\t\t\tmatchesOutputCurve(param, testBuffer);\n\t\t});\n\t});\n\n\tcontext(\"Units\", () => {\n\t\tit(\"throws an error with invalid values\", () => {\n\t\t\tconst osc = audioContext.createOscillator();\n\t\t\tconst param = new Param<\"frequency\">({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: osc.frequency,\n\t\t\t\tunits: \"frequency\",\n\t\t\t});\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\texpect(param.setValueAtTime(\"bad\", \"bad\"));\n\t\t\t}).to.throw(Error);\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\texpect(param.linearRampToValueAtTime(\"bad\", \"bad\"));\n\t\t\t}).to.throw(Error);\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\texpect(param.exponentialRampToValueAtTime(\"bad\", \"bad\"));\n\t\t\t}).to.throw(Error);\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\texpect(param.setTargetAtTime(\"bad\", \"bad\", 0.1));\n\t\t\t}).to.throw(Error);\n\t\t\texpect(() => {\n\t\t\t\t// @ts-ignore\n\t\t\t\texpect(param.cancelScheduledValues(\"bad\"));\n\t\t\t}).to.throw(Error);\n\t\t\tparam.dispose();\n\t\t});\n\n\t\tit(\"can be created with specific units\", () => {\n\t\t\tconst gain = audioContext.createGain();\n\t\t\tconst param = new Param<\"bpm\">({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: gain.gain,\n\t\t\t\tunits: \"bpm\",\n\t\t\t});\n\t\t\texpect(param.units).to.equal(\"bpm\");\n\t\t\tparam.dispose();\n\t\t});\n\n\t\tit(\"can evaluate the given units\", () => {\n\t\t\tconst gain = audioContext.createGain();\n\t\t\tconst param = new Param<\"decibels\">({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: gain.gain,\n\t\t\t\tunits: \"decibels\",\n\t\t\t});\n\t\t\tparam.value = 0.5;\n\t\t\texpect(param.value).to.be.closeTo(0.5, 0.001);\n\t\t\tparam.dispose();\n\t\t});\n\n\t\tit(\"can be forced to not convert\", async () => {\n\t\t\tconst testBuffer = await Offline(\n\t\t\t\t(context) => {\n\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\tsource.start(0);\n\t\t\t\t\tconst param = new Param({\n\t\t\t\t\t\tcontext,\n\t\t\t\t\t\tconvert: false,\n\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\tunits: \"decibels\",\n\t\t\t\t\t});\n\t\t\t\t\tparam.value = -10;\n\t\t\t\t\texpect(param.value).to.be.closeTo(-10, 0.01);\n\t\t\t\t},\n\t\t\t\t0.001,\n\t\t\t\t1\n\t\t\t);\n\t\t\texpect(testBuffer.getValueAtTime(0)).to.be.closeTo(-10, 0.01);\n\t\t});\n\t});\n\n\tcontext(\"apply\", () => {\n\t\tit(\"can apply a scheduled curve\", async () => {\n\t\t\tlet sig;\n\t\t\tconst buffer = await Offline((context) => {\n\t\t\t\tconst signal = new Signal();\n\t\t\t\tsig = signal;\n\t\t\t\tsignal.setValueAtTime(0, 0);\n\t\t\t\tsignal.linearRampToValueAtTime(0.5, 0.1);\n\t\t\t\tsignal.exponentialRampToValueAtTime(0.2, 0.5);\n\t\t\t\tsignal.linearRampToValueAtTime(4, 2);\n\t\t\t\tsignal.cancelScheduledValues(1);\n\t\t\t\tsignal.setTargetAtTime(4, 1, 0.1);\n\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\tsource.start(0);\n\t\t\t\tconnect(source, context.destination);\n\t\t\t\treturn atTime(0.4, () => {\n\t\t\t\t\tsignal.apply(source.offset);\n\t\t\t\t});\n\t\t\t}, 2);\n\t\t\tfor (let time = 0.41; time < 2; time += 0.1) {\n\t\t\t\texpect(buffer.getValueAtTime(time)).to.be.closeTo(\n\t\t\t\t\tsig.getValueAtTime(time),\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\n\t\tit(\"can apply a scheduled curve that starts with a setTargetAtTime\", async () => {\n\t\t\tlet sig;\n\t\t\tconst buffer = await Offline((context) => {\n\t\t\t\tconst signal = new Signal();\n\t\t\t\tsig = signal;\n\t\t\t\tsignal.setTargetAtTime(2, 0, 0.2);\n\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\tsource.start(0);\n\t\t\t\tconnect(source, context.destination);\n\t\t\t\treturn atTime(0.4, () => {\n\t\t\t\t\tsignal.apply(source.offset);\n\t\t\t\t});\n\t\t\t}, 2);\n\t\t\tfor (let time = 0.41; time < 2; time += 0.1) {\n\t\t\t\texpect(buffer.getValueAtTime(time)).to.be.closeTo(\n\t\t\t\t\tsig.getValueAtTime(time),\n\t\t\t\t\t0.05\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\n\t\tit(\"can apply a scheduled curve that starts with a setTargetAtTime and then schedules other things\", async () => {\n\t\t\tlet sig;\n\t\t\tconst buffer = await Offline((context) => {\n\t\t\t\tconst signal = new Signal();\n\t\t\t\tsig = signal;\n\t\t\t\tsignal.setTargetAtTime(2, 0, 0.2);\n\t\t\t\tsignal.setValueAtTime(1, 0.8);\n\t\t\t\tsignal.linearRampToValueAtTime(0, 2);\n\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\tsource.start(0);\n\t\t\t\tconnect(source, context.destination);\n\t\t\t\treturn atTime(0.4, () => {\n\t\t\t\t\tsignal.apply(source.offset);\n\t\t\t\t});\n\t\t\t}, 2);\n\t\t\tfor (let time = 0.41; time < 2; time += 0.1) {\n\t\t\t\texpect(buffer.getValueAtTime(time)).to.be.closeTo(\n\t\t\t\t\tsig.getValueAtTime(time),\n\t\t\t\t\t0.05\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\n\t\tit(\"can set the param if the Param is marked as swappable\", async () => {\n\t\t\tconst buffer = await Offline((context) => {\n\t\t\t\tconst constSource = context.createConstantSource();\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tswappable: true,\n\t\t\t\t\tparam: constSource.offset,\n\t\t\t\t});\n\t\t\t\tparam.setValueAtTime(0.1, 0.1);\n\t\t\t\tparam.setValueAtTime(0.2, 0.2);\n\t\t\t\tparam.setValueAtTime(0.3, 0.3);\n\t\t\t\tconst constSource2 = context.createConstantSource();\n\t\t\t\tconstSource2.start(0);\n\t\t\t\tparam.setParam(constSource2.offset);\n\t\t\t\tconnect(constSource2, context.destination);\n\t\t\t}, 0.5);\n\t\t\texpect(buffer.getValueAtTime(0.1)).to.be.closeTo(0.1, 0.001);\n\t\t\texpect(buffer.getValueAtTime(0.2)).to.be.closeTo(0.2, 0.001);\n\t\t\texpect(buffer.getValueAtTime(0.3)).to.be.closeTo(0.3, 0.001);\n\t\t});\n\n\t\tit(\"throws an error if the param is not set to swappable\", () => {\n\t\t\treturn Offline((context) => {\n\t\t\t\tconst constSource = context.createConstantSource();\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tparam: constSource.offset,\n\t\t\t\t});\n\t\t\t\tconst constSource2 = context.createConstantSource();\n\t\t\t\texpect(() => {\n\t\t\t\t\tparam.setParam(constSource2.offset);\n\t\t\t\t}).to.throw(Error);\n\t\t\t}, 0.5);\n\t\t});\n\t});\n\n\tcontext(\"Unit Conversions\", () => {\n\t\tfunction testUnitConversion(\n\t\t\tunits: UnitName,\n\t\t\tinputValue: any,\n\t\t\tinputVerification: number,\n\t\t\toutputValue: number\n\t\t): void {\n\t\t\tit(`converts to ${units}`, async () => {\n\t\t\t\tconst testBuffer = await Offline(\n\t\t\t\t\t(context) => {\n\t\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\t\tsource.start(0);\n\t\t\t\t\t\tconst param = new Param({\n\t\t\t\t\t\t\tcontext,\n\t\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\t\tunits,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tparam.value = inputValue;\n\t\t\t\t\t\texpect(param.value).to.be.closeTo(\n\t\t\t\t\t\t\tinputVerification,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t\t0.001,\n\t\t\t\t\t1\n\t\t\t\t);\n\t\t\t\texpect(testBuffer.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\toutputValue,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t});\n\t\t}\n\n\t\ttestUnitConversion(\"number\", 3, 3, 3);\n\t\ttestUnitConversion(\"decibels\", -10, -10, 0.31);\n\t\ttestUnitConversion(\"decibels\", -20, -20, 0.1);\n\t\ttestUnitConversion(\"decibels\", -100, -100, 0);\n\t\ttestUnitConversion(\"gain\", 1.2, 1.2, 1.2);\n\t\ttestUnitConversion(\"positive\", 1.5, 1.5, 1.5);\n\t\ttestUnitConversion(\"positive\", 0, 0, 0);\n\t\ttestUnitConversion(\"time\", 2, 2, 2);\n\t\ttestUnitConversion(\"time\", 0, 0, 0);\n\t\ttestUnitConversion(\"frequency\", 20, 20, 20);\n\t\ttestUnitConversion(\"frequency\", 0.1, 0.1, 0.1);\n\t\ttestUnitConversion(\"normalRange\", 0, 0, 0);\n\t\ttestUnitConversion(\"normalRange\", 0.5, 0.5, 0.5);\n\t\ttestUnitConversion(\"audioRange\", -1, -1, -1);\n\t\ttestUnitConversion(\"audioRange\", 0.5, 0.5, 0.5);\n\t\ttestUnitConversion(\"audioRange\", 1, 1, 1);\n\t});\n\n\tcontext(\"min/maxValue\", () => {\n\t\tfunction testMinMaxValue(units: UnitName, min, max): void {\n\t\t\tit(`has proper min/max for ${units}`, () => {\n\t\t\t\tconst source = audioContext.createConstantSource();\n\t\t\t\tsource.connect(audioContext.rawContext.destination);\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tcontext: audioContext,\n\t\t\t\t\tparam: source.offset,\n\t\t\t\t\tunits,\n\t\t\t\t});\n\t\t\t\texpect(param.minValue).to.be.equal(min);\n\t\t\t\texpect(param.maxValue).to.be.equal(max);\n\t\t\t});\n\t\t}\n\t\t// number, decibels, normalRange, audioRange, gain\n\t\t// positive, time, frequency, transportTime, ticks, bpm, degrees, samples, hertz\n\t\tconst rangeMax = 3.4028234663852886e38;\n\t\ttestMinMaxValue(\"number\", -rangeMax, rangeMax);\n\t\ttestMinMaxValue(\"decibels\", -Infinity, rangeMax);\n\t\ttestMinMaxValue(\"normalRange\", 0, 1);\n\t\ttestMinMaxValue(\"audioRange\", -1, 1);\n\t\ttestMinMaxValue(\"gain\", -rangeMax, rangeMax);\n\t\ttestMinMaxValue(\"positive\", 0, rangeMax);\n\t\ttestMinMaxValue(\"time\", 0, rangeMax);\n\t\ttestMinMaxValue(\"frequency\", 0, rangeMax);\n\t\ttestMinMaxValue(\"transportTime\", 0, rangeMax);\n\t\ttestMinMaxValue(\"ticks\", 0, rangeMax);\n\t\ttestMinMaxValue(\"bpm\", 0, rangeMax);\n\t\ttestMinMaxValue(\"degrees\", -rangeMax, rangeMax);\n\t\ttestMinMaxValue(\"samples\", 0, rangeMax);\n\t\ttestMinMaxValue(\"hertz\", 0, rangeMax);\n\n\t\tit(\"can pass in a min and max value\", () => {\n\t\t\tconst source = audioContext.createConstantSource();\n\t\t\tsource.connect(audioContext.rawContext.destination);\n\t\t\tconst param = new Param({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: source.offset,\n\t\t\t\tminValue: 0.3,\n\t\t\t\tmaxValue: 0.5,\n\t\t\t});\n\t\t\texpect(param.minValue).to.be.equal(0.3);\n\t\t\texpect(param.maxValue).to.be.equal(0.5);\n\t\t});\n\t});\n\n\tcontext(\"defaultValue\", () => {\n\t\tit(\"has the right default value for default units\", () => {\n\t\t\tconst source = audioContext.createConstantSource();\n\t\t\tsource.connect(audioContext.rawContext.destination);\n\t\t\tconst param = new Param({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: source.offset,\n\t\t\t});\n\t\t\texpect(param.defaultValue).to.be.equal(1);\n\t\t});\n\n\t\tit(\"has the right default value for default decibels\", () => {\n\t\t\tconst source = audioContext.createConstantSource();\n\t\t\tsource.connect(audioContext.rawContext.destination);\n\t\t\tconst param = new Param({\n\t\t\t\tcontext: audioContext,\n\t\t\t\tparam: source.offset,\n\t\t\t\tunits: \"decibels\",\n\t\t\t});\n\t\t\texpect(param.defaultValue).to.be.equal(0);\n\t\t});\n\t});\n\n\t// const allSchedulingMethods = ['setValueAtTime', 'linearRampToValueAtTime', 'exponentialRampToValueAtTime']\n\n\tcontext(\"setValueAtTime\", () => {\n\t\tfunction testSetValueAtTime(\n\t\t\tunits: UnitName,\n\t\t\tvalue0: number,\n\t\t\tvalue1: number,\n\t\t\tvalue2: number\n\t\t): void {\n\t\t\tit(`can schedule value with units ${units}`, async () => {\n\t\t\t\tconst testBuffer = await Offline(\n\t\t\t\t\t(context) => {\n\t\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\t\tsource.start(0);\n\t\t\t\t\t\tconst param = new Param({\n\t\t\t\t\t\t\tcontext,\n\t\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\t\tunits,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tparam.setValueAtTime(value0, 0);\n\t\t\t\t\t\tparam.setValueAtTime(value1, 0.01);\n\t\t\t\t\t\tparam.setValueAtTime(value2, 0.02);\n\n\t\t\t\t\t\texpect(param.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\t\t\tvalue0,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(param.getValueAtTime(0.01)).to.be.closeTo(\n\t\t\t\t\t\t\tvalue1,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(param.getValueAtTime(0.02)).to.be.closeTo(\n\t\t\t\t\t\t\tvalue2,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t\t0.022,\n\t\t\t\t\t1\n\t\t\t\t);\n\t\t\t\texpect(testBuffer.getValueAtTime(0)).to.be.closeTo(0, 0.01);\n\t\t\t\texpect(testBuffer.getValueAtTime(0.011)).to.be.closeTo(1, 0.01);\n\t\t\t\texpect(testBuffer.getValueAtTime(0.021)).to.be.closeTo(\n\t\t\t\t\t0.5,\n\t\t\t\t\t0.01\n\t\t\t\t);\n\t\t\t});\n\t\t}\n\n\t\tconst allUnits: UnitName[] = [\n\t\t\t\"number\",\n\t\t\t\"decibels\",\n\t\t\t\"normalRange\",\n\t\t\t\"audioRange\",\n\t\t\t\"gain\",\n\t\t\t\"positive\",\n\t\t\t\"time\",\n\t\t\t\"frequency\",\n\t\t\t\"transportTime\",\n\t\t\t\"ticks\",\n\t\t\t\"bpm\",\n\t\t\t\"degrees\",\n\t\t\t\"samples\",\n\t\t\t\"hertz\",\n\t\t];\n\n\t\tallUnits.forEach((unit) => {\n\t\t\tif (unit === \"decibels\") {\n\t\t\t\ttestSetValueAtTime(unit, -100, 0, -6);\n\t\t\t} else {\n\t\t\t\ttestSetValueAtTime(unit, 0, 1, 0.5);\n\t\t\t}\n\t\t});\n\n\t\tit(\"asserts a value range\", async () => {\n\t\t\tlet errored = false;\n\t\t\ttry {\n\t\t\t\tconst source = new Gain();\n\t\t\t\tconst param = new Param({\n\t\t\t\t\tparam: source.gain,\n\t\t\t\t\tunits: \"normalRange\",\n\t\t\t\t});\n\t\t\t\tparam.setValueAtTime(2, 0);\n\t\t\t} catch (e) {\n\t\t\t\terrored = true;\n\t\t\t}\n\t\t});\n\t});\n\n\t[\"linearRampToValueAtTime\", \"exponentialRampToValueAtTime\"].forEach(\n\t\t(method) => {\n\t\t\tcontext(method, () => {\n\t\t\t\tfunction testRampToValueAtTime(\n\t\t\t\t\tunits: UnitName,\n\t\t\t\t\tvalue0: number,\n\t\t\t\t\tvalue1: number,\n\t\t\t\t\tvalue2: number\n\t\t\t\t): void {\n\t\t\t\t\tit(`can schedule value with units ${units}`, async () => {\n\t\t\t\t\t\tconst testBuffer = await Offline(\n\t\t\t\t\t\t\t(context) => {\n\t\t\t\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\t\t\t\tsource.start(0);\n\t\t\t\t\t\t\t\tconst param = new Param({\n\t\t\t\t\t\t\t\t\tcontext,\n\t\t\t\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\t\t\t\tunits,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tparam.setValueAtTime(value0, 0);\n\t\t\t\t\t\t\t\tparam[method](value1, 0.01);\n\t\t\t\t\t\t\t\tparam[method](value2, 0.02);\n\n\t\t\t\t\t\t\t\texpect(param.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\t\t\t\t\tvalue0,\n\t\t\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\texpect(\n\t\t\t\t\t\t\t\t\tparam.getValueAtTime(0.01)\n\t\t\t\t\t\t\t\t).to.be.closeTo(value1, 0.01);\n\t\t\t\t\t\t\t\texpect(\n\t\t\t\t\t\t\t\t\tparam.getValueAtTime(0.02)\n\t\t\t\t\t\t\t\t).to.be.closeTo(value2, 0.01);\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t0.022,\n\t\t\t\t\t\t\t1\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\t\t\t1,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0.01)).to.be.closeTo(\n\t\t\t\t\t\t\t0.7,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0.02)).to.be.closeTo(\n\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst allUnits: UnitName[] = [\n\t\t\t\t\t\"number\",\n\t\t\t\t\t\"decibels\",\n\t\t\t\t\t\"normalRange\",\n\t\t\t\t\t\"audioRange\",\n\t\t\t\t\t\"gain\",\n\t\t\t\t\t\"positive\",\n\t\t\t\t\t\"time\",\n\t\t\t\t\t\"frequency\",\n\t\t\t\t\t\"transportTime\",\n\t\t\t\t\t\"ticks\",\n\t\t\t\t\t\"bpm\",\n\t\t\t\t\t\"degrees\",\n\t\t\t\t\t\"samples\",\n\t\t\t\t\t\"hertz\",\n\t\t\t\t];\n\n\t\t\t\tallUnits.forEach((unit) => {\n\t\t\t\t\tif (unit === \"decibels\") {\n\t\t\t\t\t\ttestRampToValueAtTime(unit, 0, -3, -100);\n\t\t\t\t\t} else {\n\t\t\t\t\t\ttestRampToValueAtTime(unit, 1, 0.7, 0);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t});\n\t\t}\n\t);\n\n\t[\"linearRampTo\", \"exponentialRampTo\", \"rampTo\", \"targetRampTo\"].forEach(\n\t\t(method) => {\n\t\t\tcontext(method, () => {\n\t\t\t\tfunction testRampToValueAtTime(\n\t\t\t\t\tunits: UnitName,\n\t\t\t\t\tvalue0: number,\n\t\t\t\t\tvalue1: number,\n\t\t\t\t\tvalue2: number\n\t\t\t\t): void {\n\t\t\t\t\tit(`can schedule value with units ${units}`, async () => {\n\t\t\t\t\t\tconst testBuffer = await Offline(\n\t\t\t\t\t\t\t(context) => {\n\t\t\t\t\t\t\t\tconst source = context.createConstantSource();\n\t\t\t\t\t\t\t\tsource.connect(context.rawContext.destination);\n\t\t\t\t\t\t\t\tsource.start(0);\n\t\t\t\t\t\t\t\tconst param = new Param({\n\t\t\t\t\t\t\t\t\tcontext,\n\t\t\t\t\t\t\t\t\tparam: source.offset,\n\t\t\t\t\t\t\t\t\tunits,\n\t\t\t\t\t\t\t\t\tvalue: value0,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tparam[method](value1, 0.009, 0);\n\t\t\t\t\t\t\t\tparam[method](value2, 0.01, 0.01);\n\n\t\t\t\t\t\t\t\texpect(param.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\t\t\t\t\tvalue0,\n\t\t\t\t\t\t\t\t\t0.02\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\texpect(\n\t\t\t\t\t\t\t\t\tparam.getValueAtTime(0.01)\n\t\t\t\t\t\t\t\t).to.be.closeTo(value1, 0.02);\n\t\t\t\t\t\t\t\tif (units !== \"decibels\") {\n\t\t\t\t\t\t\t\t\texpect(\n\t\t\t\t\t\t\t\t\t\tparam.getValueAtTime(0.025)\n\t\t\t\t\t\t\t\t\t).to.be.closeTo(value2, 0.01);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t0.021,\n\t\t\t\t\t\t\t1\n\t\t\t\t\t\t);\n\t\t\t\t\t\t// document.body.appendChild(await Plot.signal(testBuffer));\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0)).to.be.closeTo(\n\t\t\t\t\t\t\t1,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0.01)).to.be.closeTo(\n\t\t\t\t\t\t\t0.7,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t\texpect(testBuffer.getValueAtTime(0.02)).to.be.closeTo(\n\t\t\t\t\t\t\t0,\n\t\t\t\t\t\t\t0.01\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst allUnits: UnitName[] = [\n\t\t\t\t\t\"number\",\n\t\t\t\t\t\"decibels\",\n\t\t\t\t\t\"normalRange\",\n\t\t\t\t\t\"audioRange\",\n\t\t\t\t\t\"gain\",\n\t\t\t\t\t\"positive\",\n\t\t\t\t\t\"time\",\n\t\t\t\t\t\"frequency\",\n\t\t\t\t\t\"transportTime\",\n\t\t\t\t\t\"ticks\",\n\t\t\t\t\t\"bpm\",\n\t\t\t\t\t\"degrees\",\n\t\t\t\t\t\"samples\",\n\t\t\t\t\t\"hertz\",\n\t\t\t\t];\n\n\t\t\t\tallUnits.forEach((unit) => {\n\t\t\t\t\tif (unit === \"decibels\") {\n\t\t\t\t\t\ttestRampToValueAtTime(unit, 0, -3, -100);\n\t\t\t\t\t} else {\n\t\t\t\t\t\ttestRampToValueAtTime(unit, 1, 0.7, 0);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t});\n\t\t}\n\t);\n});\n" }, { "path": "Tone/core/context/Param.ts", "content": "import { AbstractParam } from \"../context/AbstractParam.js\";\nimport { dbToGain, gainToDb } from \"../type/Conversions.js\";\nimport {\n\tDecibels,\n\tFrequency,\n\tPositive,\n\tTime,\n\tUnitMap,\n\tUnitName,\n} from \"../type/Units.js\";\nimport { isAudioParam } from \"../util/AdvancedTypeCheck.js\";\nimport { assert, assertRange } from \"../util/Debug.js\";\nimport { optionsFromArguments } from \"../util/Defaults.js\";\nimport { EQ } from \"../util/Math.js\";\nimport { Timeline } from \"../util/Timeline.js\";\nimport { isDefined } from \"../util/TypeCheck.js\";\nimport { ToneWithContext, ToneWithContextOptions } from \"./ToneWithContext.js\";\n\nexport interface ParamOptions\n\textends ToneWithContextOptions {\n\tunits: TypeName;\n\tvalue?: UnitMap[TypeName];\n\tparam: AudioParam | Param;\n\tconvert: boolean;\n\tminValue?: number;\n\tmaxValue?: number;\n\tswappable?: boolean;\n}\n\n/**\n * the possible automation types\n */\ntype AutomationType =\n\t| \"linearRampToValueAtTime\"\n\t| \"exponentialRampToValueAtTime\"\n\t| \"setValueAtTime\"\n\t| \"setTargetAtTime\"\n\t| \"cancelScheduledValues\";\n\ninterface TargetAutomationEvent {\n\ttype: \"setTargetAtTime\";\n\ttime: number;\n\tvalue: number;\n\tconstant: number;\n}\n\ninterface NormalAutomationEvent {\n\ttype: Exclude;\n\ttime: number;\n\tvalue: number;\n}\n/**\n * The events on the automation\n */\nexport type AutomationEvent = NormalAutomationEvent | TargetAutomationEvent;\n\n/**\n * Param wraps the native Web Audio's AudioParam to provide\n * additional unit conversion functionality. It also\n * serves as a base-class for classes which have a single,\n * automatable parameter.\n * @category Core\n */\nexport class Param\n\textends ToneWithContext>\n\timplements AbstractParam\n{\n\treadonly name: string = \"Param\";\n\n\treadonly input: GainNode | AudioParam;\n\n\treadonly units: UnitName;\n\tconvert: boolean;\n\toverridden = false;\n\n\t/**\n\t * The timeline which tracks all of the automations.\n\t */\n\tprotected _events: Timeline;\n\n\t/**\n\t * The native parameter to control\n\t */\n\tprotected _param: AudioParam;\n\n\t/**\n\t * The default value before anything is assigned\n\t */\n\tprotected _initialValue: number;\n\n\t/**\n\t * The minimum output value\n\t */\n\tprivate _minOutput = 1e-7;\n\n\t/**\n\t * Private reference to the min and max values if passed into the constructor\n\t */\n\tprivate readonly _minValue?: number;\n\tprivate readonly _maxValue?: number;\n\n\t/**\n\t * If the underlying AudioParam can be swapped out\n\t * using the setParam method.\n\t */\n\tprotected readonly _swappable: boolean;\n\n\t/**\n\t * @param param The AudioParam to wrap\n\t * @param units The unit name\n\t * @param convert Whether or not to convert the value to the target units\n\t */\n\tconstructor(param: AudioParam, units?: TypeName, convert?: boolean);\n\tconstructor(options: Partial>);\n\tconstructor() {\n\t\tconst options = optionsFromArguments(Param.getDefaults(), arguments, [\n\t\t\t\"param\",\n\t\t\t\"units\",\n\t\t\t\"convert\",\n\t\t]);\n\t\tsuper(options);\n\n\t\tassert(\n\t\t\tisDefined(options.param) &&\n\t\t\t\t(isAudioParam(options.param) || options.param instanceof Param),\n\t\t\t\"param must be an AudioParam\"\n\t\t);\n\n\t\twhile (!isAudioParam(options.param)) {\n\t\t\toptions.param = options.param._param;\n\t\t}\n\n\t\tthis._swappable = isDefined(options.swappable)\n\t\t\t? options.swappable\n\t\t\t: false;\n\t\tif (this._swappable) {\n\t\t\tthis.input = this.context.createGain();\n\t\t\t// initialize\n\t\t\tthis._param = options.param;\n\t\t\tthis.input.connect(this._param);\n\t\t} else {\n\t\t\tthis._param = this.input = options.param;\n\t\t}\n\t\tthis._events = new Timeline(1000);\n\t\tthis._initialValue = this._param.defaultValue;\n\t\tthis.units = options.units;\n\t\tthis.convert = options.convert;\n\t\tthis._minValue = options.minValue;\n\t\tthis._maxValue = options.maxValue;\n\n\t\t// if the value is defined, set it immediately\n\t\tif (\n\t\t\tisDefined(options.value) &&\n\t\t\toptions.value !== this._toType(this._initialValue)\n\t\t) {\n\t\t\tthis.setValueAtTime(options.value, 0);\n\t\t}\n\t}\n\n\tstatic getDefaults(): ParamOptions {\n\t\treturn Object.assign(ToneWithContext.getDefaults(), {\n\t\t\tconvert: true,\n\t\t\tunits: \"number\" as UnitName,\n\t\t} as ParamOptions);\n\t}\n\n\tget value(): UnitMap[TypeName] {\n\t\tconst now = this.now();\n\t\treturn this.getValueAtTime(now);\n\t}\n\tset value(value) {\n\t\tthis.cancelScheduledValues(this.now());\n\t\tthis.setValueAtTime(value, this.now());\n\t}\n\n\tget minValue(): number {\n\t\t// if it's not the default minValue, return it\n\t\tif (isDefined(this._minValue)) {\n\t\t\treturn this._minValue;\n\t\t} else if (\n\t\t\tthis.units === \"time\" ||\n\t\t\tthis.units === \"frequency\" ||\n\t\t\tthis.units === \"normalRange\" ||\n\t\t\tthis.units === \"positive\" ||\n\t\t\tthis.units === \"transportTime\" ||\n\t\t\tthis.units === \"ticks\" ||\n\t\t\tthis.units === \"bpm\" ||\n\t\t\tthis.units === \"hertz\" ||\n\t\t\tthis.units === \"samples\"\n\t\t) {\n\t\t\treturn 0;\n\t\t} else if (this.units === \"audioRange\") {\n\t\t\treturn -1;\n\t\t} else if (this.units === \"decibels\") {\n\t\t\treturn -Infinity;\n\t\t} else {\n\t\t\treturn this._param.minValue;\n\t\t}\n\t}\n\n\tget maxValue(): number {\n\t\tif (isDefined(this._maxValue)) {\n\t\t\treturn this._maxValue;\n\t\t} else if (\n\t\t\tthis.units === \"normalRange\" ||\n\t\t\tthis.units === \"audioRange\"\n\t\t) {\n\t\t\treturn 1;\n\t\t} else {\n\t\t\treturn this._param.maxValue;\n\t\t}\n\t}\n\n\t/**\n\t * Type guard based on the unit name\n\t */\n\tprivate _is(arg: any, type: UnitName): arg is T {\n\t\treturn this.units === type;\n\t}\n\n\t/**\n\t * Make sure the value is always in the defined range\n\t */\n\tprivate _assertRange(value: number): number {\n\t\tif (isDefined(this.maxValue) && isDefined(this.minValue)) {\n\t\t\tassertRange(\n\t\t\t\tvalue,\n\t\t\t\tthis._fromType(this.minValue),\n\t\t\t\tthis._fromType(this.maxValue)\n\t\t\t);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Convert the given value from the type specified by Param.units\n\t * into the destination value (such as Gain or Frequency).\n\t */\n\tprotected _fromType(val: UnitMap[TypeName]): number {\n\t\tif (this.convert && !this.overridden) {\n\t\t\tif (this._is