Pakete, Repositories und App-Kategorien suchen

Paketdetailsv2.0.0

dart_melty_soundfont

Ein Soundfont-Synthesizer (also '.sf2'-Player), der rein in Dart geschrieben ist.

AndroidiOSmacOSWindowsLinux
30-Tage-Downloads
2060
Likes
51
Pub-Punkte
140

Paket installieren

flutter pub add dart_melty_soundfont

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Eine reine Dart-Implementierung eines Soundfont-Synthesizers, der .sf2-Audiosamples abspielt und somit plattformübergreifende Musikwiedergabe in Flutter-Anwendungen ermöglicht. Speziell für Entwickler konzipiert, die hochwertige Instrumentenklange ohne native Abhängigkeiten integrieren möchten. Das Paket unterstützt mehrere Plattformen wie Android, iOS, macOS, Windows und Linux und ist daher ideal für Musikanwendungen, die tragbare Tonverarbeitung erfordern. Es nutzt die Stärke von Dart, um Echtzeit-Audio-Rendering mit minimalem Aufwand zu ermöglichen.

Anwendungsfälle

  • Wiedergabe von MIDI-Dateien mit benutzerdefinierten Instrumentenklangen
  • Musikbildung-Apps erstellen
  • Interaktive Musikinstrumente in Flutter erstellen
  • Integration von abgetasteten Instrumentenbibliotheken
  • Entwicklung von plattformübergreifenden Audioanwendungen

Hauptmerkmale

  • Reine Dart-Implementierung
  • Unterstützt .sf2-Soundfont-Dateien
  • Plattformübergreifende Kompatibilität
  • Echtzeit-Audiosynthese
  • Leicht und einfach zu integrieren
  • Kein natives Code erforderlich

Geeignet für

  • Flutter-Entwickler, die Musik-Apps erstellen
  • Lernsoftware mit interaktiven Audioinhalten
  • Apps, die portable Instrumentenklange benötigen
  • Projekte, die plattformspezifische Audio-Bibliotheken vermeiden
  • Entwickler, die Code-Einfachheit und Portabilität priorisieren

Hinweise

  • Die Leistung kann sich auf gering leistungsfähigen Geräten unterscheiden
  • Große .sf2-Dateien erhöhen den Speicherverbrauch
  • Beschränkt auf SoundFont 2.0-Format
  • Erfordert sorgfältige Verwaltung von Audio-Ressourcen
  • Nicht für komplexe Polyphonie oder fortgeschrittene Effekte optimiert

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

dart_melty_soundfont is a SoundFont synthesizer (i.e. '.sf2' player) written in pure Dart.

It is a port of MeltySynth (C#, MIT License) written by Nobuaki Tanaka, to Dart.

https://github.com/sinshu/meltysynth

Dependencies

This package has no dependencies.

Maintanence

This project was specifically designed to not require maintanence, in large part by not having any dependencies. Apart from breaking changes to the Dart language (rare), it should be solid code that works for decades. It will work on any Dart SDK sdk>=2.12 indefinitely.

This package was written against Dart SDK 2.16.1.

Example

Synthesize a simple chord:

// Necessary Imports
import 'package:dart_melty_soundfont/dart_melty_soundfont.dart';
import 'package:flutter/services.dart' show rootBundle;

// load sf2
ByteData bytes = await rootBundle.load('assets/akai_steinway.sf2');

// Create the synthesizer.
Synthesizer synth = Synthesizer.loadByteData(bytes, 
    SynthesizerSettings(
        sampleRate: 44100, 
        blockSize: 64, 
        maximumPolyphony: 64, 
        enableReverbAndChorus: true,
    ));

// optional: print available instruments (aka presets)
List<Preset> p = synth.soundFont.presets;
for (int i = 0; i < p.length; i++) {
  String instrumentName = p[i].regions.isNotEmpty ? p[i].regions[0].instrument.name : "N/A";
  print('[preset $i] name: ${p[i].name} instrument: $instrumentName');
}

//  optional: select first instrument (aka preset)
synth.selectPreset(channel: 0, preset: 0);

// turn on some notes
synth.noteOn(channel: 0, key: 72, velocity: 120);
synth.noteOn(channel: 0, key: 76, velocity: 120);
synth.noteOn(channel: 0, key: 79, velocity: 120);
synth.noteOn(channel: 0, key: 82, velocity: 120);

// create a pcm buffer
ArrayInt16 buf16 = ArrayInt16.zeros(numShorts: 44100 * 3);

// render the waveform (1 second)
synth.renderMonoInt16(buf16);

// turn off a note
synth.noteOff(channel: 0, key: 72, velocity: 120);

// render another second
synth.renderMonoInt16(buf16);

Synthesize notes from a MIDI file playback:

// Necessary imports
import 'package:dart_melty_soundfont/dart_melty_soundfont.dart';
import 'package:flutter/services.dart' show rootBundle;

// Load the soundfont file
ByteData bytes = await rootBundle.load('assets/akai_steinway.sf2');

// Create the synthesizer
Synthesizer synth = Synthesizer.loadByteData(bytes);

// Load MIDI file from asset
ByteData midiBytes = await rootBundle.load('assets/arabesque.mid');
MidiFile midiFile = MidiFile.fromByteData(midiBytes);

// Start MIDI playback
MidiFileSequencer sequencer = MidiFileSequencer(synth);
sequencer.play(midiFile, loop: false);

// Change the playback speed.
sequencer.speed = 1.5;

// Render 10 seconds of playback into PCM buffer
ArrayInt16 buf16 = ArrayInt16.zeros(numShorts: 44100 * 10);
sequencer.renderMonoInt16(buf16);

Playing Sound

This library does not audibly make sound, it only generates the PCM waveform.

To actually hear something, you need to pass the generated PCM waveform to your device's speakers using PCM.

See the Example App for a flutter_pcm_sound + dart_melty_soundfont example.

Isolates

It is recommended to do your audio rendering in isolates or using compute. This will keep your UI fast & prevent audio stuttering.

Features

  • No memory allocation in the rendering process.

  • Wave synthesis

    • [x] SoundFont reader
    • [x] Waveform generator
    • [x] Envelope generator
    • [x] Low-pass filter
    • [x] Vibrato LFO
    • [x] Modulation LFO
  • MIDI message processing

    • [x] Note on/off
    • [x] Bank selection
    • [x] Modulation
    • [x] Volume control
    • [x] Pan
    • [x] Expression
    • [x] Hold pedal
    • [x] Program change
    • [x] Pitch bend
    • [x] Tuning
  • Effects

    • [x] Reverb
    • [x] Chorus
  • Other things

    • [x] Standard MIDI file support
    • [x] Loop extension support
    • [x] Performance optimization

License

DartMeltySoundFont is available under the MIT license.

References

  • SoundFont® Technical Specification
    http://www.synthfont.com/SFSPEC21.PDF

  • Polyphone Soundfont Editor
    Some of the test cases were generated with Polyphone.
    https://www.polyphone-soundfonts.com/

  • Freeverb by Jezar at Dreampoint
    The implementation of the reverb effect is based on Freeverb.
    https://music.columbia.edu/pipermail/music-dsp/2001-October/045433.html

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden