Manual: Tuning Properties

From OpenMPT Wiki
Jump to: navigation, search
Tuning Properties dialog

The Tuning Properties dialog is used to create and edit advanced sample tunings.

Collection List[edit]

This is the big list on the left side of the window. It keeps all the tunings that you have imported into OpenMPT. There are four categories of tunings available:

  • Standard tunings: This list contains standard tunings that are built into the tracker and cannot be altered. You can, however, copy tunings from this category into another another category and subsequently edit them.
  • Local: Tunings that are saved with the current OpenMPT installation. These tunings are kept in the file.
  • Tune-Specific: Tunings saved with the current song.
  • Sandbox: Temporary tunings that are lost when the dialog box is closed. When importing a new tuning, it goes into this category.

Tunings can be moved and copied between categories by dragging them to the wanted category. When releasing the mouse button, a popup menu is displayed from which you can choose the desired action — moving or copying the tuning.

Right-clicking a tuning collection allows you to add a new tuning.

Collection Information[edit]

The Tuning Collection frame holds information about the currently selected collection. Most of this information is not very interesting, however on the right side of the frame, you can view the location of the tuning collection (if it is stored on disk rather than in a song or in OpenMPT itself), and you can also directly save the collection to disk.


  • Read Only: Prevents any further editing of the current tuning.
  • Name: Here, you can give your tuning a name that is shown in the tuning collection.
  • Tuning Type: Determines how the tuning is built. The following types are available:
    • General is a non-calculated tuning type where all note pitches have to be entered manually. While the obvious disadvantage of this type is that you have to set the pitch for every note, this setting is especially useful for unpitched, strangely-pitched, or unusually-named notes, such as experimental tones or drum sets.
    • Group Geometric allows pitches to be independent within a group (octave). The pitch of notes outside the group size is determined by the Group Ratio factor.
    • Geometric calculates by number of pitches in an “octave” (called a group size), and the pitch change in the “octave”. Using this method applies the equal temperament algorithm (based on an integer root of 2), but there is a lot less flexibility in naming notes.
  • Group Size: The number of notes in this tuning's “octave” (which does not have to be an octave in the classic sense at all). You can enter a number in this field to define how many notes are in a note group (the Western European chromatic octave has 12 notes, the diatonic has 7, and the whole note scale has 6).
  • Group Ratio: The frequency multiplier between the base note and the note one “octave” higher. The default octave is 2.
  • Finetune Steps: The number of divisions that are between notes that will be used in portamento. In other words, the higher this setting, the higher the portamento value must be to bend the pitch by one note. The number of portamento finesteps needed to advance a step in the tuning is this value + 1, so the default of 15 + 1 = 16 finesteps needed. If this value is 0, finesteps equals note steps, which is the same as a glissando effect, using the pitches in the note list.
  • Note List: Shows all notes that can be played (C-0 to B-9) and the pitch ratio at each note. Clicking on any note centers the selection in the window, and shows the note attributes below the window. See the chapter on Tunings for more detailed info.

Other Controls[edit]

  • Import: Clicking on the Import button opens a file dialog so you can import tuning files (OpenMPT′s own .tun tunings and .tc tuning collections or Scala .scl tunings), which will put it into the Sandbox category.
  • Export: Clicking on the Export button will open a file dialog where you can export the selected tuning into a .tun or .tc file. You can also export an entire group of tunings by selecting the category and exporting that.