KTuberlingi käsiraamat
Autoriõigus © 1999, 2000, 2002, 2006 Éric Bischoff
Autoriõigus © 2001 Paul E. Ahlquist, Jr.
Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".
KTuberling on väikelastele mõeldud mäng.
Tabelite nimekiri
KTuberling on väikestele lastele mõeldud mäng. Mõistagi võivad seda mängida ka täiskasvanud, kelles on säilinud piisavalt last.
See on omamoodi “kartuliredaktor”.See tähendab, et sa võid lohistada silmi, suid, vuntse ning muid kehaosi ja lisajubinaid kartuliga sarnaneva mehikese peale. Lisaks sellele on aluseks võimalik võtta ka pingviin ja akvaarium, kuhu saab lohistada muulaadset kraami.
Selles mängus võitjat ei olegi - selle ainus mõte on valmistada naljakaim tegelane, keda sa vähegi suudad ette kujutada.
On olemas omamoodi muuseum (nagu “madame Tusseau'” galerii), kus võid leida hulgaliselt näiteid kaunistatud kartulitest, pingviinidest ja akvaariumidest. Mõistagi võid saata omaloodud kunstiteosed programmeerijale Éric Bischoffile, kes lisab nad meelsasti muuseumi, kui vähegi aega leiab.
KTuberling võib ka “kõnelda”, täpsemalt öelda välja nende objektide nimetused, mida sa parajasti lohistad. Ta “räägib” just selles keeles, mida sa oled valinud, nii et sa võid seda mängu kasutada isegi mõne võõrkeelse sõna äraõppimiseks. Praegu suudab KTuberling “kõnelda” taani, saksa, inglise, hispaania, prantsuse, itaalia, hollandi, portugali, rumeenia, slovaki, sloveeni ja rootsi keeles.
Peaaken jaguneb kaheks:
Vasakul asuv “mängulaud”.
Paremal asuvad “objektid”, kus saab valida objekte, mida mängulauale asetada.
Objekti lohistamiseks vii hiirekursor paremal asuvasse “objektide” alale. Klõpsa elemendil, mida soovid lohistada, kuid ära lase hiirenuppu lahti, enne kui oled liigutanud hiire kohta, kuhu tahad objekti “mängulaual” asetada.
Kui objekt on “mängulauale” kukutatud, saab teda seal ka edasi liigutada. Selleks klõpsa samamoodi objektil ning lohista see hiirenuppu all hoides teise kohta. Klõpsates ilmub see teiste objektide peale, kui need peaksid teda osaliselt varjama. Nii saab näiteks panna täpselt paika silmad ja prillid.
Tööriistaribal asuvad mõned kõige sagedamini kasutatavate funktsioonidega nupud.
Tabel 2.1. Tööriistariba nupud
| Nupp | Nimi | Menüüvaste | Tegevus |
|---|---|---|---|
| Uus | -> | Puhastab “mängulaua”, kustutades seal kõik lisatud elemendid, nii et saab alustada uut kaunistamisoperatsiooni. |
| Ava | -> | Avab olemasoleva Kartulimehe faili muuseumist või mõnest muust kataloogist. |
| Salvesta | -> | Salvestab sinu loomingu kodukataloogi või mõnesse muusse kataloogi, näiteks muuseumi, kui sa seda soovid. Kartulimees salvestatakse pisikese failina, kus on kirjas ainult objektide asend. |
| Trüki | -> | Trükib loodud pildi (PostScript® vormingus). |
| Võta tagasi | -> | Tühistab viimase tegevuse. |
| Tee uuesti | -> | Sooritab viimase operatsiooni uuesti. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Puhastab “mänguvälja”
Avab olemasoleva Kartulimehe faili muuseumist või sinu soovi kohaselt ka kuskilt mujalt.
Salvestab sinu loominug. Kartulimees salvestatakse väikese failina, kus on kirjas ainult objektide asend.
Loob graafikafaili, mis sisaldab sinu loodud pilti. Salvestada saab järgmistesse vormingutesse: XPM, JPEG, PNG ja BMP.
Trükib kartulimehe pildi PostScript® vormingus.
Lõpetab KTuberlingi töö.
Lülitab sisse kartulimehega mängulaua. KTuberling jätab viimati kasutatud mängulaua meelde ning laeb selle mängu taaskäivitamisel.
Lülitab sisse pingviiniga mängulaua. KTuberling jätab viimati kasutatud mängulaua meelde ning laeb selle mängu taaskäivitamisel.
Lülitab sisse akvaariumiga mängulaua. KTuberling jätab viimati kasutatud mängulaua meelde ning laeb selle mängu taaskäivitamisel.
Arvesta, et helide kuulmiseks peab olema paigaldatud kdemultimedia ning artsd peab töötama.
Lülitab helid välja. KTuberling jätab selle võimaluse meelde ning arvestab sellega mängu taaskäivitamisel.
Lülitab helid taani keelele. Kui taani helisid pole paigaldatud, ei saa seda kasutada. KTuberling jätab valiku meelde ja arvestab sellega mängu taaskäivitamisel.
Lülitab helid saksa keelele. Kui saksa helisid pole paigaldatud, ei saa seda kasutada. KTuberling jätab valiku meelde ja arvestab sellega mängu taaskäivitamisel.
Lülitab helid inglise keelele. Kui inglise helisid pole paigaldatud, ei saa seda kasutada. KTuberling jätab valiku meelde ja arvestab sellega mängu taaskäivitamisel.
Sama muude keelte puhul.
Lülitab tööriistariba näitamise sisse ja välja.
Avab KDE tavapärase kiirklahvide seadistamise dialoogi, kus saab muuta KTuberlingis kasutatavaid kiirklahve.
Avab KDE tavapärase tööriistaribade seadistamise dialoogi.
Käivitab KDE abisüsteemi ja avab KTuberling abimaterjali (käesoleva käsiraamatu).
Muudab hiirekursori noole ja küsimärgi kombinatsiooniks. Klõpsates nüüd mõnel KTuberling elemendil, avaneb väike abiaken (kui see on antud elemendi kohta olemas), mis selgitab elemendi funktsiooni.
Avab vearaporti dialoogi, mille abil saab teada anda veast või esitada oma “soov” millegi parandamiseks.
Näitab versiooni ja infot autori kohta.
Näitab KDE versiooni ja muud olulisemat põhiinfot.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KTuberling pakub omalt poolt hea võimaluse kaasa aidata KDE kohandamisele ja arendamisele. Ka seda mängu saab laiendada. Nii võib ka ilma programmeerimata lisada uusi mängulaudu lihtsalt graafikafaile redigeerides. Sobivate helifailide lisamisega võivad tõlkijad panna sõnad ka oma emakeeles kõlama!
Kui laiendad mängu või lisad sellele midagi, võiksid saata oma panuse ka arendajale Éric Bischoffile, kes saab siis sinu panuse järgmisse versiooni kaasata.
Mängulaua suurust ja kuju ning objektide hulka on võimalik muuta. Lisada saab uusi mängulaudu. Iga mängulaua jaoks on vaja luua vaid kaks pildifaili: mängulaud ja mask. Kokku on lubatud kuni 8 mängulauda, praegu on kasutusel vaid kolm.
KTuberling kasutab kuut pilti: potato-game.png, potato-mask.png, penguin-game.png, penguin-mask.png, aquarium-game.png ja aquarium-mask.png. Nende failide standardne asukoht on kataloog $KDEDIR/share/apps/ktuberling/pics/.
Esimest tüüpi pildid, nimelt *-game.png, sisaldavad endas mängulauda ja kasutajale valikuks pakutavaid objekte. See on graafika, mida kasutaja mängimise ajal näeb.
Teist tüüpi pildid (*-mask.png) sisaldavad ainult objektide maske. Maske kasutatakse objektide servade piiritlemiseks ning mõnel juhul ka teatud läbipaistvuse andmiseks (nt. prillide puhul). Kohustuslik on asetada objektid mängulaua failis samasse positsiooni, nagu nad eksisteerivad maskifailis.
Samas kataloogis määrab fail layout.xml ($KDEDIR/share/apps/ktuberling/pics/layout.xml), milliseid pilte kasutatakse, ning seob nad menüükirjetega. See fail sisaldab ka mänguvälja ning objektide positsioone mängulaua- ja maskifailides. Samuti seob ta helid objektidega ning seab objektid gruppidesse. Ning lõpuks määratleb ta keeled tõlgitud helide komplektina. Fail järgib XML standardeid (vt üksikasju allpool).
Sellessamas kataloogis on ka fail layout.i18n ($KDEDIR/share/apps/ktuberling/pics/layout.i18n), mis võtab failist layout.xml tõlgitavad stringid:
Menüükirjed, mis võimaldavad valida mängulauda ja keelt
Objektikategooriate nimed
Mainitud kataloogi emakataloogis on veel üks XML-fail ktuberlingui.rc ($KDEDIR/share/apps/ktuberling/ktuberlingui.rc), mis kirjeldab KTuberlingi menüüsid. See peaks sisaldama ühe sildi <action> (tegevus) iga mängulaua ja keele kohta. Tegevuse sümboolne nimi selles failis peaks kattuma tegevuse sümboolse nimega failis layout.xml.
Lisaks tavalisemale rakenduse käskude, teadete ja muu nähtava .po-failide tõlkimisele saab lokaliseerida ka helisid.
Kui tõlkijad suudavad salvestada oma hääle .wav-faili, võivad nad selle salvestada helide kataloogis keelele vastavasse alamkataloogi. Seejärel omistatakse heli nimi failile failis layout.xml. Kui näiteks sihtkeel on itaalia keel, võivad tõlkijad salvestada oma hääle .wav-failidesse, mis asuvad kataloogis $KDEDIR/share/apps/ktuberling/sounds/it. Seejärel saavad nad näiteks seostada heli nimetusega “hat” (“müts”) failinimega it/cappello.wav.
Tulevastes versioonides hakkab KTuberling helivorminguna kasutama OGG Vorbis rc3. Hetkel on võimalik teisendada WAV-failid OGG Vorbis rc3 vormingusse käsurea korraldusega:
$oggenc -q 10 -ohelifail.ogghelifail.wav
Infot selle kohta, kuidas käib tõlkimine KDEs, annab KDE tõlkimise HOWTO.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Õigupoolest on KTuberling programmeerijatele üsna hõlpsasti laiendatav.
TopLevelTipptaseme aken ja rakenduse baashaldus
PlayGroundMingi konkreetse mängutaseme kirjeldus
ToDrawMingi konkreetse graafilise “objekti” kujutamise kirjeldus
SoundFactoryMingi konkreetse keele ja selle helide kirjeldus
ActionKonkreetne kasutaja tegevus võta tagasi/tee uuesti võimalustega
.tuberling-fail sisaldab kõiki andmeid, mida on vaja kartulimehe kujutamiseks. Seda võib redigeerida ka tavalise tekstiredaktoriga.
Esimene rida sisaldab mängulaua numbrit.
Kõigil ülejäänud ridadel on üks graafiline objekt rea kohta järjekorras, nagu neid kujutatakse. Iga rida sisaldab viis numbrit: objekti identifikaator ning joonistatav nelinurk (vasak, ülemine, parem, alumine). Numbreid eraldavad tühikud.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
layout.xml) struktuurÜlataseme silt on unikaalne ning kannab nime <ktuberling>. See sisaldab mitu silti <playground>, ühe iga mängulaua kohta, ning mitu silti <language>, mida on samuti üks iga keele kohta.
Sildil <playground> on kaks atribuuti: gameboard ja masks. Need määravavad pilte sisaldavate failide nime. Silt <playground> sisaldab ka ühe sildi <menuitem>, ühe sildi <editablearea>, mitu silti <category> ja mitu silti <object>.
Silt <menuitem> kirjeldab menüüelemendi tegevuse identifikaatorit, võimaldades valida positsiooni, kuhu saab objekte kukutada, ning selle menüüelemendi nimetust. See tegevuse identifikaator peab kattuma failis ktuberlingui.rc leiduvaga.
Silt <editablearea> kirjeldab positsiooni, kuhu saab objekti kukutada, ning sellega seotud heli nime.
Silt <category> kirjeldab objektigrupi positsiooni ja nimetust. Nii näiteks saab kirjeldada grupi “lisad” positsiooni ja nimetust.
Silt <objekt> kirjeldab objekti positsiooni (nii mängulaual kui maskis), samuti sellega seonduva heli nime.
Silt <language> on ühe atribuudiga: code. See atribuut määrab antud keele lokaadi koodi. Silt <language> sisaldab ka ühe sildi <menuitem> ja mitu silti <sound>.
Madalama taseme silte me siin ei kirjelda, sest nende tähendus on iseenesestmõistetav. Kui muudad faili layout.xml, ära unusta vastavalt muutmast ka faile layout.i18n ja ktuberlingui.rc.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KTuberling
John Calhoun - algne idee, esialgsed pildid ja ingliskeelsed helid
Éric Bischoff (e.bischoff AT noos.fr) - KDE programmeerimine
François-Xavier Duranceau (duranceau AT free.fr) - testid, nõuanded ja abi
Agnieszka Czajkowska (agnieszka AT imagegalaxy.de) - pingviini graafika
Bas Willems (next AT euronet.nl) - graafika ümbertegemine ja akvaariumi teema
Roger Larsson (roger.larsson AT norran.net) - helide korrastamine
Dolores Almansa (dolores.almansa AT corazondemaria.org) - haridusalane graafika COR-EDUX algatusele
Peter Silva (peter.silva AT videotron.ca) - dokumentatsiooni korrektuur
Paul Ahlquist (pea AT ahlquist.org) - dokumentatsiooni täiendamine
See mäng on pühendatud minu pisitütrele Sunniva Bischoffile
Tänusõnad kuuluvad Apple Computer'ile ja projektile LinuxPPC™, mis võimaldasid Linux® portimise Mac®-ile. KTuberling poleks ilma selleta võib-olla teoks saanudki!
Tõlge eesti keelde: Marek Laane (bald AT starman.ee)
Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KTuberling on osa KDE projektist http://www.kde.org/.
KTuberling asub paketis kdegames KDE projekti peamises FTP saidis ftp://ftp.kde.org/pub/kde/.
KTuberlingi edukaks kompileerimiseks on vajalik KDE 3.5. Kõik nõutavad teegid, samuti KTuberling ise asuvad aadressil ftp://ftp.kde.org/pub/kde/.
Helide kuulmiseks peab olema paigaldatud kdemultimedia.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Et KTuberling oma süsteemis kompileerida ja paigaldada, anna KTuberling baaskataloogis järgmised käsud:
%./configure%make%make install
Kuna KTuberling kasutab autoconf'i ja automake'i, ei tohiks kompileerimisel probleeme esineda. Kui neid siiski ette tuleb, anna sellest palun teada KDE meililistides.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team