ekmelib

Download ekmelib 2.0

Hinweis: Dies ist eine gekürzte Fassung der Dokumentation zu ekmelib, ohne Beschreibung des HTML ekmaudio und ekmscore Elements und ohne Beispiele. Siehe die englische Dokumentation.

Ekmelib ist eine Sammlung von Skripten (JavaScript und CSS), welche die Einbettung einfacher Audio- und Noteninhalte in Webseiten (HTML-Dokumente) unterstützen – gedacht vor allem für mikrotonale Beispiele, Skalen, Intonations­übungen usw., insbesondere für das 72-stufige temperierte (72-ET, ekmelische) Tonsystem.
Es funktioniert in modernen Browsern und benötigt weder spezielle Plugins (wie QuickTime), noch Audiodateien, Streaming Audio, oder Grafikdateien. (Die Wiedergabe basiert auf der Web Audio API.)

Ekmelib bietet vorgefertigte Skripte für die wichtigsten Anwendungsfälle – nur Player, nur Notenanzeige, oder beide kombiniert – jeweils in Englisch und Deutsch. Sie befinden sich im Verzeichnis pre des ekmelib-Pakets. Sie sind mit JSMin minimiert für einen schnelleren Download. Daneben können andere Wiedergabe- und Notensatz-Engines gebildet werden, z.B. um ein anderes Tonsystem oder andere Notennamen zu implementieren, unter Verwendung der Skripte im Verzeichnis dev.

Siehe auch die Seiten Hörbeispiele von Tonfolgen, Stimmungen einiger Werke, Einführung und Ekmelische Reihen, welche ekmelib verwenden, sowie den separaten Ekmelik-Player (ist jetzt Teil von ekmelib).

Aktivieren Sie bitte JavaScript in Ihrem Browser für den Player und die Notenanzeige.
Ihr Browser unterstützt leider keine Web Audio-Wiedergabe.

Tonfolgen

Eine Tonfolge ist in Textform gegeben, z.B. in einem Texteingabefeld oder mit dem seq Attribut in einem HTML ekmaudio oder ekmscore Element. Sie kann beliebig lang sein; entweder einstimmig oder mehrstimmig mit bis zu 16 Stimmen. Beachten Sie, dass der Player die Tonfolge immer in einem Kanal (Mono) wiedergibt und die Notenanzeige nur die erste Stimme anzeigt.

Siehe die Syntax von Tonfolgen. Sie ist die gleiche, sowohl für den Player als auch für die Notenanzeige.

Player

Der Player enthält folgende Elemente:

  • Schalter zum Minimieren/Öffnen des Players. Im minimierten Player ist nur die "Abspielen" oder "Stopp" Taste sichtbar.
  • Transporttasten für "Abspielen", "Stopp", "Pause/Fortsetzen", "Halten/Fortsetzen", "Vorherige Markierung", "Nächste Markierung", und "Wiederholung (Schleife)".
  • Schalter zum Ein/Ausblenden der Audio-Parameter:
    • Lautstärke: Die Anzeige des Lautstärkepegels ist zugleich ein Umschalter zwischen Prozent (%) und Dezibel (dB).
    • Verstimmung: Die Anzeige des Cent-Werts ist zugleich ein Schalter zum Rücksetzen des Werts auf Null.
    • Oszillatortyp (Wellenform): Sinus, Sägezahn, Rechteck, Dreieck.
    Die Audio-Parameter werden von allen Playern und Noten (zum Anspielen einer einzelnen Note) im selben Dokument gemeinsam verwendet.
  • Schalter zum Erweitern aller Variablen in der Tonfolge.
  • Schalter zum Ein/Ausblenden der Variablenliste. Sie enthält die bisher geladenen Variablen und optional alle online verfügbaren Variablen. Eine ausgewählte Variable wird mit \ in die Tonfolge eingefügt.
    Die Variablenliste wird von allen Playern im selben Dokument gemeinsam verwendet.
  • Schalter zum Ein/Ausblenden der Fehlermeldungen. Bei Auswahl eines Fehlers (z.B. "Unbekannter Notenname") wird im Texteingabefeld zu jener Stelle (Note) gesprungen, an der der Fehler aufgetreten ist.
  • Schalter zur Notenanzeige, falls vorhanden (d.h. falls das entsprechende Skript in der Webseite inkludiert ist). Siehe Player und Notenanzeige (Englisch).
  • Link zur Syntax von Tonfolgen, die in einem eigenen Browser-Fenster geöffnet wird.
  • Anzeige der verstrichenen Zeit in Schritten der gespielten Töne, numerisch und als Balken, und Anzeige der Gesamtdauer.
  • Textfeld zur Eingabe der Tonfolge.
    Beachten Sie, dass Änderungen des Textes während der Wiedergabe keine Auswirkung haben. Sie werden erst bei der nächsten Wiedergabe berücksichtigt.

Weiter zum HTML ekmaudio Element (Englisch)

Notenanzeige

Die Notenanzeige enthält folgende Elemente:

  • Schalter zum Öffnen/Schließen der Stil-Parameter:
    • Notenschlüssel: Violin-, Bass-, Altschlüssel.
    • Notationsstil: abhängig vom Tonsystem; z.B. für 72-ET: Pfeil-, Richter Herf / Maedel-, Sims-, Sagittal-, Wyschnegradsky-Notation u.a..
    • Versetzungszeichenstil: immer (vergessend), traditionell, modern, neo-modern, dodekafonisch u.a..
    • Wiedergabedauer einer angeklickten Note: 0,5 bis 3 Sekunden oder Dauerton.
  • Einzelne Notenzeile mit variabler Länge.
  • Anklickbare Noten / Akkorde, um diese einzeln anzuspielen. Eine weitere Betätigung während der Wiedergabe stoppt diese (nützlich vor allem bei Einstellung auf Dauerton).
  • Optionale Beschriftung (z.B. Notenname) unterhalb der Notenzeile für jede Note / Akkord und für die gesamte Anzeige (Label) unter dem Notenschlüssel.
  • Schalter für horizontales Scrolling einer überlangen Notenzeile, während der Notenschlüssel fixiert bleibt.

Weiter zum HTML ekmscore Element (Englisch)