View source for MIDI-OX

<div align="center"><span style="font-size: 22pt">MIDI-OX</span><br />''Version 7.0''<br />''Author: [[Jamie O'Connell]] and Jerry Jorgenrud''<br />''Developer: N/A<br />''2010-06-17''</div>

{{SoftwareInfobox
| Software = MIDI-OX
| Image = [[Image:MIDIOXLogo.png|190px]]<br />
''MIDI-OX'' Title Screen
| Version = 7.0
| ReleaseDate = {{2010}}-06-17<ref>http://www.midiox.com/moxdown.htm</ref>
| Company = {{NAToolCo}}
| DevStatus = {{MaintainedDev}}
| Published = {{Published}}
| Developers = {{JamieO'ConnellToolDev}}, Jerry Jorgenrud
| Interface = {{GUI}}
| ProgLanguage = {{C++}}
| OpenSource = {{ClosedSRC}}
| Source = {{NoSourceSW}}
| License = {{CopyrightedFreeware}}
| Type = {{MIDIUtil}}
| Engine = {{NAEngTool}}
| Platform = {{WinTool}}
| Localization = {{EnglishTool}}
| Website = [http://www.midiox.com www.midiox.com]
}}

<br />
==<br /> Description ==

<blockquote>
Jamie O'Connell and Jerry Jorgenrud's MIDI-OX is a multi-purpose tool: it is both a diagnostic tool and a System Exclusive utility. It can perform filtering of MIDI data streams. It displays incoming MIDI streams, and passes the data to a MIDI output driver or the MIDI Mapper. It can convert any type of MIDI message into almost any other type of MIDI message. You can generate MIDI data using the computer keyboard or the built-in control panel. You can even record and log MIDI data and then convert it to a Standard MIDI File for playback by a sequencer.
</blockquote>

==<br /> Features ==

<blockquote>
This is a list of features added after version 6. For the full history, see MIDIOX Change History.rtf
* Added an option to always place MIDI-OX in tray. When not minimized, this option will cause MIDI-OX to appear on the taskbar and animate in the tray simultaneously.
* Added an option to toggle MIDI-OX in tray. When minimized, clicking on the tray icon will show MIDI-OX. When restored, clicking on the tray icon will hide MIDI-OX.
* Added a facility to change the tray icons displayed for each instance of the application. Look inside the TrayIcon.zip file (installed to the application folder) for details.
* Added saving of a keyboard configuration profile, KEYNOTE.INI, when the keyboard is activated and the entries don’t exist.
* Added a new view: MIDI Port Routing. This view displays and configures In Port to Out Port mapping. It should be easier to understand than the MIDI Devices dialog routing, and can remain open and edited during a session.  To use it, you can connect Input and Output ports by dragging a line with the mouse. You can also right-click on ports or lines and select the appropriate command(s). Right-clicking on a line and choosing, Properties… allows configuration of the connection.
* Added custom color configuration for the MIDI Port Routing view into the Color Dialog.
* Added an indicator to the Routing View. When a connection is made, a color coded indicator button is displayed on the connection line. Clicking on this button opens the connection properties dialog.
* Added an optional command line argument, “/MinTray”. You can use this in a shortcut or command line to open MIDI-OX minimized in the Windows Tray.
* Revised parsing of INS files to handle Unix style (no carriage returns).
* Added user information to the About box and Installer.
* Made Patch map triggering Program changes route through the current (new) port and data maps.
* Added persistence for whether the monitor display is off or on.
* Further fixed some bugs in MTC transmit: it should roll over after hour 23, not 24! Added some verification and formatting of SMPTE values specified as a location offset.
* Separated the Port Map Realtime and Common flags, so that each can be specified without the other. The first Launch of the app after install will modify internal registry maps to match the new format. 
* Added support for mapping to and from RPNs (Registered Parameter Numbers).
* Added support for specifying delays in a map. You can specify that the mapped event be delayed by 0 – 1023 milliseconds (1000 milliseconds = 1 second). Each mapping step can have a delay and these delays are stored in .oxm and .txm maps, and displayed in the mapping view.
* Added an optional switch to the Patch Mapping facility, to decide whether to resend the Program change that triggered the map change. This was hard-coded to on earlier.
* Changed the way Patch Mapping is implemented: now a (slightly delayed) triggering Program change message is sent only to the new map (not the original) after it is loaded (if the above switch is enabled). The end result is that only one (or none) program change is sent and it is sent after a new map is loaded.
* Changed some logic in device openings, that may improve the experience of dealing with corrupt drivers.
* Allow Data Maps to be attached to MIDI-OX generated events: you can assign .oxm maps to internal port – output connections.
* Support for .TXM Map files has been added to the Scripting. You can now specify a .TXM file in LoadDataMap(FilePath)
* A StatusBar has been added to the SysEx View, and a progress meter will appear when lengthy operations are undertaken.
* An option has been added to the General Options dialog to color code messages by channel rather than by Event. The channel colors can be adjusted in the Colors Dialog.
* MIDI-OX now has visual styles enabled when running under Windows XP: it will use any current theme in effect.
* The MIDI Status View has been greatly enhanced to support data entry. Clicking on a cell now opens a slider. You can drag the slider with the mouse or use the cursor keys for fine adjustment. Support for Mouse Wheel has been added. You can center the slider by pressing INSERT. To dismiss the slider, either right-click or press ESC or ENTER.. When the Slider is displayed, clicking on another Cell will move it to the new location. Clicking outside any cell will remove it.
* The SysEx View will now provide syntax highlighting for SysEx Start (F0) as well as SysEx End (F7). In addition, you can adjust the highlight color using the Options | Colors… dialog. 
* Illegal/Bad SysEx values can be located by a new SysEx View menu command: Check Data. Out of range values are flagged by underlining.
* The installer has been rewritten, and the application now properly self-registers itself.
* MIDIBar has been enhanced. There is now a Loop button, as well as Rewind and Fast Forward to end buttons.
* Added custom color configuration for Active StatusBar items (Options | Colors…), and changed the defaults to yellow test on dark blue background. 
* Enhanced the Middle C Octave setting in General Options (1 – 7), and modified the Monitor display to show negative octaves.
* Added a TaskBar command to turn the global Data Map off and on.
* The MIDI Devices dialog is now resizable. The list boxes and trees will size themselves depending on the layout dimensions. 
* Added the capability of mapping System Realtime messages: Start, Continue and Stop.
* Added the capability to map System Common message: Song Position Pointer.
* Added support for toggling Status Bar items by clicking on the Status Bar: LOG, REC, SYX, KBD and MAP. When any of these items are on, the background is displayed in green. When an item is off, its text is grayed.
* Added the ability to associate Data Maps with each Output and Input port connection. You specify this in the Options | MIDI Devices… dialog: the Port Map Objects box now contains a list of all .oxm files in the Map directory. These objects can be dragged onto an input port in the tree.
* Added a new command: View | Current Map. It displays the parameters for the currently loaded map in the Monitor. Therefore, the map display can be copied and pasted from the clipboard.
* Added Import and Export of ASCII Data Maps. This is a new file type that describes a mapping using an ASCII File format. It’s designed for those who wish to use tools such as Perl or Python to generate maps.
* Added code to re-send the Patch Change that triggers a new Patch Mapping, after the new map and/or preset is loaded. This allows placing translations into the (new) map that anticipate receiving the patch change immediately after load.
* Added an Options | Folders… dialog to configure application folders.
* Added the ability to view both Input and Output ports in the Monitor (labeled: In and Port). This means that the output Monitor will now display each event output. If you have more than one output port hooked up and active, you will see more than one event output. The Input Monitor does not have any Output port associated so the Port field is blank in the input Monitor.
* Added an option to display the 1st 3 characters of the Device name instead of a port number in the Monitor. This allows you to create custom abbreviations for display of the ports in the Monitor.
* Added an option to display a custom background bitmap: open Options | Colors… and choose Custom.
* We now only display events in output monitor when data is output, or when the input monitor is closed.
* Mapping of Data Entry and NRPN controllers has changed slightly. If you now have no other NRPN mappings, you can map Data Entry (6, 38) as if it was any other controller.
* When changing the Monitor Font, all open monitors are now updated.
* A New scripting engine has been implemented. This scripting engine uses MIDI-OX as a COM server. The engine is compatible with Windows 98, Me, and 2000. Scripting information is documented in MOXScript.rtf and in the help files. Example Windows Script Host scripts in VBScript, JScript and Python have been placed in the MIDIOX\WSH directory during installation. If you want to use Python, you’ll have to install it: http://www.python.org.
* The Keyboard Piano has been made configurable. This should allow better usability for foreign keyboards. See the text comments in KeyNote.ini for details.
* The controllers sent during Panic, and their values have been made configurable. See the MOXLIB.ini file in the application directory for variable names and default values. Set any variable to -1 to cause the corresponding controller not to be sent at all (Pan is an example of this).
* A Discard option has been added for map targets. This allows using map statements to filter data with finer granularity than the global MIDI Filter.
* Aftertouch has been added to the MIDI Status view, and maps can be appended to the currently loaded map (versus replacement).
* MIDI Status configuration is now restored properly from Profiles.
* The name of the currently loaded Port Map preset is retained and displayed across sessions.
* Added SysEx logging for MF2T format.
* A Patch Mapping facility has been added: you can now have Data maps and/or Port maps swapped and loaded upon receiving an external Program Change message.
* The MIDI Status view has been significantly enhanced: you can now choose to display any controller as a column and specify column order. In addition a controller Snapshot send facility has been added, and you can save and restore Snapshot dumps.
* You can toggle on and off whether selected input ports are automatically attached to output ports as ports are selected.
* An option has been added to the Data Mapping dialog to allow a special NRPN mode. It has been reported that certain devices, such as the EMU APS require the Data Entry portion of the NRPN to be sent in reverse order from the MIDI spec. When sending a full 4 message NRPN, and option has been added to reverse Ctrl 38 and 6. To use this, first setup a NRPN to NRPN mapping (see: APS NRPN Reverse.oxm for an example), and then check Send Full NRPN and Reverse Data Entry.
* We extended the 255-character limit for SysEx items in a map: each can now be a maximum of 1022 bytes.
* Added simple substitution for SysEx map items: you can substitute in channel, data1 and data2 values from the MIDI message that triggered the SysEx item. See the Help file for details.
* Added the capability to delay mapped SysEx buffers by the amount specified in the SysEx window.
* MIDI-OX would sometimes crash when timing clock was streaming in during driver initialization. This has been repaired.
* This release greatly increases the number of MIDI device drivers supported. Until now MIDI-OX could only handle 24 input and 24 output devices at once. This number has been increased to 63 input and 63 output devices. 
* A File Association dialog has been added. Associations can be made with Maps and SysEx files. Associations can be added and removed. In addition an option is provided to associate MIDI files with MIDI Bar.
* MIDI-OX Command line options have been enhanced: you can now specify Map and SysEx files on the command line, as well as profiles.
* MIDI-OX now supports drag and drop of Map files, SysEx files, and Profiles.
* MIDIBar has been enhanced to (optionally) limit the applet to a single instance. If it is set to single instance and an associated MIDI file is launched, it is loaded into the running instance.
* A MIDI Sync feature has been added. You can now use MIDI-OX as a MIDI Sync master controller. It can also synchronize clock start with MTC. See the help files for details.
* Mapping has been enhanced. You can now trigger SysEx data events when specified MIDI messages are received. In addition you can receive, map and transmit NRPN events. See the help files for details.
* Fixed a bug regarding multiple mapping items. The system had been limited to 64 active mappings – it has been increased to 256, by default. A setting has been added to MOXLIB.INI to further control this behavior. In the [Options] section create a setting named MapItems. Example: Mapitems=384 ; Creates room for up to 384 mapping items.
* The display in the Mapping dialog has been improved: A bitmap is now used to display the All condition (asterisk). This fixes problems with non-U.S. versions of Windows.
* A feature has been added for selection and copying of text in the Monitor views to the Windows clipboard. To mark text, right-click in the monitor and choose Mark for Clipboard, or double-click, or ctrl-click in a monitor window. Drag a rectangle over the text to select. Next, right-click and choose, Copy to Clipboard, or press Enter. Then paste the text into any application.
* Two additional commands have been added: Select Window – selects all the text currently displayed in a monitor. Copy All -- will copy the entire contents of the monitor to the clipboard. This includes displayed and non-displayed messages.
* Added a secondary method for deleting port objects. Items in the Port Mapping view (Options | MIDI Devices...), now support a context menu with a Delete <item>.
* Enhanced the mapping feature: you can now duplicate an input event to allow multiple message mapping. You can use this feature to create a NRPN value from a single MIDI controller or chords from a single input MIDI note, among other things.
* Keyboard accelerator support has been added to MIDIBar. See the help file for more details.
* Added command line processing for MIDIBar – it can now accept a filename on the command line. You can setup custom shortcuts to play specific MIDI files or associate all MIDI files with MIDIBar in the Windows Explorer Shell.
* Fixed a Y2K problem with date display in the MIDI log.
* Changed the way dynamic menus are created for Banks and Patches in the Instrument Panel. This should fix a problem when running at very high screen resolutions.
* Added a raw MIDI messages display mode for the logfile. People have asked for a way to display Raw MIDI messages and cut and paste messages from the Monitor. This may be slightly less direct than that, but it works, and gives you a permanent record.
* Added some new (optional) controllers to the MIDI Status Window.
* Several fixes for the Instrument Panel for Bank Select methods other than Normal
</blockquote>

==<br /> Requirements ==

<blockquote>
<!-- Add requirements here -->
</blockquote>


==<br /> Version History ==

<div style="font-size: 12pt">'''Maintenance: Version 7.0.2'''</div><blockquote>
* SysEx handling has been improved.
* MIDI-OX will now support up to 128 MIDI Ports.
*  Port to port data maps now are unaffected by changes to other ports being opened or closed.</blockquote><div style="font-size: 12pt">'''New features: Version 7.0'''</div>
<blockquote>
* ''''''Added an option to always place MIDI-OX in tray. When not minimized, this option will cause MIDI-OX to appear on the taskbar and animate in the tray simultaneously.''' '''
* Added an option to toggle MIDI-OX in tray. When minimized, clicking on the tray icon will show MIDI-OX. When restored, clicking on the tray icon will hide MIDI-OX.''' '''
*  Added a facility to change the tray icons displayed for each instance of the application. Look inside the '''TrayIcon.zip''' file (installed to the application folder) for details.''''''
* Added saving of a keyboard configuration profile, '''KEYNOTE.INI''', when the keyboard is activated and the entries dont exist.''' '''
* Added a new view: '''MIDI Port Routing'''. This view displays and configures '''In Port''' to '''Out Port''' mapping. It should be easier to understand than the '''MIDI Devices''' dialog routing, and can remain open and edited during a session. To use it, you can connect Input and Output ports by dragging a line with the mouse. You can also right-click on ports or lines and select the appropriate command(s). Right-clicking on a line and choosing, '''Properties''' allows configuration of the connection.''''''
* Added custom color configuration for the '''MIDI Port Routing''' view into the Color Dialog.
* Added an indicator to the Routing View. When a connection is made, a color coded indicator button is displayed on the connection line. Clicking on this button opens the connection properties dialog.
* Added an optional command line argument, '''/MinTray'''. You can use this in a shortcut or command line to open MIDI-OX minimized in the Windows Tray.
* Revised parsing of INS files to handle Unix style (no carriage returns).
* Added user information to the About box and Installer.
* Made Patch map triggering Program changes route through the current (new) port and data maps.
* Added persistence for whether the monitor display is off or on. &nbsp;
* Further fixed some bugs in MTC transmit: it should roll over after hour 23, not 24! Added some verification and formatting of SMPTE values specified as a location offset.
* Separated the Port Map Realtime and Common flags, so that each can be specified without the other. The first Launch of the app after install will modify internal registry maps to match the new format.
* The HTML help file has been updated.
* Added support for mapping to and from '''RPNs''' (Registered Parameter Numbers).''' '''
* Added support for specifying '''delays''' in a map. You can specify that the mapped event be delayed by 0  1023 milliseconds (1000 milliseconds = 1 second). Each mapping step can have a delay and these delays are stored in .oxm and .txm maps, and displayed in the mapping view.
* Added an optional switch to the '''Patch Mapping''' facility, to decide whether to resend the Program change that triggered the map change. This was hard-coded to '''<i>on</i>''' earlier.''' '''
* Changed the way Patch Mapping is implemented: now a (slightly delayed) triggering '''Program change''' message is sent <i>only</i> to the new map (not the original) <i>after</i> it is loaded (if the above switch is enabled). The end result is that only one (or none) program change is sent and it is sent after a new map is loaded.'''''' 
* Changed some logic in device openings, that may improve the experience of dealing with corrupt drivers.''' '''
* Allow Data Maps to be attached to '''MIDI-OX''' generated events: you can assign .'''<i>oxm</i>''' maps to internal port  output connections.''''''.
</blockquote><div style="font-size: 12pt">'''Maintenance: Version 6.5.1'''</div>
<blockquote>
* A bug involving initializing the events sent during Panic Reset has been fixed
* Support for .TXM Map files has been added to the Scripting.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>You can now specify a .TXM file in '''LoadDataMap(FilePath)'''
* A StatusBar has been added to the SysEx View, and a progress meter will appear when lengthy operations are undertaken.''' '''
* A bug in SysEx handling has been fixed in the Scripting engine.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>Dumps received when using buffers larger than 256 bytes had been corrupted.
* An option has been added to the General Options dialog to color code messages by channel rather than by Event. The channel colors can be adjusted in the Colors Dialog.
</blockquote><div style="font-size: 12pt">'''New features and fixes: Version 6.5'''</div>
<blockquote>
* Added the ability to associate '''Data Maps''' with each Output and Input port connection. You specify this in the '''Options | MIDI Devices''' dialog: the '''Port Map Objects''' box now contains a list of all .oxm files in the Map directory. These objects can be dragged onto an input port in the tree.
* Added a new command: '''View | Current Map. '''It displays the parameters for the currently loaded map in the Monitor. Therefore, the map display can be copied and pasted from the clipboard.
* Added '''Import''' and '''Export''' of ASCII Data Maps. This is a new file type that describes a mapping using an ASCII File format. Its designed for those who wish to use tools such as Perl or Python to generate maps.
* Added code to re-send the '''Patch Change''' that triggers a new '''Patch Mapping''', after the new map and/or preset is loaded. This allows placing translations into the (new) map that anticipate receiving the patch change immediately after load.
*  Added an '''Options | Folders''' dialog to configure application folders.
* Added the ability to view both Input and Output ports in the Monitor (labeled: '''In''' and '''Port'''). This means that the output Monitor will now display each event output. If you have more than one output port hooked up and active, you will see more than one event output. The Input Monitor does not have any Output port associated so the '''Port''' field is blank in the input Monitor.
* Added an option to display the 1<sup>st</sup> 3 characters of the Device name instead of a port number in the Monitor. This allows you to create custom abbreviations for display of the ports in the Monitor.
* The MIDI Status View has been greatly enhanced to support data entry. Clicking on a <i>cell</i> now opens a '''slider'''. You can drag the slider with the mouse or use the cursor keys for fine adjustment. To dismiss the slider, either right-click or press '''ESC. '''
* The ''' MIDI Status''' View has been further enhanced.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>Support for '''Mouse Wheel''' has been added.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>You can center the slider by pressing '''INSERT'''. To dismiss the slider, either right-click or press '''ESC''' or '''ENTER'''.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>When the Slider is displayed, clicking on another Cell will move the slider to the new location.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; 
</span>Clicking outside of any cell will dismiss it.
* The SysEx View will now provide syntax highlighting for SysEx Start (F0) as well as SysEx End (F7). In addition, you can adjust the highlight color using the '''Options | Colors''' dialog. ''' '''
* Illegal/Bad SysEx values can be located by a new SysEx View menu command: '''Check Data'''. Out of range values are flagged by underlining.''' '''
* A new SysEx View menu command has been added: '''Select All '''
* While fixing a bug regarding the registration of the COM scripting interface, it became apparent that the existing installer wouldnt do it. The installer has been rewritten, and the application now properly self-registers itself. 
* Added an option to display a custom background bitmap: open '''Options | Colors''' and choose '''Custom'''.
* Fixed a bug associated with mapping when pulling Data1 into the target Data2 position while interpolating. Also fixed pulling Data2 to Data1 while interpolating.
* We now only display events in output monitor when data is output, or when the input monitor is closed.
* The MIDI Devices dialog is now resizable. The list boxes and trees will size themselves depending on the layout dimensions.
* <span style="font -style: normal; font -variant: normal; font -weight: normal; mso-bidi-font -weight: bold">&nbsp;</span>Changed the way the Map Dialog list box was laid out. This should repair bugs associated with columns not lining up.''' '''
* Repaired a bug where ASCII map channel numbers were imported as one higher than specified.''' '''
* Added the capability of mapping System Realtime messages: '''Start''', '''Continue''' and '''Stop. '''
* Added the capability to map System Common message: '''Song Position Pointer'''.
* MIDIBar has been enhanced. There is now a '''Loop''' button, as well as '''Rewind''' and '''Fast Forward''' to end buttons.''' '''
* A bug in command line processing has been fixed.''' '''
* The HTML help file has been updated.
* The appearance of the LEDs in the Port Status view has been changed on high color systems.
* Added custom color configuration for Active StatusBar items (Options | Colors), and changed the defaults to yellow test on dark blue background.
* Enhanced the Middle C Octave setting in General Options (1  7), and modified the Monitor display to show negative octaves.
* Added a TaskBar command to turn the global Data Map off and on.
* '''MIDI-OX''' now has visual styles enabled when running under Windows XP: it will use any current theme in effect.
* Added support for toggling Status Bar items by clicking on the Status Bar: '''LOG''', '''REC''', '''SYX''', '''KBD''' and '''MAP'''. When any of these items are on, the background is displayed in green. When an item is off, its text is grayed.
</blockquote><div style="font-size: 12pt">'''Maintenance: Version 6.4.2'''</div>
<blockquote>
* Mapping of Data Entry and NRPN controllers has changed slightly. If you now have no other NRPN mappings, you can map Data Entry (6, 38) as if it was any other controller.''' '''
* MIDI-OX sometimes seems to reuse the wrong instance number, when loading the next instance after a crash. The instance number logic has been changed to account for this. 
* When changing the Monitor font , all open monitors are now updated.
* Fixed two problems associated with Instrument Definitions: 1) Prevent infinite recursion when a Bank is <i>based on</i> itself. 2) Repair parsing of certain .INS files.
*  Repaired a problem when loading '''Profiles''': the <i>PortMap</i> was not always properly obeyed.Repaired a display problem in MIDI devices, when loading from a Preset and [x] Auto-attach is off.
* Fixed a bug in the display of Windows MIDI System errors. 
* Fixed a bug in the Port Status display view when events arrive simultaneously.
* The installer has been re-written to use the Windows Installer.&nbsp; It is much more robust. 
</blockquote>
<div style="font-size: 12pt">'''Maintenance: Version 6.4.1'''</div>
<blockquote>
* This is purely a maintenance release: a small, but annoying SysEx bug has been repaired. After choosing '''Send/Receive SysEx''', re-sending the result from the Display Window would sometimes send only the first message of a multi-part SysEx message.
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.4'''</div>
<blockquote>
* A New scripting engine has been implemented.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>This scripting engine uses MIDI-OX as a COM server.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>The engine is compatible with Windows 98, Me, and 2000. Scripting information is documented in '''MOXScript.rtf '''and in the help files.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>Example Windows Script Host scripts in VBScript, JScript and Python have been placed in the '''MIDIOX\WSH''' directory during installation.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; 
</span>If you want to use Python, youll have to install it: [http://www.python.org http://www.python.org] .
* The Keyboard Piano has been made configurable. This should allow better usability for foreign keyboards. See the text comments in '''KeyNote.ini''' for details.
* The controllers sent during Panic, and their values have been made configurable.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>See the '''MOXLIB.ini''' file in the application directory for variable names and default values.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>Set any variable to '''-1''' to cause the corresponding controller not to be sent at all (Pan is an example of this).
* A '''Discard''' option has been added for map targets.<span style="mso-spacerun: yes; mso-fareast-font -family: Times New Roman; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">&nbsp; </span>This allows using map statements to filter data with finer granularity than the global MIDI Filter..
* '''Aftertouch'''has been added to the MIDI Status view, and maps can be appended to the currently loaded map (versus replacement).
* '''MIDI Status '''configuration is now restored properly from''' Profiles.'''
* The name of the currently loaded '''Port Map''' preset is retained and displayed across sessions.
* Added SysEx logging for '''MF2T''' format.
* Repaired bug in restoring '''Data Maps''' from INI Profiles.
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.3'''</div>
<blockquote>
* A '''Patch Mapping '''facility has been added: you can now have data maps and/or port maps loaded upon receiving an external Program Change message.
* The '''MIDI Status''' view has been significantly enhanced: you can now choose to display <i>any</i> controller as a column and specify column order. In addition a controller Snapshot send facility has been added, and you can save and restore Snapshot dumps.
* You can toggle on and off whether output ports are automatically attached to input ports as ports are selected.
* An option has been added to the '''Data Mapping''' dialog to allow a special NRPN mode. It has been reported that certain devices, such as the Emu APS require the Data Entry portion of the NRPN to be sent in reverse order from the MIDI spec. When sending a full 4 message NRPN, and option has been added to reverse Ctrl 38 and 6. To use this, first setup a NRPN to NRPN mapping (see: '''APS NRPN Reverse.oxm''' for an example), and then check '''Send Full NRPN''' and '''Reverse Data Entry'''.
* Miscellaneous bug fixes and improvements
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.2'''</div>
<blockquote>
* We extended the 255 character limit for SysEx items in a map: each can now be a maximum of 1022 bytes.
* Added simple substitution for SysEx map items: you can substitute in channel, data1 and data2 values from the MIDI message that triggered the SysEx item. See the Help file for details.
* Added the capability to delay mapped SysEx buffers by the amount specified in the SysEx Window.
* MIDI-OX would sometimes crash when timing clock was streaming in during driver initialization.This has been repaired.
* Repaired a problem where MIDI-OX would incorrectly map a ?pull from data 2? item when NRPNs were being mapped.
* Data entry values were being filtered when a pass-through map was in effect.They will now be passed along unhampered.
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.1.4'''</div> 
<blockquote>
* This release greatly increases the number of MIDI device drivers supported.Until now MIDI-OX could only handle 24 input and 24 output devices at once.This numberhas been increased to 63 input and 63 output devices.In addition MIDI Yoke will now present up to 16 distinct application ports.Each MIDI Yoke port can be opened by up to 4 applications on each end (input and output).
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.1.3'''</div> 
<blockquote>
* This is solely a maintenance release. Attempts have been made to better deal with hot-swapping of USB devices. In general, we have found that Windows 98/ME handling of USB MIDI devices works OK as long as the devices are switched on at boot time and left attached while the system is running. When MIDI USB devices are removed while the system is running, the driver is also removed from memory (even if it is open and being used by a program!). Remaining drivers may be renumbered on the fly, when USB devices are added or removed from the system, and this can cause all sorts of problems with existing software. Having said that, we now make an attempt to clean up, close and reopen drivers when device changes are detected.
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.1.2'''</div> 
<blockquote>
* A File Association dialog has been added.Associations can be made with Maps and SysEx files. Associations can be added and removed.In addition an option is provided to associate MIDI files with MIDI Bar.
* MIDI-OX Command line options have been enhanced: you can now specify Map and SysEx files onm the command line, as well as profiles.<span style="font-size: 11.0pt; font-family: Times New Roman">&nbsp;</span>&nbsp;
* MIDI-OX now supports drag and drop of Map files, SysEx files, and Profiles.
* MidiBar has been enhanced to (optionally) limit the applet to a single instance.If it is set to single instance and an associated MIDI file is launched, it is loaded into the running instance.<span style="font-size:11.0pt">  </span>
* A scripting bug was fixed: you can now reattach an instance after detaching it.<span style="font-size:11.0pt">  </span>
</blockquote> 
<div style="font-size: 12pt">'''New features: Version 6.1'''</div> 
<blockquote>
* <span style="font-size:11.0pt">A MIDI Sync feature has been added.You can now use MIDI-OX as a MIDI Sync master controller.It can also synchronize clock start with MTC.See the help files for details.</span>
* <span style="font-size:11.0pt">Mapping has been enhanced.You can now trigger SysEx data events when specified MIDI messages are received.In addition you can receive, map and transmit NRPN events. See the help files for details.</span>
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 6.0.5'''</div> 
<blockquote>
* Fixed a bug regarding multiple mapping items. The system had been limited to 64 active mappings ? it has been increased to 256, by default. A setting has been added to MOXLIB.INI to further control this behavior. In the [Options] section create a setting named MapItems. Example: Mapitems=384 ; Creates room for up to 384 mapping items
* The display in the Mapping dialog has been improved:&nbsp; A bitmap is now used to display the <em>All</em> condition (asterisk).&nbsp; This fixes problems with non-U.S. versions of Windows.
* A feature has been added for selection and copying of text in the Monitor views to the Windows clipboard. To mark text, right-click in the monitor and choose '''Mark for Clipboard''', or double-click, or ctrl-click in a monitor window. Drag a rectangle over the text to select. Next, right-click and choose, '''Copy to Clipboard''', or press '''Enter'''. Then paste the text into any application.
* Two additional commands have been added: '''Select Window '''? selects all the text cuurrently displayed in a monitor. '''Copy All''' -- will copy the entire contents of the monitor to the clipboard. This includes displayed and non-displayed messages.
* Added a secondary method for deleting port objects. Items in the Port Mapping view ('''Options | MIDI Devices...'''), now support a context menu with a '''<u>D</u>elete &lt;item&gt;'''.
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 6.0.4'''</div> 
<blockquote>
* Fixed a bug regarding extremely dense SysEx data.
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 6.0.3'''</div> 
<blockquote>
* Keyboard accelerator support has been added to '''MidiBar'''.&nbsp; See the help file for more details.
* Enhanced the mapping feature: you can now duplicate an input event to allow multiple message mapping. You can use this feature to create a NRPN value from a single MIDI controller or chords from a single input MIDI note, among other things. See the help file for more details.
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 6.0.2'''</div> 
<blockquote>
* Fixed a nasty bug associated with selection and use of the MIDI Mapper.
* Added command line processing for MidiBar ? it can now accept a filename on the command line. You can setup custom shortcuts to play specific MIDI files or associate all MIDI files with MidiBar in the Windows Explorer Shell.
* Fixed a Y2K problem with date display in the MIDI log.
* Changed the way dynamic menus are created for Banks and Patches in the Instrument Panel. This should fix a problem when running at very high screen resolutions.
* Added a raw MIDI messages display mode for the logfile. People have asked for a way to display Raw MIDI messages and cut and paste messages from the Monitor. This may be slightly less direct than that, but it works, and gives you a permanent record.
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 6.0.1'''</div> 
<blockquote>
* Added some new (optional) controllers to the MIDI Status Window.
* Several fixes for the Instrument Panel for Bank Select methods other than 'Normal'
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 6.0'''</div> 
<blockquote>
* Customizable Port Names have been added wherever MIDI Ports are displayed.
* HTML Help is now supplied (and used if you have HTML Help installed)
* Support for WSH (Windows Script Host''' '''-- see MOXScript.rtf for details).
* SysEx input event sinks and polling methods have been added to the scripting interface.
* Instrument Panel supporting Cakewalk Instrument Definition files.
* MIDI Port Status view ? It now shows activity for each channel plus real-time and Sysx.
* Multiple Output ports and enhanced MIDI Devices dialog.
* A comparison (diff'ing) feature has been added to the SysEx view.&nbsp; This allows you to compare both panes for sameness.&nbsp; To use this, select '''SysEx | Compare Windows'''.&nbsp;&nbsp; Different bytes are underlined. You can undo the underlining with '''SysEx | Undo error formatting'''.
</blockquote> 
<div style="font-size: 12pt">'''Maintenance: Version 5.5.1'''</div> 
<blockquote>
* Tooltips have been repaired.
* Launchable Profiles have been repaired.
* A bug preventing stand-alone launch of the new MidiBar has been repaired.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.5'''</div> 
<blockquote>
* The MIDI Status window has been enhanced. Several new controllers have been added. You can configure which columns are shown: '''Options | Configure Status... '''Scroll bars have been added to the Window.
* You can now display SysEx data in the Monitor Windows. You can enable and disable this feature in the filter dialog.
* MIDI-OX will now store up to 16 unique instance profiles in the registry.
* MIDI-OX supports saving and loading of user profiles: '''File | Save Profile... '''and''' File | Load Profile... '''A user profile can be specified on the MIDI-OX command line. Example: '''midiox mprof.ini'''
* The Monitor Window now displays known Controller types by name.
* The Monitor Window will now show GM patch names. This can be turned off if desired '''(Options | General?).'''
* An MCI MIDI File player '''(MIDIBar)''' has been added to the Actions menu. This is a separate applet that can be run outside of MIDI-OX or it can send it?s output to MIDI-OX if you use a routing driver such as MIDI Yoke.
* A capability of sending MIDI using running status has been added. This is useful mostly to test the behavior of MIDI drivers: it is still up to the driver whether to send the data to the hardware using running status, but output drivers are supposed to be capable of handling running status.
* A Running status info command has been added: '''View | Running Status?''' It displays whether running status output has been enabled, and the current status it has calculated, regardless.
* Updated versions of '''MIDI Yoke''' for Windows 95/98/NT. These now handle running status correctly as well as a few other bug fixes. To update your MIDI Yoke drivers, un-install the old ones and reboot. Then install the new ones and reboot.
* GM, GS, and XG Reset commands have been added to the action menu and the Taskbar context menu.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.13'''</div> 
<blockquote>
* '''Object REXX Scripting. '''A major new feature has been added: the ability to create and run IBM Object REXX programs on MIDI data from within MIDI-OX. If you have the IBM Windows 95/NT version of Object REXX installed, a new menu option is available: '''Actions | Run REXX... '''See the '''MIDI REXX.rtf''' file for more details, as well as the help file. Several example REXX scripts are installed with the program.
* '''SysEx Improvements.''' SysEx data handling has been improved considerably and made much more robust at the system level. In addition, the SysEx view will now display F7 bytes in a separate color.
* '''New Wallpaper.''' New background wallpaper has been added plus a way to turn it off: '''Options | Colors... Remove background bitmap'''.
* '''System Change.''' The main executable has been renamed from MIDIOX32.EXE to MIDIOX.EXE. In addition several data subdirectories are now created by the installer. For this reason, we recommend that you de-install any older MIDI-OX installations before installing this one.
* '''Monitor Enhancement.''' Known MIDI controller messages are now named in the Monitor window
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.08'''</div> 
<blockquote>
* '''Mapping Enhancement. '''A mapping feature has been added to allow swapping and extending of MIDI data bytes. The Map list box dialog is now color-coded.
* '''MIDI-OX''' now places itself on the '''Cakewalk''' Tools menu.
* '''Bank Select.''' Bank select capabilities have been added to the control panel. It can send Normal (LSB, MSB), LSB only or MSB only messages and patch changes. In addition, a Bank select column has been added to the Status window.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.07'''</div> 
<blockquote>
* '''MIDI Logging. '''The Log file dialog has been enhanced, and a view option has been added.
* '''MIDI Monitor.''' The monitor will now display note key names for polyphonic aftertouch.
* '''Patch Panel.&nbsp; '''MIDI-OX The Control Panel has been enhanced and a Program change, patch panel has been added.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.06'''</div> 
<blockquote>
* '''A SMPTE/MTC Send and Receive view has been added. You can use MIDI-OX as a master MTC device.
* '''MIDI data scratchpad.''' A raw MIDI scratchpad has been added to the SysEx View.
* '''Minimized instance can be hosted by the taskbar tray.''' MIDI-OX now offers an option to minimize to the taskbar tray. When it is running in this configuration, the taskbar icon is animated when MIDI data is received.
* '''Save and Restore of Window layouts.''' MIDI-OX now saves and restores the windows layout for each instance.
* '''Input/Output Sysx buffers separated.''' Sysx Buffers have been separated into Input and Output buffers: you can specify size and number for each.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.03'''</div> 
<blockquote>
* '''MIDI-OX Does NT.''' MIDI-OX will now operate under Windows NT 4.0. It may very well work with earlier versions of Windows NT as well, but hasn't been tested with it. MIDI-OX decides at run-time which operationg system is running and then loads the proper DLLs. This means there is only one download and installation: MIDI-OX 5.03 works on both operating systems.
* '''MIDI Yoke NT Beta drivers'''. Beta NT MIDI Yoke drivers are supplied with MIDI-OX 5.03. Installation instructions are provided with the program.
</blockquote> 
<div style="font-size: 12pt">'''NEW FEATURES: Version 5.0'''</div> 
<blockquote>
* '''Raw MIDI input monitor.''' A second MIDI monitor screen has been added to the display. The new monitor displays pre-filtered, unmapped MIDI input by default (you can choose to have it filtered if you want).
* '''Context menus'''. On almost every window, context menus have been added ? you access them by right-clicking over the window.
* '''Windows Help File'''. An extensive help file has been added to the product. You can access it via the Help menu or by pressing F1.
* '''MIDI Data Mapping.''' A MIDI message mapper has been added. This feature allows you to alter almost any MIDI message in real time: you can map channels, message types, and message values. Very powerful! Several mapping file examples have been provided to get you started.
* '''Choose Fonts and Colors.''' Intermediate versions of MIDI-OX provided some of this capability, but the program now offers extensive control over colors and fonts in both the Monitor windows and the SysEx view.
* '''Hex or Decimal monitor display.''' You can alternate between Hex and Decimal display in monitors -- you can have one monitor display hex and the other one show decimal.
* '''New Toolbar tools.''' New tools have been added to the toolbar. Note: if you have a previously installed version you may have to use the Customize toolbar option to see and add them. This is because MIDI-OX has already stored the current toolbar state into the Window registry.
* '''Full Windows Registry usage'''. MIDI-OX has been changed to store all of it?s settings in the Windows registry. The first time you run the new version, it will migrate your INI file settings to the registry.
* '''Panic button'''. A Panic button has been added to the main menu and toolbar. If you ever get stuck MIDI notes or controllers, pressing this button will send note off?s for every key on every channel and zero common controllers.
* '''MIDI to Text Logging.''' A special output logging format has been added, When a session is recorded using this format, the resulting output can be can be supplied as input to the '''T2MF''' freeware program to create a Standard MIDI file of the performance. See [http://www.midiox.com/app.htm#t2mf Text to MIDI] and the Help file for more information.
</blockquote>
</blockquote>

==<br /> Development Status ==

<blockquote>
MIDI-OX is currently maintained by [[Jamie O'Connell]] and Jerry Jorgenrud
</blockquote>

==<br /> Options ==

<blockquote>
<!-- Add options here -->
</blockquote>

<div id="DL">
==<br /> Download ==

<blockquote>
Download from here:
* [http://www.midiox.com/moxdown.htm www.midiox.com/moxdown.htm] <span class="DLInfo"> (ZIP file) [896 KB]</span>
</blockquote>

==<br /> Known Issues ==



==<br /> Credits ==

* [[Jamie O'Connell]] - [mailto:JamieOConnell@midiox.com JamieOConnell@midiox.com]
* Jerry Jorgenrud - [mailto:jorgenrud@attglobal.net jorgenrud@attglobal.net]

==<br /> Legal ==

<blockquote>
MIDI-OX is copyrighted freeware: this means individuals in non-commercial environments can freely use it.  Commercial licenses are available, and can be purchased on-line at the MIDI-OX web-site

MIDI-OX IS  PROVIDED WITHOUT ANY WARRANTY, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO FITNESS FOR A PARTICULAR PURPOSE.


Copyright © 1996-2004 by Jamie O'Connell and Jerry Jorgenrud
</blockquote>

==<br /> References ==

<references /><!-- Do not edit this section. It is autopopulated by <ref></ref> tags -->

==<br /> Also See ==

* [[:Category:MIDI Utilities|MIDI Utilities]]
* [[Sound Resource (SCI)|Sound Resources]]
* [[SCI Specifications: Chapter 1 - Introduction#SND|Sound Resources in the SCI Specifications]]
* [[:Category:Sound Resources|Sound Resource Articles]]
* [[:Category:Patch Resources|Patch Resource Articles]]
* [http://www.midiox.com www.midiox.com]
&nbsp;
[[Category:Technical Info]]
[[Category:Development]]
[[Category:Development Tools]]
[[Category:Sound Resources]]
[[Category:Patch Resources]]