Products
Orders
Services
Impressum
Freeware
Links
Deutsch

GNMIDI User Tools

GNMIDI user tools

are Win32 DLL libraries that can be used as plugin inside GNMIDI application for converting single files or batch converting folders.
GNMIDI contains a demo user tool that demonstrates the usage of a tool in menu convert and batch conversions.
GNMIDI screenshot
New user tools can be programmed for your special needs.
Some user tools are directly available as standard tools.
Contact the author if you want to order a new programmed tool or a standard MIDI tool to get the price.
Price might depend on work time for new tools and commercial (company) or noncommercial private use.
The user tools can also be used within GNMIDI 3 Professional application (requires a GNMIDI 3 Professional license).
The tools also work without GNMIDI using tool gnbatchdialog (is included).

Standard user tool toolreplacetext

Mighty search and replace text in one or many MIDI files. It supports simple text replacing and regular expression searching and replacing and special programming conditions to reduce the matches to the wanted ones.
License for toolreplacetext costs 18 Euro (incl. vat).

Options
Text type combo box search and replace in all MIDI META text types or only in MIDI events with certain META text type (e.g. trackname, lyric, marker ...). copyright events are not replaced (for safety of copyright owners).
Pattern edit box the text (or part) that must be found in original text. When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Replace edit box the text (or part) that replaces the matching pattern.When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Ignore case check box When ignore case option is used the letters in pattern are also matching if the case is different (e.g. AEIOU matches aeiou).
whole match only check box Using whole match only option the pattern must match the whole text of a MIDI event. If pattern matches only a part of the text then it is ignored.
whole words only check box Using whole words only option the pattern must match whole words of text. If pattern matches a part inside a word it is ignored.
line by line check box each line is searched and replaced independent (is default). Otherwise the whole text is searched and replaced by one step (e.g. useful for multiple line search and replacing). The whole match only option has therefore sometimes meaning whole line or whole text.
Regular expressions (for experts) check box When using regular expressions then the pattern and replace option fields must contain regular expressions that allow mighty searching and replacing. The regular expressions support also groups using (...) inside pattern and referencing groups by number e.g. \1 inside pattern and also using the found text matching by a group inside replace text by number e.g. $1 . The option should be used by experts. It requires some experimenting with regular expressions (hint: use option confirm to see the results directly on screen)
confirm every possible match check box Using confirm option the tool will show a message box dialog for every found matching text and how it would be changed. The user must answer with yes or no or can abort the tool with cancel.
encodenotascii check box using this option converts characters 80-FF to hexadecimal text Q_xHH_E before searching and these code patterns back to characters in replaced result text.
Since regular expression \xHH only allows smaller ASCII code values 00-7F
and some character might be difficult to enter into the edit box this option gives possible access to these characters e.g. Q_xC3_EQ_x84_E is utf-8 sequence C3 84 for utf-8 character encoded Ä
Only use this option if your patterns or replace field uses these coding.
no changes check box Using no changes option the MIDI file will not be changed after having found matching patterns. It shows the matches and replacements only in the log file.
condition (for programmers) edit box The tool allows access to information about current matching MIDI text event and use expressions similar to C programming language in this field
e.g. ev.startms >= 22000 && ev.startms <= 25000      (that limits matches to the given time range in milliseconds).
e.g. ev.text.toupper().containstext('COLD')      (this limits matches to text that contain text part COLD independent on letter case).
If the condition is not matching then the match is not replaced. If the condition has invalid syntax then the tool aborts with an error message in log file.
The condition expressions are very mighty (including regular expressions operators).
By default no condition is checked (option is empty).
Documentation PDF (English) (including example expressions)

Standard user tool toolreplacetextinfile

Mighty search and replace text in one or many Text files (e.g. *.txt, *.csv, *.ini). It supports simple text replacing and regular expression searching and replacing and special programming conditions to reduce the matches to the wanted ones.
License for toolreplacetextinfile costs 18 Euro (incl. vat).

Options
Pattern edit box the text (or part) that must be found in original text. When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Replace edit box the text (or part) that replaces the matching pattern.When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Ignore case check box When ignore case option is used the letters in pattern are also matching if the case is different (e.g. AEIOU matches aeiou).
whole match only check box Using whole match only option the pattern must match the whole text of a line or full text. If pattern matches only a part of the text then it is ignored.
whole words only check box Using whole words only option the pattern must match whole words of text. If pattern matches a part inside a word it is ignored.
Regular expressions (for experts) check box When using regular expressions then the pattern and replace option fields must contain regular expressions that allow mighty searching and replacing. The regular expressions support also groups using (...) inside pattern and referencing groups by number e.g. \1 inside pattern and also using the found text matching by a group inside replace text by number e.g. $1 . The option should be used by experts. It requires some experimenting with regular expressions (hint: use option confirm to see the results directly on screen)
confirm every possible match check box Using confirm option the tool will show a message box dialog for every found matching text and how it would be changed. The user must answer with yes or no or can abort the tool with cancel.
encodenotascii check box using this option converts characters 80-FF to hexadecimal text Q_xHH_E before searching and these code patterns back to characters in replaced result text.
Since regular expression \xHH only allows smaller ASCII code values 00-7F
and some character might be difficult to enter into the edit box this option gives possible access to these characters e.g. Q_xC3_EQ_x84_E is utf-8 sequence C3 84 for utf-8 character encoded Ä
Only use this option if your patterns or replace field uses these coding.
no changes check box Using no changes option the text file will not be changed after having found matching patterns. It shows the matches and replacements only in the log file.
verbose check box All replacements to the text files are listed in the log file.
condition (for programmers) edit box (default: empty, no condition) allows to specify a condition in which case the match is accepted. condition can check linenumber or line or filename.
e.g. line.toupper().containstext('COLD') && linenumber >= 10
Documentation PDF (English) (including example expressions)
www.gnmidi.com © Günter Nagler Contact