@xromdev/apu 0.4.2 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -5
- package/dist/chip.d.ts +11 -2
- package/dist/chip.js +14 -1
- package/dist/chip.js.map +1 -1
- package/dist/expansion.d.ts +71 -6
- package/dist/expansion.js +198 -6
- package/dist/expansion.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/notes.d.ts +17 -1
- package/dist/notes.js +70 -5
- package/dist/notes.js.map +1 -1
- package/dist/render.d.ts +3 -2
- package/dist/render.js +14 -2
- package/dist/render.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,11 +15,13 @@ they come out. **Try it live in the browser:
|
|
|
15
15
|
[xrom.dev/utils/apu](https://xrom.dev/utils/apu).**
|
|
16
16
|
|
|
17
17
|
- All five channels: two pulses, the triangle, noise and the DMC (samples).
|
|
18
|
-
-
|
|
19
|
-
voice (FDS, `$4040`–`$408A`)
|
|
20
|
-
through its ports at `$F800`/`$4800`)
|
|
21
|
-
|
|
22
|
-
|
|
18
|
+
- Three Famicom expansion chips, when a game has them: the Disk System's
|
|
19
|
+
wavetable voice (FDS, `$4040`–`$408A`), Namco's 163 (up to eight wavetable
|
|
20
|
+
channels, through its ports at `$F800`/`$4800`) and Konami's VRC6 (two pulses
|
|
21
|
+
with eight duties and a sawtooth, `$9000`–`$B002`). `renderWrites` turns them
|
|
22
|
+
on when the writes talk to them; `renderNotes` plays notes on them, the
|
|
23
|
+
wavetables from `waves` (`EXPANSION_CHANNELS`: FDS is channel 5, the N163's
|
|
24
|
+
6–13, the VRC6's 14–16).
|
|
23
25
|
- No dependencies, ~6 KB gzipped, runs anywhere JavaScript does (browser, worker, Node).
|
|
24
26
|
- Pure and deterministic: the same writes always give the same samples, so it
|
|
25
27
|
can be tested by measuring rather than by ear.
|
package/dist/chip.d.ts
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
* same ones, evaluated at a different moment, so the output is bit for bit what
|
|
30
30
|
* recomputing them every sample gives.
|
|
31
31
|
*/
|
|
32
|
-
import { FdsChip, N163Chip, type FdsSnapshot, type N163Snapshot } from './expansion.js';
|
|
32
|
+
import { FdsChip, N163Chip, Vrc6Chip, type FdsSnapshot, type N163Snapshot, type Vrc6Snapshot } from './expansion.js';
|
|
33
33
|
/** Where every channel's output levels go, sample by sample. */
|
|
34
34
|
export interface ChannelBuffers {
|
|
35
35
|
pulse1: Uint8Array;
|
|
@@ -45,6 +45,11 @@ export interface ChannelBuffers {
|
|
|
45
45
|
* units; index 8, if given, takes every slot without a buffer of its own.
|
|
46
46
|
*/
|
|
47
47
|
n163?: (Float64Array | undefined)[];
|
|
48
|
+
/**
|
|
49
|
+
* The VRC6's channels — pulse 1, pulse 2, saw — in `mixApu` units; index 3, if given, takes every
|
|
50
|
+
* channel without a buffer of its own.
|
|
51
|
+
*/
|
|
52
|
+
vrc6?: (Float64Array | undefined)[];
|
|
48
53
|
}
|
|
49
54
|
/** Cartridge memory for the DMC: the bytes of `$8000`–`$FFFF`, or a reader for any address. */
|
|
50
55
|
export type ApuMemory = Uint8Array | ((address: number) => number);
|
|
@@ -81,6 +86,7 @@ export interface ApuSnapshot {
|
|
|
81
86
|
/** The expansion chips' state, when the chip has them (`ApuChipOptions.expansion`). */
|
|
82
87
|
fds?: FdsSnapshot;
|
|
83
88
|
n163?: N163Snapshot;
|
|
89
|
+
vrc6?: Vrc6Snapshot;
|
|
84
90
|
dmc: {
|
|
85
91
|
/** Output level, 0..127. */
|
|
86
92
|
level: number;
|
|
@@ -104,7 +110,8 @@ export interface ApuChipOptions {
|
|
|
104
110
|
memory?: ApuMemory;
|
|
105
111
|
/**
|
|
106
112
|
* Expansion sound on the cartridge: `'FDS'` takes `$4040`–`$408A`, `'N163'` its address port
|
|
107
|
-
* (`$F800`), data port (`$4800`) and `$E000
|
|
113
|
+
* (`$F800`), data port (`$4800`) and `$E000`, `'VRC6'` `$9000`–`$9003`, `$A000`–`$A002` and
|
|
114
|
+
* `$B000`–`$B002`. Their output goes to `ChannelBuffers.fds`/`n163`/`vrc6`.
|
|
108
115
|
*/
|
|
109
116
|
expansion?: readonly string[];
|
|
110
117
|
}
|
|
@@ -114,6 +121,8 @@ export declare class Apu {
|
|
|
114
121
|
readonly fds: FdsChip | null;
|
|
115
122
|
/** Namco's 163, when `expansion` has `'N163'`. */
|
|
116
123
|
readonly n163: N163Chip | null;
|
|
124
|
+
/** Konami's VRC6, when `expansion` has `'VRC6'`. */
|
|
125
|
+
readonly vrc6: Vrc6Chip | null;
|
|
117
126
|
private readonly lengthCounter;
|
|
118
127
|
private readonly pulses;
|
|
119
128
|
private readonly triangle;
|
package/dist/chip.js
CHANGED
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
import { CPU_HZ, DMC_PERIODS, DUTY_SEQUENCES, LENGTH_TABLE, NOISE_PERIODS, QUARTER_FRAME_HZ, TRIANGLE_STEPS, } from './constants.js';
|
|
33
33
|
import { LONG_CYCLE, LONG_HIGH_BEFORE, LONG_INDEX, LONG_STATES } from './lfsr.js';
|
|
34
34
|
import { decodeSweep, sweepMutes, sweepTarget } from './sweep.js';
|
|
35
|
-
import { FdsChip, N163Chip } from './expansion.js';
|
|
35
|
+
import { FdsChip, N163Chip, Vrc6Chip, } from './expansion.js';
|
|
36
36
|
/** The four duty sequences flattened, `duty * 8 + step`. */
|
|
37
37
|
const DUTY_FLAT = Uint8Array.from(DUTY_SEQUENCES.flat());
|
|
38
38
|
const TRIANGLE_FLAT = Uint8Array.from(TRIANGLE_STEPS);
|
|
@@ -136,6 +136,7 @@ export class Apu {
|
|
|
136
136
|
this.lengthCounter = options.lengthCounter !== false;
|
|
137
137
|
this.fds = options.expansion?.includes('FDS') ? new FdsChip(sampleRate) : null;
|
|
138
138
|
this.n163 = options.expansion?.includes('N163') ? new N163Chip(sampleRate) : null;
|
|
139
|
+
this.vrc6 = options.expansion?.includes('VRC6') ? new Vrc6Chip(sampleRate) : null;
|
|
139
140
|
this.samplesPerQuarterFrame = sampleRate / QUARTER_FRAME_HZ;
|
|
140
141
|
this.frameCountdown = this.samplesPerQuarterFrame;
|
|
141
142
|
for (const p of this.pulses)
|
|
@@ -159,6 +160,8 @@ export class Apu {
|
|
|
159
160
|
if (address > 0x4017) {
|
|
160
161
|
if (this.fds?.write(address, value))
|
|
161
162
|
return;
|
|
163
|
+
if (this.vrc6?.write(address, value))
|
|
164
|
+
return;
|
|
162
165
|
this.n163?.write(address, value);
|
|
163
166
|
return;
|
|
164
167
|
}
|
|
@@ -338,6 +341,15 @@ export class Apu {
|
|
|
338
341
|
}
|
|
339
342
|
this.n163.render(count, buffers.n163, offset);
|
|
340
343
|
}
|
|
344
|
+
if (this.vrc6 && buffers.vrc6) {
|
|
345
|
+
const cleared = new Set();
|
|
346
|
+
for (const out of buffers.vrc6)
|
|
347
|
+
if (out && !cleared.has(out)) {
|
|
348
|
+
out.fill(0, offset, offset + count);
|
|
349
|
+
cleared.add(out);
|
|
350
|
+
}
|
|
351
|
+
this.vrc6.render(count, buffers.vrc6, offset);
|
|
352
|
+
}
|
|
341
353
|
let done = 0;
|
|
342
354
|
while (done < count) {
|
|
343
355
|
// Samples before the one on which the counter reaches zero. Subtracting
|
|
@@ -583,6 +595,7 @@ export class Apu {
|
|
|
583
595
|
},
|
|
584
596
|
...(this.fds ? { fds: this.fds.snapshot() } : {}),
|
|
585
597
|
...(this.n163 ? { n163: this.n163.snapshot() } : {}),
|
|
598
|
+
...(this.vrc6 ? { vrc6: this.vrc6.snapshot() } : {}),
|
|
586
599
|
dmc: {
|
|
587
600
|
level: this.dmc.level,
|
|
588
601
|
rateIndex: this.dmc.rateIndex,
|
package/dist/chip.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chip.js","sourceRoot":"","sources":["../src/chip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAuC,MAAM,gBAAgB,CAAC;AAExF,4DAA4D;AAC5D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;AACzD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAkLtD,MAAM,WAAW,GAAG,GAAa,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AAE7E,MAAM,QAAQ,GAAG,CAAC,MAAe,EAAS,EAAE,CAAC,CAAC;IAC5C,MAAM;IACN,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,WAAW,EAAE;IAClB,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC;AAEH,iEAAiE;AACjE,SAAS,aAAa,CAAC,GAAa,EAAE,MAAc,EAAE,IAAa;IACjE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QAClB,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;SAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC;QACrB,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;YAAE,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;aAC7B,IAAI,IAAI;YAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG;IAiEd,YAAY,UAAkB,EAAE,UAA0B,EAAE;QAzD3C,WAAM,GAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,aAAQ,GAAa;YACpC,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,KAAK;YACvB,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,KAAK;YACd,yEAAyE;YACzE,qEAAqE;YACrE,2EAA2E;YAC3E,yEAAyE;YACzE,SAAS;YACT,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,CAAC;SACR,CAAC;QACe,UAAK,GAAU;YAC9B,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,CAAC;YACT,GAAG,EAAE,WAAW,EAAE;YAClB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,EAAE,oCAAoC;YAC7C,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;YACxB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;SACR,CAAC;QAEe,QAAG,GAAQ;YAC1B,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,CAAC;YACZ,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC,CAAC;YACV,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;SACR,CAAC;QAGF,wEAAwE;QAChE,aAAQ,GAAG,KAAK,CAAC;QACjB,cAAS,GAAG,CAAC,CAAC;QAIL,QAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QA+JvC,uDAAuD;QACtC,QAAG,GAAmB;YACrC,MAAM,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YACzB,MAAM,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YACzB,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YAC3B,KAAK,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC;YAC1B,GAAG,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;SACvB,CAAC;QAnKA,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC;QACrD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,IAAI,CAAC,sBAAsB,GAAG,UAAU,GAAG,gBAAgB,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,IAAI;YACP,OAAO,MAAM,KAAK,UAAU;gBAC1B,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;gBACrC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;oBAC3B,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;oBACzD,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAe,EAAE,KAAa;QAClC,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;gBAAE,OAAO;YAC5C,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;QACvB,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;gBACrB,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,sEAAsE;gBACtE,qEAAqE;gBACrE,qEAAqE;gBACrE,iEAAiE;gBACjE,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,CAAC,OAAO;oBAAE,CAAC,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/C,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;gBACnB,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;gBACZ,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,KAAK,MAAM;gBACT,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC;gBACtC,OAAO;YACT,KAAK,MAAM;gBACT,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO;YACT,KAAK,MAAM;gBACT,uEAAuE;gBACvE,mEAAmE;gBACnE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACtE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO;oBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBACtC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO;YACT,KAAK,MAAM;gBACT,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;gBAC7B,OAAO;YACT,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;gBACrB,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnC,uEAAuE;gBACvE,mEAAmE;gBACnE,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS;oBAAE,CAAC,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACjE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS;oBAAE,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAChE,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC,CAAC,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,KAAK,MAAM;gBACT,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO;oBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;gBAC5B,OAAO;YACT,KAAK,MAAM;gBACT,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC;gBAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,OAAO;YACT,KAAK,MAAM;gBACT,oEAAoE;gBACpE,2CAA2C;gBAC3C,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;gBAC1B,OAAO;YACT,KAAK,MAAM;gBACT,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;gBACxC,OAAO;YACT,KAAK,MAAM;gBACT,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAClC,OAAO;YACT,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,oEAAoE;gBACpE,0EAA0E;gBAC1E,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7E,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;oBAC9B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACvC,IAAI,CAAC,OAAO,CAAC,OAAO;wBAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC;gBACH,qEAAqE;gBACrE,mEAAmE;gBACnE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;gBACnB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;oBAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;qBACjC,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;oBAC3B,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;oBAC3B,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC;oBAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,KAAK,MAAM;gBACT,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;gBACnB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC;gBAClD,6DAA6D;gBAC7D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACzB,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,CAAC;gBACD,OAAO;YACT;gBACE,OAAO;QACX,CAAC;IACH,CAAC;IAWD;;;;;OAKG;IACH,MAAM;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAa,EAAE,OAAuB,EAAE,MAAM,GAAG,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI;gBAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,GAAG,KAAK,EAAE,CAAC;YACpB,wEAAwE;YACxE,sEAAsE;YACtE,8DAA8D;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;gBACzB,OAAO,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;oBAChC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,sBAAsB,CAAC;oBACnD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;gBACrC,IAAI,IAAI,CAAC,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;gBACvC,IAAI,IAAI,GAAG,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,qFAAqF;IAC7E,IAAI,CAAC,KAAa,EAAE,OAAuB,EAAE,EAAU;QAC7D,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YACtC,iEAAiE;YACjE,oEAAoE;YACpE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YACpB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC9B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9B,KAAK,IAAI,IAAI,CAAC;oBACd,IAAI,KAAK,IAAI,CAAC;wBAAE,KAAK,IAAI,CAAC,CAAC;oBAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;gBAClD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBACxB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9B,KAAK,IAAI,IAAI,CAAC;oBACd,IAAI,KAAK,IAAI,CAAC;wBAAE,KAAK,IAAI,CAAC,CAAC;oBAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;gBACvD,CAAC;YACH,CAAC;YACD,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,yEAAyE;QACzE,2EAA2E;QAC3E,2EAA2E;QAC3E,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9B,KAAK,IAAI,IAAI,CAAC;gBACd,IAAI,KAAK,IAAI,EAAE;oBAAE,KAAK,IAAI,EAAE,CAAC;gBAC7B,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,4EAA4E;QAC5E,yEAAyE;QACzE,sDAAsD;QACtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;QACvE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC;YACxB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,uEAAuE;gBACvE,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9B,KAAK,IAAI,IAAI,CAAC;oBACd,kEAAkE;oBAClE,sEAAsE;oBACtE,iEAAiE;oBACjE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACjC,KAAK,IAAI,MAAM,CAAC;oBAChB,KAAK,IAAI,MAAM,CAAC;oBAChB,IAAI,KAAK,IAAI,UAAU;wBAAE,KAAK,IAAI,UAAU,CAAC;gBAC/C,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9B,KAAK,IAAI,IAAI,CAAC;oBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACjC,KAAK,IAAI,MAAM,CAAC;oBAChB,IAAI,IAAY,CAAC;oBACjB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;wBACf,IAAI,GAAG,CAAC,gBAAgB,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC;wBAC7E,KAAK,IAAI,MAAM,CAAC;wBAChB,IAAI,KAAK,IAAI,UAAU;4BAAE,KAAK,IAAI,UAAU,CAAC;oBAC/C,CAAC;yBAAM,CAAC;wBACN,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChD,CAAC;oBACD,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9B,KAAK,IAAI,IAAI,CAAC;gBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjC,KAAK,IAAI,MAAM,CAAC;gBAChB,IAAI,IAAI,GAAG,CAAC,CAAC;gBACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAChC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;wBAAE,IAAI,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChD,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBACxC,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;YAC5C,CAAC;YACD,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAEhB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACK,OAAO,CAAC,GAAe,EAAE,EAAU,EAAE,GAAW;QACtD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,0EAA0E;YAC1E,0EAA0E;YAC1E,wEAAwE;YACxE,8CAA8C;YAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;YACzB,qEAAqE;YACrE,kCAAkC;YAClC,CAAC,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC;gBAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC;YAClB,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACpB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;gBACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IAED,8FAA8F;IACtF,QAAQ;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG;oBAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QACD,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QACd,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACjB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YACX,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;gBACnB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,qGAAqG;IAC7F,QAAQ;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC;YAAE,OAAO;QAC/C,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QAC1D,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC;YAC3B,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IAC7E,CAAC;IAED,gFAAgF;IAChF,QAAQ;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;gBAC1C,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;YACH,QAAQ,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACvC,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;gBAC1C,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,GAAG,EAAE;gBACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC7B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;gBAC7B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO;gBACzB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC;aAChC;SACF,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,CAAQ;QAC1B,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QACzD,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IAC7E,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IACrF,CAAC;IAEO,iBAAiB;QACvB,sEAAsE;QACtE,mEAAmE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,IAAI,CAAC,CAAC,gBAAgB;YAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC;aAC7C,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,CAAC,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAC7C,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;oBAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;YACxE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YAClF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACxE,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,iEAAiE;YACjE,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC7E,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC1C,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;gBACvC,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * The 2A03's sound half, register by register.\n *\n * `Apu` holds what the chip holds — timers, sequencer positions, length and\n * linear counters, envelopes, sweep units, the frame counter — and changes it\n * only the ways the chip does: through a write to `$4000`–`$4017`, or through\n * its own clocks. Nothing here knows what a note is. That is the point: every\n * NES game's music, whatever its driver, reaches the speaker as writes to\n * these registers, so a synth that takes writes plays any of them.\n *\n * It runs at a fixed sample rate rather than per CPU cycle: `render()` advances\n * the chip a run of samples and reports each channel's output level — 0..15 for\n * the pulses, triangle and noise, 0..127 for the DMC — at every one of them. The\n * mixer and the analogue stage are separate (`mixer.ts`), because a caller that\n * wants to hear one channel alone has to get at the levels before they are mixed.\n *\n * The DMC reads its samples from the cartridge, `$8000`–`$FFFF`; give it that\n * memory as `options.memory` (without it, it reads zeros — a sample that only\n * ever steps down).\n *\n * Not modelled: the DMC's and the frame counter's IRQs, the CPU stall of the\n * DMC's memory reads, and the handful of cycle-exact write/clock races. Periods\n * and levels are the hardware's; timing is exact to the sample.\n *\n * **Speed.** `levels()` runs once per sample — 88 200 times a second of music at\n * the default oversampling — so anything that only changes when a register is\n * written (a channel's step per sample, whether the sweep unit mutes it) is\n * worked out at the write and kept, not recomputed here. The expressions are the\n * same ones, evaluated at a different moment, so the output is bit for bit what\n * recomputing them every sample gives.\n */\n\nimport {\n CPU_HZ,\n DMC_PERIODS,\n DUTY_SEQUENCES,\n LENGTH_TABLE,\n NOISE_PERIODS,\n QUARTER_FRAME_HZ,\n TRIANGLE_STEPS,\n} from './constants.js';\nimport { LONG_CYCLE, LONG_HIGH_BEFORE, LONG_INDEX, LONG_STATES } from './lfsr.js';\nimport { decodeSweep, sweepMutes, sweepTarget, type SweepConfig } from './sweep.js';\nimport { FdsChip, N163Chip, type FdsSnapshot, type N163Snapshot } from './expansion.js';\n\n/** The four duty sequences flattened, `duty * 8 + step`. */\nconst DUTY_FLAT = Uint8Array.from(DUTY_SEQUENCES.flat());\nconst TRIANGLE_FLAT = Uint8Array.from(TRIANGLE_STEPS);\n\ninterface Envelope {\n start: boolean;\n divider: number;\n decay: number;\n}\n\ninterface Pulse {\n pulse1: boolean;\n duty: number;\n /** Bit 5 of `$4000`: halts the length counter AND loops the envelope — one bit, two jobs. */\n halt: boolean;\n constant: boolean;\n /** Bits 0..3 of `$4000`: the level when `constant`, the envelope's divider period when not. */\n volume: number;\n env: Envelope;\n sweep: SweepConfig;\n sweepDivider: number;\n sweepReload: boolean;\n /** The 11-bit timer period. */\n period: number;\n length: number;\n enabled: boolean;\n /** Position in the 8-step duty sequence, fractional. */\n phase: number;\n /** Steps of the sequence per sample, from `period` — kept, see \"Speed\". */\n step: number;\n /** Whether the sweep unit mutes the channel at this period — kept, see \"Speed\". */\n muted: boolean;\n}\n\ninterface Triangle {\n /** Bit 7 of `$4008`: halts the length counter and keeps reloading the linear counter. */\n control: boolean;\n linearReload: number;\n linearReloadFlag: boolean;\n linear: number;\n period: number;\n length: number;\n enabled: boolean;\n phase: number;\n step: number;\n}\n\ninterface Noise {\n halt: boolean;\n constant: boolean;\n volume: number;\n env: Envelope;\n /** Bit 7 of `$400E`: feedback from bit 6 instead of bit 1 — the short, metallic 93-step loop. */\n shortMode: boolean;\n periodIndex: number;\n length: number;\n enabled: boolean;\n /**\n * The register. In normal mode it is held as a position in the precomputed\n * cycle (`lfsrIndex`) and `lfsr` is stale; in short mode `lfsr` is the state.\n * A mode switch converts one into the other.\n */\n lfsr: number;\n lfsrIndex: number;\n /** Fractional timer position: how many register shifts are owed. */\n phase: number;\n step: number;\n}\n\n/**\n * What the chip is doing right now, channel by channel — for showing it, not\n * for driving it. Every field is a number the hardware itself holds.\n */\n/**\n * The delta modulation channel: 1-bit samples read from cartridge memory, each\n * bit stepping a 7-bit output up or down by 2.\n */\ninterface Dmc {\n loop: boolean;\n rateIndex: number;\n /** Output level, 0..127. `$4011` sets it directly. */\n level: number;\n /** `$4012`/`$4013` as addresses and byte counts. */\n startAddress: number;\n startLength: number;\n /** The memory reader: where it reads next, and how many bytes are left. */\n address: number;\n remaining: number;\n /** The one-byte sample buffer, or -1 when empty. */\n buffer: number;\n /** The output unit: its shift register, bits left in it, and whether it is silent. */\n shift: number;\n bits: number;\n silence: boolean;\n phase: number;\n step: number;\n}\n\n/** Where every channel's output levels go, sample by sample. */\nexport interface ChannelBuffers {\n pulse1: Uint8Array;\n pulse2: Uint8Array;\n triangle: Uint8Array;\n /** Fractional: the gate is averaged over the shifts in a sample. */\n noise: Float64Array;\n dmc: Uint8Array;\n /** The FDS wave channel, in `mixApu` units (added to, not overwritten) — when the chip has one. */\n fds?: Float64Array;\n /**\n * The N163's channels by register slot 0..7 (slot 7, `$78`, is the one always on), in `mixApu`\n * units; index 8, if given, takes every slot without a buffer of its own.\n */\n n163?: (Float64Array | undefined)[];\n}\n\n/** Cartridge memory for the DMC: the bytes of `$8000`–`$FFFF`, or a reader for any address. */\nexport type ApuMemory = Uint8Array | ((address: number) => number);\n\nexport interface ApuSnapshot {\n pulse: {\n period: number;\n duty: number;\n /** Length counter, in half-frames; 0 is silent. */\n length: number;\n /** Level the channel outputs when high: the written volume, or the envelope's decay. */\n level: number;\n constant: boolean;\n /** The sweep unit is muting the channel (period < 8, or target past $7FF). */\n muted: boolean;\n enabled: boolean;\n }[];\n triangle: {\n period: number;\n length: number;\n /** Linear counter, in quarter-frames; 0 is silent. */\n linear: number;\n /** The step the staircase is on — held while silent. */\n step: number;\n enabled: boolean;\n };\n noise: {\n periodIndex: number;\n shortMode: boolean;\n length: number;\n level: number;\n constant: boolean;\n enabled: boolean;\n };\n /** The expansion chips' state, when the chip has them (`ApuChipOptions.expansion`). */\n fds?: FdsSnapshot;\n n163?: N163Snapshot;\n dmc: {\n /** Output level, 0..127. */\n level: number;\n rateIndex: number;\n loop: boolean;\n /** Bytes of the sample still to read; above 0 means it is playing. */\n remaining: number;\n /** Where the memory reader is. */\n address: number;\n enabled: boolean;\n };\n}\n\nexport interface ApuChipOptions {\n /**\n * Honour the length counters. Default true — it is hardware, and without it\n * a drum hit written with a short counter runs on as a wash. Off exists to\n * hear the difference.\n */\n lengthCounter?: boolean;\n /** Where the DMC reads its samples from — see `ApuMemory`. Reads 0 when absent. */\n memory?: ApuMemory;\n /**\n * Expansion sound on the cartridge: `'FDS'` takes `$4040`–`$408A`, `'N163'` its address port\n * (`$F800`), data port (`$4800`) and `$E000`. Their output goes to `ChannelBuffers.fds`/`n163`.\n */\n expansion?: readonly string[];\n}\n\nconst newEnvelope = (): Envelope => ({ start: false, divider: 0, decay: 0 });\n\nconst newPulse = (pulse1: boolean): Pulse => ({\n pulse1,\n duty: 0,\n halt: false,\n constant: false,\n volume: 0,\n env: newEnvelope(),\n sweep: decodeSweep(0, pulse1),\n sweepDivider: 0,\n sweepReload: false,\n period: 0,\n length: 0,\n enabled: false,\n phase: 0,\n step: 0,\n muted: true,\n});\n\n/** One quarter-frame of an envelope, in the hardware's order. */\nfunction clockEnvelope(env: Envelope, period: number, loop: boolean) {\n if (env.start) {\n env.start = false;\n env.decay = 15;\n env.divider = period;\n } else if (env.divider === 0) {\n env.divider = period;\n if (env.decay > 0) env.decay -= 1;\n else if (loop) env.decay = 15;\n } else {\n env.divider -= 1;\n }\n}\n\nexport class Apu {\n readonly sampleRate: number;\n /** The Disk System's wave channel, when `expansion` has `'FDS'`. */\n readonly fds: FdsChip | null;\n /** Namco's 163, when `expansion` has `'N163'`. */\n readonly n163: N163Chip | null;\n private readonly lengthCounter: boolean;\n\n private readonly pulses: [Pulse, Pulse] = [newPulse(true), newPulse(false)];\n private readonly triangle: Triangle = {\n control: false,\n linearReload: 0,\n linearReloadFlag: false,\n linear: 0,\n period: 0,\n length: 0,\n enabled: false,\n // Start on a zero step, so a chip that has not been written to is silent\n // rather than holding the top of the staircase as DC. The triangle's\n // position only moves while it sounds, so this is where it rests until the\n // first note — the part of power-on a listener would otherwise hear as a\n // thump.\n phase: 16,\n step: 0,\n };\n private readonly noise: Noise = {\n halt: false,\n constant: false,\n volume: 0,\n env: newEnvelope(),\n shortMode: false,\n periodIndex: 0,\n length: 0,\n enabled: false,\n lfsr: 1, // the chip powers up with bit 0 set\n lfsrIndex: LONG_INDEX[1],\n phase: 0,\n step: 0,\n };\n\n private readonly dmc: Dmc = {\n loop: false,\n rateIndex: 0,\n level: 0,\n startAddress: 0xc000,\n startLength: 1,\n address: 0xc000,\n remaining: 0,\n buffer: -1,\n shift: 0,\n bits: 8,\n silence: true,\n phase: 0,\n step: 0,\n };\n private readonly read: (address: number) => number;\n\n /** Frame counter: 5-step mode, which step is next, samples until it. */\n private fiveStep = false;\n private frameStep = 0;\n private frameCountdown: number;\n private readonly samplesPerQuarterFrame: number;\n\n private readonly out = [0, 0, 0, 0, 0];\n\n constructor(sampleRate: number, options: ApuChipOptions = {}) {\n this.sampleRate = sampleRate;\n this.lengthCounter = options.lengthCounter !== false;\n this.fds = options.expansion?.includes('FDS') ? new FdsChip(sampleRate) : null;\n this.n163 = options.expansion?.includes('N163') ? new N163Chip(sampleRate) : null;\n this.samplesPerQuarterFrame = sampleRate / QUARTER_FRAME_HZ;\n this.frameCountdown = this.samplesPerQuarterFrame;\n for (const p of this.pulses) this.retunePulse(p);\n this.retuneTriangle();\n this.retuneNoise();\n this.retuneDmc();\n const memory = options.memory;\n this.read =\n typeof memory === 'function'\n ? (address) => memory(address) & 0xff\n : memory && memory.length > 0\n ? (address) => memory[(address - 0x8000) % memory.length]\n : () => 0;\n }\n\n /**\n * A CPU write to one of the APU's registers — or an expansion chip's, when there is one.\n * Anything else is ignored.\n */\n write(address: number, value: number) {\n if (address > 0x4017) {\n if (this.fds?.write(address, value)) return;\n this.n163?.write(address, value);\n return;\n }\n const v = value & 0xff;\n switch (address) {\n case 0x4000:\n case 0x4004: {\n const p = this.pulses[address === 0x4000 ? 0 : 1];\n p.duty = v >> 6;\n p.halt = (v & 0x20) !== 0;\n p.constant = (v & 0x10) !== 0;\n p.volume = v & 0x0f;\n return;\n }\n case 0x4001:\n case 0x4005: {\n const p = this.pulses[address === 0x4001 ? 0 : 1];\n p.sweep = decodeSweep(v, p.pulse1);\n p.sweepReload = true;\n p.muted = sweepMutes(p.period, p.sweep);\n return;\n }\n case 0x4002:\n case 0x4006: {\n const p = this.pulses[address === 0x4002 ? 0 : 1];\n p.period = (p.period & 0x700) | v;\n this.retunePulse(p);\n return;\n }\n case 0x4003:\n case 0x4007: {\n // The high byte does three things at once, and all three are audible:\n // it reloads the length counter, restarts the envelope, and puts the\n // duty sequencer back to its first step — which is why a driver that\n // rewrites it every frame for a vibrato makes the vibrato click.\n const p = this.pulses[address === 0x4003 ? 0 : 1];\n p.period = (p.period & 0xff) | ((v & 7) << 8);\n if (p.enabled) p.length = LENGTH_TABLE[v >> 3];\n p.env.start = true;\n p.phase = 0;\n this.retunePulse(p);\n return;\n }\n case 0x4008:\n this.triangle.control = (v & 0x80) !== 0;\n this.triangle.linearReload = v & 0x7f;\n return;\n case 0x400a:\n this.triangle.period = (this.triangle.period & 0x700) | v;\n this.retuneTriangle();\n return;\n case 0x400b:\n // No phase reset here: the triangle's sequencer is never restarted, so\n // a new note picks up the staircase wherever the last one left it.\n this.triangle.period = (this.triangle.period & 0xff) | ((v & 7) << 8);\n if (this.triangle.enabled) this.triangle.length = LENGTH_TABLE[v >> 3];\n this.triangle.linearReloadFlag = true;\n this.retuneTriangle();\n return;\n case 0x400c:\n this.noise.halt = (v & 0x20) !== 0;\n this.noise.constant = (v & 0x10) !== 0;\n this.noise.volume = v & 0x0f;\n return;\n case 0x400e: {\n const n = this.noise;\n const shortMode = (v & 0x80) !== 0;\n // Hand the register between its two representations: a position in the\n // precomputed cycle for normal mode, the raw state for short mode.\n if (shortMode && !n.shortMode) n.lfsr = LONG_STATES[n.lfsrIndex];\n if (!shortMode && n.shortMode) n.lfsrIndex = LONG_INDEX[n.lfsr];\n n.shortMode = shortMode;\n n.periodIndex = v & 0x0f;\n this.retuneNoise();\n return;\n }\n case 0x400f:\n if (this.noise.enabled) this.noise.length = LENGTH_TABLE[v >> 3];\n this.noise.env.start = true;\n return;\n case 0x4010:\n this.dmc.loop = (v & 0x40) !== 0;\n this.dmc.rateIndex = v & 0x0f;\n this.retuneDmc();\n return;\n case 0x4011:\n // Straight to the output — the way games play PCM without the DMC's\n // own memory reader, one write per sample.\n this.dmc.level = v & 0x7f;\n return;\n case 0x4012:\n this.dmc.startAddress = 0xc000 + v * 64;\n return;\n case 0x4013:\n this.dmc.startLength = v * 16 + 1;\n return;\n case 0x4015: {\n // Clearing a channel's bit empties its length counter at once — the\n // one way to silence a channel on the spot rather than at the next clock.\n const channels = [this.pulses[0], this.pulses[1], this.triangle, this.noise];\n channels.forEach((channel, i) => {\n channel.enabled = (v & (1 << i)) !== 0;\n if (!channel.enabled) channel.length = 0;\n });\n // Bit 4 is the DMC's: clear stops the sample (what is already in the\n // buffer still plays out); set starts it again if it had finished.\n const d = this.dmc;\n if ((v & 0x10) === 0) d.remaining = 0;\n else if (d.remaining === 0) {\n d.address = d.startAddress;\n d.remaining = d.startLength;\n this.fetchDmc();\n }\n return;\n }\n case 0x4017:\n this.fiveStep = (v & 0x80) !== 0;\n this.frameStep = 0;\n this.frameCountdown = this.samplesPerQuarterFrame;\n // Selecting 5-step mode clocks everything once, immediately.\n if (this.fiveStep) {\n this.clockQuarterFrame();\n this.clockHalfFrame();\n }\n return;\n default:\n return;\n }\n }\n\n /** Scratch buffers for `levels()`, one sample long. */\n private readonly one: ChannelBuffers = {\n pulse1: new Uint8Array(1),\n pulse2: new Uint8Array(1),\n triangle: new Uint8Array(1),\n noise: new Float64Array(1),\n dmc: new Uint8Array(1),\n };\n\n /**\n * Advance one sample and return the five channel levels, `[pulse1, pulse2,\n * triangle, noise, dmc]` (see `render`). The array is reused between calls.\n * For more than a sample at a time, `render` is several times faster and\n * gives the same numbers.\n */\n levels(): readonly number[] {\n const one = this.one;\n this.render(1, one);\n const out = this.out;\n out[0] = one.pulse1[0];\n out[1] = one.pulse2[0];\n out[2] = one.triangle[0];\n out[3] = one.noise[0];\n out[4] = one.dmc[0];\n return out;\n }\n\n /**\n * Advance `count` samples, writing each channel's level into its buffer from\n * `offset` on: the pulses, triangle and DMC as whole numbers (0..15, 0..127),\n * the noise fractional (its gate is averaged over the shifts in a sample). No\n * register writes happen inside — a caller with writes due splits the run at\n * them.\n *\n * The frame counter is the only thing that changes a channel's parameters\n * between writes, so the run is cut at its clocks and each piece is filled a\n * channel at a time (`fill`). Every sum is the one `levels()` would do, in the\n * same order — the buffers come out bit for bit the same as `count` calls.\n */\n render(count: number, buffers: ChannelBuffers, offset = 0) {\n if (this.fds && buffers.fds) {\n buffers.fds.fill(0, offset, offset + count);\n this.fds.render(count, buffers.fds, offset);\n }\n if (this.n163 && buffers.n163) {\n const cleared = new Set<Float64Array>();\n for (const out of buffers.n163) if (out && !cleared.has(out)) {\n out.fill(0, offset, offset + count);\n cleared.add(out);\n }\n this.n163.render(count, buffers.n163, offset);\n }\n let done = 0;\n while (done < count) {\n // Samples before the one on which the counter reaches zero. Subtracting\n // them in one go is exact: the counter holds a value whose fractional\n // bits are all representable after taking off a whole number.\n const free = Math.ceil(this.frameCountdown) - 1;\n if (free <= 0) {\n this.frameCountdown -= 1;\n while (this.frameCountdown <= 0) {\n this.frameCountdown += this.samplesPerQuarterFrame;\n this.clockFrameCounter();\n }\n this.fill(1, buffers, offset + done);\n done += 1;\n } else {\n const run = Math.min(free, count - done);\n this.frameCountdown -= run;\n this.fill(run, buffers, offset + done);\n done += run;\n }\n }\n }\n\n /** `count` samples with every channel's parameters fixed — tight loops on locals. */\n private fill(count: number, buffers: ChannelBuffers, at: number) {\n const end = at + count;\n const { pulse1, pulse2, triangle, noise } = buffers;\n\n for (let i = 0; i < 2; i++) {\n const p = this.pulses[i];\n const out = i === 0 ? pulse1 : pulse2;\n // A pulse steps through 8 entries per cycle and each entry takes\n // 2 × (period + 1) CPU cycles: CPU / (16 × (period + 1)) per cycle.\n const step = p.step;\n let phase = p.phase;\n if (p.length === 0 || p.muted) {\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 8) phase %= 8;\n out[k] = 0;\n }\n } else {\n const level = p.constant ? p.volume : p.env.decay;\n const base = p.duty * 8;\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 8) phase %= 8;\n out[k] = DUTY_FLAT[base + ((phase | 0) & 7)] * level;\n }\n }\n p.phase = phase;\n }\n\n const t = this.triangle;\n // The staircase only moves while both counters are non-zero. When either\n // runs out the sequencer STOPS where it is and the output holds that step:\n // the triangle is never \"at zero\" between notes, it is wherever it paused.\n if (t.length > 0 && t.linear > 0) {\n const step = t.step;\n let phase = t.phase;\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 32) phase %= 32;\n triangle[k] = TRIANGLE_FLAT[(phase | 0) & 31];\n }\n t.phase = phase;\n } else {\n triangle.fill(TRIANGLE_FLAT[(t.phase | 0) & 31], at, end);\n }\n\n // AVERAGE the register's output across the shifts each sample is worth,\n // rather than sampling wherever it lands. At the short periods the LFSR\n // runs well past the sample rate, and keeping only the last shift folds the\n // rest back as alias tones — drums like a broken speaker. The channel is\n // silenced while bit 0 is set: the register gates it.\n const n = this.noise;\n const level = n.length === 0 ? 0 : n.constant ? n.volume : n.env.decay;\n const step = n.step;\n let phase = n.phase;\n if (!n.shortMode) {\n let index = n.lfsrIndex;\n if (level === 0) {\n // Silent, but the register keeps shifting: advance it, output nothing.\n for (let k = at; k < end; k++) {\n phase += step;\n // A few shifts per sample at most, so one conditional subtraction\n // wraps the index — no division. (Math.floor, not `| 0`: the phase is\n // a double, and a round trip through int32 measured 20% slower.)\n const shifts = Math.floor(phase);\n phase -= shifts;\n index += shifts;\n if (index >= LONG_CYCLE) index -= LONG_CYCLE;\n }\n noise.fill(0, at, end);\n } else {\n for (let k = at; k < end; k++) {\n phase += step;\n const shifts = Math.floor(phase);\n phase -= shifts;\n let gate: number;\n if (shifts > 0) {\n gate = (LONG_HIGH_BEFORE[index + shifts] - LONG_HIGH_BEFORE[index]) / shifts;\n index += shifts;\n if (index >= LONG_CYCLE) index -= LONG_CYCLE;\n } else {\n gate = (LONG_STATES[index] & 1) === 0 ? 1 : 0;\n }\n noise[k] = gate * level;\n }\n }\n n.lfsrIndex = index;\n } else {\n let lfsr = n.lfsr;\n for (let k = at; k < end; k++) {\n phase += step;\n const shifts = Math.floor(phase);\n phase -= shifts;\n let high = 0;\n for (let s = 0; s < shifts; s++) {\n if ((lfsr & 1) === 0) high++;\n const feedback = (lfsr & 1) ^ ((lfsr >> 6) & 1);\n lfsr = (lfsr >> 1) | (feedback << 14);\n }\n const gate = shifts > 0 ? high / shifts : (lfsr & 1) === 0 ? 1 : 0;\n noise[k] = level === 0 ? 0 : gate * level;\n }\n n.lfsr = lfsr;\n }\n n.phase = phase;\n\n this.fillDmc(buffers.dmc, at, end);\n }\n\n /**\n * The DMC over `[at, end)`. At most a bit or two per sample even at its\n * fastest rate, so it is clocked bit by bit; a channel with nothing to play\n * only has its output-cycle count moved on, which is all that changes.\n */\n private fillDmc(out: Uint8Array, at: number, end: number) {\n const d = this.dmc;\n if (d.silence && d.remaining === 0 && d.buffer < 0) {\n // Nothing to play: the output holds, and only the timer and the bit count\n // move on. Worked out for the whole run at once — nothing audible depends\n // on the timer's exact fraction until a sample starts, and starting one\n // takes a register write, which ends the run.\n const total = d.phase + d.step * (end - at);\n const clocks = Math.floor(total);\n d.phase = total - clocks;\n // Each clock uses up a bit; an emptied cycle starts another, silent,\n // since there is nothing to load.\n d.bits -= clocks % 8;\n if (d.bits <= 0) d.bits += 8;\n out.fill(d.level, at, end);\n return;\n }\n for (let k = at; k < end; k++) {\n d.phase += d.step;\n while (d.phase >= 1) {\n d.phase -= 1;\n this.clockDmc();\n }\n out[k] = d.level;\n }\n }\n\n /** One DMC timer clock: step the output by the next bit, and start a new byte after eight. */\n private clockDmc() {\n const d = this.dmc;\n if (!d.silence) {\n if (d.shift & 1) {\n if (d.level <= 125) d.level += 2;\n } else if (d.level >= 2) {\n d.level -= 2;\n }\n }\n d.shift >>= 1;\n d.bits -= 1;\n if (d.bits === 0) {\n d.bits = 8;\n if (d.buffer < 0) {\n d.silence = true;\n } else {\n d.silence = false;\n d.shift = d.buffer;\n d.buffer = -1;\n this.fetchDmc();\n }\n }\n }\n\n /** The memory reader: refill the empty buffer from the cartridge, looping or stopping at the end. */\n private fetchDmc() {\n const d = this.dmc;\n if (d.buffer >= 0 || d.remaining === 0) return;\n d.buffer = this.read(d.address);\n d.address = d.address === 0xffff ? 0x8000 : d.address + 1;\n d.remaining -= 1;\n if (d.remaining === 0 && d.loop) {\n d.address = d.startAddress;\n d.remaining = d.startLength;\n }\n }\n\n private retuneDmc() {\n this.dmc.step = CPU_HZ / DMC_PERIODS[this.dmc.rateIndex] / this.sampleRate;\n }\n\n /** A copy of the channels' internal counters and levels — see `ApuSnapshot`. */\n snapshot(): ApuSnapshot {\n const t = this.triangle;\n const n = this.noise;\n return {\n pulse: this.pulses.map((p) => ({\n period: p.period,\n duty: p.duty,\n length: p.length,\n level: p.constant ? p.volume : p.env.decay,\n constant: p.constant,\n muted: p.muted,\n enabled: p.enabled,\n })),\n triangle: {\n period: t.period,\n length: t.length,\n linear: t.linear,\n step: TRIANGLE_FLAT[(t.phase | 0) & 31],\n enabled: t.enabled,\n },\n noise: {\n periodIndex: n.periodIndex,\n shortMode: n.shortMode,\n length: n.length,\n level: n.constant ? n.volume : n.env.decay,\n constant: n.constant,\n enabled: n.enabled,\n },\n ...(this.fds ? { fds: this.fds.snapshot() } : {}),\n ...(this.n163 ? { n163: this.n163.snapshot() } : {}),\n dmc: {\n level: this.dmc.level,\n rateIndex: this.dmc.rateIndex,\n loop: this.dmc.loop,\n remaining: this.dmc.remaining,\n address: this.dmc.address,\n enabled: this.dmc.remaining > 0,\n },\n };\n }\n\n private retunePulse(p: Pulse) {\n p.step = CPU_HZ / (2 * (p.period + 1)) / this.sampleRate;\n p.muted = sweepMutes(p.period, p.sweep);\n }\n\n private retuneTriangle() {\n this.triangle.step = CPU_HZ / (this.triangle.period + 1) / this.sampleRate;\n }\n\n private retuneNoise() {\n this.noise.step = CPU_HZ / NOISE_PERIODS[this.noise.periodIndex] / this.sampleRate;\n }\n\n private clockFrameCounter() {\n // 4-step: quarter frames on every step, half frames on steps 2 and 4.\n // 5-step: quarter frames on 1, 2, 3 and 5, half frames on 2 and 5.\n const step = this.frameStep;\n if (this.fiveStep) {\n this.frameStep = (step + 1) % 5;\n if (step !== 3) this.clockQuarterFrame();\n if (step === 1 || step === 4) this.clockHalfFrame();\n } else {\n this.frameStep = (step + 1) % 4;\n this.clockQuarterFrame();\n if (step === 1 || step === 3) this.clockHalfFrame();\n }\n }\n\n private clockQuarterFrame() {\n for (const p of this.pulses) clockEnvelope(p.env, p.volume, p.halt);\n clockEnvelope(this.noise.env, this.noise.volume, this.noise.halt);\n\n const t = this.triangle;\n if (t.linearReloadFlag) t.linear = t.linearReload;\n else if (t.linear > 0) t.linear -= 1;\n if (!t.control) t.linearReloadFlag = false;\n }\n\n private clockHalfFrame() {\n if (this.lengthCounter) {\n for (const p of this.pulses) if (!p.halt && p.length > 0) p.length -= 1;\n if (!this.triangle.control && this.triangle.length > 0) this.triangle.length -= 1;\n if (!this.noise.halt && this.noise.length > 0) this.noise.length -= 1;\n }\n\n for (const p of this.pulses) {\n // The hardware's order: adjust first, then reload or count down.\n if (p.sweepDivider === 0 && p.sweep.enabled && p.sweep.shift > 0 && !p.muted) {\n p.period = Math.max(0, sweepTarget(p.period, p.sweep));\n this.retunePulse(p);\n }\n if (p.sweepDivider === 0 || p.sweepReload) {\n p.sweepDivider = p.sweep.dividerPeriod;\n p.sweepReload = false;\n } else {\n p.sweepDivider -= 1;\n }\n }\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"chip.js","sourceRoot":"","sources":["../src/chip.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The 2A03's sound half, register by register.\n *\n * `Apu` holds what the chip holds — timers, sequencer positions, length and\n * linear counters, envelopes, sweep units, the frame counter — and changes it\n * only the ways the chip does: through a write to `$4000`–`$4017`, or through\n * its own clocks. Nothing here knows what a note is. That is the point: every\n * NES game's music, whatever its driver, reaches the speaker as writes to\n * these registers, so a synth that takes writes plays any of them.\n *\n * It runs at a fixed sample rate rather than per CPU cycle: `render()` advances\n * the chip a run of samples and reports each channel's output level — 0..15 for\n * the pulses, triangle and noise, 0..127 for the DMC — at every one of them. The\n * mixer and the analogue stage are separate (`mixer.ts`), because a caller that\n * wants to hear one channel alone has to get at the levels before they are mixed.\n *\n * The DMC reads its samples from the cartridge, `$8000`–`$FFFF`; give it that\n * memory as `options.memory` (without it, it reads zeros — a sample that only\n * ever steps down).\n *\n * Not modelled: the DMC's and the frame counter's IRQs, the CPU stall of the\n * DMC's memory reads, and the handful of cycle-exact write/clock races. Periods\n * and levels are the hardware's; timing is exact to the sample.\n *\n * **Speed.** `levels()` runs once per sample — 88 200 times a second of music at\n * the default oversampling — so anything that only changes when a register is\n * written (a channel's step per sample, whether the sweep unit mutes it) is\n * worked out at the write and kept, not recomputed here. The expressions are the\n * same ones, evaluated at a different moment, so the output is bit for bit what\n * recomputing them every sample gives.\n */\n\nimport {\n CPU_HZ,\n DMC_PERIODS,\n DUTY_SEQUENCES,\n LENGTH_TABLE,\n NOISE_PERIODS,\n QUARTER_FRAME_HZ,\n TRIANGLE_STEPS,\n} from './constants.js';\nimport { LONG_CYCLE, LONG_HIGH_BEFORE, LONG_INDEX, LONG_STATES } from './lfsr.js';\nimport { decodeSweep, sweepMutes, sweepTarget, type SweepConfig } from './sweep.js';\nimport {\n FdsChip,\n N163Chip,\n Vrc6Chip,\n type FdsSnapshot,\n type N163Snapshot,\n type Vrc6Snapshot,\n} from './expansion.js';\n\n/** The four duty sequences flattened, `duty * 8 + step`. */\nconst DUTY_FLAT = Uint8Array.from(DUTY_SEQUENCES.flat());\nconst TRIANGLE_FLAT = Uint8Array.from(TRIANGLE_STEPS);\n\ninterface Envelope {\n start: boolean;\n divider: number;\n decay: number;\n}\n\ninterface Pulse {\n pulse1: boolean;\n duty: number;\n /** Bit 5 of `$4000`: halts the length counter AND loops the envelope — one bit, two jobs. */\n halt: boolean;\n constant: boolean;\n /** Bits 0..3 of `$4000`: the level when `constant`, the envelope's divider period when not. */\n volume: number;\n env: Envelope;\n sweep: SweepConfig;\n sweepDivider: number;\n sweepReload: boolean;\n /** The 11-bit timer period. */\n period: number;\n length: number;\n enabled: boolean;\n /** Position in the 8-step duty sequence, fractional. */\n phase: number;\n /** Steps of the sequence per sample, from `period` — kept, see \"Speed\". */\n step: number;\n /** Whether the sweep unit mutes the channel at this period — kept, see \"Speed\". */\n muted: boolean;\n}\n\ninterface Triangle {\n /** Bit 7 of `$4008`: halts the length counter and keeps reloading the linear counter. */\n control: boolean;\n linearReload: number;\n linearReloadFlag: boolean;\n linear: number;\n period: number;\n length: number;\n enabled: boolean;\n phase: number;\n step: number;\n}\n\ninterface Noise {\n halt: boolean;\n constant: boolean;\n volume: number;\n env: Envelope;\n /** Bit 7 of `$400E`: feedback from bit 6 instead of bit 1 — the short, metallic 93-step loop. */\n shortMode: boolean;\n periodIndex: number;\n length: number;\n enabled: boolean;\n /**\n * The register. In normal mode it is held as a position in the precomputed\n * cycle (`lfsrIndex`) and `lfsr` is stale; in short mode `lfsr` is the state.\n * A mode switch converts one into the other.\n */\n lfsr: number;\n lfsrIndex: number;\n /** Fractional timer position: how many register shifts are owed. */\n phase: number;\n step: number;\n}\n\n/**\n * What the chip is doing right now, channel by channel — for showing it, not\n * for driving it. Every field is a number the hardware itself holds.\n */\n/**\n * The delta modulation channel: 1-bit samples read from cartridge memory, each\n * bit stepping a 7-bit output up or down by 2.\n */\ninterface Dmc {\n loop: boolean;\n rateIndex: number;\n /** Output level, 0..127. `$4011` sets it directly. */\n level: number;\n /** `$4012`/`$4013` as addresses and byte counts. */\n startAddress: number;\n startLength: number;\n /** The memory reader: where it reads next, and how many bytes are left. */\n address: number;\n remaining: number;\n /** The one-byte sample buffer, or -1 when empty. */\n buffer: number;\n /** The output unit: its shift register, bits left in it, and whether it is silent. */\n shift: number;\n bits: number;\n silence: boolean;\n phase: number;\n step: number;\n}\n\n/** Where every channel's output levels go, sample by sample. */\nexport interface ChannelBuffers {\n pulse1: Uint8Array;\n pulse2: Uint8Array;\n triangle: Uint8Array;\n /** Fractional: the gate is averaged over the shifts in a sample. */\n noise: Float64Array;\n dmc: Uint8Array;\n /** The FDS wave channel, in `mixApu` units (added to, not overwritten) — when the chip has one. */\n fds?: Float64Array;\n /**\n * The N163's channels by register slot 0..7 (slot 7, `$78`, is the one always on), in `mixApu`\n * units; index 8, if given, takes every slot without a buffer of its own.\n */\n n163?: (Float64Array | undefined)[];\n /**\n * The VRC6's channels — pulse 1, pulse 2, saw — in `mixApu` units; index 3, if given, takes every\n * channel without a buffer of its own.\n */\n vrc6?: (Float64Array | undefined)[];\n}\n\n/** Cartridge memory for the DMC: the bytes of `$8000`–`$FFFF`, or a reader for any address. */\nexport type ApuMemory = Uint8Array | ((address: number) => number);\n\nexport interface ApuSnapshot {\n pulse: {\n period: number;\n duty: number;\n /** Length counter, in half-frames; 0 is silent. */\n length: number;\n /** Level the channel outputs when high: the written volume, or the envelope's decay. */\n level: number;\n constant: boolean;\n /** The sweep unit is muting the channel (period < 8, or target past $7FF). */\n muted: boolean;\n enabled: boolean;\n }[];\n triangle: {\n period: number;\n length: number;\n /** Linear counter, in quarter-frames; 0 is silent. */\n linear: number;\n /** The step the staircase is on — held while silent. */\n step: number;\n enabled: boolean;\n };\n noise: {\n periodIndex: number;\n shortMode: boolean;\n length: number;\n level: number;\n constant: boolean;\n enabled: boolean;\n };\n /** The expansion chips' state, when the chip has them (`ApuChipOptions.expansion`). */\n fds?: FdsSnapshot;\n n163?: N163Snapshot;\n vrc6?: Vrc6Snapshot;\n dmc: {\n /** Output level, 0..127. */\n level: number;\n rateIndex: number;\n loop: boolean;\n /** Bytes of the sample still to read; above 0 means it is playing. */\n remaining: number;\n /** Where the memory reader is. */\n address: number;\n enabled: boolean;\n };\n}\n\nexport interface ApuChipOptions {\n /**\n * Honour the length counters. Default true — it is hardware, and without it\n * a drum hit written with a short counter runs on as a wash. Off exists to\n * hear the difference.\n */\n lengthCounter?: boolean;\n /** Where the DMC reads its samples from — see `ApuMemory`. Reads 0 when absent. */\n memory?: ApuMemory;\n /**\n * Expansion sound on the cartridge: `'FDS'` takes `$4040`–`$408A`, `'N163'` its address port\n * (`$F800`), data port (`$4800`) and `$E000`, `'VRC6'` `$9000`–`$9003`, `$A000`–`$A002` and\n * `$B000`–`$B002`. Their output goes to `ChannelBuffers.fds`/`n163`/`vrc6`.\n */\n expansion?: readonly string[];\n}\n\nconst newEnvelope = (): Envelope => ({ start: false, divider: 0, decay: 0 });\n\nconst newPulse = (pulse1: boolean): Pulse => ({\n pulse1,\n duty: 0,\n halt: false,\n constant: false,\n volume: 0,\n env: newEnvelope(),\n sweep: decodeSweep(0, pulse1),\n sweepDivider: 0,\n sweepReload: false,\n period: 0,\n length: 0,\n enabled: false,\n phase: 0,\n step: 0,\n muted: true,\n});\n\n/** One quarter-frame of an envelope, in the hardware's order. */\nfunction clockEnvelope(env: Envelope, period: number, loop: boolean) {\n if (env.start) {\n env.start = false;\n env.decay = 15;\n env.divider = period;\n } else if (env.divider === 0) {\n env.divider = period;\n if (env.decay > 0) env.decay -= 1;\n else if (loop) env.decay = 15;\n } else {\n env.divider -= 1;\n }\n}\n\nexport class Apu {\n readonly sampleRate: number;\n /** The Disk System's wave channel, when `expansion` has `'FDS'`. */\n readonly fds: FdsChip | null;\n /** Namco's 163, when `expansion` has `'N163'`. */\n readonly n163: N163Chip | null;\n /** Konami's VRC6, when `expansion` has `'VRC6'`. */\n readonly vrc6: Vrc6Chip | null;\n private readonly lengthCounter: boolean;\n\n private readonly pulses: [Pulse, Pulse] = [newPulse(true), newPulse(false)];\n private readonly triangle: Triangle = {\n control: false,\n linearReload: 0,\n linearReloadFlag: false,\n linear: 0,\n period: 0,\n length: 0,\n enabled: false,\n // Start on a zero step, so a chip that has not been written to is silent\n // rather than holding the top of the staircase as DC. The triangle's\n // position only moves while it sounds, so this is where it rests until the\n // first note — the part of power-on a listener would otherwise hear as a\n // thump.\n phase: 16,\n step: 0,\n };\n private readonly noise: Noise = {\n halt: false,\n constant: false,\n volume: 0,\n env: newEnvelope(),\n shortMode: false,\n periodIndex: 0,\n length: 0,\n enabled: false,\n lfsr: 1, // the chip powers up with bit 0 set\n lfsrIndex: LONG_INDEX[1],\n phase: 0,\n step: 0,\n };\n\n private readonly dmc: Dmc = {\n loop: false,\n rateIndex: 0,\n level: 0,\n startAddress: 0xc000,\n startLength: 1,\n address: 0xc000,\n remaining: 0,\n buffer: -1,\n shift: 0,\n bits: 8,\n silence: true,\n phase: 0,\n step: 0,\n };\n private readonly read: (address: number) => number;\n\n /** Frame counter: 5-step mode, which step is next, samples until it. */\n private fiveStep = false;\n private frameStep = 0;\n private frameCountdown: number;\n private readonly samplesPerQuarterFrame: number;\n\n private readonly out = [0, 0, 0, 0, 0];\n\n constructor(sampleRate: number, options: ApuChipOptions = {}) {\n this.sampleRate = sampleRate;\n this.lengthCounter = options.lengthCounter !== false;\n this.fds = options.expansion?.includes('FDS') ? new FdsChip(sampleRate) : null;\n this.n163 = options.expansion?.includes('N163') ? new N163Chip(sampleRate) : null;\n this.vrc6 = options.expansion?.includes('VRC6') ? new Vrc6Chip(sampleRate) : null;\n this.samplesPerQuarterFrame = sampleRate / QUARTER_FRAME_HZ;\n this.frameCountdown = this.samplesPerQuarterFrame;\n for (const p of this.pulses) this.retunePulse(p);\n this.retuneTriangle();\n this.retuneNoise();\n this.retuneDmc();\n const memory = options.memory;\n this.read =\n typeof memory === 'function'\n ? (address) => memory(address) & 0xff\n : memory && memory.length > 0\n ? (address) => memory[(address - 0x8000) % memory.length]\n : () => 0;\n }\n\n /**\n * A CPU write to one of the APU's registers — or an expansion chip's, when there is one.\n * Anything else is ignored.\n */\n write(address: number, value: number) {\n if (address > 0x4017) {\n if (this.fds?.write(address, value)) return;\n if (this.vrc6?.write(address, value)) return;\n this.n163?.write(address, value);\n return;\n }\n const v = value & 0xff;\n switch (address) {\n case 0x4000:\n case 0x4004: {\n const p = this.pulses[address === 0x4000 ? 0 : 1];\n p.duty = v >> 6;\n p.halt = (v & 0x20) !== 0;\n p.constant = (v & 0x10) !== 0;\n p.volume = v & 0x0f;\n return;\n }\n case 0x4001:\n case 0x4005: {\n const p = this.pulses[address === 0x4001 ? 0 : 1];\n p.sweep = decodeSweep(v, p.pulse1);\n p.sweepReload = true;\n p.muted = sweepMutes(p.period, p.sweep);\n return;\n }\n case 0x4002:\n case 0x4006: {\n const p = this.pulses[address === 0x4002 ? 0 : 1];\n p.period = (p.period & 0x700) | v;\n this.retunePulse(p);\n return;\n }\n case 0x4003:\n case 0x4007: {\n // The high byte does three things at once, and all three are audible:\n // it reloads the length counter, restarts the envelope, and puts the\n // duty sequencer back to its first step — which is why a driver that\n // rewrites it every frame for a vibrato makes the vibrato click.\n const p = this.pulses[address === 0x4003 ? 0 : 1];\n p.period = (p.period & 0xff) | ((v & 7) << 8);\n if (p.enabled) p.length = LENGTH_TABLE[v >> 3];\n p.env.start = true;\n p.phase = 0;\n this.retunePulse(p);\n return;\n }\n case 0x4008:\n this.triangle.control = (v & 0x80) !== 0;\n this.triangle.linearReload = v & 0x7f;\n return;\n case 0x400a:\n this.triangle.period = (this.triangle.period & 0x700) | v;\n this.retuneTriangle();\n return;\n case 0x400b:\n // No phase reset here: the triangle's sequencer is never restarted, so\n // a new note picks up the staircase wherever the last one left it.\n this.triangle.period = (this.triangle.period & 0xff) | ((v & 7) << 8);\n if (this.triangle.enabled) this.triangle.length = LENGTH_TABLE[v >> 3];\n this.triangle.linearReloadFlag = true;\n this.retuneTriangle();\n return;\n case 0x400c:\n this.noise.halt = (v & 0x20) !== 0;\n this.noise.constant = (v & 0x10) !== 0;\n this.noise.volume = v & 0x0f;\n return;\n case 0x400e: {\n const n = this.noise;\n const shortMode = (v & 0x80) !== 0;\n // Hand the register between its two representations: a position in the\n // precomputed cycle for normal mode, the raw state for short mode.\n if (shortMode && !n.shortMode) n.lfsr = LONG_STATES[n.lfsrIndex];\n if (!shortMode && n.shortMode) n.lfsrIndex = LONG_INDEX[n.lfsr];\n n.shortMode = shortMode;\n n.periodIndex = v & 0x0f;\n this.retuneNoise();\n return;\n }\n case 0x400f:\n if (this.noise.enabled) this.noise.length = LENGTH_TABLE[v >> 3];\n this.noise.env.start = true;\n return;\n case 0x4010:\n this.dmc.loop = (v & 0x40) !== 0;\n this.dmc.rateIndex = v & 0x0f;\n this.retuneDmc();\n return;\n case 0x4011:\n // Straight to the output — the way games play PCM without the DMC's\n // own memory reader, one write per sample.\n this.dmc.level = v & 0x7f;\n return;\n case 0x4012:\n this.dmc.startAddress = 0xc000 + v * 64;\n return;\n case 0x4013:\n this.dmc.startLength = v * 16 + 1;\n return;\n case 0x4015: {\n // Clearing a channel's bit empties its length counter at once — the\n // one way to silence a channel on the spot rather than at the next clock.\n const channels = [this.pulses[0], this.pulses[1], this.triangle, this.noise];\n channels.forEach((channel, i) => {\n channel.enabled = (v & (1 << i)) !== 0;\n if (!channel.enabled) channel.length = 0;\n });\n // Bit 4 is the DMC's: clear stops the sample (what is already in the\n // buffer still plays out); set starts it again if it had finished.\n const d = this.dmc;\n if ((v & 0x10) === 0) d.remaining = 0;\n else if (d.remaining === 0) {\n d.address = d.startAddress;\n d.remaining = d.startLength;\n this.fetchDmc();\n }\n return;\n }\n case 0x4017:\n this.fiveStep = (v & 0x80) !== 0;\n this.frameStep = 0;\n this.frameCountdown = this.samplesPerQuarterFrame;\n // Selecting 5-step mode clocks everything once, immediately.\n if (this.fiveStep) {\n this.clockQuarterFrame();\n this.clockHalfFrame();\n }\n return;\n default:\n return;\n }\n }\n\n /** Scratch buffers for `levels()`, one sample long. */\n private readonly one: ChannelBuffers = {\n pulse1: new Uint8Array(1),\n pulse2: new Uint8Array(1),\n triangle: new Uint8Array(1),\n noise: new Float64Array(1),\n dmc: new Uint8Array(1),\n };\n\n /**\n * Advance one sample and return the five channel levels, `[pulse1, pulse2,\n * triangle, noise, dmc]` (see `render`). The array is reused between calls.\n * For more than a sample at a time, `render` is several times faster and\n * gives the same numbers.\n */\n levels(): readonly number[] {\n const one = this.one;\n this.render(1, one);\n const out = this.out;\n out[0] = one.pulse1[0];\n out[1] = one.pulse2[0];\n out[2] = one.triangle[0];\n out[3] = one.noise[0];\n out[4] = one.dmc[0];\n return out;\n }\n\n /**\n * Advance `count` samples, writing each channel's level into its buffer from\n * `offset` on: the pulses, triangle and DMC as whole numbers (0..15, 0..127),\n * the noise fractional (its gate is averaged over the shifts in a sample). No\n * register writes happen inside — a caller with writes due splits the run at\n * them.\n *\n * The frame counter is the only thing that changes a channel's parameters\n * between writes, so the run is cut at its clocks and each piece is filled a\n * channel at a time (`fill`). Every sum is the one `levels()` would do, in the\n * same order — the buffers come out bit for bit the same as `count` calls.\n */\n render(count: number, buffers: ChannelBuffers, offset = 0) {\n if (this.fds && buffers.fds) {\n buffers.fds.fill(0, offset, offset + count);\n this.fds.render(count, buffers.fds, offset);\n }\n if (this.n163 && buffers.n163) {\n const cleared = new Set<Float64Array>();\n for (const out of buffers.n163) if (out && !cleared.has(out)) {\n out.fill(0, offset, offset + count);\n cleared.add(out);\n }\n this.n163.render(count, buffers.n163, offset);\n }\n if (this.vrc6 && buffers.vrc6) {\n const cleared = new Set<Float64Array>();\n for (const out of buffers.vrc6) if (out && !cleared.has(out)) {\n out.fill(0, offset, offset + count);\n cleared.add(out);\n }\n this.vrc6.render(count, buffers.vrc6, offset);\n }\n let done = 0;\n while (done < count) {\n // Samples before the one on which the counter reaches zero. Subtracting\n // them in one go is exact: the counter holds a value whose fractional\n // bits are all representable after taking off a whole number.\n const free = Math.ceil(this.frameCountdown) - 1;\n if (free <= 0) {\n this.frameCountdown -= 1;\n while (this.frameCountdown <= 0) {\n this.frameCountdown += this.samplesPerQuarterFrame;\n this.clockFrameCounter();\n }\n this.fill(1, buffers, offset + done);\n done += 1;\n } else {\n const run = Math.min(free, count - done);\n this.frameCountdown -= run;\n this.fill(run, buffers, offset + done);\n done += run;\n }\n }\n }\n\n /** `count` samples with every channel's parameters fixed — tight loops on locals. */\n private fill(count: number, buffers: ChannelBuffers, at: number) {\n const end = at + count;\n const { pulse1, pulse2, triangle, noise } = buffers;\n\n for (let i = 0; i < 2; i++) {\n const p = this.pulses[i];\n const out = i === 0 ? pulse1 : pulse2;\n // A pulse steps through 8 entries per cycle and each entry takes\n // 2 × (period + 1) CPU cycles: CPU / (16 × (period + 1)) per cycle.\n const step = p.step;\n let phase = p.phase;\n if (p.length === 0 || p.muted) {\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 8) phase %= 8;\n out[k] = 0;\n }\n } else {\n const level = p.constant ? p.volume : p.env.decay;\n const base = p.duty * 8;\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 8) phase %= 8;\n out[k] = DUTY_FLAT[base + ((phase | 0) & 7)] * level;\n }\n }\n p.phase = phase;\n }\n\n const t = this.triangle;\n // The staircase only moves while both counters are non-zero. When either\n // runs out the sequencer STOPS where it is and the output holds that step:\n // the triangle is never \"at zero\" between notes, it is wherever it paused.\n if (t.length > 0 && t.linear > 0) {\n const step = t.step;\n let phase = t.phase;\n for (let k = at; k < end; k++) {\n phase += step;\n if (phase >= 32) phase %= 32;\n triangle[k] = TRIANGLE_FLAT[(phase | 0) & 31];\n }\n t.phase = phase;\n } else {\n triangle.fill(TRIANGLE_FLAT[(t.phase | 0) & 31], at, end);\n }\n\n // AVERAGE the register's output across the shifts each sample is worth,\n // rather than sampling wherever it lands. At the short periods the LFSR\n // runs well past the sample rate, and keeping only the last shift folds the\n // rest back as alias tones — drums like a broken speaker. The channel is\n // silenced while bit 0 is set: the register gates it.\n const n = this.noise;\n const level = n.length === 0 ? 0 : n.constant ? n.volume : n.env.decay;\n const step = n.step;\n let phase = n.phase;\n if (!n.shortMode) {\n let index = n.lfsrIndex;\n if (level === 0) {\n // Silent, but the register keeps shifting: advance it, output nothing.\n for (let k = at; k < end; k++) {\n phase += step;\n // A few shifts per sample at most, so one conditional subtraction\n // wraps the index — no division. (Math.floor, not `| 0`: the phase is\n // a double, and a round trip through int32 measured 20% slower.)\n const shifts = Math.floor(phase);\n phase -= shifts;\n index += shifts;\n if (index >= LONG_CYCLE) index -= LONG_CYCLE;\n }\n noise.fill(0, at, end);\n } else {\n for (let k = at; k < end; k++) {\n phase += step;\n const shifts = Math.floor(phase);\n phase -= shifts;\n let gate: number;\n if (shifts > 0) {\n gate = (LONG_HIGH_BEFORE[index + shifts] - LONG_HIGH_BEFORE[index]) / shifts;\n index += shifts;\n if (index >= LONG_CYCLE) index -= LONG_CYCLE;\n } else {\n gate = (LONG_STATES[index] & 1) === 0 ? 1 : 0;\n }\n noise[k] = gate * level;\n }\n }\n n.lfsrIndex = index;\n } else {\n let lfsr = n.lfsr;\n for (let k = at; k < end; k++) {\n phase += step;\n const shifts = Math.floor(phase);\n phase -= shifts;\n let high = 0;\n for (let s = 0; s < shifts; s++) {\n if ((lfsr & 1) === 0) high++;\n const feedback = (lfsr & 1) ^ ((lfsr >> 6) & 1);\n lfsr = (lfsr >> 1) | (feedback << 14);\n }\n const gate = shifts > 0 ? high / shifts : (lfsr & 1) === 0 ? 1 : 0;\n noise[k] = level === 0 ? 0 : gate * level;\n }\n n.lfsr = lfsr;\n }\n n.phase = phase;\n\n this.fillDmc(buffers.dmc, at, end);\n }\n\n /**\n * The DMC over `[at, end)`. At most a bit or two per sample even at its\n * fastest rate, so it is clocked bit by bit; a channel with nothing to play\n * only has its output-cycle count moved on, which is all that changes.\n */\n private fillDmc(out: Uint8Array, at: number, end: number) {\n const d = this.dmc;\n if (d.silence && d.remaining === 0 && d.buffer < 0) {\n // Nothing to play: the output holds, and only the timer and the bit count\n // move on. Worked out for the whole run at once — nothing audible depends\n // on the timer's exact fraction until a sample starts, and starting one\n // takes a register write, which ends the run.\n const total = d.phase + d.step * (end - at);\n const clocks = Math.floor(total);\n d.phase = total - clocks;\n // Each clock uses up a bit; an emptied cycle starts another, silent,\n // since there is nothing to load.\n d.bits -= clocks % 8;\n if (d.bits <= 0) d.bits += 8;\n out.fill(d.level, at, end);\n return;\n }\n for (let k = at; k < end; k++) {\n d.phase += d.step;\n while (d.phase >= 1) {\n d.phase -= 1;\n this.clockDmc();\n }\n out[k] = d.level;\n }\n }\n\n /** One DMC timer clock: step the output by the next bit, and start a new byte after eight. */\n private clockDmc() {\n const d = this.dmc;\n if (!d.silence) {\n if (d.shift & 1) {\n if (d.level <= 125) d.level += 2;\n } else if (d.level >= 2) {\n d.level -= 2;\n }\n }\n d.shift >>= 1;\n d.bits -= 1;\n if (d.bits === 0) {\n d.bits = 8;\n if (d.buffer < 0) {\n d.silence = true;\n } else {\n d.silence = false;\n d.shift = d.buffer;\n d.buffer = -1;\n this.fetchDmc();\n }\n }\n }\n\n /** The memory reader: refill the empty buffer from the cartridge, looping or stopping at the end. */\n private fetchDmc() {\n const d = this.dmc;\n if (d.buffer >= 0 || d.remaining === 0) return;\n d.buffer = this.read(d.address);\n d.address = d.address === 0xffff ? 0x8000 : d.address + 1;\n d.remaining -= 1;\n if (d.remaining === 0 && d.loop) {\n d.address = d.startAddress;\n d.remaining = d.startLength;\n }\n }\n\n private retuneDmc() {\n this.dmc.step = CPU_HZ / DMC_PERIODS[this.dmc.rateIndex] / this.sampleRate;\n }\n\n /** A copy of the channels' internal counters and levels — see `ApuSnapshot`. */\n snapshot(): ApuSnapshot {\n const t = this.triangle;\n const n = this.noise;\n return {\n pulse: this.pulses.map((p) => ({\n period: p.period,\n duty: p.duty,\n length: p.length,\n level: p.constant ? p.volume : p.env.decay,\n constant: p.constant,\n muted: p.muted,\n enabled: p.enabled,\n })),\n triangle: {\n period: t.period,\n length: t.length,\n linear: t.linear,\n step: TRIANGLE_FLAT[(t.phase | 0) & 31],\n enabled: t.enabled,\n },\n noise: {\n periodIndex: n.periodIndex,\n shortMode: n.shortMode,\n length: n.length,\n level: n.constant ? n.volume : n.env.decay,\n constant: n.constant,\n enabled: n.enabled,\n },\n ...(this.fds ? { fds: this.fds.snapshot() } : {}),\n ...(this.n163 ? { n163: this.n163.snapshot() } : {}),\n ...(this.vrc6 ? { vrc6: this.vrc6.snapshot() } : {}),\n dmc: {\n level: this.dmc.level,\n rateIndex: this.dmc.rateIndex,\n loop: this.dmc.loop,\n remaining: this.dmc.remaining,\n address: this.dmc.address,\n enabled: this.dmc.remaining > 0,\n },\n };\n }\n\n private retunePulse(p: Pulse) {\n p.step = CPU_HZ / (2 * (p.period + 1)) / this.sampleRate;\n p.muted = sweepMutes(p.period, p.sweep);\n }\n\n private retuneTriangle() {\n this.triangle.step = CPU_HZ / (this.triangle.period + 1) / this.sampleRate;\n }\n\n private retuneNoise() {\n this.noise.step = CPU_HZ / NOISE_PERIODS[this.noise.periodIndex] / this.sampleRate;\n }\n\n private clockFrameCounter() {\n // 4-step: quarter frames on every step, half frames on steps 2 and 4.\n // 5-step: quarter frames on 1, 2, 3 and 5, half frames on 2 and 5.\n const step = this.frameStep;\n if (this.fiveStep) {\n this.frameStep = (step + 1) % 5;\n if (step !== 3) this.clockQuarterFrame();\n if (step === 1 || step === 4) this.clockHalfFrame();\n } else {\n this.frameStep = (step + 1) % 4;\n this.clockQuarterFrame();\n if (step === 1 || step === 3) this.clockHalfFrame();\n }\n }\n\n private clockQuarterFrame() {\n for (const p of this.pulses) clockEnvelope(p.env, p.volume, p.halt);\n clockEnvelope(this.noise.env, this.noise.volume, this.noise.halt);\n\n const t = this.triangle;\n if (t.linearReloadFlag) t.linear = t.linearReload;\n else if (t.linear > 0) t.linear -= 1;\n if (!t.control) t.linearReloadFlag = false;\n }\n\n private clockHalfFrame() {\n if (this.lengthCounter) {\n for (const p of this.pulses) if (!p.halt && p.length > 0) p.length -= 1;\n if (!this.triangle.control && this.triangle.length > 0) this.triangle.length -= 1;\n if (!this.noise.halt && this.noise.length > 0) this.noise.length -= 1;\n }\n\n for (const p of this.pulses) {\n // The hardware's order: adjust first, then reload or count down.\n if (p.sweepDivider === 0 && p.sweep.enabled && p.sweep.shift > 0 && !p.muted) {\n p.period = Math.max(0, sweepTarget(p.period, p.sweep));\n this.retunePulse(p);\n }\n if (p.sweepDivider === 0 || p.sweepReload) {\n p.sweepDivider = p.sweep.dividerPeriod;\n p.sweepReload = false;\n } else {\n p.sweepDivider -= 1;\n }\n }\n }\n}\n"]}
|
package/dist/expansion.d.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The
|
|
3
|
-
* System's wavetable voice (FDS)
|
|
4
|
-
* 2A03 does not have — a waveform drawn in RAM
|
|
5
|
-
*
|
|
6
|
-
* its bass and drums.
|
|
2
|
+
* The expansion sound chips the Famicom's own games carried most: the Disk
|
|
3
|
+
* System's wavetable voice (FDS), Namco's 163 (N163) and Konami's VRC6. Each
|
|
4
|
+
* adds channels the 2A03 does not have — a waveform drawn in RAM played back at
|
|
5
|
+
* a pitch, or two more pulses and a sawtooth — and games that use them put
|
|
6
|
+
* their melody there, so without them a soundtrack is its bass and drums.
|
|
7
7
|
*
|
|
8
8
|
* Like the APU here they run at the sample rate, not per CPU cycle: each sample
|
|
9
9
|
* advances the chip by `CPU_HZ / sampleRate` cycles' worth of its counters.
|
|
@@ -12,7 +12,9 @@
|
|
|
12
12
|
* renderer adds it to the mix. The levels relative to the 2A03 follow the
|
|
13
13
|
* common reference players: FDS at full gain about as loud as both pulses at
|
|
14
14
|
* full, an N163 channel at full volume about as loud as one pulse — divided by
|
|
15
|
-
* the number of channels it time-shares its one output with, as the chip does
|
|
15
|
+
* the number of channels it time-shares its one output with, as the chip does —
|
|
16
|
+
* and a VRC6 pulse at full volume one and a half times a 2A03 pulse, as Mesen2
|
|
17
|
+
* mixes it (`VRC6_STEP`).
|
|
16
18
|
*/
|
|
17
19
|
export interface FdsSnapshot {
|
|
18
20
|
/** 12-bit wave frequency; Hz = CPU_HZ * frequency / 4194304. */
|
|
@@ -119,7 +121,70 @@ export declare class N163Chip {
|
|
|
119
121
|
render(count: number, outs: readonly (Float64Array | undefined)[], offset?: number): void;
|
|
120
122
|
snapshot(): N163Snapshot;
|
|
121
123
|
}
|
|
124
|
+
/** One of the VRC6's two pulses, `$9000`–`$9002` or `$A000`–`$A002`. */
|
|
125
|
+
export interface Vrc6PulseSnapshot {
|
|
126
|
+
/** 12-bit period; Hz = CPU_HZ / (16 · (period + 1)) — see `vrc6PulseHz`. */
|
|
127
|
+
period: number;
|
|
128
|
+
volume: number;
|
|
129
|
+
/** 0..7: high for duty + 1 of every 16 steps. */
|
|
130
|
+
duty: number;
|
|
131
|
+
/** The mode bit (`$x000` bit 7): the volume put out as it is, the duty ignored. */
|
|
132
|
+
constant: boolean;
|
|
133
|
+
enabled: boolean;
|
|
134
|
+
}
|
|
135
|
+
export interface Vrc6Snapshot {
|
|
136
|
+
pulse: [Vrc6PulseSnapshot, Vrc6PulseSnapshot];
|
|
137
|
+
saw: {
|
|
138
|
+
/** 12-bit period; Hz = CPU_HZ / (14 · (period + 1)) — see `vrc6SawHz`. */
|
|
139
|
+
period: number;
|
|
140
|
+
/** The accumulator rate, 0..63; past 42 the 8-bit accumulator wraps and the wave breaks up. */
|
|
141
|
+
rate: number;
|
|
142
|
+
enabled: boolean;
|
|
143
|
+
};
|
|
144
|
+
/** `$9003` bit 0: every oscillator stopped where it is. */
|
|
145
|
+
halted: boolean;
|
|
146
|
+
/** `$9003`: the periods shifted right by 4 (bit 1) or 8 (bit 2, which wins) — ×16 / ×256 pitch. */
|
|
147
|
+
shift: number;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Konami's VRC6: two pulses with eight duties and a sawtooth, beside the 2A03 (Akumajou Densetsu,
|
|
151
|
+
* Madara, Esper Dream 2). The registers are at the addresses the NSF format gives them —
|
|
152
|
+
* `$9000`–`$9003`, `$A000`–`$A002`, `$B000`–`$B002`; the cartridges themselves differ in which of
|
|
153
|
+
* A0/A1 they wire to the chip, which a player maps before here.
|
|
154
|
+
*
|
|
155
|
+
* Each channel counts down `(period >> shift) + 1` CPU cycles a step, as Mesen2's Vrc6Pulse/Vrc6Saw
|
|
156
|
+
* do. Output is the average over each sample of what the chip puts out, so a high note at a low
|
|
157
|
+
* sample rate keeps its level.
|
|
158
|
+
*/
|
|
159
|
+
export declare class Vrc6Chip {
|
|
160
|
+
private readonly cyclesPerSample;
|
|
161
|
+
private readonly pulses;
|
|
162
|
+
private sawRate;
|
|
163
|
+
private sawPeriod;
|
|
164
|
+
private sawEnabled;
|
|
165
|
+
private sawTimer;
|
|
166
|
+
private sawStep;
|
|
167
|
+
private sawAccumulator;
|
|
168
|
+
private halted;
|
|
169
|
+
private shift;
|
|
170
|
+
private static newPulse;
|
|
171
|
+
constructor(sampleRate: number);
|
|
172
|
+
/** A write to `$9000`–`$9003`, `$A000`–`$A002` or `$B000`–`$B002`. Returns false for any other address. */
|
|
173
|
+
write(address: number, value: number): boolean;
|
|
174
|
+
private static pulseLevel;
|
|
175
|
+
/**
|
|
176
|
+
* Advance `count` samples, ADDING each channel's output to `outs[0]` (pulse 1), `outs[1]` (pulse
|
|
177
|
+
* 2) and `outs[2]` (saw) — or, for a channel without a buffer of its own, to `outs[3]` if given —
|
|
178
|
+
* from `offset`.
|
|
179
|
+
*/
|
|
180
|
+
render(count: number, outs: readonly (Float64Array | undefined)[], offset?: number): void;
|
|
181
|
+
snapshot(): Vrc6Snapshot;
|
|
182
|
+
}
|
|
122
183
|
/** Hz of an FDS frequency register value. */
|
|
123
184
|
export declare const fdsHz: (frequency: number) => number;
|
|
124
185
|
/** Hz of an N163 channel, from its frequency, wave length and the number of channels on. */
|
|
125
186
|
export declare const n163Hz: (frequency: number, length: number, channels: number) => number;
|
|
187
|
+
/** Hz of a VRC6 pulse period (with `$9003`'s shift, if any): 16 steps of `(period >> shift) + 1` cycles. */
|
|
188
|
+
export declare const vrc6PulseHz: (period: number, shift?: number) => number;
|
|
189
|
+
/** Hz of the VRC6 sawtooth's period (with `$9003`'s shift, if any): 14 steps of `(period >> shift) + 1` cycles. */
|
|
190
|
+
export declare const vrc6SawHz: (period: number, shift?: number) => number;
|