Suomen Amiga-käyttäjät ry:n lehden, disketti-Sakun, formaatti ------------------------------------------------------------- Janne Sirén Päivitetty 12.01.1999 versiolle 2.70 Sisältö ------- - Historia - Tiedostot - Hakemisto.dat - Kuvat - Artikkelit - Musiikki - Yhteensopivuus - Päivitykset Historia -------- Disketti-Saku sai alkunsa tarpeesta luoda suomalaisille amigisteille oma lehti. Paperinen lehti ei tullut kyseeseen suurten kustannusten takia ja niinpä mediaksi valittiin elektroninen muoto. Sakulla on oma formaattinsa ja lukijaohjelmansa. Sittemmin mukaan ovat tulleet myös AmigaGuide- ja HTML-muotoiset Saku-lehdet. Sakun lukijaohjelma on Pasi Kovasen käsialaa ja on suurelta osin vuodelta 1993. Uudemmat versiot toivat mukanaan erinäisiä uudistuksia, mutta perus- runko on pysynyt melko samana. Vuoden 1994 syksystä Sakun ohjelmoinnista on vastannut Janne Sirén. Sakun lukija ja lehden tiedostot eivät ole kaikki vanhojen versioidensa kanssa yhteensopivia (ks. Yhteensopivuus). Disketti-Saku soveltuu erinomaisesti pienelläkin Amigalla käytettäväksi, eikä sen formaatti vaadi koneelta kummoisia, mutta se on myös varsin rajal- linen eikä kovin hyvin suunniteltu laajeneviin tarpeisiimme. Myös Sakun le- vittäminen kolmessa eri formaatissa on työlästä ja tästä syystä lehdet aio- taan tulevaisuudessa korvata HTML-hypertekstiversiolla. Siihen saakka tässä tiedostossa kuvailtu formaatti pysynee johtavana Saku-mediana. Tiedostot --------- Kun Saku puretaan paketistaan, sieltä paljastuu seuraavanlainen hakemisto- rakenne: Teksti (dir) 100kgAU.txt 3dgfx.txt Aikaisemmat.txt Amiga.txt Epic.txt Hakemisto.dat Kansilehti.txt Kayttoohjeet.txt Kokous.txt Messut.txt MI99.txt Paakirjoitus.txt Paakirjoitus_J.txt Pikkujoulut.txt Poweria.txt Tiedotteet.txt Toimitus.txt Trojan.txt TurboPrint6.txt Uudistuksia.txt Uutiset.txt Vuosi1998.txt WW7.txt Yhdistys.txt S (dir) Startup-Sequence Musiikki (dir) Taustamusiikki.MED Libs (dir) iff.library medplayer.library reqtools.library Kuvat (dir) 3dgfx.IFF Amiga_1.IFF Amiga_2.IFF Amiga_3.IFF BarettiSiren.IFF BVision.IFF Epic.IFF Kansikuva.IFF Kayttoohjeet.IFF Messut.IFF Pikkujoulut_1.IFF Pikkujoulut_2.IFF Uutiset_1.IFF Uutiset_2.IFF Vuosi1998_1.IFF Vuosi1998_2.IFF Vuosi1998_3.IFF Vuosi1998_4.IFF Vuosi1998_5.IFF Vuosi1998_6.IFF Vuosi1998_7.IFF WordWorth7.IFF AsetaENV Saku Saku.info Hakemistot S ja Libs eivät ole välttämättömiä lehden toiminnalle kovalevyl- lisissä koneissa, mutta ne ovat tarpeen lehteä käynnistettäessä suoraan le- vykkeeltä. Päähakemistossa oleva Saku on itse lukuohjelma ja AsentaENV on ajettava ennen sitä suoraan levykkeeltä käynnistettäessä. Kuvat, Musiikki ja Teksti sisältävät itse lehden tiedostot, jotka vaihtuvat numerosta toi- seen. Hakemisto.dat ------------- Lehden sydän on Teksti-hakemistosta löytyvä Hakemisto.dat. Se kertoo, mitkä tiedostot ovat artikkeleita ja sieltä löytyy myös lehden hakemistoa varten artikkelien lyhennetyt otsikot. Hakemisto.dat muodostuu kolmen rivin ryh- mistä, joita voi olla useita kymmeniä. Ensimmäisellä rivillä on hakemistos- sa näkyvä artikkelin otsikko, toisella rivillä tiedoston nimi ilman hake- mistopolkua (artikkelit ovat Teksti-hakemistossa) ja kolmannella levykkeen numero (mikäli Sakun artikkelimateriaali on jaettu useammalle levykkeelle). Kentät voivat olla korkeintaan 19 merkkiä pitkiä. Tähdellä alkavat rivit lasketaan hakemiston väliotsikoiksi eikä niitä voi valita ja ne näkyvät ha- kemistossa eri värillä. Kun lehti avataan, ensimmäiseksi näytetään Kuvat-hakemistossa oleva Kansi- kuva.IFF ja sitten Hakemisto.datin ensimmäinen artikkeli. Jos kansikuvaa ei löydy, siirrytään suoraan ensimmäiseen artikkeliin. Jos ensimmäinen artik- keli on hakemistossa väliotsikko, siirrytään suoraan hakemistoon. Jos ar- tikkelia ei löydy levyltä, pyytää koodi levykettä SakuX: (jossa X on Hake- misto.dat:ssa mainittu levykkeen numero) ja yrittää hakea tiedostoa ja ky- seisen artikkelin sisältämiä kuvia sieltä (normaaliin tapaan Teksti- ja Ku- vat-hakemistoista). Esimerkki: Käyttöohjeet Kayttoohjeet.txt 1 Kansilehti Kansilehti.txt 1 * * * *Toimitukselliset * * *---------------- * * Pääkirjoitus Paakirjoitus.txt 1 Toimitus Toimitus.txt 1 Aikaisemmat Sakut Aikaisemmat.txt 1 Yhdistystoiminta Yhdistys.txt 1 Kuvat ----- Disketti-Sakun ruutu käyttää vakiona tarkkuutta 640x256 ja 16 väriä. Ruudun ensimmäiset 240 pisteriviä on varattu hakemistolle, teksteille ja kuville ja alimmat 16 juovaa ohjauspaneelille. Ohjauspaneelille asetetaan oma, muusta ruudusta riippumaton, väripalettinsa käyttäen Amigan copper-piiriä (tai 32-väristä palettia). Tekstin paletti vaihtelee: jos ruudulla ei ole kuvia, paletti on aiemmin kuvaillun kaltainen (poikkeuksena artikkelikoh- tainen peruspaletti, ks. Artikkelit), muussa tapauksessa viimeksi ruudulle avatun kuvan palettia käytetään. Kuvat ovat IFF ILBM -muodossa ja ne pakotetaan käytettyyn tarkkuuteen ilman skaalauksia, vaikka niiden oma tarkkuus olisikin eri kuin Sakun ruudun. Ku- vasuhteet saattavat siis vääristyä, ja kuvasta, joka ei mahdu kokonaan ruu- dulle, jätetään yli vuotanut osa kylmästi näyttämättä. Paletin värit ero- tellaan Amigan OCS/ECS-piirisarjan ominaisuuksien mukaisesti 12 bitin tark- kuudella. Näin ollen on toimituksen tehtävä muokata kuvat lehteen sopivik- si. Kuvat ovat Kuvat-hakemistossa ja niiden lataamiseen käytetään Christian Weberin iff.librarya. Artikkelit ---------- Käyttäjä voi valita lehden hakemistosta Hakemisto.datiin merkityt artikke- lit näytettäväksi. Artikkelit ovat erillisissä tiedostoissaan Teksti-hake- mistossa ja niilläkin on oma formaattinsa. Ensimmäisellä rivillä on luku väliltä 0-15. Se määrittelee värin jota tekstissä käytetään (ellei ohjaus- koodeilla toisin määrätä). Värit ovat sivuilla joilla ei ole kuvia järjes- tyksessä seuraavat: musta, tumman sininen, vaalean sininen, turkoosi, tum- man harmaa, vaalean harmaa, kirkkaan punainen, keltainen, lila, sininen, vihreä, oranssi, kirkas turkoosi, valkoinen, valkoinen ja tumman punainen. Ensimmäiset neljä väriä on valittu läheisistä sävyistä ikkunoiden reunojen väreiksi. Valkoinen on paletissa kahdesti, koska käyttöjärjestelmä valitsee kursorin ja ikkunoiden värit paletin alusta ja lopusta. Toisella rivillä on joko numero 0 tai 1. Tämä määrittelee tavan jolla ar- tikkeli ladotaan ruudulle. 0 tarkoittaa palstoitusta. Tällöin artikkelin tulee olla tiedostossa 39 merkin riveinä ja ohjelma sitten läiskäisee sen ruudulle kahdessa palstassa (yhden sivun pituudeksi tulee siis 60 riviä). 1 merkitsee tavallista ladontaa jolloin tekstin leveys voi olla 80 merkkiä ja yhdelle sivulle mahtuu 30 riviä. Kolmannella ja sitä seuraavilla riveillä luetellaan artikkelin sekaan lisättävät kuvat. Ensimmäisenä riville tulee sivun numero (alkaen nollas- ta), välilyönnin jälkeen tulee kuvan nimi ilman hakemistopolkua (kuvat ovat Kuvat-hakemistossa) ja toisen välilyönnin jälkeen tulevat välilyönneillä erotetut kuvan x- ja y-koordinaatit. Kuvan sivunumeroksi voidaan antaa myös -1, jolloin kaikille artikkelin kuvattomille sivuille haetaan paletti anne- tusta kuvasta. Näin voidaan helposti yhtenäistää kuvia sisältävän artikke- lin väriasua. Palettikuvan koordinaattien arvoilla ei ole merkitystä, mutta ne tulee silti määritellä. Viimeisen kuvaesittelyrivin loppuun tulee tähti (*). Jos artikkelissa ei ole kuvia, tähti tulee jo heti ladontaohjeen jälkeen. Tähden jälkeen itse artikkeli alkaa seuraavalta riviltä. Tekstissä käytetään ISO Latin1 -merkistöä ja rivit päättyvät muiden Amiga-tekstien tapaan pelkkään LF-koodiin. Rivien alussa voidaan käyttää kaksimerkkisiä ohjauskoodeja kyseisen rivin värin vaihtamiseen. Ohjauskoodi alkaa merkillä { ja sitä seuraa heksaluku (0-F) joka määrittelee värin. Värit ovat ylhäällä luetellut, ellei kyseisen sivun palettia muuteta kuvilla. Jos ri- vin alussa tarvitaan {-merkkiä, tapahtuu se kahdella perättäisellä aaltosu- lulla ({{). Jos rivin alussa on {*, voi rivi olla monivärinen ja sisältää useita väriohjauskoodeja. Huomaathan, että moniväririveillä myös keskellä riviä oleva {-merkki tulee kirjoittaa muotoon {{. Teksti näytetään kahdeksan pisteen topaz-fontilla. Esimerkki: 5 1 0 Kuva_1.IFF 100 64 0 Kuva_2.IFF 300 64* {3Tämä teksti näytetään turkoosilla. Tämä teksti on harmaalla ja sen alla on kaksi kivaa kuvaa. {*Tämä on moniväririvi. Ensin vakioharmaata ja sitten {7keltaista. Musiikki -------- Disketti-Sakun ominaisuuksiin kuuluu myös taustalla soiva musiikki. Musiik- ki on Teijo Kinnusen kehittämässä MED- tai OctaMED-formaatissa ja se soite- taan medplayer.libraryn avustuksella. Musiikki löytyy Musiikki-hakemistosta nimellä Taustamusiikki.MED. Yhteensopivuus -------------- Sakun lukija ja lehden tiedostot eivät ole kaikki aikaisempien versioidensa kanssa yhteensopivia. Seuraava taulukko listaa yhteensopivuudet. Voit siis esimerkiksi lukea Sakuja #11 - #24 koodin versioilla 2.46 - 2.62a, mutta et versioilla 2.45 tai 2.65. Koodin versiot Yhteensopivat lehdet Formaatin muutokset --------------- ----------------------- ----------------------------------- 1.0b #1 Se aito ja alkuperäinen. --------------- ----------------------- ----------------------------------- 2.06 - 2.09d #2 - #4 Yksipalstaiset artikkelit ja taus- tamusiikki. --------------- ----------------------- ----------------------------------- 2.26 #5 Uusittu hakemisto väliotsikkoineen ja värejä artikkeleissa. --------------- ----------------------- ----------------------------------- 2.40 #6 - #7 Laajennettu kuvatuki. --------------- ----------------------- ----------------------------------- 2.41 #8 Uusitut, selkeämmät hakemistojen ja avaintiedostojen nimet. --------------- ----------------------- ----------------------------------- 2.43a - 2.45 #9 - #10 Kansikuvatiedoston nimi Hakemis- to.dat:n alussa. --------------- ----------------------- ----------------------------------- 2.46 - 2.62a #11 - #24 + Saku 97 Poistettu kansikuvan ja musiikin tiedostonimet Hakemisto.dat:sta. --------------- ----------------------- ----------------------------------- 2.62joulu Joulu-Saku 1997 Jouluinen paletti. --------------- ----------------------- ----------------------------------- 2.65 #25 - #26 Monilevyketuki ja moniväririvit. --------------- ----------------------- ----------------------------------- 2.70 #27 - Artikkelikohtainen peruspaletti. Taaksepäin yhteensopiva version 2.65 kanssa. Päivitykset ----------- 12.01.1999 Päivitetty esimerkkien tiedostonimet (nykyisin ei skandeja). 01.01.1999 Päivitetty kappaleet Kuvat ja Artikkelit. Korjauksia. 01.08.1998 Lisätty kappale Yhteensopivuus. Tarkennuksia kappaleessa Kuvat. 01.07.1998 Lisätty monilevyketuen ja moniväririvien kuvaukset. Korjauksia. 09.06.1995 Lisätty selvitys siitä miksi valkoinen on paletissa kahdesti. 03.06.1995 Ensimmäinen julkinen versio disketti-Sakun (v2.46) specseistä.