>&ksplash; on kena käivitusekraan, mis näitab rakenduse laadimise edenemist. Palun anna kõigist probleemidest või mõtetest täiustamise kohta teada &kde; meililistides. &ksplash;i peamised omadused on: </para>
<simplelist>
<member
>Teemade kasutamine</member>
<member
>Pluginate kasutamine (võimaldab täielikku kohandamist oma suva järgi)</member>
<member
>Võimalus kasutada suvalise rakendusega, mis pruugib DCOP-i</member>
</simplelist>
<para
>Käesolev käsiraamat selgitab, kuidas luua teemasid kasutamiseks juba olemasolevate pluginatega. Kui ükski plugin ei suuda sinu tuju järgi olla, võib õppida &ksplash;i välimust igati ja täielikult muutma pluginat ise C++ keeles kirja pannes. </para>
</chapter>
<chapter id="using-themes">
<title
>Teemade kasutamine</title>
<para
>Kui tahad kasutada saidi <ulink url="http://www.kde-look.org"
>KDE-Look</ulink
> teemasid, paki need ainult endale kasutamiseks lahti kataloogi <filename
>, kui soovid need teha kättesaadavaks kõigile süsteemi kasutajatele.</para>
<para
>Kogu selle vaeva võib lasta automaatselt ära teha küll ka &kde; juhtimiskeskuse kaardi <guilabel
>Välimus</guilabel
> moodulil <guilabel
>Käivitusekraan</guilabel
>.</para>
<sect1 id="using-kcontrol-module">
<title
>&juhtimiskeskus;e mooduli kasutamine</title>
<para
>See moodul võimaldab paigaldada, testida ja eemaldada &ksplash;i teemasid.</para>
<para
>Moodul näitab kõiki parajasti saadaolevaid &ksplash;i teemasid. Kui valida neist mõni, saab selle eelvaatlust näha akna põhiosas. Kui oled leidnud selle, mida soovid kasutada, klõpsa nupule <guibutton
>OK</guibutton
> või <guibutton
>Rakenda</guibutton
>. Kui soovid moodulist väljuda muudatusi tegemata, klõpsa nupule <guibutton
>Loobu</guibutton
>, või nupule <guibutton
>Vaikeväärtused</guibutton
>, kui soovid taastada süsteemse vaikekäivitusekraani.</para>
> ja otsi vajalik teema arvutist üles. Sul ei ole vaja teemafaile ise lahti pakkida, võid rahumeeli valida ka tihendatud teemafaili. Teema paigaldamine ei tähenda veel, et seda kohe kasutama hakataks - selleks tuleb see loendis valida ja klõpsata nupule <guibutton
>OK</guibutton
> või <guibutton
>Rakenda</guibutton
>.</para>
<para
>Eelvaatlust lubab küll käivitusekraanist ülevaate saada, kuid tõenäoliselt tahaksid seda siiski nii-öelda päriselt näha, et näiteks kontrollida, kuidas toimib animatsioon. Teemasid on võimalik testida, kui valida loendist teema ja klõpsata nupule <guibutton
>Test</guibutton
>.</para>
<para
>Kui sa ei soovi enam mõnda teemat kasutada, võib selle eemaldada, kui valida loendis teema ja klõpsata nupule <guibutton
>Eemalda</guibutton
>. Pane tähele, et tavakasutajal ei ole üldiselt õigust eemaldada süsteemselt paigaldatud teemasid. Samuti on päris soovitatav mitte eemaldada käivitusekraani, mille nimeks on <guilabel
>vaikimisi</guilabel
></para>
</sect1>
</chapter>
<chapter id="themes">
<title
>Kuidas luua teemasid &ksplash;ile</title>
<sect1 id="themes-general">
<title
>Üldine</title>
<para
>Oma teema loomine &ksplash;ile on päris lihtne. Kui oled teema valmis saanud, võid selle postitada veebileheküljele <ulink url="http://www.kde-look.org"
>KDE-Look</ulink
>, et sinu suurepärasest ilumeelest saaksid osa ka teised.</para>
<sect2 id="theme-syntax">
<title
>Teema identifitseerimine</title>
<para
>Võtame ette teema <literal
>MinuLaheTeema</literal
> loomise. Et &ksplash; teemat tunnistaks, tuleb see salvestada kataloogi <filename class="directory"
>MinuLaheTeema</filename
>, mis omakorda paikneb kataloogis <filename class="directory"
>~/.kde/apps/ksplash/Themes/</filename
>. Teemat sisaldab fail nimega <filename
>Theme.rc</filename
>. Selles võib ära määrata terve hulga erilisi omadusi, muuta kasutatavat pluginamootorit ja nii edasi. Kõiki vähegi mõeldavaid seadistusi kasutada ei ole mõistagi kohustuslik, sest tavaliselt on seadistustele määratud üsna mõistlikud vaikeväärtused. Faili <filename
>Theme.rc</filename
> kirjete põhisüntaks on lihtne: <literal
>[võti] = [väärtus]</literal
>. Võtmete definitsioonid leiab käsiraamatu edasistes osades.</para>
<example>
<title
>Lihtne <filename
>Theme.rc</filename
> fail</title>
<programlisting
>[KSplash Theme: MinuLaheTeema]
Name = MinuLaheTeema
Description = Kena XpLike mootorit kasutav teema
Version = 1.0
Author = Tegelik nimi <tegelik_meiliaadress@mail.ee>
## Selle teema puhul kasutatakse XpLike mootorit.
Engine = XpLike
Show Icon = false
Welcome Text = KDE käivitamine
</programlisting>
</example>
<para
>Pärast teema nime, kirjelduse ja autori määramist tuleb valida teema mootor (sageli nimetatakse seda ka pluginaks). Seejärel saab meelepäraseks muuta mootori mitmesugused võimalused, pannes paika võtme-väärtuse paarid, nagu näha toodud näites.</para>
<important>
<para
>Tuleb kindlasti tähele panna, et kataloog, kuhu teemafailid on salvestatud (antud juhul <filename class="directory"
>~/.kde/apps/ksplash/Themes/MyCoolTheme</filename
>), ning teema identifikaator (antud juhul <literal
>[KSplash Theme: MyCoolTheme] </literal
>) failis <filename
>Theme.rc</filename
> oleks samasugused, sest muidu ei tunne &ksplash; teemat ära.</para>
</important>
</sect2>
<sect2 id="theme-files">
<title
>Taustafailid</title>
<para
>Kui &ksplash; tööd alustab, püüab ta leida sinu parajasti valitsevale ekraaniresolutsioonile vastavat taustapilti, kui teemamootor seda kasutama peaks. Taustapildi fail peaks kandma järgmises vormingus nime: <filename
>Background<replaceable
>LAIUSxKÕRGUS</replaceable
>.png</filename
>.</para>
<para
>Näiteks <filename
>Background-1024x768</filename
>. Kui resolutsioonile vastavat taustapilti ei leita, püütakse muuta algupärase <filename
>Background.png</filename
> või failis <filename
>Theme.rc</filename
> määratud faili suurust, et see sobiks kokku valitseva resolutsiooniga. Selline lennult suuruse muutmine võib võtta tükk aega, mispärast oleks kasulik omada vähemalt järgmistes mõõtmetes taustapilte: 1280x1024, 1024x768 ja 800x600.</para>
</sect2>
</sect1>
<sect1 id="theme-engines">
<title
>Teemamootorite valikud</title>
<sect2 id="default-themes">
<title
>Vaiketeema</title>
<table>
<title
>Vaiketeema valikud</title>
<tgroup cols="3">
<tbody>
<row>
<entry
>Nimi</entry>
<entry
>Argument</entry>
<entry
>Seletus</entry>
</row>
<!-- Statusbar -->
<row>
<entry
>Always Show Progress</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas laadimise edenemist näidata või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<row>
<entry
>Label Foreground</entry>
<entry
>[värv]</entry>
<entry
>Määrab olekuriba teksti värv. Vaikimisi on see #FFFFFF ehk valge.</entry>
</row>
<!-- Misc. things -->
<row>
<entry
>Icons Flashing</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas ikoone <quote
>vilgutatakse</quote
> või mitte. Vaikimisi tõene (true).</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="standard-themes">
<title
>Standardteema</title>
<table>
<title
>Standardteema valikud</title>
<tgroup cols="3">
<tbody>
<row>
<entry
>Nimi</entry>
<entry
>Argument</entry>
<entry
>Seletus</entry>
</row>
<!-- Statusbar -->
<row>
<entry
>Statusbar Position</entry>
<entry
>[top/bottom]</entry>
<entry
>Määrab olekuriba asukoha ekraanil. Vaikimisi on see all (bottom).</entry>
</row>
<row>
<entry
>Statusbar Visible</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas olekuriba näidata või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<row>
<entry
>Progress Visible</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas laadimise edenemist näidata või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<!-- Fonts -->
<row>
<entry
>Statusbar Font</entry>
<entry
>[fondinimi]</entry>
<entry
>Olekuribal kasutatav font. Vaikimisi on see Helvetica.</entry>
</row>
<row>
<entry
>Statusbar Font Size</entry>
<entry
>[suurus]</entry>
<entry
>Olekuriba fondi suurus. Vaikimisi on see 16.</entry>
</row>
<row>
<entry
>Statusbar Font Bold</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas olekuriba font on rasvases kirjas või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<row>
<entry
>Statusbar Font Italic</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas olekuriba font on kaldkirjas või mitte. Vaikimisi on see väärtus väär (false).</entry>
</row>
<!-- Misc. things -->
<row>
<entry
>Statusbar Foreground</entry>
<entry
>[värv]</entry>
<entry
>Olekuriba esiplaani värv. Vaikimisi on see valge (white).</entry>
</row>
<row>
<entry
>Statusbar Background</entry>
<entry
>[värv]</entry>
<entry
>Olekuriba tausta värv. Vaikimisi on see must (black).</entry>
</row>
<row>
<entry
>Statusbar Icon</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas olekuribal peaks olema ikoon või mitte.</entry>
</row>
<row>
<entry
>Icons Visible</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas ikoonid on näha või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<row>
<entry
>Icons Jumping</entry>
<entry
>[true/false]</entry>
<entry
>Määrab, kas ikoonid hüppavad või mitte. Vaikimisi on see väärtus tõene (true).</entry>
</row>
<row>
<entry
>Icon Position</entry>
<entry
>[0-3,10-13]</entry>
<entry
>Asukoht, kus ikoone näidatakse. Vaikimisi all vasakul.</entry>
</row>
<row>
<entry
>Splash Screen</entry>
<entry
>[nimi]</entry>
<entry
>Muudab näidatavat käivituslogo pilti.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="redmond-themes">
<title
>Redmondi teema</title>
<table>
<title
>Redmondi teema valikud</title>
<tgroup cols="3">
<tbody>
<row>
<entry
>Nimi</entry>
<entry
>Argument</entry>
<entry
>Seletus</entry>
</row>
<!-- Main elements -->
<row>
<entry
>Background Image</entry>
<entry
>[failinimi]</entry>
<entry
>Kasutaja määratud kasutatav taustapilt.</entry>
</row>
<row>
<entry
>User Icon</entry>
<entry
>[ikooninimi]</entry>
<entry
>Kasutajale näidatava standardikooni nimi. Vaikimisi <constant
>go</constant
>.</entry>
</row>
<row>
<entry
>Welcome Text</entry>
<entry
>[tekst]</entry>
<entry
>Käivitusekraanil näidatav tekst. Vaikimisi "Welcome" (inglise keele korral). Eestinduses võiks olla "Tere tulemast".</entry>
</row>
<row>
<entry
>Username Text</entry>
<entry
>[tekst]</entry>
<entry
>Tekst, mida näidatakse kasutaja tegeliku nime asemel.</entry>
</row>
<!-- Positioning elements -->
<row>
<entry
>Welcome Text Position</entry>
<entry
>[x,y]</entry>
<entry
>Asukoht ekraanil, kus näidatakse tervitusteksti.</entry>
</row>
<row>
<entry
>Username Text Position</entry>
<entry
>[x,y]</entry>
<entry
>Asukoht ekraanil, kus näidatakse kasutajanime.</entry>
</row>
<row>
<entry
>Action Text Position</entry>
<entry
>[x,y]</entry>
<entry
>Asukoht ekraanil, kus näidatakse parajasti käivat tegevust.</entry>
</row>
<row>
<entry
>Icon Position</entry>
<entry
>[x,y]</entry>
<entry
>Asukoht ekraanil, kus näidatakse kasutaja ikooni.</entry>
>Tiitli esiplaani värv. Vaikimisi valge (white).</entry>
</row>
<row>
<entry
>Status Text Color</entry>
<entry
>[värv]</entry>
<entry
>Staatusetekstide värv. Vaikimisi sama, mis tiitli tausta värv.</entry>
</row>
<row>
<entry
>Rotator Color 1</entry>
<entry
>[värv]</entry>
<entry
>Määrab esimese rotaatori värvi. Vaikimisi tumesinine (dark blue).</entry>
</row>
<row>
<entry
>Rotator Color 2</entry>
<entry
>[värv]</entry>
<entry
>Määrab teise rotaatori värvi. Vaikimisi tsüaan (cyan).</entry>
</row>
<row>
<entry
>Rotator Speed</entry>
<entry
>[väärtus]</entry>
<entry
>Määrab rotaatori kiiruse. Vaikimisi 30.</entry>
</row>
<row>
<entry
>Window Title</entry>
<entry
>[tekst]</entry>
<entry
>Määrab aknatiitli teksti.</entry>
</row>
<row>
<entry
>Logo File</entry>
<entry
>[failinimi]</entry>
<entry
>Määrab kasutatava logo.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
</sect1>
</chapter>
<chapter id="from-other-applications">
<title
>&ksplash;i kasutamine oma rakendustel</title>
<para
>Selles peatükis kirjeldame lihtsat viisi, kuidas kasutada &ksplash;i oma &kde; rakenduse käivituslogona. Kui sa ei tegele rakenduste arendamisega &kde; tarbeks, võid peatüki ka vahele jätta.</para>
<sect1 id="basic-other-reqs">
<title
>Põhinõuded</title>
<para
>Valitud &kde; rakendus peab olema &DCOP;-teadlik. &DCOP; on &kde; rakendustevahelise suhtlemise tehnoloogia. Kui kasutad standardset <ulink url="http://developer.kde.org"
>&kde; rakenduse raamistikku</ulink
>, peaks selle eest olema automaatselt hoolt kantud. Kui vajad rohkem infot &DCOP;i ja sellega seotud &kde; tehnoloogia kohta, uuri <ulink url="http://developer.kde.org"
>&kde; arendajate kodulehekülge</ulink
>.</para>
</sect1>
<sect1 id="other-using">
<title
>&ksplash;i käivitamine</title>
<para
>Enne seda, kui sinu rakendus alustab arvutikurnamist või pluginate laadimist &etc;, kutsu &ksplash; nii välja:</para>
if (kapp->startServiceByDesktopName("ksplash", args, &error,
&KSplashName, &pid))
{
KMessageBox::sorry(0, error, "Unable to invoke KSplash");
// Some error processing here.
}
</programlisting>
<para
>Me eeldame, et korraga töötab ainult üks &ksplash;i protsess, muidu lähevad asjad natuke keerulisemaks. Täpsemalt loe selle kohta &DCOP;i dokumentatsioonist.</para>
</sect1>
<sect1 id="show-messages">
<title
>Teadete näitamine</title>
<para
>Enne kui näidata mingeid teateid, tuleb määrata, mitut sammu näidatakse. Näiteks &kde; käivitusprotseduuril on 7 sammu.</para>
<programlisting
>QByteArray data;
QDataStream arg(data,IO_WriteOnly);
arg << someNumber;
if (!(c->send(KSplashName, "KSplashIface", "setStartupItemCount(int)",
data))
// Some error processing here.
</programlisting>
<para
>Kui soovid näidata teadet ikooniga või ilma, kasuta</para>
>Ja ongi kõik! Selleks, et osa saada kõigest, mida &ksplash; sulle pakkuda suudab, ei ole vaja midagi rohkem teha.</para>
</sect1>
</chapter>
<!-- FIXME: Better to leave this out until it's written, or the translators -->
<!-- will have to still translate it ... -->
<chapter id="wrplugins">
<title
>Uute &ksplash;i pluginate kirjutamine</title>
<para
>&ksplash;ile uute pluginate kirjutamine pole kuigi raske. Selles peatükis kirjutame lihtsa plugina, mis emuleerib hästi tuntud operatsioonisüsteemi käivitusekraani. Me eeldame, et sa tunned C++ põhialuseid ja oled kas või põgusalt tuttav KDE/Qt programmeerimisega.</para>
<sect1 id="basic-requirements">
<title
>Põhinõuded</title>
<para
>Loome plugina nimetusega <literal
>2k</literal
>. Plugina nime kasutatakse mitmes kohas ning oluline on seda kõikjal ühtmoodi kasutada, et &ksplash; selle ikka ära tunneks. Õigupoolest on &ksplash;i pluginad dünaamiliselt laetavad teegid, mille juures tuleb järgida järgmisi nimekonventsioone: </para>
<simplelist>
<member
>Teek peaks kandma nime <filename
>ksplash+teemanimiväiketähtedega</filename
>. Meie teema puhul siis <filename
>ksplash2k</filename
>.</member>
<member
>Sellele peab vastama töölauafail nimega <filename
>Lõpuks peab teegi tagastatud objekt olema klass nimega <literal
>Theme+teemanimi</literal
>, meie juhul <literal
>Theme2k</literal
>.</member>
</simplelist>
<para
>Ei tasu masendusse langeda, kui sa kõigest kohe aru ei saanud. Hiljem vaatame kõiki punkte lähemalt. Veel üks oluline punkt on see, et pluginaklassi päritolu peab olema <literal
>ThemeEngine</literal
>. </para>
</sect1>
<sect1 id="skeleton">
<title
>Näidisraamistiku loomine</title>
<para
>Me kasutame &kde; rakenduse raamistikku, mis hoolitseb plugina loomise eest ja pakub meile sõltumatust platvormist, ilma et me selleks ise erilisi pingutusi peaksime ette võtma. Selleks kontrolli, et paigaldatud oleks pakett <filename
> rakenduse nimega "2k" tekitamiseks. See loob tipptaseme kataloogi, kus on mitmed üldised failid, näiteks AUTHORS &etc; Meid huvitab kõige enam alamkataloog <filename class="directory"
>2k</filename
>. Mine sellesse alamkataloogi ja kustuta seal kõik failid. Nüüd on meil olemas vajalik "luustik". </para>
<para
>Järgmine samm on luua <filename
>.desktop</filename
>-fail, mis paigaldamise korral teatab &ksplash;ile, et meie plugin on saadaval. Vastavalt <link linkend="basic-requirements"
>eelmises osas</link
> kirjeldatud nimekonventsioonidele loome siin kataloogis faili <filename
>ksplash2k.desktop</filename
>. See peaks sisaldama järgmisi ridu: </para>
<programlisting
><literal>
[Desktop Entry]
Encoding=UTF-8
Type=Service
Comment=KSplash Plugin
Name=KSplash2k
ServiceTypes=KSplash/Plugin
X-KDE-Library=ksplash2k
X-KSplash-Default=true
X-KSplash-PluginName=2k
X-KSplash-ObjectName=Theme2k
</literal
>
</programlisting>
<para
>Kodeering (<literal
>Encoding</literal
>), tüüp (<literal
>Type</literal
>), kommentaar (<literal
>Comment</literal
>) ja teenuse tüüp (<literal
>ServiceTypes</literal
>) on kõigile pluginatele ühesugused. Plugina ja teegi nimi järgivad eespool mainitud nimekonventsiooni. Kirje <literal
>X-KSplash-Default</literal
> kasutab tõeväärtust, mis määrab, kas seda näidatakse vaikimisi juhtimiskeskuse moodulis. Kui mõned harvad erandid kõrvale jätta, peaks see väärtus olema tõene (<constant
>true</constant
>). </para>
</sect1>
<sect1 id="headerfile">
<title
>Pluginaklassi deklaratsioon</title>
<para
>Eeltöö on tehtud, asume nüüd tõeliselt vaimustava osa kallale - looma klassi, mis pakub just sellist käitumist, mida me soovime. Me võime selle klassiga ette võtta küll peaaegu kõike, mida soovime, kuid siiski on siin teatud piirangud.</para>
<orderedlist>
<listitem
><para
>Pluginaklasside päritolu peab olema klass <constant
>ThemeEngine</constant
>.</para
></listitem>
<listitem
><para
>Pluginaklassid peavad kandma nime vastavalt reeglile <classname
>Theme+PluginaNimi</classname
>.</para
></listitem>
<listitem
><para
>Pluginaklassid peavad pakkuma <literal
>staatilise</literal
> funktsiooni <function
>names</function
>, mis tagastab nimede nimekirja, mida see saab välja kutsuda.</para
></listitem>
<listitem
><para
>Kui pluginat saab seadistada juhtimismoodulis, peab see seadistamiseks pakkuma <literal
>ThemeEngineClass</literal
>-põhise klassi.</para
></listitem>
<listitem
><para
>Pluginaklassid peavad tühistama vähemalt ühe virtuaalsetest funktsioonidest <function
>. Hetkel ei ole mõtet pead vaevata klassiga <classname
>RotWidget</classname
>. See on väike element, mis pakub kasutajale veidi silmailu. Meie plugin on äärmiselt lihtne ega näita mingeid ikoone või edenemisriba. Kui soovid ikoone näidata, tühista funktsioon <function
>slotSetPixmap</function
>. Sarnased funktsioonid on olemas edenemisriba vahemikule (<function
>slotUpdateSteps</function
>) ja käesoleva sammu kasvamisele (<function
>slotUpdateProgress</function
>). </para>
</sect1>
<sect1 id="Implementation">
<title
>Plugina teostus</title>
<para
>Uurime ainult meile kordaminevaid teostuse osi. Kogu teostuse listingut võib näha lisas. Kõigepealt tuleb välja saada teeginõue:</para>
>Kuna meile meeldivad meie kasutajad, pakume neile parameetritena mõistlikke vaikeväärtusi, mida teemafailis ei leidu. Pane tähele, et alati tuleb grupiks määrata "KSplash Theme: themename", et ühilduda tulevase teema spetsifikatsiooniga. Meetod <function
>initUI()</function
> meid praegu eriti ei huvita, sest see ainult loob elemente. Selle kohta vaata lähemalt lisast. </para>
</sect1>
<sect1 id="compilingfile">
<title
>Plugina kompileerimine</title>
<para
>Kuna me otsustasime kasutada plugina kompileerimiseks &kde; raamistikku, tuleb meil luua <filename
> kirjutamise kohta &kde; tarbeks leiab &kde; arendajate <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html"
>veebileheküljelt</ulink
>. Ainus asi, mida tasub märkida, on see, et me pakume sellele pluginale põhineva vaiketeema ning sellele ka eelvaatluse. Kasutajate huve silmas pidades tuleks pakkuda näidisfail <filename
>Theme.rc</filename
>, mis illustreerib erinevate valikut kasutamist.</para>
>&ksplash;i edukaks kasutamiseks on vajalik &kde; 3.2 või uuem. Mõned teemad võivad nõuda spetsiifilisi pluginaid. Kui teema ei hakka tööle, võta ühendust teema autoriga ja selgita välja, kuidas ja kust hankida vajalik plugin.</para>