otomatalabs/furnace
8
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Many doc updates.

Browse source 
Settings changes, interface niceties, and a ton of info about sample limits.
This commit is contained in:
Electric Keet 2025-09-27 17:17:07 -07:00 • committed by tildearrow
parent a4b9442cc8
commit d4364a1b74
23 changed files with 81 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

2
doc/7-systems/c140.md
View file

@ -16,6 +16,8 @@ none!
this chip uses the [C140](../4-instrument/c140.md) instrument editor.
maximum sample length is 65535.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/c219.md
View file

@ -24,3 +24,5 @@ if a sample that is on a different bank plays in a group, the group is switched
## info
this chip uses the [C219](../4-instrument/c219.md) instrument editor.
maximum sample length is 131072, and loop start and end points must be even numbers.

2
doc/7-systems/es5506.md
View file

@ -44,6 +44,8 @@ it has a whopping 32 channels of 16-bit PCM and:
this chip uses the [ES5506](../4-instrument/es5506.md) instrument editor.
sample memory is split into 2MB banks, making the maximum sample length 2097024 bytes.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/gba.md
View file

@ -28,6 +28,8 @@ it features echo and up to 16 voices.
this chip uses the [GBA DMA](../4-instrument/gbadma.md) and [GBA MinMod](../4-instrument/gbaminmod.md) instrument editors.
when played via DMA, a sample's loop start point must be a multiple of 4, and the loop's length must be a multiple of 16. sample length is padded to a multiple of 16.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/k007232.md
View file

@ -16,6 +16,8 @@ yeah.
this chip uses the [K007232](../4-instrument/k007232.md) instrument editor.
maximum sample length is 131071 samples.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/k056320.md
View file

@ -12,6 +12,8 @@ this chip is a sample-based chip that featured in a number of Konami arcade game
this chip uses the [K053260](../4-instrument/k053260.md) instrument editor.
maximum sample length is 65535, and loop points are ignored; samples may only loop over the entire sample.
## chip config
the following options are available in the Chip Manager window:

48
doc/7-systems/msm6295.md
View file

@ -1,6 +1,8 @@
# OKI MSM6295
an upgrade from 6258 - it provides 4 ADPCM channels, at max 32 KHz (still no variable pitch though). between late '80s and late '90s, it was one of the most common, if not _the_ most common soundchip used in arcade machines (Capcom, Toaplan, Kaneko, Atari, Tecmo, the list can go on and on...). without bankswitching, the chip supports 256kB of sample RAM and can hold up to 127 samples at once.
this chip is an upgrade from the MSM6258 in that it provides 4 ADPCM channels at a fixed output rate up to 32 KHz depending on clock rate. between the late '80s and late '90s, it was one of the most common, if not _the_ most common soundchip used in arcade machines: Capcom, Toaplan, Kaneko, Atari, Tecmo, the list can go on and on...
without bankswitching, the chip supports 256kB of sample RAM and can hold up to 127 samples at once. Each sample can be up to 63KB.
## effects
@ -14,31 +16,25 @@ this chip uses the [MSM6295](../4-instrument/msm6295.md) instrument editor.
## chip clock rates
like MSM6258, MSM6295 is an extremely basic ADPCM sound codec. it has no variable frequency rate, it depends on clock rate of a chip itself. Furnace supports following rates:
like MSM6258, MSM6295 is an extremely basic ADPCM sound codec. it has no variable sample rate; it depends on clock rate of the chip itself. the clock can be divided by either 132 or by 165 to get the sample rates listed below:
| clock rate | sampling rate |
|--------------------|---------------|
| 1 MHz | 7576 Hz |
| 1.02 MHz | 7727 Hz |
| 1.056 MHz | 8000 Hz |
| 1.193 MHz | 9038 Hz |
| 0.89 MHz | 6742 Hz |
| 0.875 MHz | 6629 Hz |
| 0.9375 MHz | 7102 Hz |
| 1.5 MHz | 11364 Hz |
| 1.79 MHz | 13561 Hz |
| 2 MHz | 15152Hz |
| 2.112 MHz | 16000 Hz |
| 3 MHz | 22728 Hz |
| 3.58 MHz | 27122 Hz |
| 4 MHz | 30304 Hz |
| 4.224 MHz | 32000 Hz |
## chip clock divisor
MSM6295 clock rate could be divided by 132 (resulting sample rates above), or by 165.
to get a clock rate using divisor of 165, formula is clock rate (in Hz) / 165.
example: 1 MHz MSM6295 in 165 divisor mode results in output rate of 6060 Hz.
| clock rate | /132 | /165 |
|--------------------|---------:|---------:|
| 0.875 MHz | 6629 Hz | 5303 Hz |
| 0.89 MHz | 6742 Hz | 5394 Hz |
| 0.9375 MHz | 7102 Hz | 5682 Hz |
| 1 MHz | 7576 Hz | 6061 Hz |
| 1.02 MHz | 7727 Hz | 6182 Hz |
| 1.056 MHz | 8000 Hz | 6400 Hz |
| 1.193 MHz (Atari) | 9038 Hz | 7230 Hz |
| 1.5 MHz | 11364 Hz | 9091 Hz |
| 1.79 MHz | 13561 Hz | 10848 Hz |
| 2 MHz | 15152 Hz | 12121 Hz |
| 2.112 MHz | 16000 Hz | 12800 Hz |
| 3 MHz | 22728 Hz | 18182 Hz |
| 3.58 MHz | 27122 Hz | 21697 Hz |
| 4 MHz | 30304 Hz | 24242 Hz |
| 4.224 MHz | 32000 Hz | 25600 Hz |
## chip config
@ -46,4 +42,4 @@ the following options are available in the Chip Manager window:
- **Clock rate**: sets the rate at which the chip will run.
- **Output rate**: sets the chip clock divider.
- **Bankswitched**: add an NMK112 chip to increase sample memory.
- **Bankswitched**: add an NMK112 chip to increase sample memory to 16MB and the maximum number of samples to 8192. Each bank is up to 63KB with sample headers, and the maximum sample length is 129024 samples.

2
doc/7-systems/multipcm.md
View file

@ -21,3 +21,5 @@ it has a whopping 28 channels of stereo 16-bit PCM and:
## info
this chip uses the [MultiPCM](../4-instrument/multipcm.md) instrument editor.
maximum sample length is 65535 samples.

8
doc/7-systems/nds.md
View file

@ -16,6 +16,14 @@ additionally, the last 8 channels may be put in "PSG mode", featuring 6 channels
this chip uses the [Nintendo DS](../4-instrument/nds.md) instrument editor.
sample length, loop start, and loop end are 32-bit word aligned, meaning they must be divisible evenly by the alignments shown in the table below:
| sample type | sample length max | loop start max | alignment |
|:-----------:|------------------:|---------------:|----------:|
| 16-bit PCM | 8388606 | 131070 | 2 samples |
| 8-bit PCM | 16777212 | 262140 | 4 samples |
| IMA ADPCM | 33554424 | 524280 | 8 samples |
## chip config
the following options are available in the Chip Manager window:

4
doc/7-systems/opl.md
View file

@ -91,6 +91,10 @@ OPL4 PCM uses the [MultiPCM](../4-instrument/multipcm.md) instrument editor.
when two channels are joined for 4-op mode, the channel bar will show `4OP` on a bracket tying them together.
sample lengths on the Y8950 are padded to multiples of 512 samples. ADPCM samples ignore loop points; they may only be loop over the entire sample.
OPL4 maximum sample length is 65535.
## chip config
the following options are available in the Chip Manager window:

4
doc/7-systems/qsound.md
View file

@ -23,6 +23,10 @@ there are also 3 ADPCM channels. ADPCM samples are fixed to 8012Hz.
this chip uses the [QSound](../4-instrument/qsound.md) instrument editor.
PCM sample loops must be no longer than 32767 samples and have a length limit of 65535 samples.
ADPCM samples cannot loop and have a length limit of 131070 samples.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/segapcm.md
View file

@ -19,3 +19,5 @@ Furnace also has a five channel version of this chip, but it only exists for Def
## info
this chip uses the [SegaPCM](../4-instrument/segapcm.md) instrument editor.
maximum sample length is 65280 samples.

2
doc/7-systems/watarasv.md
View file

@ -15,7 +15,7 @@ this chip uses the [Watara Supervision](../4-instrument/watarasv.md) and [Generi
### sample info
sample channel is a 4-bit DMA channel with 4 frequencies assigned to sample octaves (C2, C3, C4, C5; C, C#, D, D# in Furnace respectively). max sample size is 4 kilobytes (8192 samples).
the sample channel is a 4-bit DMA channel with 4 frequencies assigned to sample octaves (C2, C3, C4, C5; C, C#, D, D# in Furnace respectively). max sample size is 4 kilobytes (8192 samples), samples are padded to multiples of 32 samples, and loop points are ignored.
## chip config

2
doc/7-systems/x1-010.md
View file

@ -41,6 +41,8 @@ this chip was the inspiration for Organya/PxTone (the former being used in a wel
this chip uses the [X1-010](../4-instrument/x1_010.md) instrument editor.
if bankswitched, the sample length limit is 131072 samples.
## chip config
the following options are available in the Chip Manager window:

2
doc/7-systems/ym2608.md
View file

@ -114,6 +114,8 @@ the [YM2610 (OPNB)](ym2610.md) and [YM2610B](ym2610b.md) chips are very similar
this chip uses the [FM (OPN)](../4-instrument/fm-opn.md), [AY-3-8910/SSG](../4-instrument/ay8910.md), [ADPCM-A](../4-instrument/adpcm-a.md) and [ADPCM-B](../4-instrument/adpcm-b.md) instrument editors.
sample lengths are padded to multiples of 512 samples. loop points are ignored for ADPCM samples; they may only loop over the entire sample.
## extended channel 3
in ExtCh mode, channel 3 is split into one column for each of its four operators. feedback and LFO levels are shared. the frequency of each operator may be controlled independently with notes and effects. this can be used for more polyphony or more complex sounds.

6
doc/7-systems/ym2610.md
View file

@ -112,6 +112,12 @@ its soundchip is a 4-in-1: 4ch 4-op FM, YM2149 (an AY-3-8910 clone) and [2 diffe
this chip uses the [FM (OPN)](../4-instrument/fm-opn.md), [AY-3-8910/SSG](../4-instrument/ay8910.md), [ADPCM-A](../4-instrument/adpcm-a.md) and [ADPCM-B](../4-instrument/adpcm-b.md) instrument editors.
sample lengths are padded to multiples of 512 samples.
ADPCM-A samples cannot loop, and have a fixed sample rate of the chip's clock divided by 432.
ADPCM-B samples have a maximum length of 2097152 samples, and loop points are ignored; they may only loop over the entire sample. these have a maximum sample rate of the chip's clock speed divided by 144.
## extended channel 2
in ExtCh mode, channel 2 is split into one column for each of its four operators. feedback and LFO levels are shared. the frequency of each operator may be controlled independently with notes and effects. this can be used for more polyphony or more complex sounds.

6
doc/7-systems/ymz280b.md
View file

@ -2,7 +2,7 @@
8-channel PCM/ADPCM sample-based sound chip designed for use with arcade machines. it lived throughout mid to late 90s.
it has 16-level stereo panning, up to 16-bit PCM and up to 16MB of external PCM data.
it has 16-level stereo panning, up to 16-bit PCM and up to 16MB of external PCM data. 4-bit ADPCM has a sample playback rate limit of 44.1 kHz with a tunning resolution of 256 Hz, while 8-bit and 16-bit PCM can go up to 88.2kHz with a tuning resolution of 512 Hz.
## effects
@ -12,6 +12,10 @@ none so far.
this chip uses the [YMZ280B](../4-instrument/ymz280b.md) instrument editor.
4-bit ADPCM format can be selected in the sample editor as "YMZ/YMU ADPCM". for this format, loop start and end points must align to multiples of 2 samples, and samples will be padded to a multiple of 2 samples.
PCM samples have a maximum playback rate of the chip's clock divided by 192.
## chip config
the following options are available in the Chip Manager window: