Tekst źródłowy strony NEO

Format modułu muzycznego obsługiwany przez program [[NeoTracker]].

<table border=1>
<tr><td>offset</td><td>długość</td><td>opis</td></tr>
<tr><td>$0000</td><td>$0003</td><td>identyfikator: 'NEO' w ASCII</td></tr>
<tr><td>$0003</td><td>$0001</td><td>zarezerwowane (obecnie 0)</td></tr>
<tr><td>$0004</td><td>$0001</td><td>numer wersji programu koniecznej do poprawnego wczytania pliku ($10 - 1.12, $14 - 1.4+)</td></tr>
<tr><td>$0005</td><td>$0001</td><td>typ pliku: $8e</td></tr>
<tr><td>$0006</td><td>$0028</td><td>tytuł utworu (uzupełniony spacjami)</td></tr>
<tr><td>$002e</td><td>$0001</td><td>początkowa szybkość odtwarzania</td></tr>
<tr><td>$002f</td><td>$0001</td><td>numer sampla oznaczonego jako "long sample" ($ff oznacza brak)</td></tr>
<tr><td>$0030</td><td>$0080</td><td>młodsze bajty adresów patternów</td></tr>
<tr><td>$00b0</td><td>$0080</td><td>starsze bajty adresów patternów</td></tr>
<tr><td>$0130</td><td>$0400</td><td>nazwy sampli</td></tr>
<tr><td>$0530</td><td>$0040</td><td>głośności sampli</td></tr>
<tr><td>$0570</td><td>$0080</td><td>długości sampli</td></tr>
<tr><td>$05f0</td><td>$0080</td><td>pozycje początku pętli (względem początku sampla)</td></tr>
<tr><td>$0670</td><td>$0400</td><td>dane songu</td></tr>
<tr><td>$0a70</td><td>$0002</td><td>adres końca danych patternów</td></tr>
<tr><td>$0a72</td><td>...</td><td>dane patternów</td></tr>
<tr><td>...</td><td>...</td><td>dane sampli</td></tr>
</table>

Wszystkie słowa zapisane są w formacie LSB-MSB (little endian).

Poniższe informacje dotyczą wersji $14 formatu.

=== Dane songu ===

Ułożone w kolejności:
* $80 bajtów oznaczających numery patternów na ścieżce 1,
* $80 bajtów transpozycji na ścieżce 1,
* ...
* $80 bajtów numerów patternów na ścieżce 4,
* $80 bajtów transpozycji na ścieżce 4.

Wartość ujemna ($80..$ff) numeru patternu w pierwszej ścieżce oznacza rozkaz skoku do pozycji w songu. Argument pobierany jest z bajtu transpozycji patternu ścieżki pierwszej. Skok do bieżącej pozycji lub do pozycji poza songiem ($80..$ff) powoduje zakończenie odtwarzania. 

=== Dane patternów ===

Grupy poleceń rozpoznawane są po najstarszych 2 bitach:
* 00 - rozpoczęcie grania nuty o numerze zawartym w pozostałych bitach ($00-$3e). Następny bajt oznacza głośność ($00-$20); dodatkowo ustawienie siódmego bitu oznacza, że sampel nie będzie zagrany od początku, a szóstego - że wystąpi dodatkowy bajt komendy efektu.
* 01 - zmiana bieżącego instrumentu, numer zapisany w pozostałych bitach ($00-$3f). Następny bajt zawiera nutę do odegrania ($00-3e). Kolejny bajt oznacza głośność ($00-$20); dodatkowo ustawienie siódmego bitu oznacza, że sampel nie będzie zagrany od początku, a szóstego - że wystąpi dodatkowy bajt komendy efektu. 
* 10 - puste linie, pomniejszona o 1 ilość zapisana w pozostałych bitach ($00-$3f).
* 11 - puste linie z ew. zmianą głośności i ew. komendą efektu. Kiedy w następnym bajcie ustawiony jest bit siódmy wtedy jest to bajt komendy efektu; jeśli bit siódmy jest skasowany wtedy jest to bajt głośności ($00-$20); dodatkowo ustawienie szóstego bitu oznacza, że kolejny bajt będzie dodatkowym bajtem komendy efektu.

Komenda efektu:
* $00 - koniec patternu,
* $0x - zmiana szybkości odtwarzania,
* $1x - płynne ściszanie,
* $2x - płynne zgłaśnianie,
* $3x - portamento w dół,
* $4x - portamento w górę.

Gdzie x oznacza parametr komendy.

Pojedynczy pattern zajmuje od jednego do 256 bajtów.

=== Uwagi ===

1. Wersja $10 formatu różni się od $14 następującymi cechami:
* głośności instrumentów w nagłówku (nie w patternie) przyjmują wartości $00..$40,
* sample o deklarowanej długości 0 bajtów w rzeczywistym pliku mają długość 1 bajtu o nieokreślonej wartości.
Maksymalna długość sampla dla formatów $10 i $14 wynosi 16384 B, wyjątkiem jest longsample - ten może mieć długość 22528 B.

2. Odtwarzanie nuty D-6 (kod nuty $3e) powoduje odtworzenie sampla z maksymalną częstotliwością.

3. Obszar danych patternów zaczyna się od $4000.

[[Kategoria: Formaty plików]]