diff --git a/papers/doc/1-intro/README.md b/papers/doc/1-intro/README.md index 0f89f6ccc..c21ad355b 100644 --- a/papers/doc/1-intro/README.md +++ b/papers/doc/1-intro/README.md @@ -1,32 +1,21 @@ # introduction -Furnace is a tool which allows you to create music using emulated sound chips from the 8/16-bit era. -For a full list of soundchips that Furnace supports, please see [this list](https://github.com/tildearrow/furnace/tree/master/papers/doc/7-systems). +Furnace is a tool which allows you to create music using sound chips ("chiptune"), most from the 8/16-bit era. -It has a music tracker interface. think of a piano roll, or a table that scrolls up and plays the notes. +it has a large selection of features and sound chips. from the NES, SNES and Genesis to ES5506, VIC-20 or even Arcade, Furnace has most likely covered your target with many presets to choose from. -Another core feature of Furnace is its windowing system, similar to that of GEMS or Deflemask, but with a few more features. +every chip is emulated using many emulation cores, therefore the sound that Furnace produces is authentic to that of real hardware. -## Interface - -Furnace is built to have a user-friendly interface that is intentionally made so that it is quick and easy to get around when working in Furnace. -However, we understand that the interface may not be the easiest to learn, depending on how you learn, so there is documentation on it as well. - -See [2-interface](https://github.com/tildearrow/furnace/tree/master/papers/doc/2-interface) and [3-pattern](https://github.com/tildearrow/furnace/tree/master/papers/doc/3-pattern) to view said documentation. - -## Hexadecimal +## hexadecimal Furnace uses hexadecimal (abbreviated as "hex") numbers frequently. see [this guide](hex.md) for a crash course. -## Sound generation +## interface -Furnace generates sound from 3 different main types of sound sources. - - Instruments are the most standard and most used type of sound source in Furnace. -The instrument format is how you can specify parameters and macros for certain channels on certain soundchips, as well as binding samples and wavetables to a format that you can sequence on the note grid. -See [4-instrument](https://github.com/tildearrow/furnace/tree/master/papers/doc/4-instrument) for more details. - - Wavetables are the way that you create custom waveform shapes for the HuC6280, Seta X1-010, WonderSwan, any PCM chip with wavetable synthesizer support, etc. -Wavetables only work in the sequencer if you bind them to an instrument. See [4-instrument](https://github.com/tildearrow/furnace/tree/master/papers/doc/4-instrument) and [5-wave](https://github.com/tildearrow/furnace/tree/master/papers/doc/5-wave) for more details. - - Samples are how you play back raw audio streams (samples) on certain channels, on certain soundchips, and in some cases, in certain modes. -To sequence a sample, you do not need to assign it to an instrument, however, to resample samples (change the speed of a sample), you need to bind it to a Sample instrument. -See [6-sample](https://github.com/tildearrow/furnace/tree/master/papers/doc/6-sample) and [4-instrument](https://github.com/tildearrow/furnace/tree/master/papers/doc/4-instrument) for more details. +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. +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. + +it also has a flexible windowing system which you may move around and organize. + +see [2-interface](../2-interface/README.md) and [3-pattern](../3-pattern/README.md) for more information. diff --git a/papers/doc/2-interface/README.md b/papers/doc/2-interface/README.md index c61bf575c..ce2b822b4 100644 --- a/papers/doc/2-interface/README.md +++ b/papers/doc/2-interface/README.md @@ -2,6 +2,10 @@ the Furnace user interface is where the job gets done. +the default layout of Furnace is depicted below. + +![interface](interface1.png) + - [UI components](components.md) - [global keyboard shortcuts](keyboard.md) - [basic mode](basic-mode.md) diff --git a/papers/doc/2-interface/interface1.png b/papers/doc/2-interface/interface1.png new file mode 100644 index 000000000..ae9950139 Binary files /dev/null and b/papers/doc/2-interface/interface1.png differ