FC (format pliku)

From Atariki

Revision as of 00:45, 3 wrz 2011; view current revision
←Older revision | Newer revision→
Jump to: navigation, search

Format modułu muzycznego obsługiwany przez program Future Composer w wersji 1.32 (mega).

Spis treści

Postać nieskompresowana

offsetdługośćopis
$0000$0002identyfikator: $26,$23
$0002$0001tempo
$0003$0100dane tracka 1
$0103$0100dane tracka 2
$0203$0100dane tracka 3
$0303$0080dane 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ą.

offsetdługośćopis
$0000$0001pozycja startowa w tracku
$0001$0321program playera
$0322$0040tablica LSB adresów patternów
$0362$0020tablica LSB adresów obwiedni głośności instrumentów
$0382$0040tablica MSB adresów patternów
$03C2$0020tablica MSB adresów obwiedni głośności instrumentów
$03E2$0020tablica czasów trwania nut obliczona na podstawie tempa utworu (pierwszy bajt jest równoważny tempu)
$0402$0003tablica LSB adresów tracków
$0405$0003tablica MSB adresów tracków
$0408$0080tablica 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.

Źródło: "http://atariki.krap.pl/index.php/FC_%28format_pliku%29"
Personal tools