Paakkuli 2.0 by ISO
,-------------------------------.
| Paakkuli 2.0 |
| dokumentit |
`-------------------------------'
HUOM! Rivit, jotka päättyvät '|' -merkkiin, tulevat voimaan vasta
Paakkulin seuraavassa versiossa.
Kerrataan yleiset asiat
-----------------------
Paakkuli on ISOn ohjelmointikieli, lahja niille ISOn jäsenille, jotka
haluaisivat tehdä omia demoja mutteivät osaa tahi jaksa millään vaikealla
kielellä. Paakkuli on helppo ja nopea kieli, sillä se keskittyy demon
teossa tärkeisiin asioihin eikä jumita merkityksettömissä.
Idea on se, että teet lähdekooditiedoston, yleensä normaalilla teksti
editorilla. 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ähdekoodistasi konekielisen ajettavat EXE-tiedoston.
Kun sitten sijoitat demosi tarvitsemat musiikki- ja kuvatiedostot samaan
hakemistoon EXE-tiedoston kanssa, on demosi valmis. Muita Paakkulin
tiedostoja demosi ei sitten enää tarvitsekaan, ei edes lähdekooditiedostoa.
Kääntäjä ei valita lähdekoodissa olevista virheistä. Tämän takia ole siis
todella tarkka, että teet lähdekoodisi virheettömäksi. Demo toimii väärin
pienimmistäkin virheistä. Vielä todennäköisempää on että demo jumittaa
koneen kokonaan.
Uutta, lukekaa tämä!
--------------------
Kieli ei tarvitse enää aloitustagia. Merkit '#' ja '$' eivät ole enää
varattuja, joten niitä voi käyttää. Poikkeus on lopputeksti: Tämän
lopetustagina on merkki '$' mutta tässäkin tapauksessa merkin voi
muuttaa haluamakseen. Ainoa varattu merkki on enää ASC 0, josta ei
tarvitse kantaa huolta, sillä sitä ei normaalioloissa edes pysty
käyttämään. Uutta on myös se, että lähdekooditiedosto saa nyt olla
jopa 40000 tavun kokoinen. Uutta sekin, että kuvat ladataan nyt aluksi
muistiin, josta ne on omin käsin kopioitava ruudulle. Tähän löytyy
uudet komennot.
Kieli ei ole yhteensopiva Paakkuli 1.0:n kanssa. Tästä lähtien kuitenkin
pyrimme pitämään tulevat versiot yhteensopivina tämän version kanssa.
Kieli on uusittu siten, että komennot ovat 4 merkkiä pitkiä, ja komentojen
jälkeen tulee välilyönti ennen parametrejä. Parametrittömiin komentoihin
ei anneta välilyöntiä. Käytä kaikessa pieniä kirjaimia! Tiedostossa
'KOMENNOT.NFO' on lyhyt yhteenveto kielen komennoista, mutta komennot
esitellään perusteellisemmin myöhemmin tässä dokumentissa.
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.
Kuvadata-tiedostot. Keino vähentää demon tarvitsemia tiedostoja |
yhdistämällä kuvatiedostoja yhdeksi ja samaksi data-tiedostoksi. |
Paakkulissa on nyt uusia komentoja, joilla näitä voi sitten lukea ja |
käyttää. Kuvat luetaan siinä järjestyksessä, kun ne ovat kuvadata- |
tiedostoon laitettu. Helpoin tapa tehdä kuvadata-tiedostoja on mukana |
tuleva TEEDATA-ohjelma. Esimerkki: 'TEEDATA.EXE KUVA1.PCX KUVA2.PCX |
KUVA3.PCX KUVADATA.DAT'. Tämä esimerkkimme kopioi kolme ensimmäistä |
kuvatiedostoa peräkkäin neljänteen tiedostoon. |
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'). Tähdellä (*) merkityt komennot ovat helppoja: Käytä
näitä, jos Paakkuli on sinulle muuten liian vaikea kieli. Helpoimpia |
komentoja esitellään esimerkki-koodissa 'EASIES.PKL'. |
Tulossa seuraaviin versioihin: Tuki IPF-kuvaformaatille, paljon lisää |
efektejä, Paakkuli-kielen kirjoittamiselle suunniteltu virheistä |
ilmoittava editori, tekstitysmahdollisuus sekä MCGA- että tekstitilalle, |
paremmat ruudunkaappausrutiinit, ym. ym. |
Paakkuli-kielen komennot
------------------------
uses Lisää plug-in-moduuleja Paakkuliin. Parametriksi plug-in-moduulin |
tiedostonnimi. Nämä käskyt täytyy sijoittaa ensimmäisiksi lähde- |
koodiin. |
mode * Vaihtaa näyttötilaa. Parametriksi joko 0 tai 1: 0 on tekstitila
80x25 merkkiä, 1 on MCGA-grafiikkatila 320x200 merkkiä 256 värillä.
open Avaa kuvadata-tiedoston. Parametriksi tiedoston nimi. |
shut Sulkee parhaillaan auki olevan kuvadata-tiedoston. Sulje aina, |
käytön jälkeen, ennen uuden avaamista tai demon loppumista. Ei |
parametrejä. |
next Lataa seuraavan PCX-kuvan auki olevasta kuvadata-tiedostosta |
muistiin. Ei parametrejä. |
show Lataa yksittäisen PCX-kuvan (ei kuvadata-tiedostossa olevan kuvan)
muistiin. Parametriksi kuvatiedoston nimi.
flip Kopioi kuvan muistista ruudulle. Ei parametrejä.
pale Asettaa muistissa olevan PCX-kuvan paletin. Ei parametrejä.
easy * Yksinkertaisin kuvanlatauskomento: Parametriksi vian kuvatiedoston
nimi. Ikäänkuin yhdistetty SHOW, FLIP ja PALE.
fafb Liu'uttaa paletin mustasta muistissa olevan PCX-kuvan palettiin. |
Parametriksi liu'utuksen nopeus (00-99), 00 on nopein ja 99 hitain. |
fatb Liu'uttaa paletin muistissa olevasta PCX-kuvan paletista mustaan. |
Parametriksi liu'utuksen nopeus (00-99), 00 on nopein ja 99 hitain. |
fafw Liu'uttaa paletin valkoisesta muistissa olevan PCX-kuvan palettiin. |
Parametriksi liu'utuksen nopeus (00-99), 00 on nopein ja 99 hitain. |
fatw Liu'uttaa paletin muistissa olevasta PCX-kuvan paletista valkoiseen. |
Parametriksi liu'utuksen nopeus (00-99), 00 on nopein ja 99 hitain. |
dark * Pyyhkii ruudun mustaksi ja asettaa paletin värit mustiksi. Ei
parametrejä.
lght Pyyhkii ruudun valkoiseksi ja asettaa paletin värit valkoisiksi. Ei
parametrejä.
ps3m * Aloittaa S3M-musiikin soiton. Parametriksi musiikkitiedoston nimi.
stop * Lopettaa parhaillaan soivan S3M-musiikin soiton. Ei parametrejä.
wait * Odotus musiikin mukaan. Odottaa, kunnes musiikki saavuttaa tietyn
kohdan. Parametriksi annetaan tämä kohta. Kohta muodostuu musiikin
POSITION:sta ja ROW:sta; tiedät mitä nämä ovat jos olet saanut
musiikin väsättyä. Positionin numero väliltä (00-99) ja Rowin
numero väliltä (00-63). Näitä ei enää eroteta pilkulla kuten
Paakkuli 1.0:ssa.
waef Kuten äsken, mutta tekee samalla efektiä kun odottaa musiikin |
tiettyä kohtaa. Parametri muodostetaan näin: Musiikin kohta aivan |
kuten äskeisessä komennossa, sen jälkeen pilkku ja sitten efektin |
numero (00-99) ja efektin parametri (00-99). Efektit esitellään |
myöhemmin tässä dokumentissa ja yleisesti tiedostossa 'KOMENNOT.DOC'.|
Tämän komennon muoto kannattaa tarkistaa tiedostosta 'EXAMPLE.PKL'. |
time Odotus ajan mukaan. Parametriksi aika millisekunteina väliltä
0000-9999. Tähän aikaan demo lisää yhden millisekuntin, joten
oikea aika on väliltä 0001-10000. Muista, että 1000 millisekuntia
on yksi sekunti.
mark Vaihtaa lopputekstin lopetusmerkkiä. Parametriksi uusi merkki.
end! * Lopeta koodisi tähän tai seuraavaan komentoon. Ei parametrejä.
ent! Kuten äsken, mutta lopputekstien myötä. Parametri, eli lopputeksti,
alkaa poikkeuksellisesti seuraavan riviin alusta. Lopputeksti on
vapaamuotoista tekstiä siihen asti, kunnes vastaan tulee merkki '$'.
Merkki voi olla myös jokin muu, jos se on mark-komennolla annettu.
Tällä keinolla voi lopputeksteissä käyttää '$'-merkkiä.
Paakkuli-kielen efektit |
----------------------- |
|
|
00 f |
01 f |
02 f |
03 f |
04 f |
05 f |
[ back to the prod ]