Pattern editor

Pattern field

The pattern field consists of all channels and works like this:


All fields except note, octave and effect letter are in hexadecimal.

Use insert-key to insert rows and delete-key to delete rows. Backspace removes a row. Every field can be cleared by using the '-' (dash) key.

Channels can be muted by clicking it's name in the channel header, double clicking makes it play solo. Shortcuts for these commands are Alt+F9 & Alt+F10.

Selection and drag-n-drop is supported in this area.
Ctrl+A (first time) = select whole channel, Ctrl+A (second time) = select all channels
Ctrl+C = copy, Ctrl+X = cut, Ctrl+V = paste
Selection+mouse wheel = transpose

Additional keys can be found in key command-section.

Toolbar



The buttons are in order:
New New module
Open Open a file
Save Save current file
Cut Cut selected pattern
Copy Copies selected pattern
Paste Paste into pattern
About Display about box
Help Help button
Add frame Add a new frame
Remove frame Remove selected frame
Move frame down Move selected frame down one step
Move frame up Move selected frame up one step
Duplicate frame Inserts a copy of selected frame
Play Play the module
Play pattern Play and loop selected pattern
Stop Stop player
Record Record/normal mode
Previous song Moves to previous song in list
Next song Moves to next song in list
Setting Bring up settings dialog
NSF export Bring up export dialog
Octave Selected octave
Follow mode Enable/disable follow mode when playing the module (Can be toggled with Scroll-lock)
Row highlight Steps between highlighted rows
2nd highlight Steps between second row highlight

The control panel


Frame editor

The first part is the frame editor (also known as order editor). A frame is a set of patterns for all channels, where each channel is represented by a number that represents the selected pattern slot. There are 128 available pattern slots for each channel, and the patterns aren't shared across the channels. 128 frames can be used.

To change pattern, press "+" - or "-" buttons or "+" & "-" keys in the pattern editor. If "change all" is checked, all channels will change instead of just the selected one. To move between frames in the pattern editor, use Ctrl+Right and Ctrl+Left. It's possible to double-click the window to enter edit mode, you can then enter values manually.

Song settings & edit settings

Song settings is default play speed & tempo, number of rows and frames in the song. Double-click any box to enter a value manually.

Speed and tempo can also be changed by using pattern command Fxx. The real BPM tempo is calculated by using the formula

BPM = (6 * Tempo) / Speed

which means the tempo box is correct at speed of 6. The time base for the song is 60 or 50 frames per second (when using default NTSC/PAL settings), and this is used to calculate the average tempo of the song. This means that some rows may play slightly longer than others and may be noticeable. To avoid this, leave the tempo setting at 150 (125 for PAL) and use only the speed setting to change BPM to ensure all rows get the same duration.

The step setting changes the step behaviour when moving the cursor in the pattern editor. Key repetition enables key repeat behaviour.

Song information & instrument list

Song information text fields are for name, artist and copyright. These strings are stored in NSFs (and also available in the NSF export dialog). The song list selects a song in multi-song files. The big list to the right is the instrument box, and the small toolbar is used to create, delete, open, save and edit settings for instrument and the text box is to name instruments.