.
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õ.