ekmelib

Download ekmelib 2.4

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 Dokumenten) unterstützen. Schwerpunkte sind:

  • Mikrotonalität:
    Ekmelib ist gedacht vor allem für mikrotonale Beispiele (Skalen, Intonations­übungen usw.), insbesondere im Ekmelischen, d.h. im 72-stufigen temperierten Tonsystem (72-ET).
  • Textform:
    Musikbeispiele sind als Tonfolgen in Textform gegeben. Diese können direkt in HTML Dokumenten (in ekmaudio und ekmscore Elementen) oder in URLs angegeben werden, ohne separate Audiodateien oder Streaming Audio. Benutzereigene Tonfolgen können einfach mit einem Textfeld in einer Webseite eingegeben werden.
  • Einfachheit:
    Die Skripte implementieren eine einfache Wiedergabe (in einem Kanal) und Notensatz, die in modernen Browsern ohne spezielle Plugins funktionieren. Die Wiedergabe basiert auf der Web Audio API. Die Notenanzeige verwendet die Ekmelos Schriftart.

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 und sind mit JSMin minimiert (für schnellen 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.

Player

Der Player enthält folgende Elemente:

  • Ein 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)".
  • Ein 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 Notenanzeigen (zum Anspielen einzelner Noten) im selben Dokument gemeinsam verwendet.
  • Ein Schalter zum Erweitern aller Variablen in der Tonfolge.
  • Ein 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.
  • Ein 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.
  • Ein Schalter zur Notenanzeige, falls vorhanden (d.h. falls das entsprechende Skript in der Webseite inkludiert ist). Siehe Player mit Notenanzeige (Englisch).
  • Ein Link zur Syntax von Tonfolgen, die in einem eigenen Browser-Fenster geöffnet wird.
  • Eine Anzeige der verstrichenen Zeit in Schritten der gespielten Töne, numerisch und als Balken, und eine Anzeige der Gesamtdauer.
  • Ein 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:

  • Eine Notenzeile für jede Stimme in der Tonfolge. Die Notenzeilen können horizontal gescrollt werden, wenn sie nicht in die Anzeige passen, während die Notenschlüssel (d.h. die Notenzeilen-Präfixe) fixiert bleiben. Scrolling findet entweder über die eingeblendeten Scroll-Schalter oder automatisch während der Wiedergabe des assoziierten Players statt.
  • Anklickbare Notenzeilen-Präfixe (Bereich mit dem Notenschlüssel) zum Ein/Ausblenden der Stil-Parameter:
    • Notenschlüssel: Violin-, Bass-, Altschlüssel.
    • Notationsstil: Hängt vom Tonsystem ab; z.B. für 72-ET: Pfeil-, Richter Herf / Maedel-, Sims-, Sagittal-, Wyschnegradsky-Notation u.a..
    • Versetzungszeichenstil: Bestimmt die Regeln der Notation von Versetzungs­zeichen: immer (vergessend), traditionell, modern, neo-modern, dodekafonisch u.a.. 1
    • Wiedergabedauer einer angeklickten Note: 1 bis 4 Sekunden oder Dauerton.
  • 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).
  • Töne die als Frequenz oder Proportion in der Tonfolge angegeben sind, werden durch "generische" Notenköpfe [] und <> über der untersten Notenlinie dargestellt.
  • Eine optionale Beschriftung (z.B. Notenname) unter jeder Note / Akkord, und ein Label unter jedem Notenschlüssel.

Weiter zum HTML ekmscore Element (Englisch)

  1. Der Begriff des Versetzungszeichenstils und die Namen wurden von LilyPond übernommen, außer "default", weil "immer (vergessend)" geeigneter ist für die typische Verwendung von ekmelib mit mikrotonalen Skalen und Intonations­übungen.