GNMIDI Benutzerfunktionen

sind Win32 DLL Bibliotheken, die als Plugin direkt in GNMIDI Professional Anwendung zum Konvertieren von einzelnen oder MIDI Verzeichnisse benutzt werden können.
GNMIDI enthält ein Demobenutzertool im Menü Konvertieren und Batchfunktionen, das man mit der GNMIDI Demo ausprobieren kann.
GNMIDI Screenshot

Neue Benutzerfunktionen können entsprechend ihren Anforderungen erstellt werden.
Einige Benutzerfunktionen sind direkt als Standardtools erhältlich.
Kontaktieren Sie den Autor, wenn Sie ein neues Tool oder ein standard MIDI Tool bestellen möchten. Es wird der Preis vor der Implementierung festgelegt.
Preise hängen von der Arbeitszeit für neu angefertigte Tools und von kommerzieller Verwendung (in Firmen) oder nichtkommerzielle private Verwendung (zuhause) ab.
Die meisten Benutzerfunktionen können direkt in GNMIDI 3 Professional Anwendung verwendet werden (GNMIDI 3 Professional Lizenz ist dazu notwendig und nicht inbegriffen).
Die Benutzertools funktionieren auch ohne GNMIDI mit der Anwendung gnbatchdialog (wird mitgeliefert).

Standard Benutzerfunktion toolreplacetext (Texte suchen und Ersetzen in MIDI Dateien)

Das Tool stellt eine Funktion zum mächtigen Suchen und Ersetzen von Texten in einer oder vielen MIDI Dateien zur Verfügung. Es unterstützt sowohl einfachste Textersetzungen als auch komplexe Reguläre Suchausdrücke bei Suche und beim Ersetzen und programmierte Bedingungen, um die Suchtreffer auf bestimmte erwünschte MIDI Befehle einzuschränken.
Eine Lizenz für toolreplacetext kostet 18 Euro (inkl. UST).

Optionen
Textart	Combobox	sucht und ersetzt Texte in allen MIDI META Textarten oder nur in MIDI Textbefehlen, die zur angegebenen Textart gehören (z.B. Spurtitel, Lyrik; Markierung ...). Copyright Befehle werden nicht ersetzt (zum Schutz der Copyright Benutzer).
Suchbegriff	Editbox	der zu suchende Begriff (oder Teilbegriff), der im Originaltext ersetzt werden muss. Wenn die Option Reguläre Suchausdrücke verwendet wird, dann muss die Editbox einen regulären Suchausdruck enthalten (z.B. [A-Z]+[0-9]+).
Ersetzen durch	Editbox	der Text, der den übereinstimmenden Suchbegriff ersetzen wird. Wenn die Option Reguläre Suchausdrücke verwendet wird, muss die Editbox einen die Regeln für die Spezialzeichen bei regulären Suchausdrücken einhalten (z.B: \\ für Backslash Zeichen).
Groß-/Kleinschreibung ignorieren	Checkbox	Wenn die Option Groß-/Kleinschreibung ignorieren verwendet wird dann passen die Suchbegriffe auch zu Texten mit anderer Groß/Kleinschreibung (z.B. AEIOU passt zu aeiou).
Nur ganze Treffer	Checkbox	Mit der Option Nur ganze Treffer muss der Suchbegriff mit dem gesamten Text eines MIDI Befehls übereinstimmen. Wenn der Suchbegriff nur mit einem Teil passt (auch wenn es nur um Leerzeichen unterschiedlich ist), dann wird diese Stelle nicht ersetzt.
Nur ganze Wörter	Checkbox	Mit der Option Nur ganze Wörter muss der Suchbegriff bei ganzen Wörter übereinstimmen. Ein Suchbegriff der mitten im Wort passt wird nicht ersetzt.
Reguläre Suchausdrücke (für Experten)	Checkbox	Wenn die Option Reguläre Suchausdrücke verwendet wird muss das Feld Suchbegriff und Ersetzen die Syntax für reguläre Suchausdrücke einhalten (z.B. \\ für Zeichen Backslash). Diese flexiblen Ausdrücke erlauben mächtigeres Suchen und Ersetzen. Die regulären Suchausdrücke unterstützen auch Gruppen mit Klammern (...) innerhalb des Suchbegriffs die Teilausdrücke als numerierte Gruppe definieren und innerhalb Suchbegriff per Nummer z.B: \1 referenziert werden können. Und auch im Ersetzen Ausdruck kann der zu einer Gruppe passende gefundene Text mittels Nummer verwendet werden z.B. $1 . Die Option sollte nur von Experten verwendet werden. Es benötigt etwas Erfahrung mit der Verwendung von Regulären Suchausdrücken (Tipp: benutzen Sie die Option Bestätigen, um Ausdrücke auszuprobieren und die Ergebnisse sofort am Bildschirm zu sehen)
Sonderzeichen umkodieren	Checkbox	mit dieser Option werden Sonderzeichen 80-FF in Hexadezimalschreibweise als Text Q_xHH_E umkodiert. Vor der Suche und nach der Suche im Ergebnistext. Da Reguläre Ausdrücke \xHH nur ASCII Werte 00-7F akzeptiert und einige Zeichen im Bereich 80-FF schwierig in die Editierbox eingegeben können kann diese Möglichkeit genutzt werden um diese Zeichen als anders geschriebene Texte zu suchen und ersetzen. z.B. Q_xC3_EQ_x84_E ist die UTF-8 Sequenz C3 84 für das UTF-8 kodierte Zeichen ä Verwenden Sie diese Option nur wenn sie diese Zeichen suchen oder ersetzen möchten.
Bestätige jeden möglichen Treffer	Checkbox	Mit der Option Bestätigen wird das Tool bei jedem Treffer eine Meldungsbox mit gefundenem und vorgeschlagenem Ersatztext anzeigen und den Benutzer fragen, ob es ersetzt werden soll. Der Benutzer muss mit Ja oder Nein oder Abbrechen antworten. Abbrechen beendet das gesamte Suchen und Ersetzen.
Keine Änderungen	Checkbox	Mit der Option Keine Änderungen wird die MIDI Datei bei Treffer nicht verändert sondern nur die Fundstellen und geplanten Ersetzungstexte in der Logdatei angegeben.
Ausführlich	Checkbox	Mit Option Ausführlich werden alle Fundstellen und Ersetzungen in der Logdatei aufgeführt.
Bedingung (für Programmierer)	Editbox	Das Tool erlaubt den Zugriff auf einige Informationen über die gefundenen MIDI Textbefehle und mittels der Programmiersprache C ähnlichen Ausdrücken können MIDI Befehle ausgeschlossen oder werden (Bedingung ergibt als Ergebnis true, dann wird die Fundstelle ersetzt). z.B. ev.startms >= 22000 && ev.startms <= 25000 (begrenzt die Fundstellen auf MIDI Befehle in einem bestimmten Zeitbereich). z.B. ev.text.toupper().containstext('COLD') (begrenzt die Fundstellen auf Felder die mitten drinnen irgendwo den Text COLD enthalten ohne Rücksicht auf die Groß/Kleinschreibung). Wenn die angegebene Bedingung nicht erfüllt ist dann wird die Fundstelle nicht ersetzt. Wenn die Bedingung ungültige Syntax hat dann bricht das Tool ab (Fehlermeldung in der Logdatei). Die Bedingungen sind sehr mächtig (und unterstützen auch Operatoren mit reguären Suchausdrücken). Standardmäßig wird keine Bedingung geprüft (Editbox ist leer).
Dokumentation	PDF (Englisch)	mit Beispielen

Standard Benutzertool toolreplacetextinfile

Das Tool stellt eine Funktion zum mächtigen Suchen und Ersetzen von Texten in einer oder vielen Textdateien (*.txt, *.csv, *.ini,...) zur Verfügung. Es unterstützt sowohl einfachste Textersetzungen als auch komplexe Reguläre Suchausdrücke bei Suche und beim Ersetzen und programmierte Bedingungen, um die Suchtreffer auf bestimmte erwünschte Textzeilen oder Textdokumente einzuschränken.
Eine Lizenz für toolreplacetext kostet 18 Euro (inkl. UST).

Optionen
Suchbegriff	Editbox	der Text, der den übereinstimmenden Suchbegriff ersetzen wird. Wenn die Option Reguläre Suchausdrücke verwendet wird, muss die Editbox einen die Regeln für die Spezialzeichen bei regulären Suchausdrücken einhalten (z.B: \\ für Backslash Zeichen).
Ersetzen durch	Editbox	der Text, der den übereinstimmenden Suchbegriff ersetzen wird. Wenn die Option Reguläre Suchausdrücke verwendet wird, muss die Editbox einen die Regeln für die Spezialzeichen bei regulären Suchausdrücken einhalten (z.B: \\ für Backslash Zeichen).
Groß-/Kleinschreibung ignorieren	check box	Wenn die Option Groß-/Kleinschreibung ignorieren verwendet wird dann passen die Suchbegriffe auch zu Texten mit anderer Groß/Kleinschreibung (z.B. AEIOU passt zu aeiou).
Nur ganze Treffer	Checkbox	Mit der Option Nur ganze Treffer muss der Suchbegriff mit dem gesamten Text (Zeile oder Dokument je nach Option Zeile für Zeile) übereinstimmen. Wenn der Suchbegriff nur mit einem Teil passt (auch wenn es nur um Leerzeichen unterschiedlich ist), dann wird diese Stelle nicht ersetzt.
Nur ganze Wörter	Checkbox	Mit der Option Nur ganze Wörter muss der Suchbegriff bei ganzen Wörter übereinstimmen. Ein Suchbegriff der mitten im Wort passt wird nicht ersetzt.
Reguläre Suchausdrücke (für Experten)	Checkbox	Wenn die Option Reguläre Suchausdrücke verwendet wird muss das Feld Suchbegriff und Ersetzen die Syntax für reguläre Suchausdrücke einhalten (z.B. \\ für Zeichen Backslash). Diese flexiblen Ausdrücke erlauben mächtigeres Suchen und Ersetzen. Die regulären Suchausdrücke unterstützen auch Gruppen mit Klammern (...) innerhalb des Suchbegriffs die Teilausdrücke als numerierte Gruppe definieren und innerhalb Suchbegriff per Nummer z.B: \1 referenziert werden können. Und auch im Ersetzen Ausdruck kann der zu einer Gruppe passende gefundene Text mittels Nummer verwendet werden z.B. $1 . Die Option sollte nur von Experten verwendet werden. Es benötigt etwas Erfahrung mit der Verwendung von Regulären Suchausdrücken (Tipp: benutzen Sie die Option Bestätigen, um Ausdrücke auszuprobieren und die Ergebnisse sofort am Bildschirm zu sehen)
Bestätige jeden möglichen Treffer	Checkbox	Mit der Option Bestätigen wird das Tool bei jedem Treffer eine Meldungsbox mit gefundenem und vorgeschlagenem Ersatztext anzeigen und den Benutzer fragen, ob es ersetzt werden soll. Der Benutzer muss mit Ja oder Nein oder Abbrechen antworten. Abbrechen beendet das gesamte Suchen und Ersetzen.
Sonderzeichen umkodieren	Checkbox	mit dieser Option werden Sonderzeichen 80-FF in Hexadezimalschreibweise als Text Q_xHH_E umkodiert. Vor der Suche und nach der Suche im Ergebnistext. Da Reguläre Ausdrücke \xHH nur ASCII Werte 00-7F akzeptiert und einige Zeichen im Bereich 80-FF schwierig in die Editierbox eingegeben können kann diese Möglichkeit genutzt werden um diese Zeichen als anders geschriebene Texte zu suchen und ersetzen. z.B. Q_xC3_EQ_x84_E ist die UTF-8 Sequenz C3 84 für das UTF-8 kodierte Zeichen ä Verwenden Sie diese Option nur wenn sie diese Zeichen suchen oder ersetzen möchten.
Keine Änderungen	Checkbox	Mit der Option Keine Änderungen wird die Text Datei bei Treffer nicht verändert sondern nur die Fundstellen und geplanten Ersetzungstexte in der Logdatei angegeben.
Ausführlich	Checkbox	Mit Option Ausführlich werden alle Fundstellen und Ersetzungen in der Logdatei aufgeführt.
Bedingung (für Programmierer)	Editbox	(standardmäßig: leer, keine Bedingung) erlaubt es eine Zusatzbedingung anzugeben in welchem Fall ein Treffer ersetzt werden darf. Bedingung kann die Zeilennummer (linenumbercondition) oder Zeile (line) oder Dateiname (filename) prüfen. z.B. line.toupper().containstext('COLD') && linenumber >= 10
Dokumentation	PDF (Englisch)	mit Beispielen

Standardbenutzertool toolmidinote

konvertiert eine MIDI Datei in leicht lesbaren Text für Benutzer (Beispiel Ergebnis Text) und Maschinen/Software (Beispiel Ergebnis Text).
Eine Lizenz für toolmidinote kostet 18 Euro (inkl. UST.).

Standardbenutzertool toolnote2mid

konvertiert eine Textdatei, die von toolmidinote erzeugt wurde, zurück in eine MIDI Datei.
Eine Lizenz für toolnote2mid kostet 18 Euro (inkl. UST.).

Standardbenutzertool toolmididmp

konvertiert eine MIDI file in leicht lesbaren Text (sortiert nach Takte) für Benutzer (Beispiel Ergebnis Text) und Machinen/Software (Beispiel Ergebnis Text).
Eine Lizenz für toolmididmp kostet 18 Euro (inkl. UST.).

Standardbenutzertool tooldmp2midi

konvertiert eine Textdatei die von toolmididmp erzeugt wurde, zurück in eine MIDI Datei.
Eine Lizenz für tooldmp2midi kostet 18 Euro (inkl. UST.).

Standardbenutzertool syx2midi

konvertiert eine .syx binäre Datei, die MIDI Befehle vom MIDI Protokoll enthält, in eine MIDI Datei.
Kann auch eine hexadezimale (Hexdump) Textdatei, die hexadezimale MIDI Befehle enthält, in eine MIDI Datei konvertieren.
Optional kann eine Pause von angegebener Dauer nach jedem Sysexbefehl eingefügt werden.
Eine Lizenz für toolsyx2midi kostet 18 Euro (inkl. UST.).

Standardbenutzertool midi2syx

konvertiert eine .mid Datei in eine binäre .syx Datei.
Eine Lizenz für toolmidi2syx kostet 18 Euro (inkl. UST.).

www.gnmidi.com

Kontakt