Paakkuli 2.0 by ISO
,-------------------------------. | Paakkuli 2.0 | | dokumentit | `-------------------------------' HUOM! Rivit, jotka pttyvt '|' -merkkiin, tulevat voimaan vasta Paakkulin seuraavassa versiossa. Kerrataan yleiset asiat ----------------------- Paakkuli on ISOn ohjelmointikieli, lahja niille ISOn jsenille, jotka haluaisivat tehd omia demoja mutteivt osaa tahi jaksa milln vaikealla kielell. Paakkuli on helppo ja nopea kieli, sill se keskittyy demon teossa trkeisiin asioihin eik jumita merkityksettmiss. Idea on se, ett teet lhdekooditiedoston, yleens normaalilla teksti editorilla. Sitten talletat sen esimerkiksi nimell 'SORSA.PKL'. muistat nimen ja komennat: 'PAAKUTA.EXE SORSA.PKL'. Tm Paakuta on kntj, joka tekee lhdekoodistasi 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 lhdekooditiedostoa. Kntj ei valita lhdekoodissa olevista virheist. Tmn takia ole siis todella tarkka, ett teet lhdekoodisi virheettmksi. Demo toimii vrin pienimmistkin virheist. Viel todennkisemp on ett demo jumittaa koneen kokonaan. Uutta, lukekaa tm! -------------------- Kieli ei tarvitse en aloitustagia. Merkit '#' ja '$' eivt ole en varattuja, joten niit voi kytt. Poikkeus on lopputeksti: Tmn lopetustagina on merkki '$' mutta tsskin tapauksessa merkin voi muuttaa haluamakseen. Ainoa varattu merkki on en ASC 0, josta ei tarvitse kantaa huolta, sill sit ei normaalioloissa edes pysty kyttmn. Uutta on mys se, ett lhdekooditiedosto saa nyt olla jopa 40000 tavun kokoinen. Uutta sekin, ett kuvat ladataan nyt aluksi muistiin, josta ne on omin ksin kopioitava ruudulle. Thn lytyy uudet komennot. Kieli ei ole yhteensopiva Paakkuli 1.0:n kanssa. Tst lhtien kuitenkin pyrimme pitmn tulevat versiot yhteensopivina tmn version kanssa. Kieli on uusittu siten, ett komennot ovat 4 merkki pitki, ja komentojen jlkeen tulee vlilynti ennen parametrej. Parametrittmiin komentoihin ei anneta vlilynti. Kyt kaikessa pieni kirjaimia! Tiedostossa 'KOMENNOT.NFO' on lyhyt yhteenveto kielen komennoista, mutta komennot esitelln perusteellisemmin myhemmin tss dokumentissa. Voit kytt kahdenlaisia lisuketiedostoja: S3M musiikeissa ja PCX kuvissa (Tulevissa versioissa IPF). S3M huom: Musan voi tehd vaikkapa Impulse Trackerillkin, ja savettaa S3M:ksi, mutta se tytyy viel ladata Scream Trackerill ja savettaa vaikkapa heti plle, jotta se toimisi Paakkulissa. PCX huom: Kuvan tulee olla 256 vrinen, color formaatissa (grey format ei kelpaa, mutta color-formaatin kuvat voivat olla harmaasvyisi joten ei haittaa), eli 8 bittisi. Resoluutiona 320x200, eli MCGA. Kuvadata-tiedostot. Keino vhent demon tarvitsemia tiedostoja | yhdistmll kuvatiedostoja yhdeksi ja samaksi data-tiedostoksi. | Paakkulissa on nyt uusia komentoja, joilla nit voi sitten lukea ja | kytt. Kuvat luetaan siin jrjestyksess, 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'. Tm esimerkkimme kopioi kolme ensimmist | kuvatiedostoa perkkin neljnteen tiedostoon. | Jokaiselle riville vain yksi komento, tyhji vlirivej ei saa jtt. Vain lopetuskomennon jlkeen saa olla mit tahansa paskaa, esimerkiksi huomautuksia. Komentojen jlkeen ei saa olla yhtn vlilynti-merkki, vaan normaali rivinvaihto tytyy seurata heti (return: ASC 13, ASC 10). Jos tuottaa ongelmia, niin mukana on esimerkki-koodi (tiedosto nimelt 'EXAMPLE.PKL'). Thdell (*) merkityt komennot ovat helppoja: Kyt nit, jos Paakkuli on sinulle muuten liian vaikea kieli. Helpoimpia | komentoja esitelln 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. Nm kskyt tytyy sijoittaa ensimmisiksi lhde- | koodiin. | mode * Vaihtaa nytttilaa. Parametriksi joko 0 tai 1: 0 on tekstitila 80x25 merkki, 1 on MCGA-grafiikkatila 320x200 merkki 256 vrill. open Avaa kuvadata-tiedoston. Parametriksi tiedoston nimi. | shut Sulkee parhaillaan auki olevan kuvadata-tiedoston. Sulje aina, | kytn jlkeen, ennen uuden avaamista tai demon loppumista. Ei | parametrej. | next Lataa seuraavan PCX-kuvan auki olevasta kuvadata-tiedostosta | muistiin. Ei parametrej. | show Lataa yksittisen 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. Iknkuin 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 vrit mustiksi. Ei parametrej. lght Pyyhkii ruudun valkoiseksi ja asettaa paletin vrit 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 tm kohta. Kohta muodostuu musiikin POSITION:sta ja ROW:sta; tiedt mit nm ovat jos olet saanut musiikin vstty. Positionin numero vlilt (00-99) ja Rowin numero vlilt (00-63). Nit ei en eroteta pilkulla kuten Paakkuli 1.0:ssa. waef Kuten sken, mutta tekee samalla efekti kun odottaa musiikin | tietty kohtaa. Parametri muodostetaan nin: Musiikin kohta aivan | kuten skeisess komennossa, sen jlkeen pilkku ja sitten efektin | numero (00-99) ja efektin parametri (00-99). Efektit esitelln | myhemmin tss dokumentissa ja yleisesti tiedostossa 'KOMENNOT.DOC'.| Tmn komennon muoto kannattaa tarkistaa tiedostosta 'EXAMPLE.PKL'. | time Odotus ajan mukaan. Parametriksi aika millisekunteina vlilt 0000-9999. Thn aikaan demo lis yhden millisekuntin, joten oikea aika on vlilt 0001-10000. Muista, ett 1000 millisekuntia on yksi sekunti. mark Vaihtaa lopputekstin lopetusmerkki. Parametriksi uusi merkki. end! * Lopeta koodisi thn tai seuraavaan komentoon. Ei parametrej. ent! Kuten sken, mutta lopputekstien myt. Parametri, eli lopputeksti, alkaa poikkeuksellisesti seuraavan riviin alusta. Lopputeksti on vapaamuotoista teksti siihen asti, kunnes vastaan tulee merkki '$'. Merkki voi olla mys jokin muu, jos se on mark-komennolla annettu. Tll keinolla voi lopputeksteiss kytt '$'-merkki. Paakkuli-kielen efektit | ----------------------- | | | 00 f | 01 f | 02 f | 03 f | 04 f | 05 f |
[ back to the prod ]