2023-09-09 09:27:48 +00:00
# pattern
2022-01-16 06:10:43 +00:00
2023-09-09 09:27:48 +00:00
the pattern view allows you to edit the song's patterns.
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
a pattern consists of columns ("channels") and numbered rows.
2022-01-16 06:10:43 +00:00
each column has several subcolumns in this order:
1. note
2. instrument
3. volume
2023-07-25 05:20:29 +00:00
4. effects, split into effect type and effect value
2022-01-16 06:10:43 +00:00
all columns are represented in hexadecimal, except for the note column.
2023-07-25 05:20:29 +00:00
row highlights show beats and measures, and are configured in the [the Speed window ](../2-interface/song-info.md ).
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
## cursor and selection
you may change the cursor position by clicking anywhere on the pattern.
to select an area, press and hold the left mouse button. then drag the mouse and release the button to finish selection.
2023-09-09 09:27:48 +00:00
right-clicking within the pattern view brings up a pop-up menu with most options from the [edit menu ](../2-interface/menu-bar.md ).
2023-07-25 05:20:29 +00:00
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
## channel bar
using the channel bar, you may adjust several aspects of the channel display.
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
clicking on a channel name mutes that channel.
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
double-clicking or right-clicking it enables solo mode, in which only that channel will be audible.
2022-02-09 07:12:37 +00:00
2023-11-01 22:23:49 +00:00
clicking the `++` at the top left corner of the pattern view pops up a small menu to set view modes:
- **Effect columns/collapse**: as shown above. adds the following buttons beneath the channel name:
2023-07-25 05:20:29 +00:00
- **-**: collapse visible columns. changes to ** +** when columns are hidden; click to expand them.
- **< **: disables the last effect column and hides it. effects are not deleted...
- **>**: adds an effects column. if one previously existed, its contents will be preserved.
2023-09-09 09:27:48 +00:00
- **Pattern names**: displays pattern names (per channel). pattern names are also visible when hovering over a pattern in the order list.
2023-11-01 22:23:49 +00:00
- **Channel group hints**: display indicators when channels are paired in some way (e.g. OPL3 4-op mode).
- **Visualizer**: during playback, show visual effects in the pattern view.
- also can be toggled by right-clicking on the `++` button.
- **Channel status**: displays icons that indicate activity in the channel. see the "channel status" section below.
to rename and/or hide channels, open [the Channels window ](../8-advanced/channels.md ) via the window menu.
### channel status
2023-11-01 17:25:26 +00:00
- note status:
-  note off
-  note on
-  note on, macro released
-  note released
- pitch effect:
-  no effect
-  pitch up
-  pitch down
-  portamento
-  arpeggio
- volume effect:
-  no effect
-  volume up
-  volume down
-  tremolo
- other icons depending on chip.
2023-07-25 05:20:29 +00:00
2023-09-11 00:34:13 +00:00
## input
2023-07-25 05:20:29 +00:00
2023-09-11 00:34:13 +00:00
### note input
2023-07-25 05:20:29 +00:00
- pressing any of the respective keys will insert a note at the cursor's location, then advance to the next row (or otherwise according to the Edit Step.)
2023-09-10 17:16:55 +00:00
- **note off** (`OFF`) turns off the last played note in that channel (key off for FM/hardware envelope; note cut otherwise).
- **note release** (`===`) triggers macro release (and in FM/hardware envelope channels it also triggers key off).
- **macro release** (`REL`) does the same as above, but does not trigger key off in FM/hardware envelope channels.
2023-07-25 05:20:29 +00:00
- **toggle edit** enables and disables editing. when editing is enabled, the cursor's row will be shaded red.
2023-09-11 00:34:13 +00:00
### instrument/volume input
2023-07-25 05:20:29 +00:00
type any hexadecimal number (0-9 and A-F). the cursor will move by the Edit Step when a suitable value is entered.
2023-09-11 00:34:13 +00:00
### effect input
2023-07-25 05:20:29 +00:00
works like the instrument/volume input.
each effect column has two subcolumns: effect and effect value.
if the effect value is not present, it is treated as `00` .
most effects run until canceled using an effect of the same type with effect value `00` , with some exceptions.
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
here's [a list of effect types ](effects.md ).
2022-02-09 07:12:37 +00:00
2023-07-25 05:20:29 +00:00
2023-09-11 00:34:13 +00:00
## keyboard shortcuts
2023-07-25 05:20:29 +00:00
these are the default key functions. all keys are configurable in the Keyboard tab of the Settings window.
2022-02-09 07:12:37 +00:00
key | action
------------|-----------------------------------------------------------------
Up/Down | move cursor up/down by one row or the Edit Step (configurable)
Left/Right | move cursor left/right
PageUp | move cursor up by 16 rows
PageDown | move cursor down by 16 rows
Home | move cursor to beginning of pattern
End | move cursor to end of pattern
Shift-Home | move cursor up by exactly one row, overriding Edit Step
Shift-End | move cursor down by exactly one row, overriding Edit Step
Shift-Up | expand selection upwards
Shift-Down | expand selection downwards
Shift-Left | expand selection to the left
Shift-Right | expand selection to the right
Backspace | delete note at cursor and/or pull pattern upwards (configurable)
Delete | delete selection
Insert | create blank row at cursor position and push pattern
Ctrl-A | auto-expand selection (select all)
Ctrl-X | cut selection
Ctrl-C | copy selection
Ctrl-V | paste selection
Ctrl-Z | undo
2022-02-10 09:19:15 +00:00
Ctrl-Y | redo
2022-02-09 07:12:37 +00:00
Ctrl-F1 | transpose selection (-1 semitone)
Ctrl-F2 | transpose selection (+1 semitone)
Ctrl-F3 | transpose selection (-1 octave)
Ctrl-F4 | transpose selection (+1 octave)
Space | toggle note input (edit)
