Author Topic: Keyboard Setup commands  (Read 3922 times)

Offline Harbinger

  • Extreme artist
  • *****
  • Posts: 1,146
  • Gender: Male
  • Operating System: Windows XP
Keyboard Setup commands
« on: July 04, 2009, 00:30:45 »
Edit: This list is no longer up-to-date. Visit the Wiki instead.

This page will be part of the Upcoming help manual, but i wanted to post this for reference, and also to get feedback on the descriptions. I will assume the reader has some working experience using MPT before trying to develop his own shortcuts.
There are a couple i'm still not sure about, so if you have some insight, mention it here. I also skipped over the last set of shortcuts for plugins. (i'll get to those later).
Also, there are a couple of allusions to sections elsewhere. Ignore those -- i'll provide links in the manual for those later.

---------------------------------------------------------------------------

These are the descriptions of the keyboard shortcuts that can be customized in MPT.

NOTE: If your keyboard shortcut will not work, check that you did not leave another MPT notice window open (such as the one generated when you verify SFx assignments!). To check this quickly, look in Windows' taskbar (the one with the Start Menu and a listing of all open windows/apps).

Global keys

These keyboard shortcuts will work on all parts of ModPlugTracker, as long as it's the frontmost application.


File/New
 Creates a new blank track. If one is already open, it is neither closed nor saved.
 
File/Open
 Shows the dialog to open an existing readable tracking format. If one is already open, it is neither closed nor saved.
 
File/Close
 Closes the current song. If it has not been saved, you are given the opportunity before the file is closed.
 
File/Save
 Saves the file in its current name and format.
 
File/Save As
 Allows you to save the file with a new name or in another folder.
 
File/Save as Wave
 Exports the current track .wav file in the folder you choose. The current track is neither closed nor saved.
 
File/Save as MP3
 Exports the current track .mp3 file in the folder you choose. The current track is neither closed nor saved.
 
File/Export to Midi
 Exports the current track into the .mid format. See the section on MIDI files for a detailed explanation of how this file is exported. The current track is neither closed nor saved.
 
File/Export to IT/XM
 Exports the current track to "pure" .it format, without MPT's .it alterations.
 
Previous Document
 Goes to the previous tracking file that is open, all of which are visible in the Windows Menu.
 
Next Document
 Goes to the next tracking file that is open, all of which are visible in the Windows Menu.
 
File/Import Midi Lib
 Imports the MIDI Instrument Library of your choosing. If the file is valid, it will appear in the Folder Tree in its own heading.
 
File/Add Sound Bank
 Imports a sound bank of your choosing. If the file is valid, it will appear in the Folder Tree in its own heading.
 
Play song/Pause song
 Toggles the playback of the current track. The playback pointer is not reset when using this toggle; that is, it plays from where the pointer left off when it was last pressed.
 
Pause song
 Only stops the playback of the current track but does not reset the playback pointer.
 
Stop Song
 Stops the playback of the current track AND resets the pointer to the beginning of the song.
 
Play song from start
 Resets the playback pointer to the very first event of the track, and begins playback from there.
 
Play song from cursor
 Resets the pointer to the row where the editing cursor is set (even if the selected row is not in the currently displayed pattern), and begins playback from there. Playback will continue until the end of the track.
 
Play pattern from start
 Resets the pointer to the first row of the current pattern (even if you are in a different section of MPT), and begins playback from there. It will stop at the end of the pattern (or loop within the pattern if Loop Pattern is enabled).
 
Play pattern from cursor
 Resets the pointer to the row where the editing cursor is set in the current pattern (even if you are in a different section of MPT), and begins playback from there. It will stop at the end of the pattern (or loop within the pattern if Loop Pattern is enabled).
 
Estimate Song Length
 Estimates the playback length of the entire track.
 
Show approx. real BPM
 Estimates the beats per minute of the song, based on the Initial tempo and the number of ticks per row, plus the Tempo Mode in the Song Properties dialog.
 
Toggle Midi Record
 Toggles the MIDI Record option.
 
Undo
 Rescinds the last edit. Applies to all text and pattern data. However, while there are multiple Undo's for pattern edits, there is only one Undo for text edits (pressing Undo a second time re-applies the edited text). THERE IS NO UNDO FOR EDITS TO SAMPLE DATA.
 
Cut
 Copies the selected data into the clipboard, then removes it from the field it occupies. Applies to text, pattern, and sample data.
 
Copy
 Copies the selected data into the clipboard. Applies to text, pattern, and sample data.
 
Paste
 Pastes the selected data at the location of the cursor, but Paste acts differently on the type of data. With text, clipboard contents are inserted at the point of the cursor, or, if text is already highlighted, replace the selected text. With pattern data, clipboard contents are pasted in the same row at the same column of the current (visible) Pattern where the cursor is located, overwriting any pattern data that falls within the paste area. With sample data, clipboard contents are pasted OVER THE ENTIRE SAMPLE, in essence replacing all of that sample's data with whatever sample data is stored in the clipboard.
 
Mix Paste
 Clipboard contents are pasted in the same row at the same column of the current (visible) pattern where the cursor is located, EXCEPT where there is already any data in any corresponding field of the paste area.
 
Mix Paste (old IT Style)
 Clipboard contents are pasted in the same row at the same column of the current (visible) pattern where the cursor is located, EXCEPT where there is already any pattern data that falls within the paste area. However, the note data is assumed to include the note name, the designated instrument, and the note FX (volume data field), so if any of these contain non-blank data, none of the note data in that row of that channel of the clipboard will be pasted over it. (But channel FX data is tested separately, and will be only pasted if the last column in that channel is blank.)
 
SelectAll
 Selects all text data, pattern data, or sample data, depending on the location of the cursor or current selection.
 
Find
 Opens the Find/Replace dialog, which allows you to search for and/or replace given pattern data. Find starts from the cursor location.
 
Find Next
 Applies the current Find settings and searches for the next data that matches it, selecting the given data; however it does not set the cursor in that row. For Find to be used again, the cursor must be set in the current pattern, then Find Next searches the entire row (in each channel) before going to the next row.
 
View General
 Opens the General Tab.
 
View Pattern
 Opens the Pattern Tab.
 
View Samples
 Opens the Samples Tab.
 
View Instruments
 Opens the Instruments Tab.
 
View Comments
 Opens the Comments Tab.
 
View Graph
 Currently not functional.
 
Toggle Main View
 Shows/hides Main toolbar.
 
Toggle Tree View
 Shows/hides Folder Tree panel.
 
View Options
 Opens the OpenMPT Setup dialog.
 
View Channel Manager
 Opens the Channel Manager table.
 
View Plugin Manager
 Opens the Plugin dialog.
 
Show song properties window
 Opens the Song Properties dialog.
 
View MIDI Mapping
 Opens the MIDI mapping dialog.
 
Help (to do)
 Opens the Offline Help Manual (currently not functional)
 
Previous instrument
 Changes the current instrument to the previous one in order.
 
Next instrument
 Changes the current instrument to the next one in order.
 
Previous octave
 Changes the current octave to the next lower octave.
 
Next octave
 Changes the current octave to the next higher octave.
 
Previous order
 Changes the current pattern to the previous one in the pattern order. If the pattern ID is the same the display will not change.
 
Next order
 Changes the current pattern to the next one in the pattern order. If the pattern ID is the same the display will not change.

Pattern - General Context

These keyboard shortcuts will only work if the cursor focus is within one of the columns of the Pattern Editor, except where noted.

NOTE: When navigating (moving the cursor) to before the first row or after the last row in the pattern, the cursor "wraps" to the other side of the same pattern, if the "Cursor Wrap" option is enabled (in the Options section of the General tab of the MPT Setup dialog). If navigating beyond the first or last row when the "Continuous Scroll" option is enabled, the cursor will instead move to the previous/next pattern in the order list.


Navigate down by 1 row
 Moves the cursor to the next row in the same column.
 
Navigate up by 1 row
 Moves the cursor to the previous row in the same column.
 
Navigate down by spacing
 Moves the cursor down (in the same column) by the number in the Row Spacing field.
 
Navigate up by spacing
 Moves the cursor up (in the same column) by the number in the Row Spacing field.
 
Navigate left
 Moves the cursor to the previous column in the same row, going to the previous channel's last column if moving from the first column of the current channel.
 
Navigate right
 Moves the cursor to the next column in the same row, going to the next channel's first column if moving from the last column of the current channel.
 
Navigate to next channel
 Moves the cursor to the same column in the same row in the next channel.
 
Navigate to previous channel
 Moves the cursor to the same column in the same row in the previous channel.
 
Jump down by measure
 Moves the cursor down (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).
 
Jump up by measure
 Moves the cursor up (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).
 
Jump down by beat
 Moves the cursor down (in the same column) by the number in the Rows/beat field (of the Song Properties dialog).
 
Jump up by beat
 Moves the cursor up (in the same column) by the number in the Rows/measure field (of the Song Properties dialog).
 
Snap down to measure
 Moves the cursor down (in the same column) to the first row of the next measure, as determined by the number in the Rows/measure field (of the Song Properties dialog).
 
Snap up to measure
 Moves the cursor up (in the same column) to the first row of the previous measure, as determined by the number in the Rows/measure field (of the Song Properties dialog).
 
Snap down to beat
 Moves the cursor down (in the same column) to the first row of the next beat, as determined by the number in the Rows/beat field (of the Song Properties dialog).
 
Snap up to beat
 Moves the cursor up (in the same column) to the first row of the previous beat, as determined by the number in the Rows/beat field (of the Song Properties dialog).
 
Go to first channel
 Moves the cursor to the first column of the first channel in the same row.
 
Go to first row
 Moves the cursor to the first row of the same channel in the same column.
 
Go to first row of first channel
 Moves the cursor to the first column of the first channel in the first row.
 
Go to last channel
 Moves the cursor to the last column of the last channel in the same row.
 
Go to last row
 Moves the cursor to the last row of the same channel in the same column.
 
Go to last row of last channel
 Moves the cursor to the last column of the last channel in the last row.
 
Previous pattern
 Displays the previous pattern in the order list, moving the cursor to its equivalent position in it.
 
Next pattern
 Displays the next pattern in the order list, moving the cursor to its equivalent position in it.
 
Selection key
 The modifier key to be used to extend the selection when navigating with keyboard shortcuts.
 
Copy select key
 The modifier key to be used to copy the selection when dragging with the mouse.
 
Select channel / Select all
 Toggles the "select all" method, either all events in the current pattern of the current channel where the cursor is located, or all events in the pattern.
 
Copy and lose selection
 Copies the selected events (replacing whatever was in the clipboard) and deleting the selected events from the pattern.
 
Clear row
 Deletes all event data in the same row in the current channel.
 
Clear field
 Deletes only the event data in the same row of the same column in the current channel.
 
Clear field (IT Style)
 Deletes the note and instrument when the cursor is in the note column; note FX and channel FX remain.
 
Clear row and step
 Deletes all event data in the same row in the current channel and moves the cursor by the number of rows in the Row Spacing field.
 
Clear field and step
 Deletes only the event data in the same row of the same column in the current channel and moves the cursor by the number of rows in the Row Spacing field.
 
Clear field and step (IT Style)
 Deletes the note and instrument when the cursor is in the note column (note FX and channel FX remain) and moves the cursor by the number of rows in the Row Spacing field.
 
Delete rows
 Deletes the same number of rows as the selection, affecting the same number of channels where the selection extends; the data is moved up to replace the cleared data, and extra rows are added in the affected channels so that the row number remains the same.
 
Delete all rows
 Deletes all event data in the selected channels
 
Insert Row
 Moves event data in the current and following rows in the selected channel down one row. Event data in the last row of those channels is deleted.
 
Insert All Rows
 Moves event data in the current and following rows in all channels down one row. Event data in the last row of all channels is deleted.
 
Mute current channel
 Toggles the sound output (mute) for the channel where the cursor is located.
 
Solo current channel
 Toggles the sound output (mute) for all channels except the one where the cursor is located.
 
Unmute all channels
 Activates the sound output for all channels, regardless of Mute status.
 
(Un)mute chan on pat transition
 Toggles the sound output (mute) for the channel where the cursor is located, but the change takes place when the current pattern is finished playing.
 
Transpose +1
 Raises by one the note number of the currently selected notes. Only selected note data (first column) is affected.
 
Transpose -1
 Lowers by one the note number of the currently selected notes. Only selected note data (first column) is affected.
 
Transpose +12
 Raises by one the octave number of the currently selected notes. Only selected note data (first column) is affected.
 
Transpose -12
 Lowers by one the octave number of the currently selected notes. Only selected note data (first column) is affected.
 
Amplify selection
 Opens a dialog to change the volume commands (note FX not channel FX) of the selected volume data. Only selected volume data (third column vxx) is affected.
 
Interpolate note
 Transitions smoothly (using all available notes) between notes in the selection, filling in (and replacing if necessary) all rows with new note data. The first and last rows of the selection must contain note data.
 
Interpolate volume
 Transitions smoothly between data amounts in the selection, filling in (and replacing if necessary) all rows with new note FX data. The first and last rows of the selection must contain note FX data, and they must be of the same type (volume, panning, etc). Note FX of different types are not replaced.
 
Interpolate effect
 Transitions smoothly between data amounts in the selection, filling in (and replacing if necessary) all rows with new channel FX data. The first and last rows of the selection must contain channel FX data, and they must be for the same effect (Ixx, Zxx, etc.). Channel FX of different types are not replaced.
 
Open effect visualizer
 Opens the Params Editor dialog.
 
Open pattern randomizer
 Opens the Pattern Randomizer dialog. (available but not functional)
 
Go to row/channel/...
 Opens the Go To dialog dialog.
 
Apply current instrument
 Applies the current instrument to all rows in the selection that contains note data.
 
Grow selection
 "Expands" the selection by doubling the number of the selected rows, and evenly spacing out the event data within it. The expansion will replace event data below it in the same channels as the selection.
 
Shrink selection
 "Shrinks" the selection by deleting every other row of the selection. However, if only part of any row is selected, the data corresponding to the deleted selected data is also deleted.
 
Toggle follow song
 Toggles the "Follow Song" function.
 
Quick copy
 Copies only one field of data (where the cursor is located) to MPT's "Quick" clipboard; the standard clipboard is not erased. Each column has its own Quick clipboard.
 
Quick paste
 Pastes the data in MPT's "Quick" clipboard to the location of the cursor. The data last saved in that column's clipboard will be pasted in the cursor's corresponding column.
 
Enable recording
 Toggles the Event Record feature. When enabled, patterns may be edited.
 
Play row
 Process and play only the events in the current row where the cursor is located.
 
Set row jump on note entry
 The modifier key(s) that, when pressed with digits 0-8, will allow you to change the Row Spacing amount without using the mouse or moving the cursor focus out of the editor.
 
Switch to order list
 Toggles the cursor focus between the pattern editor and the current pattern in the Pattern Order list.
 
Insert new pattern
 Inserts a new blank pattern after the current pattern, displays it, and moves the cursor to the same position in it. Also functions when cursor focus is in the Order list.
 
Toggle channel’s plugin editor
 Opens the Plugin Manager dialog.
 
Show note properties
 Opens the Note Properties dialog, where you can assign any event data to the current row of the current channel.
 
Show pattern properties window
 Opens the Pattern Properties dialog.
 
Show macro configuration
 Opens the Macro Setup dialog.
 
Toggle loop pattern
 Toggles the Loop Pattern feature.
 
Show context (right-click) menu
 Opens the context menu at the cursor location without using the mouse.
 
Show playback time at current row
 Shows the estimated time within the track at the start of the current row.
 

Pattern – Note Column

These shortcuts will be recognized as note entries when the pattern editor has focus and the cursor is in the note column (the first column).

Base octave [note]
 Enters a note in the octave indicated in the Octave field
 
Base octave +1 [note]
 Enters a note in the next higher octave indicated in the Octave field
 
Base octave +2 [note]
 Enters a note two octaves higher than the one indicated in the Octave field
 
Set octave [0 – 9]
 Modifies the octave range of all selected notes.
 
Chord Modifier

Note cut
 Enters a note cut command ( ^ ^ ) and applies the current instrument (replacing it if necessary)
 
Note off
 Enters a note off command ( = = ) and applies the current instrument (replacing it if necessary)
 
Note cut (don’t remember instrument)
 Enters a note cut command ( ^ ^ ), leaving the instrument field blank
 
Note off (don’t remember instrument)
 Enters a note off command ( = = ), leaving the instrument field blank


Pattern Editor – Instrument Column

These shortcut keys will be activated only when the pattern editor has focus and the cursor is in the instrument column (the second column).

Some users may wish to assign certain number keys to other functions (e.g. ‘8’ to ‘Play Row’), so making the numbers fully customizable helps manage this case. Note that MPT distinguishes between standard number keys and “numpad” keys.

Set instrument digit [0 -9]
 Enters the digit into the rightmost place in the instrument field, moving the existing digit to the leftmost place.

Pattern Editor – Channel Effect Column

These work when the pattern editor has focus and the cursor is in the Channel FX column (the prefix of the fourth column). MPT distinguishes between standard number keys and “numpad” keys. Currently only some of the newer effects introduced in MPT are customizable.

FX MIDI macro slide
 Enters the symbol for Macro slide between parameters (see the section on Macros for details)
 
FX pseudo-velocity (experimental)
 
FX parameter extension command
 
Pattern Editor – Effect Param

These work when the pattern editor has focus and the cursor is in the Channel FX parameter column (the last 2 places of the last column in the channel). MPT distinguishes between standard number keys and “numpad” keys.

Remember that unlike the other numeric columns, the Channel FX column is in hexadecimal, where counting is done from 0 to 15, with the letters A – F representing the numbers 10 – 15.

FX Param digit [0 -9]
 Enters the digit into the rightmost place in the parameter field, moving the existing digit to the leftmost place.
 
FX Param digit [A – F]
 Enters the letter into the rightmost place in the instrument field, moving the existing digit to the leftmost place.
 

Sample Editor

These shortcuts are recognized when the Samples Tab is visible. REMEMBER THAT THERE IS NO UNDO FOR SAMPLE EDITS.

Trim sample around loop points
 If loop points are specified, all sample data outside of these start/end times are deleted
 
Silence sample selection
 All of the sample data within the selected area is set to zero, effectively placing silence in that span.
 
Normalise Sample
 
Amplify Sample
 Opens the Amplify dialog, allowing you to alter the volume of the sample and apply Fade In or Fade Out (from silence).
 
Reverse sample
 Puts the selected sample data in reverse order, causing it to sound like it's being played backwards.
 
Delete sample selection
 Deletes the sample data within the selection, moving the remaining data together.
 
Zoom Out
 Decreases the data-to-display ratio, effectively zooming out to show less graphic detail of the sample data. The values “wrap” so when you Zoom Out to the lowest ratio, using the command again goes to the highest ratio.
 
Zoom In
 Increases the data-to-display ratio, effectively zooming in to show more graphic detail of the sample data. The values “wrap” so when you Zoom In to the highest ratio, using the command again goes to the lowest ratio.
 
Load a Sample
 Opens the Open File dialog to allow you to import a .wav file into the sample slot. (This command also works in the Instrument Tab, importing an instrument to the next Instrument slot.)
 
Save Sample
 Opens the Save File dialog to allow you to save the .wav file into a folder of your choice. (This command also works in the Instrument Tab, saving the Instrument and its accompanying samples as an .iti file.)
 
New Sample
 Creates a blank sample in the next unused slot. (This command also works in the Instrument Tab.)
« Last Edit: July 10, 2012, 00:30:15 by Saga Musix »

Offline Sam_Zen

  • Extreme artist
  • *****
  • Posts: 3,689
    • http://www.xs4all.nl/~samzen/
Keyboard Setup commands
« Reply #1 on: July 04, 2009, 22:51:09 »
Once again, a very nice job, Harbinger !
0.618033988

Offline Saga Musix

  • OpenMPT Developers
  • *****
  • Posts: 7,507
  • aka Jojo
    • Download music, samples, VST plugins: Saga Musix Website
  • Operating System: Windows 10 x64
Keyboard Setup commands
« Reply #2 on: September 29, 2009, 23:56:55 »
This needs a little update.
General: Toggle overflow paste
Notes: Param Control, Param Control (Smooth), Note Fade, Note Fade (don't remember instrument)
Sample Editor: Remove DC Offset
» No support, bug reports, feature requests via private messages - they will not be answered. Use the forums and the issue tracker so that everyone can benefit from your post.

Offline Saga Musix

  • OpenMPT Developers
  • *****
  • Posts: 7,507
  • aka Jojo
    • Download music, samples, VST plugins: Saga Musix Website
  • Operating System: Windows 10 x64
Keyboard Setup commands
« Reply #3 on: October 04, 2009, 19:24:51 »
Another one that's missing: Reset channel in pattern context.

EDIT: Even the commands from the .53 release are missing: Unsign sample, invert sample phase.
» No support, bug reports, feature requests via private messages - they will not be answered. Use the forums and the issue tracker so that everyone can benefit from your post.

Offline Harbinger

  • Extreme artist
  • *****
  • Posts: 1,146
  • Gender: Male
  • Operating System: Windows XP
Keyboard Setup commands
« Reply #4 on: October 05, 2009, 15:03:39 »
I'll get to it eventually...