advanced.docbook

Amarok是一款在LINUX或其他类UNIX操作系统中运行的音频播放器软件。 经过两年开发后

<chapter id="advanced-features">
<title
>Muud Amaroki võimalused</title>


<sect1 id="keybd-shortcuts">
<title
>Kiirklahvid</title>

<para
>&amarok; kasutab kiirklahve nagu iga muu korralik rakendus. Allpool on ära toodud kiirklahvid ja nendega käivitatavad toimingud. Globaalseid kiirklahve saab seadistada, kui klõpsata hiire parema nupuga mängija aknas ja valida <guimenuitem
>Globaalsete kiirklahvide seadistamine...</guimenuitem
> &amarok;i enda kiirklahve saab seadistada, kui klõpsata hiire parema nupuga mängija aknas ja valida <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
></para>

<tip
><para
>Oma multimeediaklahvide kasutamiseks &amarok;i kiirklahvidena tuleb määrata klaviatuur &amarok;i juhtimiskeskuses.</para
></tip>

<para
>Globaalsed kiirklahvid:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Klahvikombinatsioon</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>X</keycap
></keycombo
></entry>
<entry
>Esitus</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Paus</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>V</keycap
></keycombo
></entry>
<entry
>Stopp</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Järgmine pala</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Eelmine pala</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Heli juurde</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Heli maha</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Palas edasiliikumine</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Palas tagasiliikumine</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Lisa andmekandja</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Esitusnimekirja lülitamine</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>OSD näitamine</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Heli välja</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>&amarok;i kiirklahvid:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Klahvikombinatsioon</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Kopeeri</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>KP_Enter</keycap
></keycombo
></entry>
<entry
>Mine praegusele</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Valitud palad järjekorda</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Välju</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Tee uuesti</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Salvesta esitusnimekiri</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Vali kõik</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Menüüriba näitamine</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>H</keycap
></keycombo
></entry>
<entry
>Segatud</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Võta tagasi</entry>
</row>


</tbody>
</tgroup>
</informaltable>


<para
>Esitusnimekirja sirvija kiirklahvid:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Klahvikombinatsioon</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Tühikuklahv</keycap
></entry>
<entry
>Esitusnimekirja laadimine</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Esitusnimekirja ümbernimetamine</entry>
</row>

<row>
<entry
><keycap
>Backspace</keycap
></entry>
<entry
>Esitusnimekirja eemaldamine</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="the-dcop-interface">
<title
>DCOP-liides</title>

<para
>Amaroki DCOP-liides võimaldab imelihtsalt juhtida Amaroki tööd enda loodud skriptidega.</para>

<para
>Amaroki DCOP-liides pakub mitmeid üldisi funktsioone, mida kasutavad ka muud KDE rakendused. Käesolevas osas kirjeldame kuues tabelis nii muusikakogu, kontekstisirvija, mängija, esitusnimekirja, esitusnimekirja sirvija kui ka skriptide DCOP-funktsioone. Näiteks DCOP-funktsioon <quote
>pause</quote
> näeb välja selline:</para>

<para
><prompt
>&percnt;</prompt
>dcop amarok player pause</para>

<sect2 id="dcop-collection">
<title
>DCOP ja amaroKi muusikakogu</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>DCOP-väljakutse</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Tagastab albumite koguarvu muusikakogus.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Tagastab esitajate koguarvu muusikakogus.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Tagastab kompilatsioonide koguarvu muusikakogus.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Tagastab žanride koguarvu muusikakogus.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Tagastab palade koguarvu muusikakogus.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Esitab andmebaasile päringu SQL-i vahendusel.</entry>
</row>

<row>
<entry
>QStringList similarArtists( int artists )</entry>
<entry
>Tagastab aktiivse pala esitajaga sarnased esitajad, piiranguks 'int artists' antud arv.</entry>
</row>

<row>
<entry
>void migrateFile( QString oldURL, QString newURL )</entry>
<entry
>Liigutab kogus faili, jättes statistika muutmata.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Uurib muusikakogu.</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Uurib muusikakogu puhul ainult muutusi.</entry>
</row>


</tbody>
</tgroup>
</informaltable>

</sect2>

<sect2 id="dcop-context">
<title
>dcop amarok contextbrowser</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>DCOP-väljakutse</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Näitab kontekstisirvijas aktiivset pala.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Näitab kontekstisirvijas sõnade kaarti.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Näitab kontekstisirvijas Wikipedia kaarti.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect2>

<sect2 id="dcop-player">
<title
>dcop amarok player</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>DCOP-väljakutse</entry>
<entry
>Toiming</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Tagastab dünaamilise režiimi oleku.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Tagastab ekvalaiseri oleku.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Tagastab 'tõene', kui midagi esitatakse.</entry>
</row>

<row>
<entry
>bool randomModeStatus()</entry>
<entry
>Tagastab juhusliku režiimi oleku.</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Tagastab esitusnimekirja kordamise oleku.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Tagastab pala kordamise oleku.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Tagastab helitugevuse vahemikus 0-100%.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Tagastab parajasti esitatava pala diskreetimissageduse.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Tagastab parajasti esitatava pala hinde.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Tagastab esitamise oleku: 0 - peatatud, 1 - paus, 2 - esitatakse.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Tagastab pala esitamiskoha sekundites.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Tagastab aktiivse laulu esitamiskorrad.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Tagastab pala pikkuse sekundites.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Tagastab parajasti mängitava pala albumi.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Tagastab parajasti mängitava pala esitaja.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Tagastab parajasti mängitava pala bitikiiruse (XX kbps).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Tagastab parajasti mängitava pala kommentaari.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Tagastab parajasti mängitava pala kaanepildi URL-i. </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Tagastab parajasti mängitava pala positsiooni ([h:]mm:ss vormingus).</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Tagastab parajasti mängitava pala kodeeritud URL-i.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Tagastab parajasti kasutatatava audiomootori nime.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Tagastab parajasti mängitava pala žanri.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Tagastab parajasti mängitava pala sõnad.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString path )</entry>
<entry
>Tagastab pala sõnad määratud asukohast.</entry>
</row>

<row>
<entry
>QString nowPlaying()</entry>
<entry
>Parajasti mängitava andmekandja pealkiri.</entry>
</row>

<row>
<entry
>QString path()</entry>
<entry
>Tagastab parajasti mängitava pala kodeerimata asukoha.</entry>
</row>

<row>
<entry
>QString setContextStyle( QString )</entry>
<entry
>Määrab kontekstisirvijale CSS-stiili.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Tagastab parajasti mängitava pala pealkirja.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Tagastab parajasti mängitava pala kogupikkuse ([h:]mm:ss vormingus).</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Tagastab pala järjekorranumbri.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Tagastab failitüübi.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Tagastab parajasti mängitava pala aasta.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Ekvalaiseri seadistustedialoogi lülitamine.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool enable)</entry>
<entry
>Dünaamilise režiimi lülitamine sisse või välja.</entry>
</row>

<row>
<entry
>void enableOSD(bool enable)</entry>
<entry
>OSD kuvamise lülitamine sisse või välja.</entry>
</row>