@marmooo/midy 0.4.8 → 0.5.0

package/README.md

@@ -24,10 +24,14 @@ This library provides several files depending on the implementation level.
 - [Humidy](https://marmooo.github.io/humidy/) - GM2 MIDI mixer app
 - [Timidy](https://marmooo.github.io/timidy/) - Timidity++ style MIDI player
 - [4x4pad](https://marmooo.github.io/4x4pad/) - 4x4 grid MPE MIDI controller
-- [Celltone](https://marmooo.github.io/celltone/) - Grid MPE MIDI controller with
-  Janko-Piano layout
+- [Celltone](https://marmooo.github.io/celltone/) - Grid MPE MIDI controller
+  with Janko-Piano layout
 - [Isotone](https://marmooo.github.io/isotone/) - Grid MPE MIDI controller
   optimized for chords
+- [Hexatone](https://marmooo.github.io/hexatone/) - Hexagonal MPE MIDI
+  controller with Wicki-Hayden layout
+- [Glisstone](https://marmooo.github.io/glisstone/) - Hexagonal MPE MIDI
+  controller optimized for glissando
 
 ## Support Status
 
@@ -90,6 +94,18 @@ midy.addEventListener("resumed", func);
 midy.addEventListener("seeked", func);
 ```
 
+## Cache Mode
+
+- "none" -for full real-time control (dynamic CC, LFO, pitch)
+- "ads" - for real-time playback with higher cache hit rate
+- "adsr" - for real-time playback with accurate release envelope
+- "note" - for efficient playback when note behavior is fixed
+- "audio" - for fully pre-rendered playback (lowest CPU)
+
+```
+const midy = new Midy(audioContext, { cacheMode: "note" });
+```
+
 ### MIDI Message
 
 There are functions that handle MIDI messages as they are, as well as simplified

package/esm/midy-GM1.d.ts

@@ -11,7 +11,7 @@ export class MidyGM1 extends EventTarget {
         fineTuning: number;
         coarseTuning: number;
     };
-    constructor(audioContext: any);
+    constructor(audioContext: any, options?: {});
     perceptualSmoothingTime: number;
     mode: string;
     numChannels: number;
@@ -28,7 +28,6 @@ export class MidyGM1 extends EventTarget {
     voiceCache: Map<any, any>;
     realtimeVoiceCache: Map<any, any>;
     decodeMethod: string;
-    decoderQueue: Promise<void>;
     isPlaying: boolean;
     isPausing: boolean;
     isPaused: boolean;
@@ -42,7 +41,15 @@ export class MidyGM1 extends EventTarget {
     notePromises: any[];
     instruments: Set<any>;
     exclusiveClassNotes: any[];
+    adsrVoiceCache: Map<any, any>;
+    noteOnDurations: Map<any, any>;
+    noteOnEvents: Map<any, any>;
+    fullVoiceCache: Map<any, any>;
+    renderedAudioBuffer: null;
+    isRendering: boolean;
+    audioModeBufferSource: null;
     audioContext: any;
+    cacheMode: any;
     masterVolume: any;
     scheduler: any;
     schedulerBuffer: any;
@@ -54,33 +61,35 @@ export class MidyGM1 extends EventTarget {
         modLfoToVolume: (channel: any, note: any, scheduleTime: any) => void;
         chorusEffectsSend: (_channel: any, _note: any, _scheduleTime: any) => void;
         reverbEffectsSend: (_channel: any, _note: any, _scheduleTime: any) => void;
-        delayModLFO: (_channel: any, note: any, scheduleTime: any) => void;
+        delayModLFO: (channel: any, note: any, scheduleTime: any) => void;
         freqModLFO: (_channel: any, note: any, scheduleTime: any) => void;
         delayVibLFO: (_channel: any, _note: any, _scheduleTime: any) => void;
         freqVibLFO: (_channel: any, _note: any, _scheduleTime: any) => void;
         detune: (channel: any, note: any, scheduleTime: any) => void;
     };
     controlChangeHandlers: any[];
-    channels: any[];
+    channels: Channel[];
     addSoundFont(soundFont: any): void;
     toUint8Array(input: any): Promise<Uint8Array<ArrayBuffer>>;
     loadSoundFont(input: any): Promise<void>;
     loadMIDI(input: any): Promise<void>;
+    buildNoteOnDurations(): void;
     cacheVoiceIds(): void;
-    getVoiceId(channel: any, noteNumber: any, velocity: any): any;
+    getVoiceId(channel: any, noteNumber: any, velocity: any): number | undefined;
     createChannelAudioNodes(audioContext: any): {
         gainL: any;
         gainR: any;
         merger: any;
     };
-    createChannels(audioContext: any): any[];
+    createChannels(audioContext: any): Channel[];
     decodeOggVorbis(sample: any): Promise<any>;
     createAudioBuffer(voiceParams: any): Promise<any>;
-    createBufferSource(voiceParams: any, audioBuffer: any): any;
+    createBufferSource(voiceParams: any, renderedOrRaw: any): any;
     scheduleTimelineEvents(scheduleTime: any, queueIndex: any): any;
     getQueueIndex(second: any): number;
     resetAllStates(): void;
     updateStates(queueIndex: any, nextQueueIndex: any): void;
+    playAudioBuffer(): Promise<void>;
     playNotes(): Promise<void>;
     ticksToSecond(ticks: any, secondsPerBeat: any): number;
     secondToTicks(second: any, secondsPerBeat: any): number;
@@ -92,6 +101,7 @@ export class MidyGM1 extends EventTarget {
     stopActiveNotes(channelNumber: any, velocity: any, force: any, scheduleTime: any): Promise<any[]>;
     stopChannelNotes(channelNumber: any, velocity: any, force: any, scheduleTime: any): Promise<any[]>;
     stopNotes(velocity: any, force: any, scheduleTime: any): Promise<any[]>;
+    render(): Promise<null | undefined>;
     start(): Promise<void>;
     stop(): Promise<void>;
     pause(): Promise<void>;
@@ -114,12 +124,21 @@ export class MidyGM1 extends EventTarget {
     clampCutoffFrequency(frequency: any): number;
     setFilterEnvelope(note: any, scheduleTime: any): void;
     startModulation(channel: any, note: any, scheduleTime: any): void;
-    getAudioBuffer(channel: any, noteNumber: any, velocity: any, voiceParams: any, realtime: any): Promise<any>;
+    createAdsRenderedBuffer(note: any, voiceParams: any, audioBuffer: any, isDrum?: boolean): Promise<RenderedBuffer>;
+    createAdsrRenderedBuffer(note: any, voiceParams: any, audioBuffer: any, noteDuration: any): Promise<RenderedBuffer>;
+    createFullRenderedBuffer(channel: any, note: any, voiceParams: any, noteDuration: any, noteEvent?: {}): Promise<RenderedBuffer>;
+    getAudioBuffer(channel: any, note: any, realtime: any): Promise<any>;
+    getAdsCachedBuffer(channel: any, note: any, audioBufferId: any, realtime: any): Promise<any>;
+    getAdsrCachedBuffer(note: any, audioBufferId: any): Promise<any>;
+    getFullCachedBuffer(note: any, audioBufferId: any): Promise<any>;
     setNoteAudioNode(channel: any, note: any, realtime: any): Promise<any>;
     handleExclusiveClass(note: any, channelNumber: any, startTime: any): void;
     setNoteRouting(channelNumber: any, note: any, startTime: any): void;
-    noteOn(channelNumber: any, noteNumber: any, velocity: any, startTime: any): Promise<void>;
+    noteOn(channelNumber: any, noteNumber: any, velocity: any, startTime: any): Promise<any>;
+    createNote(channelNumber: any, noteNumber: any, velocity: any, startTime: any): Note;
+    setupNote(channelNumber: any, note: any, startTime: any): Promise<any>;
     disconnectNote(note: any): void;
+    releaseFullCache(note: any): void;
     releaseNote(channel: any, note: any, endTime: any): Promise<any>;
     noteOff(channelNumber: any, noteNumber: any, _velocity: any, endTime: any, force: any): any;
     setNoteIndex(channel: any, index: any): void;
@@ -143,7 +162,7 @@ export class MidyGM1 extends EventTarget {
         modLfoToVolume: (channel: any, note: any, scheduleTime: any) => void;
         chorusEffectsSend: (_channel: any, _note: any, _scheduleTime: any) => void;
         reverbEffectsSend: (_channel: any, _note: any, _scheduleTime: any) => void;
-        delayModLFO: (_channel: any, note: any, scheduleTime: any) => void;
+        delayModLFO: (channel: any, note: any, scheduleTime: any) => void;
         freqModLFO: (_channel: any, note: any, scheduleTime: any) => void;
         delayVibLFO: (_channel: any, _note: any, _scheduleTime: any) => void;
         freqVibLFO: (_channel: any, _note: any, _scheduleTime: any) => void;
@@ -189,4 +208,61 @@ export class MidyGM1 extends EventTarget {
     handleSysEx(data: any, scheduleTime: any): void;
     scheduleTask(callback: any, scheduleTime: any): Promise<any>;
 }
+declare class Channel {
+    constructor(audioNodes: any, settings: any);
+    isDrum: boolean;
+    programNumber: number;
+    scheduleIndex: number;
+    detune: number;
+    dataMSB: number;
+    dataLSB: number;
+    rpnMSB: number;
+    rpnLSB: number;
+    modulationDepthRange: number;
+    fineTuning: number;
+    coarseTuning: number;
+    scheduledNotes: any[];
+    sustainNotes: any[];
+    currentBufferSource: null;
+    state: ControllerState;
+    resetSettings(settings: any): void;
+}
+declare class RenderedBuffer {
+    constructor(buffer: any, meta?: {});
+    buffer: any;
+    isLoop: any;
+    isFull: any;
+    adsDuration: any;
+    loopStart: any;
+    loopDuration: any;
+    noteDuration: any;
+    releaseDuration: any;
+}
+declare class Note {
+    constructor(noteNumber: any, velocity: any, startTime: any);
+    voice: any;
+    voiceParams: any;
+    adjustedBaseFreq: number;
+    index: number;
+    ending: boolean;
+    bufferSource: any;
+    timelineIndex: null;
+    renderedBuffer: null;
+    fullCacheVoiceId: null;
+    filterEnvelopeNode: any;
+    volumeEnvelopeNode: any;
+    modLfo: any;
+    modLfoToPitch: any;
+    modLfoToFilterFc: any;
+    modLfoToVolume: any;
+    noteNumber: any;
+    velocity: any;
+    startTime: any;
+    ready: Promise<any>;
+    resolveReady: (value: any) => void;
+}
+declare class ControllerState {
+    array: Float32Array<ArrayBuffer>;
+}
+export {};
 //# sourceMappingURL=midy-GM1.d.ts.map

package/esm/midy-GM1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"midy-GM1.d.ts","sourceRoot":"","sources":["../src/midy-GM1.js"],"names":[],"mappings":"AAmHA;IAsCE;;;;;;;;;;;MAWE;IAEF,+BAgBC;IA9DD,gCAAgC;IAChC,aAAa;IACb,oBAAiB;IACjB,qBAAmB;IACnB,kBAAc;IACd,0BAAwB;IACxB,kBAAc;IACd,mBAAiB;IACjB,kBAAc;IACd,mBAAe;IACf,kBAAgB;IAChB,0BAAuD;IACvD,4BAAyB;IACzB,0BAAuB;IACvB,kCAA+B;IAC/B,qBAAqC;IACrC,4BAAiC;IACjC,mBAAkB;IAClB,mBAAkB;IAClB,kBAAiB;IACjB,oBAAmB;IACnB,mBAAkB;IAClB,iCAEG;IACH,cAAU;IACV,cAAa;IACb,iBAAY;IACZ,gBAAc;IACd,oBAAkB;IAClB,sBAAwB;IACxB,2BAAqC;IAiBnC,kBAAgC;IAChC,kBAA8C;IAC9C,eAAwD;IACxD,qBAGE;IACF,uBAAmD;IACnD;;;;;;;;;;;;MAA2D;IAC3D,6BAA+D;IAC/D,gBAAiD;IAMnD,mCASC;IAED,2DAYC;IAED,yCAmBC;IAED,oCASC;IAED,sBA6BC;IAED,8DAeC;IAED;;;;MAeC;IAED,yCAaC;IAED,2CAsBC;IAED,kDA6BC;IAED,4DASC;IAED,gEAsDC;IAED,mCASC;IAED,uBAUC;IAED,yDAqCC;IAED,2BA0EC;IAED,uDAEC;IAED,wDAEC;IAED,qCAKC;IAED;;;MAwDC;IAED,kGAeC;IAED,mGAeC;IAED,wEAQC;IAED,uBAMC;IAED,sBAIC;IAED,uBAMC;IAED,wBAIC;IAED,0BAKC;IAED,8BAMC;IAED,wBAYC;IAED,sBAIC;IAED,kEAWC;IAED,kFAYC;IAED,8BAEC;IAED,8BAEC;IAED,4BAEC;IAED,qCAMC;IAED,2DAIC;IAED,6CAEC;IAED,sDAeC;IAED,4DASC;IAED,qDAkBC;IAED,6CAIC;IAED,sDA6BC;IAED,kEAqBC;IAED,4GAkCC;IAED,uEAyCC;IAED,0EAiBC;IAED,oEASC;IAED,0FAwBC;IAED,gCASC;IAED,iEAwBC;IAED,4FAmBC;IAED,6CAUC;IAED,qDAUC;IAED,qFAeC;IAED,+BAmBC;IAED,kDAOC;IAED,sFA2BC;IAED,mFAGC;IAED,wFAGC;IAED,sEAUC;IAED,mEAYC;IAED,wDAKC;IAED,sDAOC;IAED,mDAMC;IAED,kDAKC;IAED;;;;;;;;;;;;MAoCC;IAED,oFAMC;IAED,6EA2BC;IAED,qCAeC;IAED,+FAYC;IAED,wDAUC;IAED,4EAKC;IAED,mEAKC;IAED;;;MAMC;IAED,gEAKC;IAED,uEAKC;IAED,sEAGC;IAED,2DAUC;IAED,yEAWC;IAED,kFAeC;IAED,2DAMC;IAED,uDAoBC;IAED,gDAEC;IAED,gDAEC;IAED,sEAGC;IAED,qEAKC;IAED,2EAUC;IAED,iEAMC;IAED,uEAQC;IAED,mEAKC;IAED,yEAQC;IAED,gFAGC;IAED,6CAqBC;IAGD,8EAgCC;IAED,gFAGC;IAED,+EAgBC;IAED,qCAUC;IAED,4EAaC;IAED,4DAGC;IAED,qDAKC;IAED,gDAYC;IAGD,6DAgBC;CACF"}
+{"version":3,"file":"midy-GM1.d.ts","sourceRoot":"","sources":["../src/midy-GM1.js"],"names":[],"mappings":"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"}