==============================================================================
       ATARI STE DMA MUSIC DEMO - OSTATNIE CHWILE WOLNOSCI
                    WERSJA WZORCOWA POST-PARTY
==============================================================================

Autor, koncepcja i prowadzenie projektu: paptak
Platforma: Atari STe / Mega STe
Data wydania wersji post-party: 2026-08-02

Demo zajelo 3. miejsce w swojej kategorii:
  ATARI ST/STE - DEMO COMPO
podczas Silly Venture 2026 Summer Edition, uzyskujac wynik 5,302 pkt.


1. SZYBKI START
---------------

Skopiuj CALY katalog OCW_FULL na dysk Atari. Nie zmieniaj ukladu jego
podkatalogow. Wejdz do katalogu OCW_FULL i uruchom:

  DEMO.PRG

Program nie jest przywiazany do litery dysku. Moze dzialac z dowolnej
partycji, pod warunkiem uruchomienia go z katalogu OCW_FULL i zachowania
podkatalogow AUDIO, IMAGES oraz TEXTS.


2. CZYM NAPRAWDE JEST TO DEMO
-----------------------------

To demo jest moim interaktywnym albumem muzycznym na Atari STe. Gdybym
wydawal te piosenki jako tradycyjny album, nazwalbym go "Ostatnie Chwile
Wolnosci". Nie jest to klasyczne demo, w ktorym muzyka stanowi jedynie tlo
dla kolejnych efektow graficznych. Tutaj najwazniejsza jest wlasnie muzyka,
a kod, grafiki, przejscia, gwiazdy, wskazniki i scrolle tworza dla niej
atarowska oprawe.

W srodku znajduje sie dwanascie pelnych piosenek, a nie kilkunastosekundowe
fragmenty przygotowane tylko na compo. Kazdy utwor ma wlasna ilustracje oraz
dlugi scroll. Te teksty nie sa wypelniaczem. Opowiadam w nich, skad wziela sie
melodia, kto napisal oryginalna kompozycje, jak powstawaly kolejne wersje,
co zrobilo SUNO, co zrobilem ja i o czym naprawde jest dana piosenka.

Material muzyczny ma rozne zrodla. Sa tu melodie, ktore komponowalem jeszcze
w 1997 roku na Amidze, starsze szkice z GarageBandu, pomysly zanucane do
dyktafonu w smartfonie oraz nowe utwory zaczynane od samego tematu i opisu
stylu. Sa rowniez piosenki zbudowane na kompozycjach muzykow scenowych,
miedzy innymi Stringa i TSM. Dokladne pochodzenie kazdej z nich podaje w jej
scrollu, zamiast ukrywac inspiracje pod ogolnym haslem.

Nie ukrywam tez roli sztucznej inteligencji. SUNO bylo narzedziem, ktore
tworzylo aranzacje, wokale, a w zaleznosci od utworu takze melodie i slowa.
Ja wybieralem tematy, kierunek, style, poprawialem zalozenia, odrzucalem
nieudane wersje i decydowalem, co ostatecznie znajdzie sie w demie. Czasem
punktem wyjscia byla moja gotowa melodia, czasem cudza kompozycja scenowa,
a czasem tylko pomysl na piosenke. To nie jest album udajacy, ze AI nie bralo
udzialu w jego powstaniu.

Nie jest to rowniez neutralny zbior tekstow. Piosenki mowia o wolnosci,
manipulacji medialnej, presji tlumu, nieufnosci wobec wladzy, utracie
wlasnosci, cyfrowej kontroli, wojnie, kryzysach zaopatrzenia i leku przed
przyszloscia. Czesc jest osobista, czesc dystopijna, a czesc otwarcie
polityczna i prowokacyjna. Nie wszystkie tezy wypowiada bezposrednio autor;
niekiedy sa glosem bohatera piosenki, jego strachem, gniewem lub skrajna
interpretacja wydarzen. Pelne scrolle wyjasniaja ten kontekst bez lagodzenia
tematow i bez udawania, ze kontrowersyjne utwory sa o czyms innym.

Atari STe nie jest tu przypadkowym odtwarzaczem. Chcialem wykorzystac stereo
DMA w najlepszej jakosci, jaka uznalismy za realna na seryjnym komputerze:
signed 8-bit PCM, 50066 Hz, dwa kanaly i strumieniowanie z dysku. Dlatego demo
zajmuje prawie 375 MB. Jak na produkcje atarowska jest ogromne, ale to
swiadoma cena za pelne piosenki bez redukowania ich do niskiej czestotliwosci
albo mono.

Utwory zapetlaja sie, poniewaz scrolle sa dluzsze od pojedynczego odtworzenia.
To demo ma byc sluchane i czytane we wlasnym tempie, a nie tylko szybko
obejrzane. Menu pozwala wybrac dowolna piosenke, wylaczyc scroll, obejrzec
cala ilustracje, a potem wrocic do czytania od zapamietanego miejsca.

Niniejsza paczka jest pelna, wzorcowa wersja przeznaczona do publikacji po
party. Zachowuje stabilny silnik sprawdzony przed konkursem na emulatorze,
FPGA i prawdziwym Atari, ale przywraca materialy zmienione na potrzeby compo.

W porownaniu z wersja konkursowa:

* utwor 03 ponownie nosi tytul "Ustawa 447";
* przywrocono oryginalny plik muzyczny i ilustracje utworu 03;
* przywrocono pelne, niezneutralizowane teksty wszystkich scrolli;
* pozostawiono poprawiony silnik potrojnego buforowania DMA;
* pozostawiono lekkie wskazniki poziomu i porcjowany odczyt z dysku.

Wersja pokazana na compo zawierala w pozycji 03 utwor
"15-minutowe Miasto" oraz lagodniejsze teksty scrolli. Zmiany te dotyczyly
wylacznie wydania konkursowego. Niniejsza paczka jest pelnym masterem,
ktory od poczatku byl planowany jako wersja publikowana po zakonczeniu SV.


3. WYMAGANIA SPRZETOWE
----------------------

Wymagane:

* Atari STe lub Mega STe
* 4 MB ST-RAM
* DMA Sound
* dysk twardy lub zgodne urzadzenie masowe
* kolorowy tryb ST-Low 320x200, 50 Hz

Atari ST oraz Mega ST NIE sa obslugiwane, nawet jezeli maja 4 MB RAM.
Komputery te nie maja ukladu DMA Sound potrzebnego do odtwarzania muzyki.

Demo samo rozpoznaje rodzine komputera i ilosc pamieci. Przy niespelnionych
wymaganiach pokazuje komunikat po polsku i angielsku. Uruchomione z wysokiej
rozdzielczosci probuje automatycznie przejsc do trybu kolorowego.

Przy 4 MB RAM zalecany jest czysty start TOS, bez akcesoriow zajmujacych
duza czesc pamieci TPA.


4. STEROWANIE
-------------

A-L       wybor utworu 01-12 w menu
SPACJA    wlaczenie lub wylaczenie scrolla przy wybranym utworze
ESC       powrot z utworu do glownego menu

Po ponownym wlaczeniu scroll jest kontynuowany od zapamietanego miejsca.
Po powrocie do menu jego pozycja jest zerowana, dlatego ponowne wybranie
utworu rozpoczyna scroll od poczatku.


5. LISTA UTWOROW
----------------

01  Ostatnie chwile wolnosci
02  Wlasny kurs
03  Ustawa 447
04  Nie odwroce drogi
05  Ostatnie zniwa
06  Chleb z popiolu
07  Nie bedziesz mial nic
08  Wlasnosc systemu
09  Ukryci
10  Cyfrowa petla (Remix)
11  Kajdany pokoju
12  Kryptonim Reset

Kazdy utwor ma osobna ilustracje i obszerny polski scroll opisujacy jego
historie, styl, znaczenie tekstu oraz pochodzenie muzycznych inspiracji.


6. DANE TECHNICZNE
------------------

Procesor i kod:
  Motorola 68000, assembler, program w formacie GEMDOS PRG.

Grafika:
  320x200 pikseli, 16 kolorow, format planarny Degas PI1, paleta STe 12-bit.
  Dwa ekrany fizyczne sa zamieniane w przerwaniu VBL. Intro i zmiany plansz
  wykorzystuja plynne rozjasnienia i wyciemnienia palety.

Dzwiek:
  stereo DMA, signed 8-bit PCM, 50066 Hz, probki przeplatane L/R.
  Muzyka jest strumieniowana z dysku przez potrojny pierscien buforow po
  1 000 000 bajtow. Odczyt nastepnego fragmentu odbywa sie podczas
  odtwarzania poprzednich danych przez DMA.

Menu:
  efekt gwiazd 3D, dwukanalowe wskazniki poziomu, wielokolorowy scroll
  graficzny oraz dwa utwory menu odtwarzane na przemian.

Scrolle:
  teksty UTF-8 z polskimi literami, przygotowane z wyprzedzeniem fazy
  przesuniecia, podwojne buforowanie i porcjowane odczyty z dysku.

Odczyt z dysku:
  dane menu sa doczytywane porcjami po 16384 bajty. Potrojny bufor DMA
  zapobiega powtarzaniu fragmentow muzyki, a odswiezanie wskaznikow jest
  probkowane regularnie z zegara VBL. Przerwania MFP sterownika dysku
  pozostaja dozwolone podczas pomiaru wskaznikow.

Program wylacza systemowy dzwiek klawiatury na czas calego dema i odtwarza
jego poprzedni stan przy wyjsciu.


7. TESTOWANE KONFIGURACJE
-------------------------

* prawdziwe Atari STe i Mega STe
* MiST FPGA z rdzeniem Atari STe
* MiSTer FPGA z rdzeniem Atari ST/STE
* Hatari 2.6.1
* TOS 2.06
* 4 MB ST-RAM
* sterowniki HDDriver 12.78, Putnik oraz ICD Pro

Odczyt z dysku byl osobno optymalizowany i sprawdzany na wszystkich trzech
sterownikach, lacznie ze starszym i wolniejszym ICD Pro.


8. UKLAD KATALOGU
-----------------

OCW_FULL\
  DEMO.PRG       interaktywna wersja dema
  INFO.TXT       ten plik
  AUDIO\         12 utworow i 2 utwory menu w formacie PCM
  IMAGES\        menu, intro, plansza tytulowa i 12 ilustracji PI1
  TEXTS\         pelne polskie teksty wszystkich scrolli

Miejsce wymagane po rozpakowaniu:
  374 740 304 bajtow = 374,74 MB = 357,38 MiB

Zalecane jest co najmniej 400 MB wolnego miejsca na docelowej partycji.


9. AUTORSTWO I NARZEDZIA
------------------------

Koncepcja, dobor materialu, kierunek artystyczny, wielokrotna selekcja
wariantow, redakcja i testy:
  paptak

Kod Motorola 68000, narzedzia konwersji i przygotowanie techniczne:
  ChatGPT Codex, pod kierunkiem paptaka i w toku dlugiej, iteracyjnej pracy.

Budowanie programu:
  GNU Binutils dla m68k-elf: assembler, linker i objcopy.

Konwersja i kontrola materialow:
  FFmpeg/ffprobe, Pillow, ImageMagick, mtools, Hatari oraz narzedzia wlasne.

Testy na prawdziwym sprzecie:
  Bart i Piter.


10. JAWNA INFORMACJA O UZYCIU AI
--------------------------------

W produkcji muzycznej wykorzystano SUNO. Autor projektu przygotowywal tematy,
style i zalozenia utworow, wybieral rezultaty oraz prowadzil kolejne wersje.
W czesci utworow punktem wyjscia byly starsze melodie autora lub kompozycje
scenowe innych muzykow. Szczegolowe pochodzenie zostalo podane w scrollach
odpowiednich utworow.

Czesc ilustracji i elementow oprawy powstala z wykorzystaniem generatywnych
narzedzi graficznych, a nastepnie zostala wybrana, poprawiona i przystosowana
do ograniczen 320x200 oraz 16-kolorowej palety Atari STe.

Kod dema i narzedzia robocze powstaly we wspolpracy z ChatGPT Codex. Decyzje
projektowe, ocena efektu, testy na emulatorze, FPGA i prawdziwym sprzecie oraz
ostateczne zatwierdzenie wszystkich elementow nalezaly do paptaka.


11. PODZIEKOWANIA
-----------------

Podziekowania dla Jesionena, Hospesa, Jacka, Pitera, Artiego, Mavera, dMk
oraz pozostalych osob z grupy DruidFeST. Greyowi dziekujemy za organizacje
Silly Venture. Bartowi i Piterowi dziekujemy za testy na prawdziwym Atari.

Szczegolne podziekowania dla Beatki i Pauli za wyrozumialosc. Nie kazdy
znioslby sluchanie tych samych utworow w kolko przez miesiac.

Dziekuje osobom glosujacym na demo podczas Silly Venture 2026 Summer Edition.
Zdobyte 3. miejsce w kategorii ATARI ST/STE - DEMO COMPO jest wspolnym
podsumowaniem wielu tygodni pracy i testow.


12. SUMA KONTROLNA PROGRAMU
---------------------------

SHA-256 DEMO.PRG:
6c29ae4863c9cd82b6d81eaeea6bf888abbec3aed79798ad7400e70e8ec74bd5


==============================================================================
ENGLISH SUMMARY
==============================================================================

Title:
  Atari STe DMA Music Demo - Ostatnie Chwile Wolnosci

Release:
  Full reference post-party version, published after Silly Venture 2026
  Summer Edition. The demo placed 3rd in its category,
  ATARI ST/STE - DEMO COMPO, with a score of 5.302 points.

Author, concept and project direction:
  paptak

What this actually is:
  This is an interactive music album for the Atari STe, not a conventional
  effect-first demo. It contains twelve complete songs. Each track has its
  own 16-color illustration and a long Polish scroller documenting where the
  music came from, how SUNO was used, what the author contributed and what
  the lyrics are really about.

  The songs are personal, social, dystopian and sometimes openly political
  or provocative. Their subjects include freedom, media manipulation,
  distrust of government, ownership, digital control, war and supply-chain
  collapse. The post-party edition does not disguise or neutralize these
  themes.

  Some tracks grew from paptak's old Amiga or GarageBand compositions and
  hummed voice-memo melodies; others use clearly credited demoscene music or
  began as a subject and style description for SUNO. The exact provenance is
  documented separately for every track.

  Nearly 375 MB of disk space is a deliberate choice: the complete songs are
  streamed as stereo signed 8-bit PCM at 50066 Hz to preserve the best sound
  quality considered practical on a standard 4 MB Atari STe.

Requirements:
  Atari STe or Mega STe, 4 MB ST-RAM, DMA Sound, hard disk or compatible
  mass storage, color 320x200/50 Hz display mode.

Atari ST and Mega ST are not supported because they do not provide the DMA
Sound hardware required by this production.

This post-party master restores track 03 "Ustawa 447" and the complete,
original scroller texts. The competition version used "15-minutowe Miasto"
in slot 03 and contained neutralized scroller texts.

Copy the complete OCW_FULL directory to any drive, enter that directory and
run DEMO.PRG. No drive letter is hard-coded.

Controls:
  A-L selects tracks 01-12, SPACE toggles the track scroller, ESC returns
  to the main menu.

Technical format:
  Motorola 68000 assembly, 320x200 16-color planar graphics, STe 12-bit
  palettes, double-buffered VBL graphics, stereo signed 8-bit DMA PCM at
  50066 Hz and triple-buffered hard-disk streaming.

AI disclosure:
  SUNO was used in the music production process. Generative image tools were
  used for part of the artwork. The 68000 code and conversion tools were
  developed with ChatGPT Codex under paptak's direction. The concept,
  selection, editorial decisions, testing and final approval were performed
  by paptak.

==============================================================================
