diff --git a/doc/1-intro/README.md b/doc/1-intro/README.md index f864f8f9d..dc9af5efc 100644 --- a/doc/1-intro/README.md +++ b/doc/1-intro/README.md @@ -12,9 +12,11 @@ Furnace uses hexadecimal (abbreviated as "hex") numbers frequently. see [this gu ## interface -Furnace uses a music tracker interface. think of a table with music notes written on it. then that table scrolls up and plays the notes. even experienced tracker musicians might benefit from a quick review of [tracker concepts and terms](concepts.md) before using Furnace. there's also a [glossary of common terms](glossary.md). +Furnace uses a music tracker interface. think of a table with music notes written on it. then that table scrolls up and plays the notes. +for an introduction to a tracker interface, see [tracker concepts and terms](concepts.md) before using Furnace. +there's also a [glossary of common terms](glossary.md). -due to its nature of being feature-packed, it may be technical and somewhat difficult to get around. therefore we added a basic mode, which hides several advanced features. +due to its nature of being feature-packed, it may be technical and somewhat difficult to get around. therefore we added a [basic mode](../2-interface/basic-mode.md), which hides several advanced features. it also has a flexible windowing system which you may move around and organize. @@ -22,8 +24,6 @@ see [2-interface](../2-interface/README.md) and [3-pattern](../3-pattern/README. once familiar with the tracker, look to [9-guides](../9-guides/README.md) for useful techniques. +# tutorial? - -# links - -[Furnace Tutorials](https://youtube.com/playlist?list=PLCELB6AsTZUnwv0PC5AAGHjvg47F44YQ1): video tutorials created by Spinning Square Waves. \ No newline at end of file +[Furnace Tutorials](https://youtube.com/playlist?list=PLCELB6AsTZUnwv0PC5AAGHjvg47F44YQ1): video tutorials created by Spinning Square Waves. be noted that these may not apply to the current version. diff --git a/doc/1-intro/concepts.md b/doc/1-intro/concepts.md index b91797179..773301907 100644 --- a/doc/1-intro/concepts.md +++ b/doc/1-intro/concepts.md @@ -1,36 +1,39 @@ # concepts and terms -- A **module** is a file for a tracker that contains at least one **song**. -- Each Furnace module involves at least one **[chip](../7-systems/README.md)**, an emulation of a specific audio processor. +- a **song** (also called **module**) is a file for a tracker that contains at least one **subsong**. +- each Furnace song involves at least one **chip**, an emulation of a specific audio processor. ## tracking -The **[pattern view](../3-pattern/README.md)** is like a spreadsheet that displays the following: -- Each labeled column represents a **channel** of sound provided by the chips in use. -- Each **note** starts a sound playing. Within a channel, only one note can play at a time. -- Each note is assigned an **[instrument](../4-instrument/README.md)** which describes what it will sound like. -- An **effect** is a command that changes some aspect of playback. It can alter note pitch, volume, timing, and more. -- An instrument **macro** is an automated sequence of effects that applies to every note of that instrument. +the **[pattern view](../3-pattern/README.md)** is similar to spreadsheet that displays the following: +- each labeled column represents a **channel** of sound provided by the chips in use. +- each **note** starts a sound playing. Within a channel, only one note can play at a time. +- each note is assigned an **[instrument](../4-instrument/README.md)** which describes what it will sound like. +- an **effect** is a command that changes some aspect of playback. it can alter note pitch, volume, timing, and more. +- an instrument **macro** is an automated sequence of effects that applies to every note of that instrument. +- during playback, the **playhead** moves down, scrolling through the pattern view, triggering the notes that it encounters. ## structure -The **order list** is a smaller spreadsheet showing the overall song structure. -- A song is made up of a list of orders. -- An **order** is a set of numbered patterns used for each channel. -- Each channel has its own unique list of patterns. -- Each **pattern** contains note and effect data for that channel only. -- Patterns may be used multiple times in the order list. Changing a pattern's data in one order will affect the same pattern used in other orders. +the **order list** is a smaller spreadsheet showing the overall song structure. +- a song is made up of a list of orders. +- an **order** is a set of numbered patterns used for each channel. +- each channel has its own unique list of patterns. +- each **pattern** contains note and effect data for that channel only. +- patterns may be used multiple times in the order list. changing a pattern's data in one order will affect the same pattern used in other orders. +- each pattern is made of the same number of rows as seen in the tracker view. +- during playback, the **playhead** moves down as described previously. when it reaches the end of the pattern view, it will go to the next order. +- if the last order is reached and the playhear reaches the end of the pattern view, it will go back to the beginning of the song. ## time -- Each pattern is made of the same number of rows as seen in the tracker view. -- During playback, each **row** lasts a number of ticks determined by its **speed** value. -- A **tick** is the smallest measure of time to which all note, effect, and macro times are quantized. +- during playback, each **row** lasts a number of ticks determined by the song's **speed** value(s). +- a **tick** is the smallest measure of time to which all note, effect, and macro times are quantized. ## sound -Different chips have different capabilities. Even within the same chip, each channel may have its own ways of making sound. -- Some channels use one or more waveform **generators** (sine, square, noise...) to build up a sound. -- Of special note are **[FM (frequency modulation)](../4-instrument/fm.md)** channels, which use a number of generators called **operators** that can interact to make very complex sounds. -- Some channels use **[samples](../6-sample/README.md)** which are recordings of sounds, often with defined loop points to allow a note to sustain. -- Some channels use **[wavetables](../5-wave/README.md)**, which are like very short samples of fixed length that automatically loop. \ No newline at end of file +sound chips have different capabilities. even within the same chip, each channel may have its own ways of making sound. +- some channels use one or more waveform **generators** (sine, square, noise...) to build up a sound. + - of special note are **FM (frequency modulation)** channels, which use a number of generators called **operators** that can interact to make very complex sounds. +- some channels use **[samples](../6-sample/README.md)** which are (usually) recordings of sounds, often with defined loop points to allow a note to sustain. +- some channels use **[wavetables](../5-wave/README.md)**, which are very short samples of fixed length that automatically loop.