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 ]