From 000a2f626f81b3dc9727429500d27767c38fa921 Mon Sep 17 00:00:00 2001 From: Electric Keet Date: Fri, 19 Jul 2024 12:37:54 -0700 Subject: [PATCH] All graphics and example file included. Also, of course, more edits to the doc itself. --- demos/quickstart.fur | Bin 0 -> 13941 bytes doc/1-intro/qs-insteditor.png | Bin 0 -> 29551 bytes doc/1-intro/qs-instlist-empty.png | Bin 0 -> 7587 bytes doc/1-intro/qs-instlist-full.png | Bin 0 -> 13264 bytes doc/1-intro/qs-instlist-lessempty.png | Bin 0 -> 9801 bytes doc/1-intro/qs-macro-release.png | Bin 0 -> 30474 bytes doc/1-intro/qs-macro.png | Bin 0 -> 30482 bytes doc/1-intro/qs-notes-effect.png | Bin 0 -> 2450 bytes doc/1-intro/qs-notes-inst.png | Bin 0 -> 2951 bytes doc/1-intro/qs-notes-spaced.png | Bin 0 -> 4265 bytes doc/1-intro/qs-notes-vol.png | Bin 0 -> 3089 bytes doc/1-intro/qs-notes-wronginst.png | Bin 0 -> 4161 bytes doc/1-intro/qs-order-added.png | Bin 0 -> 7851 bytes doc/1-intro/qs-order-changed.png | Bin 0 -> 8012 bytes doc/1-intro/qs-order-default.png | Bin 0 -> 6492 bytes doc/1-intro/qs-samplist.png | Bin 0 -> 8012 bytes doc/1-intro/qs-speed.png | Bin 0 -> 17166 bytes doc/1-intro/qs-waveeditor.png | Bin 0 -> 15232 bytes doc/1-intro/qs-wavelist.png | Bin 0 -> 7310 bytes doc/1-intro/quickstart.md | 97 +++++++++++--------------- 20 files changed, 42 insertions(+), 55 deletions(-) create mode 100644 demos/quickstart.fur create mode 100644 doc/1-intro/qs-insteditor.png create mode 100644 doc/1-intro/qs-instlist-empty.png create mode 100644 doc/1-intro/qs-instlist-full.png create mode 100644 doc/1-intro/qs-instlist-lessempty.png create mode 100644 doc/1-intro/qs-macro-release.png create mode 100644 doc/1-intro/qs-macro.png create mode 100644 doc/1-intro/qs-notes-effect.png create mode 100644 doc/1-intro/qs-notes-inst.png create mode 100644 doc/1-intro/qs-notes-spaced.png create mode 100644 doc/1-intro/qs-notes-vol.png create mode 100644 doc/1-intro/qs-notes-wronginst.png create mode 100644 doc/1-intro/qs-order-added.png create mode 100644 doc/1-intro/qs-order-changed.png create mode 100644 doc/1-intro/qs-order-default.png create mode 100644 doc/1-intro/qs-samplist.png create mode 100644 doc/1-intro/qs-speed.png create mode 100644 doc/1-intro/qs-waveeditor.png create mode 100644 doc/1-intro/qs-wavelist.png diff --git a/demos/quickstart.fur b/demos/quickstart.fur new file mode 100644 index 0000000000000000000000000000000000000000..0e2d241b5f566fb7d0454f8dd5be10d36f61ad1a GIT binary patch literal 13941 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�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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-instlist-lessempty.png b/doc/1-intro/qs-instlist-lessempty.png new file mode 100644 index 0000000000000000000000000000000000000000..ec2005c9d472dc860932de68f1edecc04f75699b GIT binary patch literal 9801 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 Xy{vcmTtaI8|9+5_RFJ3rlf literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-macro-release.png b/doc/1-intro/qs-macro-release.png new file mode 100644 index 0000000000000000000000000000000000000000..659982f3bfb2c219fce6525fd479bb46ade83e93 GIT binary patch literal 30474 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ⅆ*z<)kO6IdrbDr!2_%BkTArS*uPcGz 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-notes-effect.png b/doc/1-intro/qs-notes-effect.png new file mode 100644 index 0000000000000000000000000000000000000000..1d88ee4859320bc72cf95b0a6e86fb3c36b25e20 GIT binary patch literal 2450 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 E2OWrkvH$=8 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-notes-inst.png b/doc/1-intro/qs-notes-inst.png new file mode 100644 index 0000000000000000000000000000000000000000..2c0c2e9bf4aceff4dccb7c38b416049e2506d531 GIT binary patch literal 2951 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 D=Itgi literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-notes-vol.png b/doc/1-intro/qs-notes-vol.png new file mode 100644 index 0000000000000000000000000000000000000000..5644da1a0bcdbfd013660379c59af13d1e9704d7 GIT binary patch literal 3089 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-notes-wronginst.png b/doc/1-intro/qs-notes-wronginst.png new file mode 100644 index 0000000000000000000000000000000000000000..b92e6a70da1320f1eb469ca42509678410e14917 GIT binary patch literal 4161 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 H*dhEsEsX(0 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-order-added.png b/doc/1-intro/qs-order-added.png new file mode 100644 index 0000000000000000000000000000000000000000..372968f46218af3789e0fd96e575fb255bf6db3d GIT binary patch literal 7851 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-order-changed.png b/doc/1-intro/qs-order-changed.png new file mode 100644 index 0000000000000000000000000000000000000000..47abdcc6c75bf8d57132bcc26f450dda9b7620fd GIT binary patch literal 8012 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-order-default.png b/doc/1-intro/qs-order-default.png new file mode 100644 index 0000000000000000000000000000000000000000..e7823b0f8d679a98be31b666ff9e523740312139 GIT binary patch literal 6492 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-samplist.png b/doc/1-intro/qs-samplist.png new file mode 100644 index 0000000000000000000000000000000000000000..cfe4990e88145e60cc3b510cefaf174820022435 GIT binary patch literal 8012 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-speed.png b/doc/1-intro/qs-speed.png new file mode 100644 index 0000000000000000000000000000000000000000..19a9e109d6db3626e4ed202ab0042d644ab42c02 GIT binary patch literal 17166 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 HCGh_Mrt_mY literal 0 HcmV?d00001 diff --git a/doc/1-intro/qs-waveeditor.png b/doc/1-intro/qs-waveeditor.png new file mode 100644 index 0000000000000000000000000000000000000000..33ad7dfbea25a8a314239e1f4a36cfb3cc79ce8d GIT binary patch literal 15232 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 Q0$%{cgro$^K5O~>f21eRX9`{g~~ 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 literal 0 HcmV?d00001 diff --git a/doc/1-intro/quickstart.md b/doc/1-intro/quickstart.md index 2e7d3df1a..6694e15e5 100644 --- a/doc/1-intro/quickstart.md +++ b/doc/1-intro/quickstart.md @@ -1,10 +1,3 @@ - - # quick start guide first things first: thank you for taking the time to understand Furnace, the world's most comprehensive chiptune tracker. it's amazingly versatile, but it can also be intimidating, even for those already familiar with trackers. this quick start guide will get you on the road to making the chiptunes of your dreams! if you're a beginner, it will probably take about an hour from start to finish. @@ -29,9 +22,9 @@ on starting Furnace for the first time, the interface should look like this. if there's a lot going on, but the most prominent part of Furnace's interface is the **pattern view** – the spreadsheet-like table that takes up the bottom-left. -click to place the cursor somewhere in this view. it will appear as a medium-blue highlight. try moving around with the up and down arrow keys. also try the `PgUp` and `PgDn` keys to move around faster. the vertical axis represents time. during editing and playback the view scrolls around a highlighted row that stays put in the center; this is called the **playhead**. +click to place the cursor somewhere in this view. it will appear as a medium-blue highlight. try moving around with the up and down arrow keys. also try the `PgUp` and `PgDn` keys to move around faster. the `Home` and `End` keys quickly move to the first and last rows. the vertical axis represents time. during editing and playback the view scrolls around a highlighted row that stays put in the center; this is called the **playhead**. -now try the left and right arrow keys to move between columns. while we're at it, use the `Home` and `End` keys to quickly get to the first and last columns. pressing them twice will also shuttle you to the top or bottom row. when you're done, hit `Home` twice to return to the top-left. +now try the left and right arrow keys to move between columns. pressing `Home` or `End` twice will shuttle you to the first or last column, respectively. when you're done, hit `Home` twice to return to the top-left. hit `Del` to delete them all at once. +now let's clear out those notes. you could delete them individually with the `Del` key, but let's try something else first. click and drag to select them all. you'll know they're selected when they have a medium grey background. hit `Del` to delete them all at once. ![selection area](qs-selection.png) @@ -65,7 +58,7 @@ you'll usually want more than one note playing at a time. move back to the start ![notes in three channels](qs-notes-channels.png) -that chord will ring out for quite some time, but let's try stopping it early. a few rows after that chord, use the `Tab` or `1` key to enter a **note off** (sometimes called "note cut") in each channel that has a note. it'll appear as `OFF` in the note column. now try the shortcut `F5` to play from the start without having to move there. you should hear the chord as before, then it will stop where the note offs are, as though letting off the keys of a piano. +that chord will ring out for quite some time, but let's try stopping it early. a couple rows after that chord, use the `Tab` or `1` key to enter a **note off** (sometimes called "note cut") in each channel that has a note. it'll appear as `OFF` in the note column. now try the shortcut `F5` to play from the start without having to move there. you should hear the chord as before, then it will stop where the note offs are, as though letting off the keys of a piano. ![notes and note offs](qs-noteoffs-channels.png) @@ -77,19 +70,19 @@ before the next part of this guide, save the current **module** – the tracker at the top of the interface, just right of center, is the **instrument** list. there are also tabs for wavetables and samples, but we'll get to those later. just like physical instruments, these define the sounds we can use in the track. unlike physical instruments, these sounds can be endlessly redefined. -{{ empty instrument list }} +![empty instrument list](qs-instlist-empty.png) click the `+` button to add a new instrument. a small list of instrument types will pop up, one for each type supported by the chips in use. select "FM (OPN)", and the new instrument will appear in the list as "00: Instrument 0". this will sound the same as the default instrument (listed as "- None -"). -we still need something new and different, so let's pull from another module. open up a second instance of Furnace and use `Ctrl-O` to open the `quickstart.fur` file included with Furnace in its `demos` directory. the instrument list will contain "00: horn"; select it, then use the floppy-disk save icon above it to save it wherever you like. Furnace instrument filenames end with the `.fui` extension. +we still need something new and different, so let's pull from another module. open up a second instance of Furnace and use `Ctrl-O` to open the `quickstart.fur` file included with Furnace in its `demos` directory. the instrument list will contain "00: horn"; select it, then use the floppy-disk save icon above it to save it wherever you like. Furnace instrument filenames end with the `.fui` extension. let's return to the first instance with our slowly-evolving practice track. load up the new instrument; click the folder button left of the "save instrument" button and select the file. it will appear in the list as "01: horn", and it should already be highlighted. -{{ less empty instrument list }} +![less empty instrument list](qs-instlist-lessempty.png) -click into the pattern view and add some notes. the number `01` appears next to them; this is the instrument column, and it can be edited directly by typing in the number desired. generally, each note should have an associated instrument value. +click into the pattern view and add some notes in another FM channel well after our existing chord. we'll hear them with our new sound, and the number `01` appears next to them. this is the instrument column, and it can be edited directly by typing in the number desired. generally, each note should have an associated instrument value. -{{ small chunk of pattern view showing filled-in instrument value }} +![notes with instruments](qs-notes-inst.png) +beneath Base Tempo is "Speed", set to 6. right now, each row takes 6 ticks to complete before moving to the next row. let's say we want things to be a little faster. play the current set of notes to hear their tempo first. then, change speed to 5; the tempo after "Divider" will now show "180.00 BPM". play our notes back, and they're definitely faster... perhaps faster than desired. it's possible to get tempos in between by alternating speeds; if you're interested, check out the documentation on [speeds and grooves](../8-advanced/grooves.md) later on. ## what about those other channels? here's where we really get into the nitty-gritty of our emulated videogame system. we've been using Furnace's default system, the Sega Genesis. it employs two very different sound chips. the first is the Yamaha YM2612, also known as the Yamaha OPN2; it uses frequency modulation (FM) synthesis to generate sounds, and that's what we've heard so far. the other sound chip is the Sega PSG; it's a programmable sound generator (PSG) that can only make square waves and variations of noise. it's nowhere near as versatile, but don't ignore it – it's an important part of the classic Genesis sound. -let's start by creating a new instrument, this time choosing "Sega PSG" from the list. the new "Instrument 2" appears in the instrument list, already selected. now click in the pattern view and change one of our existing notes to use the new instrument. the number will change color from soft blue to bright yellow; this means that the chosen instrument isn't meant for the chip it's being used on, and if played back, we'll only hear that familiar default FM instrument. +let's start by creating a new instrument, this time choosing "SN76489/Sega PSG" from the list. the new "Instrument 2" appears in the instrument list, already selected. now click in the pattern view and change one of our existing notes to use the new instrument. the number will change color from soft blue to bright yellow; this means that the chosen instrument isn't meant for the chip it's being used on, and if played back, we'll only hear that familiar default FM instrument. -{{ chunk of pattern view showing normal instruments and one incorrect one }} +![notes with a wrong instrument](qs-notes-wronginst.png) go ahead and undo that edit, then move to the channel labelled "Square 1", the first of the PSG's channels. try adding notes with the new instrument, and they'll work just fine without complaint. of course, they're plain, no-frills square waves. while we're here, try making them quieter by entering new volumes; since this chip only uses sixteen volume levels, `0F` is the maximum. @@ -176,15 +165,15 @@ let's move to the noise channel now. the same instrument will work here, but pla the FM side of the Sega Genesis has a special feature; channel 6 can be used to play back digital **samples**. this means that any recording – a snare drum, an orchestra hit, somebody talking, whatever you have – can be part of the music. -go back to that second instance of Furnace. just as we saved an instrument last time, let's switch to the "Samples" tab and select the lone sample there, "0: bell", then save it as a `.wav` file. swap back to the instance of Furnace we've been working in, and load it there. +go back to that second instance of Furnace. just as we saved an instrument last time, let's switch to the "Samples" tab and select the lone sample there, "0: example", then save it as a `.wav` file. swap back to the instance of Furnace we've been working in, and in the Sample tab, open it. -{{ samples tab? }} +![sample list](qs-samplist.png) in order to use the sample, we want to make an instrument that references it. right-click on it in the list and select "make instrument". the "Instrument Editor" window will pop up to show us that we now have an instrument 3 named "example", a type of "Generic Sample", and below that, the sample selected is "example". while we're at it, let's change the instrument name to "bell" since that's what it sounds like; just select the "example" at the top and type over it. -{{ instrument list? }} +![full instrument list](qs-instlist-full.png) -now, let's hear it in action. close the instrument editor, then clear out everything in the patterns of our first order. (either delete what's there, or adjust orders to get it out of the way.) switch to our new bell instrument and put a C-4 note in channel "FM 6". when we play it back, it sounds perfect! +now, let's hear it in action. close the instrument editor, then clear out everything in the patterns of our first order. (either delete what's there, or adjust orders to get it out of the way. try hitting `Ctrl-A` three times to select everything at once.) switch to our new bell instrument and put a C-4 note in channel "FM 6". when we play it back, it sounds perfect! if ever a sample sounds out of tune, refer to the [sample tuning guide](../9-guides/tuning-samples.md) to fix it up. @@ -194,21 +183,21 @@ now that we've gotten everything we need from `quickstart.fur`, close that insta ## what about wavetables? -some chips can use **wavetables**, which are a lot like very short looping samples. one of these is the Game Boy. let's start a new file, either from the menu or with `Ctrl-N`. a dialog box pops up to ask which system we want; type "boy" in the search and it can be easily located in the results. +some chips can use **wavetables**, which are a lot like very short looping samples. one of these is the Game Boy. let's start a new file, either from the menu or with `Ctrl-N`. a warning dialog asks if you want to save; it's up to you. after that, a dialog box pops up to ask which system we want; type "boy" in the search and it will be at the top of the results. select it. in our brand new song, we'll want to add a new wavetable. between the "Instruments" and "Samples" tabs, select "Wavetables". add a new one with the `+` button. Furnace will generate a wavetable of the right size for the current chip, and it will already have a sawtooth wave in it. -{{ wavetables list }} +![wavetables list](qs-wavelist.png) double-click that new entry to open the "Wavetable Editor". you'll see a line of large pixel-like blocks. this is our sawtooth wave. nice as those are, let's get creative. click anywhere in that area and "draw" a new wave, something interesting. note that at the bottom of the window, there's a line of numbers that change as you edit. you can edit the numbers directly to change the values above; keep this in mind for later. once you're happy with this wavetable, make at least two more, just for later demonstration purposes. -{{ wavetable editor }} +![wavetable editor](qs-waveeditor.png) right now, we can't do much with this wavetable; as with samples, it needs an instrument. this time we can't just create one directly from the wavetable, so go to the instruments list and add a new one. open it up in the instrument editor, name it whatever you like, then select its "Macros" tab. -we'll get to macros in more detail in a bit, but for now, simply click the down-arrow next to "Wavetable". click the `+` button that appears; a column will turn grey in the box to the right. click in the middle of that column and it turns half orange; this is how you select which wavetable to use for this instrument. it's like a bar graph. +we'll get to macros in more detail in a bit, but for now, simply click the down-arrow next to "Waveform". click the `+` button that appears; a column will turn grey in the box to the right. click in the middle of that column and it turns half orange; this is how you select which wavetable to use for this instrument. it's like a bar graph. -{{ instrument editor on macros tab }} +![instrument editor](qs-insteditor.png) close the wavetable editor, move the instrument editor off to the side, and click into the "Wavetable" channel in the pattern view. add a few notes to get a good sense of their tone. in the instrument editor, change that macro to a different value, and play the notes again to hear the difference between the wavetables you made. @@ -218,21 +207,19 @@ the **macro** is perhaps Furnace's most powerful feature. formally defined, it a let's start by clearing out the notes we've entered. after that, move the cursor to the top-left into the "Pulse 1" channel. create a new instrument and go into the instrument editor. we'll want to work with the volume macro, but before we can do that, we have to select the "Game Boy" tab and check the box labelled "Use software envelope". the Game Boy's sound hardware can do its own limited volume envelopes, but those won't help us right now, and if we leave the box unchecked, the volume macro won't work (though the others will). -{{ instrument editor on Game Boy tab with that box checked? }} - -in the "Macros" tab, click the down arrow next to "Volume" to open it up. the number that appears beneath the word "Volume" is the length of the macro; let's set it to 30. in the large box next to it, draw a ramp from near minimum volume (1) to maximum volume (15) at the left, then another down to minimum volume (0) at the right. if it's a little uneven, that's okay; you can always edit the numbers directly beneath the box, just as with the wavetable editor. +in the "Macros" tab, the number that appears beneath the word "Volume" is the length of the macro; let's set it to 30. in the large box next to it, draw a ramp from near minimum volume (1) to maximum volume (15) at the left, then another down to minimum volume (0) at the right. if it's a little uneven, that's okay; you can always edit the numbers directly beneath the box, just as with the wavetable editor. also try right-clicking in the macro and dragging; now you have perfectly smooth ramps. you may have a little trouble navigating the whole macro at once. use the scrollbar at the top of the macros tab to move around it. even better, use the `-` button to the left of it to narrow the bars until it's all visible! -{{ completed macro }} +![volume macro](qs-macro.png) while in the instrument editor (and as long as you're not in a text box) you can play notes on the keyboard without affecting anything in the pattern view. give it a try, and you'll notice that when held down, each note does its own quick fade in then fade to silence. you could do this with effects, but if you're using it on many notes, doing it with the instrument itself could save a lot of typing! in the pattern view, add a few notes spaced far enough apart that the whole rise and fall is audible (at speed 6, five rows will do). then look to the thin bar underneath the macro view. it may not look like much, but if you hold the `Shift` key and click directly underneath the peak of the macro, it will light up green. we've just set a **release point**. play with the instrument a little here, and notice that holding the key down holds the note in place at top volume – at the release point – until let go. now play the song from the start; each note will rise to max volume then stay there until the next note plays. -{{ macro view }} +![volume macro with release](qs-macro-release.png) -somewhere after the last note in our song, move to about ten rows beneath it and place a note off. the final note rises to maximum, then is suddenly cut off! to get the rest of the macro to play, delete the note off and use the `~` key to put in a **macro release** instead, which will appear as `REL`. now when the song is played back, the final note will rise and hold steady until it reaches the macro release, then we'll hear the rest of the macro play out. +about ten rows after the last note in our song, place a note off. the final note rises to maximum, then is suddenly cut off! to get the rest of the macro to play, move your cursor over the note off and use the `~` key to replace it with a **macro release** instead, which will appear as `REL`. now when the song is played back, the final note will rise and hold steady until it reaches the macro release, then we'll hear the rest of the macro play out. macros are absurdly powerful tools. read the [macro documentation](../4-instrument/README.md) to make the most of them!