new ins format, part 1
This commit is contained in:
tildearrow
parent
98de4c6ca8
commit
ae7382f7a9
3 changed files with 519 additions and 92 deletions
310
papers/newIns.md
310
papers/newIns.md
|
|
@ -48,20 +48,34 @@ the following feature codes are recognized:
|
|||
- `SU`: Sound Unit ins data
|
||||
- `ES`: ES5506 ins data
|
||||
- `X1`: X1-010 ins data
|
||||
- `EN`: end of features
|
||||
- if you find this feature code, stop reading the instrument.
|
||||
- it will usually appear only when there sample/wave lists.
|
||||
|
||||
# instrument name (NA)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
STR | instrument name
|
||||
```
|
||||
|
||||
# FM data (FM)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | operator count
|
||||
1 | flags
|
||||
| - bit 4-7: op enabled
|
||||
| - op order from 4 to 7: 0, 2, 1, 3
|
||||
| - 2-op instruments: 0, 1, x, x
|
||||
| - bit 0-3: op count
|
||||
-----|------------------------------------
|
||||
| **base data**
|
||||
| /7 6 5 4 3 2 1 0|
|
||||
1 | |x| ALG |x| FB |
|
||||
1 | |FMS2 |AMS| FMS |
|
||||
1 | |AM2|4| LLPatch |
|
||||
1 | |KV4|KV3|KV2|KV1|
|
||||
-----|------------------------------------
|
||||
| **operator data × opCount**
|
||||
| /7 6 5 4 3 2 1 0|
|
||||
|
|
@ -73,11 +87,11 @@ size | description
|
|||
| \- VIB
|
||||
1 | |A|KSL| D R |
|
||||
| \- AM
|
||||
1 | |e|x| D2R |
|
||||
1 | |e|KVS| D2R |
|
||||
| \- EGT
|
||||
1 | | S L | R R |
|
||||
1 | | DVB | SSG |
|
||||
1 | | DAM | W S |
|
||||
1 | | DAM |DT2| W S |
|
||||
```
|
||||
|
||||
# macro data (MA)
|
||||
|
|
@ -113,8 +127,8 @@ size | description
|
|||
| - 15: ex4
|
||||
| - 16: ex5
|
||||
| - 17: ex6
|
||||
| - 17: ex7
|
||||
| - 18: ex8
|
||||
| - 18: ex7
|
||||
| - 19: ex8
|
||||
| - 255: stop reading and move on
|
||||
1 | macro length
|
||||
1 | macro loop
|
||||
|
|
@ -137,3 +151,287 @@ size | description
|
|||
| - length: macro length × word sizs
|
||||
```
|
||||
|
||||
# C64 data (64)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | flags 1
|
||||
| - bit 7: dutyIsAbs
|
||||
| - bit 6: initFter
|
||||
| - bit 5: volIsCutoff
|
||||
| - bit 4: toFilter
|
||||
| - bit 3: noise on
|
||||
| - bit 2: pulse on
|
||||
| - bit 1: saw on
|
||||
| - bit 0: triangle on
|
||||
1 | flags 2
|
||||
| - bit 7: oscSync
|
||||
| - bit 6: ringMod
|
||||
| - bit 5: noTest
|
||||
| - bit 4: filterIsAbs
|
||||
| - bit 3: ch3off
|
||||
| - bit 2: band pass
|
||||
| - bit 1: high pass
|
||||
| - bit 0: low pass
|
||||
1 | attack/decay
|
||||
| - bit 4-7: attack
|
||||
| - bit 0-3: decay
|
||||
1 | sustain release
|
||||
| - bit 4-7: sustain
|
||||
| - bit 0-3: release
|
||||
2 | duty
|
||||
2 | cutoff/resonance
|
||||
| - bit 12-15: resonance
|
||||
| - bit 0-10: cutoff
|
||||
```
|
||||
|
||||
# Game Boy data (GB)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | envelope params
|
||||
| - bit 5-7: length
|
||||
| - bit 4: direction
|
||||
| - bit 0-3: volume
|
||||
1 | sound length
|
||||
| - 64 is infinity
|
||||
1 | flags
|
||||
| - bit 1: always init envelope
|
||||
| - bit 0: software envelope (zombie mode)
|
||||
1 | hardware sequence length
|
||||
??? | hardware sequence...
|
||||
| - length: 3*hwSeqLen
|
||||
```
|
||||
|
||||
a value in the hardware sequence has the following format:
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | command
|
||||
| - 0: set envelope
|
||||
| - 1: set sweep
|
||||
| - 2: wait
|
||||
| - 3: wait for release
|
||||
| - 4: loop
|
||||
| - 5: loop until release
|
||||
2 | data
|
||||
| - for set envelope:
|
||||
| - 1 byte: parameter
|
||||
| - bit 4-7: volume
|
||||
| - bit 3: direction
|
||||
| - bit 0-2: length
|
||||
| - 1 byte: sound length
|
||||
| - for set sweep:
|
||||
| - 1 byte: parameter
|
||||
| - bit 4-6: length
|
||||
| - bit 3: direction
|
||||
| - bit 0-2: shift
|
||||
| - 1 byte: nothing
|
||||
| - for wait:
|
||||
| - 1 byte: length (in ticks)
|
||||
| - 1 byte: nothing
|
||||
| - for wait for release:
|
||||
| - 2 bytes: nothing
|
||||
| - for loop/loop until release:
|
||||
| - 2 bytes: position
|
||||
```
|
||||
|
||||
# sample ins data (SM)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
2 | initial sample
|
||||
1 | flags
|
||||
| - bit 2: use wave
|
||||
| - bit 1: use sample
|
||||
| - bit 0: use sample map
|
||||
1 | waveform length
|
||||
4?? | sample map... (120 entries)
|
||||
| - only read if sample map is enabled
|
||||
```
|
||||
|
||||
the sample map format:
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
2 | note to play
|
||||
2 | sample to play
|
||||
```
|
||||
|
||||
# operator macro data (O1, O2, O3 and O4)
|
||||
|
||||
similar to macro data, but using these macro codes:
|
||||
|
||||
- 0: AM
|
||||
- 1: AR
|
||||
- 2: DR
|
||||
- 3: MULT
|
||||
- 4: RR
|
||||
- 5: SL
|
||||
- 6: TL
|
||||
- 7: DT2
|
||||
- 8: RS
|
||||
- 9: DT
|
||||
- 10: D2R
|
||||
- 11: SSG-EG
|
||||
- 12: DAM
|
||||
- 13: DVB
|
||||
- 14: EGT
|
||||
- 15: KSL
|
||||
- 16: SUS
|
||||
- 17: VIB
|
||||
- 18: WS
|
||||
- 19: KSR
|
||||
|
||||
# OPL drums mode data (LD)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | fixed frequency mode
|
||||
2 | kick freq
|
||||
2 | snare/hat freq
|
||||
2 | tom/top freq
|
||||
```
|
||||
|
||||
# SNES data (SN)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | attack/decay
|
||||
| - bit 4-6: decay
|
||||
| - bit 0-3: attack
|
||||
1 | sustain/release
|
||||
| - bit 5-6: sustain
|
||||
| - bit 0-4: release
|
||||
1 | flags
|
||||
| - bit 4: envelope on
|
||||
| - bit 3: make sustain effective
|
||||
| - bit 0-2: gain mode
|
||||
| - 0: direct
|
||||
| - 4: dec
|
||||
| - 5: exp
|
||||
| - 6: inc
|
||||
| - 7: bent
|
||||
1 | gain
|
||||
```
|
||||
|
||||
# Namco 163 data (N1)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
4 | waveform
|
||||
1 | wave pos
|
||||
1 | wave len
|
||||
1 | wave mode
|
||||
```
|
||||
|
||||
# FDS/Virtual Boy data (FD)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
4 | mod speed
|
||||
4 | mod depth
|
||||
1 | init mod table with first wave
|
||||
1?? | modulation table (32 entries)
|
||||
```
|
||||
|
||||
# wavetable synth data (WS)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
4 | first wave
|
||||
4 | second wave
|
||||
1 | rate divider
|
||||
1 | effect
|
||||
| - bit 7: single or dual effect
|
||||
1 | enabled
|
||||
1 | global
|
||||
1 | speed (+1)
|
||||
1 | parameter 1
|
||||
1 | parameter 2
|
||||
1 | parameter 3
|
||||
1 | parameter 4
|
||||
```
|
||||
|
||||
# list of samples (SL)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | number of samples
|
||||
4?? | pointers to samples...
|
||||
| - these use the Furnace sample format.
|
||||
```
|
||||
|
||||
# list of wavetables (WL)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | number of wavetables
|
||||
4?? | pointers to wavetables...
|
||||
| - these use the Furnace wavetable format.
|
||||
```
|
||||
|
||||
# MultiPCM data (MP)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | attack rate
|
||||
1 | decay 1 rate
|
||||
1 | decay level
|
||||
1 | decay 2 rate
|
||||
1 | release rate
|
||||
1 | rate correction
|
||||
1 | LFO rate
|
||||
1 | vibrato depth
|
||||
1 | AM depth
|
||||
```
|
||||
|
||||
# Sound Unit data (SU)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | switch roles of phase reset timer and frequency
|
||||
```
|
||||
|
||||
# ES5506 data (ES)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
1 | filter mode
|
||||
| - 0: HPK2_HPK2
|
||||
| - 1: HPK2_LPK1
|
||||
| - 2: LPK2_LPK2
|
||||
| - 3: LPK2_LPK1
|
||||
2 | K1
|
||||
2 | K2
|
||||
2 | envelope count
|
||||
1 | left volume ramp
|
||||
1 | right volume ramp
|
||||
1 | K1 ramp
|
||||
1 | K2 ramp
|
||||
1 | K1 slow
|
||||
1 | K2 slow
|
||||
```
|
||||
|
||||
# X1-010 data (X1)
|
||||
|
||||
```
|
||||
size | description
|
||||
-----|------------------------------------
|
||||
4 | bank slot
|
||||
```
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue