pouët.net

Paakkuli 1.0(BETA) by ISO



               ISO Demo Paakkuli 1.0 (alpha)
                                  dokumentit
               -----------------------------


Nyt ISO tarjoaa sinulle helpon ohjelmointikielen, jotta voisit koodailla
omia ISO demoja. Dokumentit ovat suomeksi, jotta tajuaisit jotain. Eli
että osaisin kirjottaa nää hommat oikein.

Idea on se, että teet lähdekooditiedoston, yleensä normaalilla teksti-
editorilla (EDIT joka tulee DOSsin mukana, kelpaa). sitten talletat
sen esimerkiksi nimellä 'SORSA.PKL'. muistat nimen ja komennat:
'PAAKUTA.EXE SORSA.PKL'. Tämä Paakuta on kääntäjä, joka tekee lähde-
koodistasi konekielisen ajettavat tiedoston, nimellä 'DEMO.EXE'.
Voisiko olla helpompaa! (Huom: Tässä versiossa tätä nimeä ei saa
muuttaa haluamakseen, 'DEMO.EXE' ei toimi jos sen nimeä muuttaa.)
Muista myös että lähdekooditiedosto saa olla korkeintaan 12000
tavua pitkä.

Voit käyttää kahdenlaisia lisuketiedostoja: S3M musiikeissa ja PCX
kuvissa (Tulevissa versioissa IPF). S3M huom: Musan voi tehdä vaikkapa
Impulse Trackerilläkin, ja savettaa S3M:ksi, mutta se täytyy vielä
ladata Scream Trackerillä ja savettaa vaikkapa heti päälle, jotta
se toimisi Paakkulissa. PCX huom: Kuvan tulee olla 256 värinen, color
formaatissa (grey format ei kelpaa, mutta color-formaatin kuvat voivat
olla harmaasävyisiä joten ei haittaa), eli 8 bittisiä. Resoluutiona
320x200, eli MCGA.

Paakkulin tämä versio kytkee automaattisesti MCGA-moden päälle kun
demo aloitetaan, ja lopussa kytkee tekstimoden. Paakkulin tuleviin
versioihin tulee kaikkea lisää, efektejä, tekstiä, fadeja, tää on
vain tällänen nopeasti tehty.

Kun demosi on valmis, niin muista sijoittaa demon tarvitsemat kuva-
sekä musiikkitiedostot samaan hakemistoon 'DEMO.EXE':si kanssa. Muita
Paakkulin tiedostoja demosi ei kääntämisen jälkeen enää tarvitse.
Demo ei tarvitse toimiakseen edes lähdekooditiedostoaan enää. Tää
homma on todella virhealtista eli jos mokaat vähänkin kun teet
lähdetiedostoa niin mitä todennäköisimmin demosi jummaa tai ainakin
toimii väärin, koska kääntäjä ei jaksa valittaa virheistä.

Paakkulin on valmistanut Paavi/ISO; Selvät yhtäläisyydet LISP-kieleen
ovat nähtävissä, mutta se ei haittaa, tämän kielen omistaa ISO.



                    Paakkuli-kielen komennot
                    ------------------------


Jokaiselle riville vain yksi komento, tyhjiä välirivejä ei saa jättää.
Vain lopetuskomennon jälkeen saa olla mitä tahansa paskaa, esimerkiksi
huomautuksia. Komentojen jälkeen ei saa olla yhtään välilyönti-merkkiä,
vaan normaali rivinvaihto täytyy seurata heti (return: ASC 13, ASC 10).
Jos tuottaa ongelmia, niin mukana on esimerkki-koodi (tiedosto nimeltä
'EXAMPLE.PKL'). Käytä komennoissa pieniä kirjaimia, ja nyt aloitamme:

   Koodi pitää aloittaa seuraavanlaisesti:
$bcode
   Koodi pitää lopettaa seuraavanlaisesti:
$ecode
   Musiikin lataa ja aloittaa komento:
p
   Musiikin tiedostonimi laitetaan välittömästi perään, joten jos musiikki
   on esimerkiksi 'SONG.S3M' niin komento saa muodon:
psong.s3m
   Musiikin lopettaa komento:
s
   Kuvan lataa, piirtää ruudulle ja asettaa paletin komento
i
   Tiedostonnimi laitetaan kuten musiikissa (esim 'PICTURE.PCX'):
ipicture.pcx
   Seuraava komento tyhjentää ruudun ja asettaa kaikki paletin arvot
   nollille:
b
   Musan synkronisointi demoon tehdään komennolla:
w
   Parametreiksi annetaan musiikin ns. position sekä ns. row, jotka ovat
   sinulle tuttuja jahka olet musaa tehnyt. Nämä kaksi erotetaan pilkulla,
   row saa olla väliltä 00-63 ja position väliltä 00-99. Käytä aina nollia
   saadaksesi kaksinumeroisen luvun. Esimerkki odottaa niinkauan kunnes
   saavuttaa musiikissa rivin 32 positionista 2:
w02,32
   Seuraavaa komentoa voi käyttää vain kerran, sen voi sijoittaa vaikkapa
   viimeiseksi ennen lopetuskomentoa:
t
   Tälle komennolle annetaan parametriksi kommentti, esimerkiksi lause tai
   sana, joka tulostetaan ruudulle kun demo loppuu. Se saa olla korkeintaan
   75 merkkiä pitkä:
tNyt on tämä demo loppu.

Lisähuomautuksia: musassa on hyvä olla tyhjää lopussa, jotta synkroni-
sointi saadaan hoidettua kunnialla loppuun asti. Jos peräkkäin näytet-
tävissä kuvissa on aivan samanlainen paletti, ei b-komentoa kannata
käyttää, ettei ruudun musta välähdys näy. Tosin kelpaa tämäkin ISO
tason efektiksi (lähde: 333Elite/ISO). Jos kuvissa on eri paletit eikä
b-komentoa käytetä, näkyy jälkimmäinen kuva aluksi vanhan kuvan
paletilla. Tämäkin voi näyttää hienolta (lähde: Nunna/ISO).

Älä käytä tiedostonnimissä tahi loppukommentissa merkkiä '$' koska se
on varattu erikoiskomennoille ($bcode / $ecode) ja aiheuttaa sekoilua
kääntäjän toiminnassa. Myöskään merkkiä '#' ei sovi käyttää (varattu
kääntäjän erikoistoiminnoille).