<row><entry>void enableRandomMode(bool aktivere)</entry><entry>Sl? tilf?ldigt tilstand til og fra.</entry></row><row><entry>void enableRepeatPlaylist(bool aktivere)</entry><entry>Sl? gentagelse af spilleliste til og fra.</entry></row><row><entry>void enableRepeatTrack(bool aktivere)</entry><entry>Sl? gentagelse af spor til og fra.</entry></row><row><entry>void mediaDeviceMount()</entry><entry>Indstiller kommandoen som bruges til at montere medieenheder.</entry></row><row><entry>void mediaDeviceUmount()</entry><entry>Indstiller kommandoen som bruges til at afmontere medieenheder.</entry></row><row><entry>void mute()</entry><entry>Sl? lyd til og fra.</entry></row><row><entry>void next()</entry><entry>Svarer til at klikke p? knappen "N?ste".</entry></row><row><entry>void pause()</entry><entry>Svarer til at klikke p? knappen "Pause".</entry></row><row><entry>void play()</entry><entry>Svarer til at klikke p? knappen "Spil".</entry></row><row><entry>void playPause()</entry><entry>Skift tilstand mellem at spille og holde pause (godt for brugere af multimedietastatur) </entry></row><row><entry>void prev()</entry><entry>Svarer til at klikke p? knappen "Foreg?ende".</entry></row><row><entry>void queueForTransfer( KURL url )</entry><entry>S?t filer i k? for overf?rsel til medieenheden.</entry></row><row><entry>void seek(int s)</entry><entry>S?g i sporet til positionen i sekunder.</entry></row><row><entry>void seekRelative(int s)</entry><entry>S?g til en position i forhold til sporets nuv?rende position.</entry></row><row><entry>void setEqualizer(int, int, int, int, int, int, int, int, int, int, int)</entry><entry>Indstil equalizerens b?nd </entry></row><row><entry>void setEqualizerEnabled( bool active )</entry><entry>Skift equalizeren.</entry></row><row><entry>void setEqualizerPreset( QString navn )</entry><entry>Indstil equalizerens forudindstilling </entry></row><row><entry>void setLyricsByPath( QString url, QString sangtekst )</entry><entry>Indstil sangtekst for et spor if?lge dets s?gesti.</entry></row><row><entry>void setScore( int scoring )</entry><entry>Indstil scoring for sporet som for ?jeblikket spilles.</entry></row><row><entry>void setScoreByPath( QString url, int scoring )</entry><entry>Indstil scoring for et spor if?lge dets s?gesti.</entry></row><row><entry>void setVolume(int lydstyrke)</entry><entry>Indstil lydstyrke i intervallet 0 - 100 %</entry></row><row><entry>void showBrowser( QString browser )</entry><entry>Viser browserne i spillelistens vindue.</entry></row><row><entry>void showOSD()</entry><entry>Vis sk?rmmeddelelser p? sk?rmen.</entry></row><row><entry>void stop()</entry><entry>Svarer til at klikke p? knappen "Stop".</entry></row><row><entry>void transferDeviceFiles()</entry><entry>Overf?r filer til medieenheden.</entry></row><row><entry>void volumeDown()</entry><entry>Mindsk lydstyrke med et rimeligt skridt.</entry></row><row><entry>void volumeUp()</entry><entry>?g lydstyrke med et rimeligt skridt.</entry></row></tbody></tgroup></informaltable></sect2><sect2 id="dcop-playlist"><title>dcop amarok playlist</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP-kald</entry><entry>Handling</entry></row></thead><tbody><row><entry>int getActiveIndex()</entry><entry>Returnér indeks for sporet som for ?jeblikket er aktivt. -1 hvis intet.</entry></row><row><entry>int getTotalTrackCount()</entry><entry>Returnér antal spor i spillelisten. 0 hvis ingen.</entry></row><row><entry>QString saveCurrentPlaylist()</entry><entry>Gemmer den nuv?rende spilleliste i nuv?rende.xml og og returnerer dens s?gesti.</entry></row><row><entry>void addMedia( KURL )</entry><entry>Tilf?j lydmedium angivet af url'en.</entry></row><row><entry>void addMediaList( KURL::List )</entry><entry>Tilf?j et lydmedie angivet af url'en.</entry></row><row><entry>void clearPlaylist()</entry><entry>Rydder spillelisten.</entry></row><row><entry>void playByIndex(int)</entry><entry>Begynder at afspille sporet med angivet indeks.</entry></row><row><entry>void playMedia( KURL )</entry><entry>Tilf?j lydmedium angivet af url'en.</entry></row><row><entry>void popupMessage( QString)</entry><entry>Viser en midlertidig sk?rmmeddelelse.</entry></row><row><entry>void removeCurrentTrack()</entry><entry>Fjerner nuv?rende spor fra spillelisten.</entry></row><row><entry>void repopulate()</entry><entry>Fyld i spillelisten ind igen med tilf?ldige spor.</entry></row><row><entry>void saveM3u( QString s?gesti, bool relativ_s?gesti)</entry><entry>Gemmer nuv?rende spilleliste som m3u.</entry></row><row><entry>void setStopAfterCurrent( bool )</entry><entry>Aktiverer eller deaktiverer funktionen "Stop efter dette spor".</entry></row><row><entry>void shortStatusMessage( QString)</entry><entry>Viser en midlertidig meddelelse p? statuslinjen.</entry></row><row><entry>void shufflePlaylist()</entry><entry>Blander spillelisten.</entry></row><row><entry>void togglePlaylist()</entry><entry>Sl? spillelistens vindue til og fra.</entry></row></tbody></tgroup></informaltable></sect2><sect2 id="dcop-playlistbrowser"><title>dcop amarok playlistbrowser</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP-kald</entry><entry>Handling</entry></row></thead><tbody><row><entry>void addPodcast( QString )</entry><entry>Tilf?j en podradioudsendelse til spillelistebrowseren.</entry></row><row><entry>void scanPodcasts()</entry><entry>S?g gennem alle podradioudsendelser efter opdateringer.</entry></row><row><entry>void addPlaylist( QString )</entry><entry>Tilf?j en spilleliste til spillelistebrowseren.</entry></row></tbody></tgroup></informaltable></sect2><sect2 id="dcop-script"><title>dcop amarok script</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP-kald</entry><entry>Handling</entry></row></thead><tbody><row><entry>bool runScript( QString navn)</entry><entry>Starter scriptet med angivet navn. Returnerer sandt hvis det lykkes.</entry></row><row><entry>bool stopScript( QString navn)</entry><entry>Stopper scriptet med angivet navn. Returnerer sandt hvis det lykkes.</entry></row><row><entry>QStringList listRunningScripts()</entry><entry>Returnerer en liste med scripter som for ?jeblikket k?rer.</entry></row><row><entry>void addCustomMenuItem(QString undermenu, QString punkttitel )</entry><entry>Aktiverer og indstiller titlen for eget menupunkt.</entry></row><row><entry>void removeCustomMenuItem(QString undermenu, QString punkttitel )</entry><entry>Fjerner det egne menupunkt.</entry></row><row><entry>QString readConfig( QString n?gle)</entry><entry>Returnerer v?rdien af en indstillingsindgang fra AmarokConfig for angiven n?gle.</entry></row></tbody></tgroup></informaltable></sect2></sect1><sect1 id="cmd-line-options"><title>Kommandolinje-tilvalg</title><para>Amarok underst?tter brug af de s?dvanlige Qt- og KDE-kommandolinjeflag. Amarok har ogs? sine egne programspecifikke flag.</para><para>Qt og kde flag:</para><informaltable><tgroup cols="2"><thead><row><entry>Tilvalg</entry><entry>Handling</entry></row></thead><tbody><row><entry>--help</entry><entry>Vis hj?lp om flag.</entry></row><row><entry>--help-qt</entry><entry>Vis Qt-specifikke flag.</entry></row><row><entry>--help-kde</entry><entry>Vis KDE-specifikke flag.</entry></row><row><entry>--help-all</entry><entry>is alle flag.</entry></row><row><entry>--author</entry><entry>Vis udviklerinformation.</entry></row><row><entry>-v, --version</entry><entry>Vis versionsinformation.</entry></row><row><entry>--license</entry><entry>Vis licensinformation.</entry></row></tbody></tgroup></informaltable><para>Amarok-flag:</para><note><para>amarok's flag er designet til at blive brugt mens Amarok k?rer.</para></note><informaltable><tgroup cols="2"><thead><row><entry>Tilvalg</entry><entry>Handling</entry></row></thead><tbody><row><entry>-r, --previous</entry><entry>Spring over forrige spor p? spillelisten.</entry></row><row><entry>-p, --play</entry><entry>Start med af spille den nuv?rende spilleliste.</entry></row><row><entry>-s, --stop</entry><entry>Stop afspilning.</entry></row><row><entry>--pause</entry><entry>Hold pause i afspilning.</entry></row><row><entry>-f, --next</entry><entry>Spring over det n?ste spor p? spillelisten.</entry></row><row><entry>-a, --append</entry><entry>Vedl?g filer/URL'er i spillelisten.</entry></row><row><entry>-e, --enqueue</entry><entry>Se append, tilg?ngelig for bagudkompatibilitet.</entry></row><row><entry>--queue</entry><entry>S?tter filer/URL'er i k? efter det spor der afspilles nu.</entry></row><row><entry>-m, --toggle-playlist-window</entry><entry>Sl? spillelistens vindue til og fra.</entry></row><row><entry>--wizard</entry><entry>Start f?rstek?rselsguide.</entry></row><row><entry>--engine "navn"</entry><entry>Start &amarok; med "navn"-motoren.</entry></row></tbody></tgroup></informaltable></sect1><sect1 id="script-writing"><title>Skrive scripter</title><para>At skrive scripter tillader dig nemt at udvide &amarok; uden at ?ndre den egentlige kodebase. Scripter ligner plugin, men i stedet for en s?rlig programmeringsgr?nseflade bruger de &amarok;s DCOP-gr?nseflade til kommunikation. Det g?r det muligt at skrive scripter i n?sten hvilket som helst programsprog, s?som Ruby, Python eller PHP. Du kan ikke kun oprette scripter med klassiske scriptsprog, men ogs? med kompilerede sprog s?som C++ eller almindelig C. Desuden kan &amarok; underrette scripter om s?rlige begivenheder og f? dem til at reagere i overensstemmelse med dem. Systemet med underretninger forklares senere i afsnittet.</para><sect2 id="script-bindings"><title>Bindinger</title><para>Det er muligt at skrive enkle scripter som ikke kr?ver indblanding af brugeren, og det er ogs? muligt at oprette scripter med bekvemme grafiske gr?nseflader som fungerer som sm? program i sig selv. For programmering af den grafiske gr?nseflade kan en af de mange bindinger som KDE s?rger for bruges, for eksempel RubyQt, en binding til Qt-biblioteket for Ruby. Det er dog v?rd at notere at ikke alle brugere har installeret alle tilg?ngelige bindinger. Hvis du bestemmer dig for at bruge en binding, s? fors?g at bruge en af dem som er relativt udbredte (f.eks. RubyQt eller PyQt).</para><para>For at give nogen tilbagemelding n?r et script mislykkes at k?re p? grund af en afh?ngighed som mangler, skal du kontrollere i scriptet om modulet du vil inkludere virkelig findes. Hvis afh?ngigheder mangler, b?r du fange fejlen og vise en informationsdialog med kommandolinjev?rkt?jet "kdialog", s? brugeren f?r rede p? hvorfor scriptet mislykkes at k?re.</para><para>F?lgende eksempel viser hvordan en afh?ngighed som mangler kan fanges i Ruby:</para><programlisting>begin       require 'Korundum'rescue LoadError       error = 'Korundum (KDE-bindinger for Ruby) fra kdebindings v3.4 kr?ves af dette script.'       `kdialog --sorry '#{error}'`       exitend</programlisting></sect2><sect2 id="script-templates"><title>Kom i gang: Skabelonerne</title><para>&amarok; s?rger for skabelonscripter for flere sprog i mappen <filename class="directory">scripts/templates/</filename>. Du kan bruge disse scripter som en basis for dine egne, og udvide dem med funktioner du beh?ver. Du vil bem?rke at det i virkeligheden er ganske ligetil at skrive scripter. Hvis du for eksempel véd en del om hvordan man programmerer i Python, tager det ikke lang tid at oprette dit eget script.</para></sect2><sect2 id="script-controlling-amarok"><title>Kontrollér &amarok; med DCOP</title><para>Scripter kan styre Amarok ved at kalde visse af dets DCOP-funktioner. Den enkleste m?de at udf?re en DCOP-funktion er ved at bruge kommandolinjev?rkt?jet "dcop", som indg?r i alle distributioner af KDE.</para><para>Her er et eksempel p? hvordan hovedlydstyrken ?ges:</para><programlisting>dcop amarok player volumeUp</programlisting><para>De fleste scriptsprog tillader at eksterne programmer k?res, med en funktion s?som exec(). P? den m?de kan v?rkt?jet "dcop" nemt kaldes. Her er et enkelt eksempel i Python:</para><programlisting>import os os.system("dcop amarok player volumeDown")</programlisting></sect2><sect2 id="script-notifications"><title>Underretninger</title><para>&amarok; sender underretninger til alle scripter som k?rer ved at skrive strenge til deres standardindtastning. Scripterne b?r derfor hele tiden overv?ge standardindtastningen og reagere p? passende m?de p? hver af de mulige begivenheder. Scripter kan ogs? v?lge at ignorere alle begivenheder de ikke har nogen nytte af.</para><para>F?lgende underretninger sendes af &amarok;:</para><programlisting><cmdsynopsis><command>configure</command></cmdsynopsis>Fort?ller scriptet at dets indstillingsdialog skal vises. Scriptetskal h?ndtere lagring og indl?sning af indstillingstilvalg selv.N?r et script startes, indstiller Amarok dets arbejdsmappe til mappenhvor al data skal opbevares.</programlisting><programlisting><cmdsynopsis><command>engineStateChange:</command><arg>empty|idle|paused|playing</arg></cmdsynopsis>Signalerer en ?ndring af gr?nsefladens tilstand.</programlisting><programlisting><cmdsynopsis><command>trackChange</command></cmdsynopsis>Signalerer start af et nyt spor. Scriptet kan derefter bruge DCOP-funktionertil at sp?rge efter yderligere information om sporet, f.eks. metadata og l?ngde.</programlisting><programlisting><cmdsynopsis><command>volumeChange</command><arg>ny-volym</arg></cmdsynopsis>Signalerer en ?ndring af hovedlydstyrken. Lydstyrken er et heltal medintervallet 0 - 100.</programlisting><programlisting><cmdsynopsis><command>customMenuClicked:</command><arg>undermenu objektnavn s?gestier</arg></cmdsynopsis>Returnerer s?gestier til markerede filer i spillelisten n?r det egne tilvalgi spillelistens sammenh?ngsafh?ngige menu klikkes. Undermenuen og objektnavnet returneresogs? i identifieringsform?l i tilf?ldet hvor et script lytter efter flere underretninger.Brug DCOP-kaldet 'dcop amarok script addCustomMenuItem( undermenu objektnavn )'til at inds?tte et objekt i den sammenh?ngsafh?ngige menu. AnvendDCOP-kaldet 'dcop amarok script removeCustomMenuItem( undermenu objektnavn )'til at fjerne et objekt fra den sammenh?ngsafh?ngige menu.</programlisting></sect2><sect2 id="script-termination"><title>Afslutning af script</title><para>Inden &amarok; afsluttes, eller n?r brugeren stopper et script i scripth?ndteringen, sender &amarok; signalet SIGTERM til scriptet. Signalet kan indfanges for at udf?re oprensningsarbejde, s?som at gemme data eller indstillinger.</para></sect2><sect2 id="script-packaging"><title>Pakning</title><para>Scripth?ndteringen i &amarok; kan installere scriptpakker som brugeren har hentet ned fra en webserver. Pakker er blot s?dvanlige arkiver (.tar), valgfrit komprimerede med bzip2 (.bz2). Vi anbefaler st?rkt at bruge et filnavn s?som mit-script.amarokscript.tar.bz2, s? brugeren l?t kan identificere pakken som et script for Amarok.</para><note><para>&amarok; 1.3 accepterer kun scriptpakker med filendelsen amarokscript, det er alts? bedre at bruge det lige fra begyndelsen.</para></note><para>Filens indhold skal v?re organiseret p? f?lgende vis:</para><programlisting>mit-script/   README   mit-script.py (k?rbar fil)   en-modul.py   fil.data   ...</programlisting></sect2><sect2 id="script-permissions"><title>Filrettigheder</title><para>Hovedscriptet skal have k?rerettigheder (+x) indstillede,mens yderligere moduler som scriptet indl?ser ikke skal have k?rerettigheder. For at bevare filrettigheder i arkivet, skal du bruge tar med flaget -p.</para><programlisting>tar -cf mitt-script.amarokscript.tar -p mit-script</programlisting><note><para>&amarok; kan ikke installere scriptet hvis filrettighederne ikke er rigtigt indstillede.</para></note></sect2><sect2 id="script-distributing"><title>Distribution</title><para>N?r pakken er klar, kan du overf?re den til <ulink url="http://www.kde-apps.org">www.kde-apps.org</ulink> og tilf?je linket p? &amarok;s <ulink url="http://amarok.kde.org/amarokwiki/index.php/Scripts">Wiki scriptside</ulink>. For indgangen i kde-apps skal du bruge kategorien <ulink url="http://kde-apps.org/index.php?xcontentmode=56">&amarok; Scripter</ulink>.</para></sect2></sect1></chapter>