FC (format pliku)
From Atariki
Wersja z dnia 00:42, 3 wrz 2011 Mono (Dyskusja | wkład) (przyklad zapisu subsongow) ← Previous diff |
Wersja z dnia 00:45, 3 wrz 2011 Mono (Dyskusja | wkład) (→Tricki przy zapisie tracków) Next diff → |
||
Linia 104: | Linia 104: | ||
* $FF - koniec obwiedni. | * $FF - koniec obwiedni. | ||
- | == Tricki przy zapisie tracków == | + | == Tricki przy zapisie songów == |
Ponieważ format nie precyzuje jak oznaczać subsongi, dlatego stosowane są dwie techniki: | Ponieważ format nie precyzuje jak oznaczać subsongi, dlatego stosowane są dwie techniki: |
Wersja z dnia 00:45, 3 wrz 2011
Format modułu muzycznego obsługiwany przez program Future Composer w wersji 1.32 (mega).
Spis treści |
Postać nieskompresowana
offset | długość | opis |
$0000 | $0002 | identyfikator: $26,$23 |
$0002 | $0001 | tempo |
$0003 | $0100 | dane tracka 1 |
$0103 | $0100 | dane tracka 2 |
$0203 | $0100 | dane tracka 3 |
$0303 | $0080 | dane 32 instrumentów (każdy z nich składa się z 4 bajtów) |
$0383 | ... | dane 64 patternów |
... | ... | dane 32 obwiedni dźwięku |
Dane tracków
Znaczenie poszczególnych poleceń:
- $00..$3F - numer patternu,
- $40 xx - ustawia AUDCTL wartością xx,
- $8x - ustawia transpozycję dla tracka (8 jest przyjmowane, jako transpozycja "zerowa").
- $FE - koniec songu,
- $FF - zapętlenie songu.
Dane patternów
Znaczenie poszczególnych poleceń:
- $00..$3F - zagranie nuty ($00 = C-1, $01 = C#1, ...),
- $40..$5f - odstęp między nutami (ilość definiują bity 0..4 - można w ten sposób zapisać odstęp o 32 pozycje patternu),
- $80..$9f - zmiana instrumentu (numer definiują bity 0..4),
- $FF - koniec patternu.
Dane instrumentów
Każdy instrument zdefiniowany jest za pomocą 4 bajtów:
- $00: numer obwiedni ($00..$1F),
- $01: zniekształcenia wpisywane do AUDCx,
- $02: głębokość efektu powstałego przez naprzemienne granie dźwięku podstawowego i podniesionego o podaną ilość półtonów,
- $03: efekt specjalny ($00 - brak, bit 7 - 0=vibrato, 1=slide down).
Dane obwiedni
Znaczenie poszczególnych poleceń:
- $00..$7F - dane są ORowane ze zniekształceniem instrumentu i wynik zapisywany jest do AUDCx,
- $80..$FE - dane są bezpośrednio zapisywane do AUDCx, a dodatkowo AUDFx ustawiany jest na 0,
- FF - koniec obwiedni.
Postać skompresowana
Plik jest zgrywany bez żadnego nagłówka, jako zwykłe dane RAW i łącznie z procedurą odtwarzającą.
offset | długość | opis |
$0000 | $0001 | pozycja startowa w tracku |
$0001 | $0321 | program playera |
$0322 | $0040 | tablica LSB adresów patternów |
$0362 | $0020 | tablica LSB adresów obwiedni głośności instrumentów |
$0382 | $0040 | tablica MSB adresów patternów |
$03C2 | $0020 | tablica MSB adresów obwiedni głośności instrumentów |
$03E2 | $0020 | tablica czasów trwania nut obliczona na podstawie tempa utworu (pierwszy bajt jest równoważny tempu) |
$0402 | $0003 | tablica LSB adresów tracków |
$0405 | $0003 | tablica MSB adresów tracków |
$0408 | $0080 | tablica instrumentów ($20*4) |
$0488 | ... | dane 64 patternów |
... | ... | dane 32 obwiedni głośności dźwięku |
... | ... | dane 3 tracków |
Na pozycji $0001 w pliku znajduje się rozkaz JSR INIT i na podstawie jego argumentu można odtworzyć adres, pod jaki skompilowano moduł playera i muzyki. Adres liczy się wzorem:
ADDR = msx[2] + $100 * msx[3] - $10
Track
W tracku występują następujące rozkazy:
- $00..$3F - numer patternu do odegrania,
- $40 xx - ustawia AUDCTL wartością xx,
- $8x - transponuje dźwięk o x (8 jest uznawane za "poziom zerowy"),
- $FE - koniec odtwarzania,
- $FF - zapętlenie odtwarzania.
Pattern
W patternie występują następujące rozkazy:
- $00..$3F - nuta,
- $40..$7F - czas trwania dźwięku (bity 0..4),
- $80..$9F - instrument (bity 0..4),
- $FF - koniec patternu.
Instrument
Instrument składa się z pól:
- $00: numer obwiedni głośności,
- $01: zniekształcenie (AUDCx),
- $02: vibrato,
- $03: efekt.
Obwiednia głośności
W obwiedni występują następujące rozkazy:
- $00..$FE - dane obwiedni,
- $FF - koniec obwiedni.
Tricki przy zapisie songów
Ponieważ format nie precyzuje jak oznaczać subsongi, dlatego stosowane są dwie techniki:
1. Na pozycji $0000 playera znajduje się komórka oznaczająca początek songu w trackach. Zmieniając jej wartość można spowodować odgrywanie songu od innego miejsca w trackach. Dzięki temu w jednym module można pomieścić kilka subsongów. Ponieważ song w każdym tracku może zajmować różną ilość miejsca, dlatego pola znajdujące się za subsongiem są zazwyczaj wypełniane zerami (ale mogą zawierać również śmieci!). Np.
0000000: 00 00 07 fe 00 00 08 fe 09 fe 00 00 00 0000010: 00 00 00 00 00 88 02 02 86 02 02 84 02 02 88 02 0000020: 86 02 ff 00 00 00 00 00 00 00 00 00 00 00 00 00 ... 0000100: 00 00 00
0000100: 06 fe 00 00 08 fe 00 00 00 00 0a fe 0b 0000110: fe 0c fe 0d fe 88 03 03 03 01 ff 00 00 00 00 00 ... 0000200: 00 00 00
0000200: 00 ff 00 ff 00 ff 00 ff 00 ff 00 ff 00 0000210: ff 00 ff 00 ff 00 ff 00 ff 00 ff 00 ff 81 01 02 0000220: 03 04 05 05 05 05 05 05 08 05 05 05 05 05 05 05 0000230: 05 05 05 08 0f 12 05 05 05 05 05 05 05 05 05 05 0000240: 08 0f 12 05 05 08 0f 08 0f 08 0f 19 ff 81 00 00 0000250: 00 00 00 00 00 00 06 06 06 81 09 00 00 00 00 00 0000260: 00 00 00 06 06 06 09 00 00 13 14 86 15 0a 0e 0d 0000270: 88 0c 0b 00 00 81 13 14 86 15 81 09 86 16 81 09 0000280: 86 16 81 09 86 16 81 18 ff 88 00 00 00 00 00 00 0000290: 00 00 07 07 07 0b 86 0a 0a 0e 0d 81 0c 88 0b 86 00002a0: 10 11 88 00 00 00 00 00 00 00 00 81 06 06 06 09 00002b0: 86 10 11 00 00 00 00 88 0b 1b 0b 1b 0b 1b 1a ff 00002c0: 01 01 01 01 01 00 01 00 01 00 01 00 01 00 01 00 00002d0: 01 ff 04 03 03 02 02 02 01 01 01 01 01 01 04 03 00002e0: 03 02 02 02 01 ff 89 86 85 04 83 83 02 82 01 81 00002f0: 80 80 ff 8a 84 82 81 80 80 84 82 81 81 80 ff 00 0000300: ff 00 ff
2. Ponieważ player posiada tablicę adresów początków tracków (tablicę LSB adresów tracków w $0402 oraz MSB adresów w $0405), można upakować wiele subsongów zmieniając adresy początków tracków w tej tablicy. Offset songu w trackach ($0000) nie jest zmieniany. Np.
0000000: 88 02 02 02 02 02 02 02 02 08 08 08 08 0000010: 0b 08 08 08 08 0e 0e 11 12 ff 01 01 01 01 03 0a 0000020: 0c 0a 0f 0f 0f 14 ff 04 04 04 04 04 04 04 04 09 0000030: 09 09 09 0d 09 09 09 09 10 10 10 10 10 10 10 10 0000040: 10 10 10 10 13 ff 16 fe 15 ff 17 ff 18 fe ff 19 0000050: fe ff 1a fe ff 1b 1b 1b 1b 1e 1e 1e 1e ff 1c 1c 0000060: 1c 1c 1f 1f 1f 1f ff 1d 1d 20 20 ff 80 5f 08 ff ...
0000100: 81 01 01 01 01 03 0a 0c 0a 0f 0f 0f 14 0000110: ff 04 04 04 04 04 04 04 04 09 09 09 09 0d 09 09 0000120: 09 09 10 10 10 10 10 10 10 10 10 10 10 10 13 ff 0000130: 16 fe 15 ff 17 ff 18 fe ff 19 fe ff 1a fe ff 1b 0000140: 1b 1b 1b 1e 1e 1e 1e ff 1c 1c 1c 1c 1f 1f 1f 1f 0000150: ff 1d 1d 20 20 ff 80 5f 08 ff 82 41 27 20 28 20 0000160: 25 20 27 20 27 20 28 20 25 20 27 20 27 20 28 20 ...
0000200: 81 04 04 04 04 04 04 04 04 09 09 09 09 0000210: 0d 09 09 09 09 10 10 10 10 10 10 10 10 10 10 10 0000220: 10 13 ff 16 fe 15 ff 17 ff 18 fe ff 19 fe ff 1a 0000230: fe ff 1b 1b 1b 1b 1e 1e 1e 1e ff 1c 1c 1c 1c 1f 0000240: 1f 1f 1f ff 1d 1d 20 20 ff 80 5f 08 ff 82 41 27 0000250: 20 28 20 25 20 27 20 27 20 28 20 25 20 27 20 27 0000260: 20 28 20 25 20 27 20 27 20 28 20 25 20 27 20 ff ...
Ten trick pozwala na znacznie gęstsze upakowanie subsongów w module niż sposób 1.