https://mirror.atariki.pl/w/index.php?action=history&feed=atom&title=SS_%28format_pliku%29
SS (format pliku) - Historia wersji
2026-10-02T21:27:43Z
Historia wersji tej strony wiki
MediaWiki 1.46.0
https://mirror.atariki.pl/w/index.php?title=SS_(format_pliku)&diff=3574&oldid=prev
imported>Atariki recovery: Reconstructed from archived HTML; see provenance manifest
2026-10-01T08:51:48Z
<p>Reconstructed from archived HTML; see provenance manifest</p>
<p><b>Nowa strona</b></p><div>'''Ten artykuł wymaga poszerzenia lub poprawek.'''<br />Zajrzyj na stronę [[Dyskusja:SS (format pliku)|dyskusji]], by dowiedzieć się, czego brakuje, i - jeśli jesteś w stanie - uzupełnij braki.<br /><br />
Po naprawieniu mankamentów szablon {{SDP}} można usunąć z treści hasła.Format modułu muzycznego programu [[Softsynth]].<br />
<br />
Plik składa się ze stałego nagłówka i stokenizowanego kodu programu w języku MASIC o zmiennej długości.<br />
<br />
Wszystkie słowa zapisane są w kolejności LSB, MSB.<br />
<br />
== Nagłówek ==<br />
<br />
{|<br />
|-<br />
| offset<br />
| długość<br />
| opis<br />
|-<br />
| $0000<br />
| $0004<br />
| identyfikator: 'SYN',$9B w ASCII<br />
|-<br />
| $0004<br />
| $0002<br />
| ilość wierszy programu<br />
|-<br />
| $0006<br />
| $0002<br />
| długość bloku programu - 1<br />
|-<br />
| $0008<br />
| $00B0<br />
| blok 16 definicji plików fal .S<br />
|-<br />
| $00B8<br />
| $00B0<br />
| blok 16 definicji plików obwiedni .H<br />
|-<br />
| $0168<br />
| ...<br />
| stokenizowany kod programu<br />
|}<br />
<br />
== Definicja pliku fali/obwiedni ==<br />
<br />
{|<br />
|-<br />
| offset<br />
| długość<br />
| opis<br />
|-<br />
| $0000<br />
| $0001<br />
| długość nazwy - 1<br />
|-<br />
| $0001<br />
| $0002<br />
| ile razy nazwa fali/obwiedni została użyta w programie<br />
|-<br />
| $0003<br />
| $0008<br />
| nazwa<br />
|}<br />
<br />
Nazwa to nazwa pliku lecz bez dołączonego rozszerzenia.<br />
<br />
== Program w MASIC-u ==<br />
<br />
Kod programu znajduje się w pliku w postaci stokenizowanej i jest zapisany linia po linii.<br />
<br />
== Format linii ==<br />
<br />
{|<br />
|-<br />
| offset<br />
| długość<br />
| opis<br />
|-<br />
| $0000<br />
| $0002<br />
| numer linii<br />
|-<br />
| $0002<br />
| $0001<br />
| długość linii<br />
|-<br />
| $0003<br />
| ...<br />
| dane<br />
|}<br />
<br />
Linie mogą przyjmować numery w zakresie 1..32767 w związku z czym słowo numeru linii dzieli się na dwie części:<br />
<br />
* bity 0..14: numer linii<br />
* bit 15: znacznik rodzaju linii (0=linia nuty, 1=linia rozkazu sterującego)<br />
<br />
Długość linii liczona jest, analogicznie jak w BASIC-u, łącznie z bajtami numeru linii i długości.<br />
<br />
=== Linia nuty ===<br />
<br />
Jeśli najstarszy bit numeru linii jest skasowany wtedy oznacza to, że w linii zdefinowana jest nuta przeznaczona do odegrania.<br />
<br />
Bajt długości linii dzielony jest wtedy na 3 części i zawiera:<br />
<br />
* bity 0..4: długość linii<br />
* bity 5..6: numer kanału na którym będzie uruchomiony dźwięk<br />
* bit 7: 0-długa postać linii, 1-krótka postać linii<br />
<br />
==== Krótka postać linii ====<br />
<br />
Występuje tu tylko słowo częstotliwości nuty.<br />
<br />
Przykładowa krótka linia widziana w edytorze SoftSynth:<br />
<br />
<pre>10 1,C<br />
</pre><br />
<br />
==== Długa postać linii ====<br />
<br />
Kolejne bajty określają:<br />
<br />
1. Bajt znaczników określających jakie dane zapisane są dalej (0-znacznik skasowany, 1-znacznik ustawiony):<br />
<br />
* bit 0: LSB czasu oczekiwania<br />
* bit 1: niewykorzystany<br />
* bit 2: fala<br />
* bit 3: obwiednia<br />
* bit 4: głośność<br />
* bit 5: czas trwania<br />
* bit 6: MSB czasu oczekiwania<br />
* bit 7: dodatkowe efekty<br />
<br />
2. Słowo częstotliwości nuty.<br />
<br />
3. Występowanie kolejnych bajtów zależy od stanu znaczników:<br />
<br />
* bajt indeksu fali,<br />
* bajt indeksu obwiedni,<br />
* bajt głośności (0..15),<br />
* słowo czasu trwania dźwięku,<br />
* bajt LSB czasu oczekiwania,<br />
* bajt MSB czasu oczekiwania,<br />
* bajt znaczników dodatkowych efektów.<br />
<br />
Znaczniki dodatkowych efektów:<br />
<br />
* bity 0..1: niewykorzystane<br />
* bit 2: glissando<br />
* bit 3: wartość glissanda jest ujemna<br />
* bit 4: wartość glissanda jest podzielona przez 256<br />
* bit 5: dźwięk ciągły<br />
* bity 6..7: niewykorzystane<br />
<br />
W przypadku gdy znacznik glissanda (bit 2) jest ustawiony wtedy dalej następują bajty opisujące efekt:<br />
<br />
* słowo przyrostu dla nuty docelowej glissanda,<br />
* bajt głębokości glissanda (0-9),<br />
* słowo czasu przejścia glissanda.<br />
<br />
Czas przejścia glissanda (jakkolwiek w kodzie programu zapisywany) jest przez procedurę odtwarzającą ignorowany.<br />
<br />
Przykładowa długa linia widziana w edytorze SoftSynth:<br />
<br />
<pre>10 1,C,SINUS,DEFAULT,15,100,100,&lt;,&gt;C1,1,100<br />
</pre><br />
<br />
=== Linia rozkazu sterującego ===<br />
<br />
Jeśli najstarszy bit numeru linii jest ustawiony wtedy oznacza to, że w linii znajduje się token rozkazu sterującego wraz z bajtami danych rozkazu.<br />
<br />
==== Tokeny ====<br />
<br />
1. '''? czas : tekst'''<br />
<br />
* bajt $01<br />
* bajt czasu wyświetlania tekstu mierzonego w 1/50 sekundy<br />
* tekst do wyświetlenia zapisany w ATASCII<br />
<br />
2. '''/ polecenia'''<br />
<br />
* bajt $02<br />
* tekst poleceń edytora zapisany w ATASCII<br />
<br />
3. '''; komentarz'''<br />
<br />
* bajt $03<br />
* tekst komentarza zapisany w ATASCII<br />
<br />
4. '''SET 1,fala,obwiednia,głośność,czas trwania,czas oczekiwania'''<br />
<br />
* bajt $04<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głośności<br />
* słowo czasu trwania<br />
* słowo czasu oczekiwania liczonego w tiknięciach licznika tempa<br />
<br />
5. '''SET 2,fala,obwiednia,głośność,czas trwania,czas oczekiwania'''<br />
<br />
* bajt $05<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głośności<br />
* słowo czasu trwania<br />
* słowo czasu oczekiwania liczonego w tiknięciach licznika tempa<br />
<br />
6. '''SET 3,fala,obwiednia,głośność,czas trwania,czas oczekiwania'''<br />
<br />
* bajt $06<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głośności<br />
* słowo czasu trwania<br />
* słowo czasu oczekiwania liczonego w tiknięciach licznika tempa<br />
<br />
7. '''SET 4,fala,obwiednia,głośność,czas trwania,czas oczekiwania'''<br />
<br />
* bajt $07<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głośności<br />
* słowo czasu trwania<br />
* słowo czasu oczekiwania liczonego w tiknięciach licznika tempa<br />
<br />
8. '''MOD modulacja'''<br />
<br />
* bajt $08<br />
* bajt typu modulacji (0..4)<br />
<br />
9. '''SPEED tempo'''<br />
<br />
* bajt $09<br />
* bajt tempa mierzonego w 1/200 sekundy<br />
<br />
10. '''INT kanał,kanał,różnica'''<br />
<br />
* bajt $0A<br />
* bajt numeru kanału - 1<br />
* bajt numeru kanału - 1<br />
* bajt różnicy częstotliwości<br />
<br />
11. '''KW czas,czas'''<br />
<br />
* bajt $10<br />
* bajt czasu mierzonego w tiknięciach licznika tempa<br />
* bajt czasu mierzonego w tiknięciach licznika tempa<br />
<br />
12. '''TRON numer ścieżki'''<br />
<br />
* bajt $11<br />
* bajt numeru ścieżki ($00..$1F)<br />
<br />
13. '''TROFF numer ścieżki'''<br />
<br />
* bajt $12<br />
* bajt numeru ścieżki ($00..$1F)<br />
<br />
14. '''TRACK numer ścieżki'''<br />
<br />
* bajt $13<br />
* bajt numeru ścieżki ($00..$1F)<br />
<br />
15. '''''koniec utworu'''''<br />
<br />
* bajt $20<br />
* bajt $20<br />
<br />
Rozkaz końca utworu ma zawsze numer linii ustawiony na $8000 i bajt długości linii na $20 (co nie pokrywa się z prawdą, ponieważ ma ona zawsze rzeczywistą długość 5 bajtów - ma to zresztą odzwierciedlenie w słowie długości programu MASIC-a w nagłówku pliku).<br />
<br />
16. '''PHAS OFF'''<br />
<br />
* bajt $21<br />
<br />
17. '''WAIT czas'''<br />
<br />
* bajt $23<br />
* słowo czasu oczekiwania podanego w tiknięciach licznika tempa<br />
<br />
18. '''KW OFF'''<br />
<br />
* bajt $40<br />
<br />
19. '''ECHO kanał,kanał,opóźnienie'''<br />
<br />
* bajt $41<br />
* bajt numeru kanału - 1<br />
* bajt numeru kanału - 1<br />
* bajt opóźnienia liczonego w tiknięciach licznika tempa<br />
<br />
20. '''ECHO OFF'''<br />
<br />
* bajt $42<br />
<br />
21. '''END'''<br />
<br />
* bajt $43<br />
<br />
22. '''OFF 1'''<br />
<br />
* bajt $80<br />
<br />
23. '''OFF 2'''<br />
<br />
* bajt $81<br />
<br />
24. '''OFF 3'''<br />
<br />
* bajt $82<br />
<br />
25. '''OFF 4'''<br />
<br />
* bajt $83<br />
<br />
26. '''PHAS fala,obwiednia,okres'''<br />
<br />
* bajt $C0<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* słowo okresu<br />
<br />
27. '''VIB 1,fala,obwiednia,głębokość,okres,okres'''<br />
<br />
* bajt $E0<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
* słowo okresu<br />
<br />
28. '''VIB 2,fala,obwiednia,głębokość,okres,okres'''<br />
<br />
* bajt $E1<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
* słowo okresu<br />
<br />
29. '''VIB 3,fala,obwiednia,głębokość,okres,okres'''<br />
<br />
* bajt $E2<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
* słowo okresu<br />
<br />
30. '''VIB 4,fala,obwiednia,głębokość,okres,okres'''<br />
<br />
* bajt $E3<br />
* bajt indeksu fali<br />
* bajt indeksu obwiedni<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
* słowo okresu<br />
<br />
31. '''VIB 1,fala,głębokość,okres'''<br />
<br />
* bajt $E8<br />
* bajt indeksu fali<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
<br />
32. '''VIB 2,fala,głębokość,okres'''<br />
<br />
* bajt $E9<br />
* bajt indeksu fali<br />
* bajt głębokości<br />
* słowo okresu<br />
<br />
33. '''VIB 3,fala,głębokość,okres'''<br />
<br />
* bajt $EA<br />
* bajt indeksu fali<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
<br />
34. '''VIB 4,fala,głębokość,okres'''<br />
<br />
* bajt $EB<br />
* bajt indeksu fali<br />
* bajt głębokości (0..9)<br />
* słowo okresu<br />
<br />
35. '''VIB 1 OFF'''<br />
<br />
* bajt $F0<br />
<br />
36. '''VIB 2 OFF'''<br />
<br />
* bajt $F1<br />
<br />
37. '''VIB 3 OFF'''<br />
<br />
* bajt $F2<br />
<br />
38. '''VIB 4 OFF'''<br />
<br />
* bajt $F3<br />
<br />
== Częstotliwości ==<br />
<br />
Nuty podawane są w postaci częstotliwości podzielonej przez zakładaną częstotliwość odtwarzania równą 11059.2 Hz.<br />
<br />
Nuta C w oktawie podstawowej ma częstotliwość 261 Hz.<br />
<br />
== Czas trwania ==<br />
<br />
Czas trwania dźwięku podawany jest wg wzoru<br />
<br />
<pre> 16384<br />
value = -------<br />
czas<br />
</pre><br />
<br />
Czas podany jest w tiknięciach licznika tempa.<br />
<br />
== Ciekawostki ==<br />
<br />
* Zabezpieczenie plików przed listowaniem w edytorze SoftSynth polega na nadaniu wszystkim liniom wartości 0.<br />
* Faktyczna częstotliwość odtwarzania playera wynosi 10983 Hz.<br />
* Rozszerzenie pliku zostało zaproponowane przez [[Mono]], ponieważ oryginalne pliki modułów go nie miały (sporadycznie spotykano .MUS lub .SYN).<br />
<br />
== Linki ==<br />
<br />
* [[Softsynth]]<br />
* [[S (format pliku)|S]]<br />
* [[H (format pliku)|H]]<br />
<br />
[[Kategoria:Strony do poszerzenia]]<br />
[[Kategoria:Formaty plików]]<br />
</div>
imported>Atariki recovery