Documentation

File Selection Screen

The File Selection Screen has 3 tabs: Samples, Saved Files and Last Viewed..  The Samples screen lists files that are included with SongTracks.   Each sample MIDI file includes karaoke information, so lyrics will be shown if any of the samples are selected and shown.

song-samples

The Saved Files tab lets you search for MIDI files on your phone’s system storage or SD Card.   MIDI files are usually saved in  the system/BlackBerry/ringtones or SDCard/BlackBerry/rightones folder.

Note: You will not be able to launch SongTracks directly from the Blackberry web browser when opening MIDI files (due to restrictions on overriding web content handlers).  Instead, save the file and either open SongTracks or navigate to the MIDI file from the Blackberry File app.  SongTracks will be shown as choice under the Play With -> menu.

song-playAs

You can search the web for “midi” to find many sources of free midi files to download.


Main Screen

The main screen displays all the tracks that are in the MIDI file.  If a name is stored in the file (either as a text event or part of a karaoke lyric), then that name will be shown across the top of the screen.  Else, the filename will be shown

The first column shows the track number, the second column is the track indicator and the thrid column is the track name or instrument name.  If no instrument or track name can be found, then “– no text –” will be shown as the track label.

song-main

If the track indicator is green, then the track contains notes and is active.   If the track indicator is red, then the track contains notes, but is muted.   If the indicator is black, then the track does not contain any notes.

When the indicator is red or green, then it is selectable. The indicator can be toggled back and forth between active (green) and muted (red).

Clicking on the track label will open up the the Event List screen.


Event List Screen

song-eventList

The Event List Screen displays the MIDI events that are present in a track.  If the eventi is a NoteOn, then a tone will be played and a key on the piano keyboard lit up when scrolling over the note.

If a ProgremChange event is present, then an the appropriate instrument voice will be selected when the event is scrolled over.

Column 1 shows the delta time offset for each event.  If no delta event is shown, that mean that the event occurs at the same delta event that was previously displayed (ex: a chord of 3 notes that are played simultaneously).

For NoteOn events, the following info is shown:

  • NoteOn(NoteOctave,Volume)len=quantizedLength,realLength
  • NoteOctave is [A, B, C, D, E ,F G] followed by an octave number
  • Volume is [0-127]
  • quantizedLength is the real note length expressed as quarters notes (adjusted to the closest 16th note)
  • realLength is the real note length indicated in the midi file.

Pressing T will scroll to the top of the event list

Pressing B will scroll to the bottom of the event list.


Settings Screen

The Event Filter controls what type of midi events will be shown on the EventList screen.  By default, only the NoteOn and ProgramChange events will be shown.   The more event types that are shown, the more memory that will be used to load the EventScreen.  On large midi files

settings

with lots of events (or on midi format 0 files where all the tracks are stored as a single track), it is possible to exhaust your phone’s memory if too many event types are selected in the filter.


Info Screen

The Info Screen shows some low-level settings for the MIDI file.

song-info

 

midiFormat:  Displays the midi file format that is used 0,1 or 2).  Read here for more details.

midiDivisor:  How many midi beats occur per each quarter note.

selfSpacing: If true, then the lyrics stored in the file contain spaces for separating words.  If false, then SongTracks will determine where spaces need to be added.