Copyright (c) 2010-2017, WADA Masashi All rights reserved.
Web: https://osdn.jp/projects/miditrail/
Mail: yknk@users.osdn.me
1. Introduction
2. System requirement
3. How to start
4. Usage
5. Setting
6. Restriction
7. Copyright and license
8. Appendix
9. History
MIDITrail is a MIDI player which provides 3D visualization of MIDI data sets.
You can enjoy not only listening but also viewing.
MIDITrail supports SMF format 0/1, and multiple MIDI ports.
MIDITrail is available for Windows, Mac OS X and iOS.
Screenshot: PianoRoll3D
Screenshot: PianoRollRain
Device: iPad, iPhone, iPod touch
OS: iOS 8.0
When the MIDI data sets contains a great number of notes, MIDITrail needs more performance graphics.
MIDITrail supports Standard MIDI File (Format0/1).
You have to transfer MIDI files to your iOS device from Mac or PC.
Connect your iOS device to Mac or PC, and launch iTunes. Then you can transfer MIDI files using 'File Sharing'.
MIDITrail does not have software synth.
You have to prepare sound module which supports CoreMIDI.
There are two ways as shown below:
The first way is to connect MIDI interface device and external sound module.
(e.g. iRig MIDI, i-MX1, etc.)
The second way is to use Synth App which supports 'Virtual MIDI Port' and 'Background Mode'.
(e.g. Sound Canvas for iOS, bs-16i, etc.)
When you finished preparing sound module, launch MIDITrail and select MIDI OUT device.
When you select 'MIDI Files' tab, MIDI files stored in your iOS device will be displayed.
You have to transfer MIDI files to your iOS device from Mac or PC in advance.
When you touch a MIDI file, MIDITrail will load the file and open the main screen.
You can start and stop music by touching buttons.
You can move the camera by swiping screen.
When you select 'MIDI IN Monitor' tab and touch 'Start Monitoring' button, MIDITrail will open the main screen.
You can see data sets received from MIDI IN device in real time on the main screen.
You have to select the MIDI IN device for monitoring in advance.
If you enable the MIDITHRU, MIDITrail will send data sets received from MIDI IN to MIDI OUT while monitoring.
NOTE: MIDITrail can not record data sets received from MIDI IN.
When select 'Setting' tab, setting items will be displayed.
Select view mode.
Select items which display in main screen.
Select MIDI OUT device.
At least, you must select the MIDI OUT device of "Port A". Ordinary MIDI datasets is sent to "Port A".
If you want to play the MIDI datasets which uses multiple ports, you must select the MIDI OUT device of port B, C, and so on.
To play the MIDI datasets which uses multiple ports, it is necessary to prepare multiple MIDI sound modules.
Select MIDI IN device for monitoring.
MIDITHRU: MIDITrail will send data sets received from MIDI IN to MIDI OUT while monitoring.
Character Encoding: Select character encoding of MIDI file. That will be used when display the title of MIDI file.
Image File: If you want to display the background image, select the image file.
You have to transfer image files to your iOS device from Mac or PC, by using iTunes's 'File Sharing'.
The extension of the image file must be .jpg or .png.
The maximum size of the image is 4096 x 4096 pixels.
If you use the sound module which delays sound, the sound and display may not synchronize.
MIDITrail renders all notes of the MIDI file in real time.
If the MIDI file has a great number of notes, the load of rendering becomes high.
In order to enjoy the MIDI file which contains tens of thousands of notes comfortably,
you have to use iOS device which has high performance graphics.
In specification of SMF (Standard MIDI File), a method to select port is not defined.
However there is the unofficial method (*1) to select port.
MIDITrail supports that method, but may be unable to play the MIDI file.
It depends on the MIDI file.
(*1) Meta event (FF 21 01 pp) is the command to select port.
MIDITrail can't open the MIDI file whose delta time represents actual time.
WADA Masashi holds the copyright of MIDITrail.
MIDITrail is released under the BSD license.
Copyright (c) 2010-2017, WADA Masashi <yknk@users.osdn.me> All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the author nor the names of its contributors
may be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
(a) The structure of "Piano roll 3D" visualization
When MIDITrail open the MIDI data sets uses multiple ports, unused port will be not displayed.
For example, if the MIDI data sets uses port A, C and E,
MIDITrail displays port A, C and E side by side, and omits port B and D.
(b) The structure of "Piano Roll Rain" visualization
When MIDITrail open the MIDI data sets uses multiple ports,
only piano keyboards of port A will be displayed.
However piano roll bars of all ports will be displayed.
The piano roll bar will move with change of pitch bend.
Some MIDI animation works are using pitch bend to shift the piano roll bars without change keys.
If the MIDI animation is not displayed correctly,
please disable the 'Pitch Bend Motion' to fix the piano roll bars.
Date | Version | Changelog |
---|---|---|
2012/03/17 | Ver.0.0.0 |
Development start. It based on the source code of MIDITrail Ver.1.2.0 for Mac OS X. |
2012/08/05 | Ver.1.0.0 |
First formal release for iOS. #29179 MIDITrail for iOS development. |
2014/01/19 | Ver.1.0.1 |
#32933 Merged features of MIDITrail Ver.1.2.1 for Mac OS X #32367 Added view mode "Piano Roll Rain 2D" #32427 Added note color assignment to active key #32915 Added support for iPhone5 #32916 Added ability to import files from other apps #32941 Changed Base SDK to iOS6.1 #30548 Fixed bug. (At the start of playback, MIDI data transmission is blocked) |
2017/2/12 | Ver.1.1.0 |
#35775 Changed URL and mail address in user's manual #36981 Added support for iOS 64bit #36982 Added support for iPhone6, iPhone6 Plus and iPad Pro #36983 Added screen lock feature #36984 Added background image customization #36985 Added support for multiple MIDI OUT ports #36986 Changed launch screen using storyboard #36987 Fixed bug (Japanese locale is not detected) |
2017/2/20 | Ver.1.1.1 |
#37007 Fixed bug (The numerical value of the counter is incorrect) |