Glossary
Achromatic instrument
An instrument whose Type, under Pitch on its Parameters tab, is Achromatic. It sounds at its own Fixed note wherever it is played, which suits drums and other sounds that keep their own pitch, and the notes in your patterns are kept equal to that fixed note. See the Parameters tab in 9. Instrument Editor.
Arpeggio
A rapid sequence of notes from a chord played in succession. In RhYMe, arpeggios cycle through semitone offsets on each tick to create chord-style playback. See also: arpeggio table.
Arpeggio table
A reusable, looping sequence of semitone offsets applied to the base pitch via effect QNnn. Unlike inline arpeggios (A/B), tables can span many values and persist across notes and instruments until explicitly stopped.
Arrangement
The order in which a song plays its patterns: a row of slots in the song editor, each of which plays a pattern, played from left to right, up to 256 of them. At the end the song stops, or goes back to its loop point if it has one. See 7. Song Editor.
Atari ST
The 16-bit home computer released by Atari in 1985, featuring a Motorola 68000 CPU and a YM2149 PSG sound chip. RhYMe targets this platform's audio hardware.
Buzzer
A sound made by running the hardware envelope so fast that it is heard as a tone, as the envelope tone modes do with a short envelope period. A buzzer ignores the step volume unless the step's timer mode is envelope volume modulation, and only one channel can sound one at a time, since there is one envelope generator. See 8. Sound Generation.
Channel
One of the three independent PSG voices (A, B, C). Each channel has its own note, instrument, effects, and register state.
Continue
The effect RY, which starts the slides the last freeze (RZ) stopped on a channel again, each at the rate it ran at and from the pitch and volume where the freeze left it. A slide written again, a new note or a reset since the freeze replaces the frozen slide, which then does not start again.
DAC (Digital to Analog Converter)
The YM2149's built-in 4-bit converter that translates digital volume values into analog audio levels. Used for sample playback by writing PCM data to the volume register at audio rate.
Detune
A pitch offset of a whole channel, set at once by the effect KT and slid by KL (down), KH (up) and KR (return), that every note on the channel is played at. Notes and resets leave it alone, so it carries on across notes, and every note is moved by the same interval. Not to be confused with an instrument's tuning, which stays fixed.
Digidrum
A historical name for a 4-bit sample played by the YM2149 through its volume. See Sample.
Digisound
Another historical name for a 4-bit sample played by the YM2149 through its volume. See Sample.
Edit Mode
A toggle state for the pattern grid. When active, key presses enter notes and effects into the grid. When inactive, typing into the grid changes nothing, while commands chosen from a menu or a dialog still work.
Effect
A command entered on a pattern row that modifies sound parameters or controls playback. Each effect is a single letter followed by hex digits (e.g. F300 for pitch up). Effects can be trailing (continue across rows), memory-based (reuse last non-zero parameter), or one-shot (apply to the current row only).
Effect matrix
An instrument's grid saying how each of its pitches - the square pitch, the envelope pitch and the timer pitch - follows the effects that move a note's pitch: whether it follows each one at all, and how much of it it takes. See the Effects tab in 9. Instrument Editor.
Effect sample
A sample played on a channel by the Sample Trigger effect Y, rather than by an instrument with its notes. See Sample and 12. Samples.
Effects mode
A song setting that chooses how long trailing effects last. Trailing, the default, keeps them running on the rows below the one they are written on; Non-trailing confines them to that row, so they must be written again on each row they should continue. See 5. Main Window.
Envelope
The YM2149's hardware-driven amplitude modulator. Controlled by shape (R13) and period (R11/R12) registers. There is only one envelope generator on the chip, and only one channel uses it at a time: a channel starting an envelope sound takes it over from the channel that was using it. See 8. Sound Generation.
Envelope synchronization (ESY)
A timer mode (mode 2) that resets the hardware envelope generator at the timer rate, creating rhythmic, envelope-driven effects at audio rate. Because the pitch then comes from the timer rather than from the envelope period, an envelope synchronization is also the accurate way to play a buzzer in tune. See 8. Sound Generation.
Envelope volume modulation (EVM)
A timer mode (mode 3) that gives a buzzer a working volume: the timer restarts a rising envelope at the buzzer's pitch, and the step volume sets how loud the ramp gets. The buzzer stays in tune, since the timer produces its pitch. See 8. Sound Generation.
Event strip
An overview of the whole song shown under the song editor's slots: what each channel plays and, when you add them, graphs of the timers, the samples and the estimated CPU load. Show or hide it with View > Show Event Strip or Ctrl+Shift+G. See 7. Song Editor.
Experience level
How much of the editor RhYMe shows. Expert shows every feature; Novice leaves out the advanced features and options, for a simpler editor to get started with the basics. A song that uses a hidden feature still plays and exports it. Choose it from View > Experience Level or from the dropdown at the right end of the status bar. See 16. Menus & Toolbars.
Fader
A volume of a whole channel, set by the effect KV and faded by KI (in) and KO (out), that lowers everything the channel plays on top of the volumes its rows set. Notes, the volume effect V and resets leave it alone, so a fade carries on over rows that set their own volumes. Like V, it does not reach a sample played by the sample trigger (Y) or a sound played through the hardware envelope, such as a buzzer.
Freeze
The effect RZ, which stops the pitch bends, the semitone bends, the portamento, the volume slides, the fades and the detune on a channel where they are. The pitch and the volume they reached stay, and each keeps its rate, so writing it again with 000 carries on from there. Unlike the reset (RS), it changes nothing else. A continue (RY) starts the slides it stopped again.
Hexadecimal (hex)
Base-16 number system using digits 0–9 and A–F. Used throughout RhYMe because it maps directly to the YM2149's 4-bit register boundaries. Hex values are written with an h suffix (e.g. 3Fh).
Instrument
A sequence of steps that defines how the YM2149's registers change over time. Each step sets mode, volume, noise, tone periods, and timer configuration. Instruments are referenced by number (01h–FFh) in pattern rows.
Key range
The lowest and highest note an instrument plays, set on its Parameters tab. A note outside the range sounds nothing, and the editor warns about it. See the Parameters tab in 9. Instrument Editor.
Loop point
A marker that defines where playback repeats. Song loop points return to a specified arrangement slot. Instrument loop points repeat a range of steps. Temporary loop ranges override the song loop point for preview purposes.
Memory effect
An effect that stores its last non-zero parameter, so writing it with a zero parameter (e.g. E000) reuses the stored value instead of stopping the effect. Pitch down (E), pitch up (F), the semitone bends (I, J) and the portamentos (G, L) are memory effects, each with a separate memory. This works in both effects modes; in Non-trailing it is the short way to continue one on the next row.
MFP (Multi-Function Peripheral)
The Motorola 68901 chip on the Atari ST that provides its four hardware timers, A, B, C and D. A song sets which of them its effects may use: A, B and D to begin with, and C as well when you allow it.
Mute (effect)
The effect KM, which silences the note playing on a channel while it plays on unheard: its instrument and its effects keep running, and a sample picks up where it would have been. The unmute (KU) lets the note be heard again from where it had reached, without playing it again. A new note ends the mute. Not to be confused with muting a channel in the editor, which is not part of the song.
Noise generator
The YM2149's pseudo-random noise source, controlled by a 5-bit period register (R6). Shared across all three channels — writing a noise period affects all channels simultaneously. The highest channel playing noise that can be heard sets it; a channel at volume 0 leaves it alone. Used for percussion and sound effects.
Note
A musical pitch entered on a pattern row, written as a note name plus octave (e.g. C-4). Notes are mapped to YM2149 tone periods via a tuning table. --- means no note; === is an OFF note, which silences the channel.
Octave
A 12-semitone pitch range. The entry octave (shown on the main toolbar) determines which octave note keys produce.
OFF note
A note written as ===, which ends the instrument on its channel and silences it. Enter one with Shift+O in Edit Mode, or by entering a note while the OFF instrument (00) is selected. A later note without an instrument number plays the instrument that was playing before the OFF note. See 6. Pattern Editor.
Pattern
A grid of rows spanning three channels (A, B, C). Each row contains a note, instrument number, and up to five effects. Patterns are arranged sequentially in the song editor. Up to 256 patterns per song; every pattern in a song has the same length, from 1 to 128 rows, set on the Song tab.
Period (tone period)
A 12-bit value (000h–FFFh) written to the YM2149's frequency registers that determines pitch. Lower periods produce higher frequencies. The tuning table maps note numbers to period values. See Notes and Periods and the Note Period Table.
Pitch
The perceived frequency of a sound. In RhYMe, pitch is determined by the tone period, modified by instrument transposition, pitch offsets, arpeggios, vibrato, and pitch-bend effects.
Pitch bend
The effects E (down) and F (up), which move the pitch every tick by a number of 256ths of a tone period. Since a period unit is a small step on a low note and a large one on a high note, the same value bends high notes faster than low ones, which suits fine, precise movements. They share one bend with the semitone bends, so either kind can take over from the other. Trailing, memory effects. See also Semitone bend.
Playlist
An ordered set of songs, saved as a .rhp file, that refers to the songs' files instead of storing copies of them. A playlist is published as one SNDH file or Atari ST program, with each song a subtune. See 14. Playlists.
Portamento
A smooth pitch glide from the current pitch toward a target note at a configurable speed. The glide stops on the target note however fast it is set, and every side of the instrument stops there with it. Started after a pitch bend, it glides on from the bent pitch and stops the bend. Effect G sets the speed in tone periods, so a high note glides faster than a low one, and effect L in semitones, so it glides at the same speed on every note. Both are trailing, memory effects, and either carries on a glide the other started.
Program (.prg)
A self-contained Atari ST program that RhYMe can export, with the YMXR replay routine built in. Started on an Atari ST or an emulator, it plays the song and returns to the desktop when you press Space or Escape. A song that ends falls silent but the program keeps running, so you can pick another song in it.
PSG (Programmable Sound Generator)
The YM2149 chip — a 3-channel sound generator with square wave, envelope, and noise capabilities.
PWM (Pulse-Width Modulation)
A timer mode (mode 1) that toggles the channel volume on and off at an audio rate, creating a richer, grittier timbre by modulating the square wave output.
Register
A single 8-bit storage location in the YM2149 (R0–R15). Registers control tone period, volume, envelope, noise, and mixer settings. Each instrument step writes values to a subset of these registers.
Row
One position down a pattern, spanning all three channels: on each channel it has a note, an instrument number and up to five effects. Playback advances one row every N ticks (determined by the speed setting, which a row length effect O can lengthen or shorten for a single row).
Row length
The effect O, which makes the row it is written on last a number of ticks longer or shorter than the speed, so the song stays on that row longer or moves on sooner, while every effect and instrument keeps moving tick by tick. The speed itself does not change.
Sample
Digitized 8-bit PCM audio data stored in the song's sample bank. Played through the YM2149's volume DAC via the MFP timer, triggered from a pattern with the Y effect, or played by an instrument that plays a sample with its notes. It can be any sound. While it plays it takes one of the song's timers. See 12. Samples. Up to 127 samples per song, each up to 64 KB.
Semitone bend
The effects I (down) and J (up), which move the pitch every tick by a number of 256ths of a semitone, so J100 rises a semitone a tick on any note. They bend every note by the same interval, which suits wide sweeps and dives. They share one bend with the pitch bends E and F. Trailing, memory effects. See also Pitch bend.
Slot
One element of a song's arrangement, shown in the song editor as the number of the pattern it plays. The same pattern can fill any number of slots. A slot's place in the song is its song position. See 7. Song Editor.
SNDH
The standard Atari ST music file format (.sndh): a header with the title, composer, replay rate and length, an embedded replay routine and the music data, playable in SNDH players and on real hardware. RhYMe exports SNDH files with the YMXR replay routine built in. The stored length lets current players stop when the song ends; older players play it for their own default length.
Song
The top-level document in RhYMe, containing patterns, instruments, arpeggio/vibrato tables, samples, wavetables, and an arrangement sequence. Saved in the .rhs format.
Song position
A slot's place in the song's arrangement. The song editor's Previous Song Position and Next Song Position buttons (Ctrl+, / Ctrl+.) move from one to the next. See Slot.
Speed
The number of ticks per row, set on the Song tab and changed during the song by effect SSnn. A new song starts at 6 ticks per row.
Swing
The effect SWxy, which plays the rows of the song at two speeds in turn: its own row lasts x ticks, the next row y, the one after that x again, and so on until the next SSnn or SWxy; SW00 ends it and returns to the song speed. SW64 gives a shuffle feel at an average speed of 5.
Square wave
The YM2149's fundamental tone generator, producing a harmonic-rich waveform. Pitch is set by the 12-bit period register. One square wave generator per channel.
Step
A single row in an instrument's step sequencer. Each step defines a snapshot of YM2149 register values. Steps advance every N ticks (determined by the instrument's speed setting, or by effect SInn when a channel overrides it).
Subtune
One of several tunes stored in a single SNDH file or Atari ST program, which the player lets you choose between. A playlist is published with each of its songs as a subtune. See Publishing the Set.
Temporary loop
A range of slots in the song editor that song playback repeats while it is set, in place of the song's own loop point, so you can listen to one passage over and over. It is not saved with the song. Set it by Alt+drag across slots or from a slot's right-click menu. See 7. Song Editor.
Tick
The smallest unit of time in playback: one playback frame. A song ticks at its tick frequency, about 50 times a second on a PAL Atari ST (50.0527 Hz), unless the song sets a different rate. Effects process every tick; pattern rows advance every N ticks.
Tick frequency
How many ticks a song plays each second, set on the Song tab. PAL, which new songs start with, is 50.0527 Hz, the rate a PAL Atari ST refreshes its screen at; Custom is a whole number of hertz from 25 to 300, played from the Atari ST's 200 Hz clock as on the machine, so a rate that does not divide 200 ticks unevenly. Together with the speed it sets the song's tempo. See the Song tab in 5. Main Window.
Timer
One of the MFP 68901's hardware timers, used for PWM, envelope synchronization, envelope volume modulation, wavetables and sample playback. A channel takes one for as long as its effect sounds, so a song can sound as many of these effects at once as it may use timers: three to begin with, four with Timer C. The timer rate follows the square wave period, adjusted by octave, transposition and pitch offset.
Tone mode
The coupling mode of the square wave and envelope generators on an instrument step. Six modes (0–5): Off, Square Only, Envelope Only, Square Drives Envelope, Envelope Drives Square, and Square and Envelope.
Track
One channel's column of notes and effects within a pattern. A pattern has three tracks (A, B, C).
Trailing effect
An effect that continues to apply on subsequent rows until explicitly stopped or reset. The trailing effects are A, B, E, F, G, H, I, J, L, N, Q, SI, SN, T, U, W and Z: arpeggios, pitch bends and semitone bends, portamentos, vibrato, instrument and arpeggio speed, note and sample retrigger, arpeggio and vibrato tables, transpose and volume slides. They trail only while the song's Effects mode is Trailing; in Non-trailing each is confined to the row it is written on.
Transposition
A semitone offset applied to the pitch of a generator (square or envelope).
Tuning table
A per-song table mapping note indices (0–127) to explicit YM2149 tone period values. Populated automatically when importing from platforms with non-standard PSG clock rates (e.g. Amstrad CPC at 1 MHz).
Value table
An arpeggio table or a vibrato table: a named, looping sequence of values that a channel applies on top of its note. Both kinds are saved and loaded as .rhv files. See 11. Arpeggios & Vibratos.
VBL
The vertical blank: the moment, 50.0527 times a second on a PAL Atari ST, when the screen has been drawn and the next frame begins. Many Atari ST songs are played once per VBL. A song whose tick frequency is PAL ticks at this rate. See Tick frequency.
Vibrato
A periodic modulation of pitch. Effect H applies a sine vibrato at the speed and depth you give it; for any other shape, use a vibrato table (effect QVnn).
Vibrato table
A reusable, looping sequence of period-unit deltas applied to the pitch via effect QVnn. Unlike inline vibrato, tables can define complex modulation patterns and persist across notes until explicitly stopped.
Volume copy
A copy of a sample or wavetable at a lower volume, stored by the Atari ST exports because the player cannot turn a sample down. Each copy counts as one of the 127 waves a tune can contain. See Atari ST Exports.
Volume transformation
A small table the Atari ST player reads a sample or wavetable through to play it at a lower volume, in place of a volume copy. It saves waves and memory but costs the Atari ST a little more time for every value played. The song's Optimize for setting chooses when the exports use them. See Atari ST Exports.
Wavetable
A short cycle of 2 to 64 volume levels, drawn on the Wavetables tab and stored with the song, up to 127 per song. An instrument step in the timer's wavetable mode plays it through the channel's volume at the note's pitch, going round the cycle once for every cycle of the note. Unlike a sample, a wavetable always loops and is made of the chip's own volume levels.
Wavetable mode (WVT)
A timer mode (mode 4) that plays a wavetable through the channel's volume at the note's pitch, the step's Wave column saying which wavetable. See 8. Sound Generation.
YM2149
The Yamaha 3-channel Programmable Sound Generator (PSG) chip used in the Atari ST and other 1980s computers. Operates at 2 MHz on the Atari ST. RhYMe is built around this chip's register-level interface.
YM6
A file format for YM2149 music (.ym) that YM players and many music collections use: a list of what the chip is told on every frame, together with samples and up to two timer effects at a time. RhYMe's YM6 export plays your song and writes down what it plays.
YMXR
An Atari ST player and tune format for YM2149 music, defined by the YMXR project. A YMXR player unpacks a tune bit by bit as it plays, so a long song needs no more memory than a short one. RhYMe's SNDH and Atari ST program exports contain your song with the YMXR player built in; the YMXR tools write both files, and the export dialogs show what the tools report.
YMXS
The tune data structure the YMXR tools read (.ymxs), defined by the YMXS project: the song as rows of YM2149 settings, with the effects and samples the timers play. Every Atari ST export writes your song this way first; the YMXS structure export saves it as a file you can read, change or pack later with the tools.