Importieren von Samples

Napo 5.9, das erstmalig in EuleOrgan 1.0 eingesetzt wird, führt die folgende neue Funktionalität ein:

Sample-Dateien einer App können an drei Stellen gespeichert sein: In den Documents der App, der Library der App und den Resources der App. Die App sucht an allen drei Orten nach Sample-Dateien, in der genannten Reihenfolge, und nimmt immer die als erste gefundene Datei.
Samples können in die Library importiert werden. Drei Arten von Importquellen werden unterstützt: Verzeichnisse, RAR-Archive, ZIP-Archive. In EuleOrgan können Sie dies verwenden, um die Register zu importieren, die nicht Teil der ausgelieferten App sind, vorausgesetzt, Sie besitzen das Sample-Set. Das Importverfahren ist auch ein Weg, um Patches für einzelne Sample-Dateien zu verteilen.

Lageplätze für Samples

Einige weitere Erläuterungen zu den drei Orten, die als Repositories für Sample-Dateien verwendet werden können:

Resources

Die Resources sind Teil des ausgelieferten App-Bundles. Sie erlauben der App nur lesenden Zugriff, und darin enthaltene Dateien sind nicht für Anwenderzugriff gedacht. Bei jedem Update der app werden die Resources neu heruntergeladen und ersetzen die vorige Version. In den Napo-Apps, die vor Napo 5.9 entwickelt wurden, enthalten die Resources alle benötigten Sample-Dateien. Dies ist der Grund dafür, daß jede Aktualisierung dieser Apps einen große Menge herunterzuladender Daten mit sich bringt, was ein Ärgernis ist, dessen wir uns bei zukünftigen Apps gerne entledigen würden.

Library

Die Library ist ein Ort, an dem die App Daten speichern kann, die bei App-Aktualisierungen erhalten bleiben sollen. Sie ist ebenfalls nicht für Anwenderzugriff gedacht. In Napo 5.9 und später werden importierte Sample-Dateien in der Library abgelegt. Wenn eine Sample-Datei in der Library vorhanden ist, dann wird diese Datei und nicht die Version aus den Resources geladen.

Documents

Die Dateien in den Documents sind Anwendern mittels der Files-App (iOS) oder des Finders (macOS) zugänglich. Sie bleiben ebenfalls bei Aktualisierungen der App erhalten. Wenn eine Sample-Datei in den Documents vorhanden ist, dann wird diese Datei und nicht die Version aus der Library oder den Resources verwendet. Aufgepaßt: Wenn Sie Sample-Dateien zu den Documents hinzufügen, wird eine Napo-App dies erst bei ihrem nächsten Start bemerken, und wenn Sie Sample-Dateien in den Documents verändern oder löschen, während die App läuft, wird sie vermutlich Fehlermeldungen anzeigen und muß neu gestartet werden. Abgesehen von besonderen Umständen und für vorübergehende Zwecke empfehlen wir nicht, die Documents als Ort für Sample-Dateien zu verwenden. Lieber importieren Sie die Dateien in die Library. Falls Sie aber Sample-Dateien in den Documents ablegen möchten, muß dies in einer besonderen Verzeichnisstruktur geschehen, die unten beschrieben ist.

Im Info-Tab der Einstellungen-Sicht gibt es einen Eintrag Dateistatistik und einen Knopf Zeigen. Dieser zeigt eine Übersicht über die Anzahl und Größe der Sample-Dateien an jedem der drei möglichen Orte, aufgeschlüsselt nach 16- und 24-Bit-Dateien, und zusätzlich gibt es Angaben über Dateien, die gegenwärtig von der App verwendet werden.

Wenn Sie alle Register mit 24 Bits in EuleOrgan importiert haben, sieht die Tabelle zum Beispiel so aus:

Wie Sie sehen können, werden die 16-Bit-Dateien, die mit der App in ihren Resources geliefert wurden, nicht mehr verwendet. Statt dessen verwendet die App die importierten Dateien, die in der Library sind. Im Eule Szombathely-Sample-Set gibt es acht 16-Bit-Dateien. Napo wandelt diese nicht auf 24 Bit, weil dies keinen Nutzen hätte. Napo kann ohne weiteres mit einem Gemisch von 16- und 24-Bit-Dateien arbeiten.

Hätte Sie den Import mit 16 Bits gemacht, dann hätte die App nur diejenigen Dateien importiert, die nicht in den Resources inbegriffen sind.

Die Knöpfe Alle Dateien zeigen und Benutzte Dateien zeigen liefern weitere Einzelheiten, nämlich die Namen, Änderungszeiten und Bitbreiten der Dateien. Ab Napo 5.16 zeigt Benutzte Dateien zeigen außerdem die Frequenzwerte, die den WAV-Dateien der Pfeifen entnommen wurden. Wenn die WAV-Datei einer Pfeife keine Tonhöhendaten enthält, dann wird die Frequenz aus der Eigenstimmung der Orgel berechnet, was durch Klammern () um den Frequenzwert angedeutet wird.

Importfunktionen

Nach dem Auswählen des Eintrags Samples importieren des Aktionsmenüs der Einstellungen-Sicht, erhälten Sie ein weiteres Aktionsmenü mit den folgenden Einträgen:

Dokumentenverzeichnis zeigen: Diesen Eintrag gibt es nur unter macOS. Er zeigt die Documents der App im Finder and macht es Ihnen so einfacher, in diesem Verzeichnis Importquellen abzulegen.
Importquelle wählen: Wählen Sie dies, wenn Sie Sample-Dateien aus einer Importquelle, die Sie in den Documents der App abgelegt haben, importieren möchten. Es wird Ihnen eine Liste der gefundenen Importquellen angezeigt: Unterverzeichnisse von und RAR/ZIP-Dateien in den Documents. Wählen Sie eine Importquelle, entscheiden Sie zwischen 16 und 24 Bits Importqualität und mit oder ohne Schleifenüberblendung, und der Import läuft los. Schleifenüberblendung meint ein kurzes (256 Frames) lineares Überblenden beim Übergang vom Schleifenende zum Schleifenanfang. Es schadet nicht und kann hörbare Schleifenübergänge glätten. Es hilft nicht, wenn es an dieser Stelle eine deutliche Unstetigkeit der Signalleistung gibt.
Ab Napo 5.18 hat dieses Fenster rechts oben einen Knopf Andere Orte. Mit diesem können Sie Importquellen von anderswo als dem Dokumentenverzeichnis der App wählen, auch vom iCloud Drive oder von einem USB-Laufwerk. Falls Sie die App gelegentlich löschen und neu installieren, ist es ratsam, die Dateien mit den Sample-Sets oder Patches nicht im Dokumentenverzeichnis abzulegen, weil dieses zusammen mit der App gelöscht wird.
Importierte Samples löschen: Wählen Sie dies, wenn Sie alle importierten Sample-Dateien aus der Library entfernen möchten. Die App wird dann auf die Sample-Dateien in den Resources zurückfallen (wenn es nicht entsprechende Dateien in den Documents gibt). Registerknöpfe, für die es keine Sample-Dateien gibt, werden aus der Spieltisch-Sicht entfernt.

Verzeichnistrukturen

Wenn Sie nicht beabsichtigen, selbst Importquellen zu erstellen oder die Documents als Repository für Sample-Dateien zu verwenden, brauchen Sie sich um das Folgende nicht zu kümmern.

Verzeichnisstruktur in Importquellen

Eine Napo-App kann mit Importquellen (Verzeichnisse oder RAR/ZIP-Archive) umgehen, bei denen die Dateien wie im zugrundeliegenden Sample-Set angeordnet sind. Nur die hinteren Teile des Dateipfads sind wesentlich. Mit zwei Dateien von EuleOrgan als Beispiel, wird der folgende Aufbau erwartet, wobei xxx beliebig ist. Für die Hauptdatei:


	      xxx/near_dry/I-01-Prinzipal8/036-c.wav

Für die Release-Datei:


	      xxx/near_dry/I-01-Prinzipal8/L/036-c.wav

Gegenwärtig ist EuleOrgan die einzige App, bei der die Releases in getrennten Dateien sind und die Hauptdatei nur die Teile Attack und Loop enthält. Bei den anderen Apps gibt es nur die Hauptdatei, die Attack, Loop und Release enthält.

Verzeichnisstuktur in den Repositories

In den Repositories liegen die Dateien in einem Unterverzeichnis Samples. Dies bedeutet, wenn Sie Sample-Dateien im Verzeichnis Documents ablegen wollen, müssen sie wie folgt angeordnet sein (wobei wieder EuleOrgan als Beispiel benutzt ist):


	      ./Samples/near_dry/I-01-Prinzipal8/036-c.wav

	      ./Samples/near_dry/I-01-Prinzipal8/L/036-c.wav

Anmerkungen

Für den Importvorgang müssen die Importquellen in den Documents der App abgelegt sein. Bei macOS-Apps kann dies mit dem Finder erledigt werden. Bei iOS-Apps verwenden Sie die Files-App oder verbinden Sie das Gerät mit einem Mac-Computer und benutzen den Finder.
Bewahren Sie immer eine Kopie Ihrer Importquellen an einem sicheren Ort auf. Vergessen Sie nicht, daß die Documents einer App verloren gehen, wenn Sie die App löschen.
Für den Umgang mit RAR- und ZIP-Dateien setzt Napo UnRarKit und SSZipArchive ein. Die Lizenzdateien beider Werkzeuge werden mit den Napo-Apps ausgeliefert und können mittels des Menüeintrags Über die App der Einstellungen-Sicht angesehen werden.