<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kcmlirc "<application
>KDE LIRC Control Center Module</application
>">
  <!ENTITY kdelirc "<application
>KDE LIRC</application
>">
  
  <!ENTITY % Swedish "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>

<title
>Inställning av &kde;:s infraröda fjärrkontroll</title>

<authorgroup>
<author
><firstname
>Frank</firstname
> <surname
>Scheffold</surname
> <affiliation
> <address
><email
>fscheffold@googlemail.com</email
></address>
</affiliation>
</author>
<author
><firstname
>Michael</firstname
> <surname
>Zanetti</surname
> <affiliation
> <address
><email
>michael_zanetti@gmx.net</email
></address>
</affiliation>
</author>
<author
><firstname
>Gav</firstname
> <surname
>Wood</surname
> <affiliation
> <address
><email
>gav@kde.org</email
></address>
</affiliation>
</author>
<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>

<date
>2010-01-06</date>
<releaseinfo
>2.0</releaseinfo>

<copyright>
<year
>2004</year>
<holder
>Gav Wood</holder>
</copyright>
<copyright>
<year
>2010</year>
<holder
>Frank Scheffold</holder>
<holder
>Michael Zanetti</holder>
</copyright>
<!--
<legalnotice
>&FDLNotice;</legalnotice>
-->


<abstract
><para
>&kdelirc;-inställning: Infrastrukturen för &kde;:s infraröda fjärrkontrollfunktion.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>irkick</keyword>
<keyword
>kdelirc</keyword>
<keyword
>kcmlirc</keyword>
<keyword
>lirc</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
  <title
>Inledning</title>
  <sect1 id="requirements">
    <title
>Krav</title>
    <para
>För att &kde;:s ramverk för LIRC ska kunna användas, måste du ha ställt in LIRC på datorn. Om det är riktigt inställt, lyser &kdelirc;-ikonen i systembrickan röd <inlinemediaobject
><imageobject
><imagedata fileref="irkick.png" format="PNG"/></imageobject
></inlinemediaobject
>. Om inte är den grå och överkryssad <inlinemediaobject
><imageobject
><imagedata fileref="irkickoff.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>

    <para
>För mer information om LIRC, och hur man ställer in det, besök deras hemsida på <ulink url="http://www.lirc.org/"
>http://www.lirc.org</ulink
>. </para>

    <para
><emphasis role="strong"
>Observera:</emphasis
> Vid inställning av LIRC rekommenderas att utnyttja namnrymder för knappar. </para>
  </sect1>

</chapter>

<chapter id="usage">
  <title
>Användning</title>

  <para
>Det finns tre flikar som ger dig flera delar med inställningar och ytterligare information. Den första fliken, som heter <guibutton
>Fjärrkontrollfunktioner</guibutton
> används för att ställa in lägen och åtgärder för alla tillgängliga fjärrkontroller. Fliken som heter <guibutton
>Översikt av profiler</guibutton
> innehåller detaljinformation om tillgängliga profiler. Fliken <guibutton
>Tillgängliga fjärrkontroller</guibutton
> visar ytterligare information om fjärrkontrollerna. Att välja en fjärrkontroll ger en översikt av dess knappar. </para>
  <sect1 id="controllerFunctions">
    <title
>Fjärrkontrollfunktioner</title>
    <sect2 id="modes">
      <title
>Fjärrkontroller och lägen</title>

      <para
>Varje fjärrkontroll kan ha ett antal olika lägen. Genom att ha flera lägen, kan samma knapp utföra olika åtgärder vid olika tillfällen. Tänk på det som en fjärrkontroll med flera användningar för tv, video, satellit och dvd. Istället för att använda olika fjärrkontroller för olika program, kan du ändra beteende hos en fjärrkontroll för att anpassa den till ett program genom att skapa olika lägen och byta mellan dem efter behov. </para>

      <para
>Åtgärder som definieras direkt för fjärrkontrollen är alltid tillgängliga, oberoende av vilket läge fjärrkontrollen för närvarande har. Åtgärder definierade i ett läge utförs bara om fjärrkontrollen för närvarande är inställd i det läget. Varje fjärrkontroll kan bara vara i ett läge åt gången. Den kan också inte vara i något läge alls, vilket betyder att bara åtgärder som alltid är tillgängliga utförs när knappar trycks ner. Man kan också definiera ett standardläge, vilket är det läge som automatiskt tilldelas vid start. </para>

      <para
>Listan till vänster innehåller alla fjärrkontroller som detekterats på datorn. Lägen kan läggas till och tas bort genom att markera önskad fjärrkontroll eller läge och använda knapparna direkt under listan. Knappen Redigera låter dig ändra befintliga lägen. </para>

    </sect2>

    <sect2 id="addactions">
      <title
>Tilldela åtgärder till knappar</title>
      <para
>&kdelirc; känner till två olika typer av åtgärder. Byte av läge och åtgärder att utföra. Byte av läge tillåter att nuvarande fjärrkontroll ställs om till ett annat läge, medan reguljära uttryck tillåter att kommandon utförs via &DBus;. När en ny åtgärd att utföra definieras har man två möjligheter. Det ena är att använda en mall, medan det andra kräver att alla möjliga alternativ måste anges manuellt. Mallar för åtgärder kallas profiler. Medan det är enklare och mer rättframt att använda profiler för att skapa åtgärder, är det inte möjligt att komma åt alla funktioner med profiler. Mer avancerade åtgärder kan ställas in genom att manuellt välja funktioner och deras parametrar. </para>

      <para
>Använd knappen <guibutton
>Lägg till...</guibutton
> nere till höger för att lägga till en åtgärd. En guide dyker upp och frågar dig vilken typ av åtgärd som ska skapas. Det första alternativet skapar en åtgärd baserad på en profil. Det andra alternativet låter dig skapa hela åtgärden manuellt. Kom ihåg att programmet du vill styra måste köra vid tillfället då åtgärden ställs in, annars visas det inte i listan med tillgängliga program. Det tredje alternativet låter dig skapa en åtgärd för att byta läge. Välj önskad typ av åtgärd, och följ stegen genom guiden. </para>

      <para
>Åtgärder kan också fyllas i automatiskt med knappen <guibutton
>Fyll i automatiskt...</guibutton
>. Det betyder att &kdelirc; kan försöka para ihop knappar med funktioner åt dig. Dialogrutan för att fylla i automatiskt visar alla tillgängliga profiler med en flagga. Beroende på flaggans färg stöds fjärrkontrollen fullständigt, delvis eller inte alls av profilen. Grön betyder fullständigt stöd, gul delvis stöd och röd inget stöd alls. </para>
      <para
><emphasis role="strong"
>Observera:</emphasis
> Om fjärrkontrollen inte är kompatibel med någon profil, kanske du inte har ställt in LIRC med namnrymder. </para>

    </sect2>

  </sect1>

  <sect1 id="profiles">
    <title
>Översikt av profiler</title>

    <para
>Fliken <guibutton
>Översikt av profiler</guibutton
> ger dig information om de tillgängliga profilerna. Genom att välja en profil kan du se detaljerad information som information om upphovsmannen och en lista med alla definierade åtgärder. Varje åtgärdspost innehåller information om ytterligare inställningar, en kommentar och identifieraren för knappen som ska användas av funktionen för att fylla i automatiskt. </para>

    <para
>Om du skulle vilja bidra med profiler för program, se kapitlet <link linkend="advancedInformation"
>Avancerad information</link
>. </para>

  </sect1>

  <sect1 id="availableRemotes">
    <title
>Tillgängliga fjärrkontroller</title>
    <para
>Den här fliken ger dig detaljerad information om fjärrkontrollerna. Här kan du kontrollera om fjärrkontrollerna kändes igen riktigt av systemet. </para>
  </sect1>

</chapter>

<chapter id="advancedInformation">
  <title
>Avancerad information</title>
  <para
>Det här kapitlet beskriver viss information som kan vara intressant för mer avancerade användare eller utvecklare. Du får lära dig hur du kan skapa egna profiler. </para>

  <sect1 id="profileCreation">
    <title
>Skapa profiler</title>

    <sect2>
      <title
>Inledning</title>
      <para
>Alla program som hanterar &DBus; kan användas med &kdelirc; utan några ytterligare åtgärder. För att tillhandahålla en användarvänlig inställning och låta programmet visas i dialogrutan för att fylla i automatiskt, kan du dock vilja skapa en profil för det. </para>
      <para
>En profil talar om för &kdelirc; (och användaren), vad de olika &DBus; anropen gör. Det är väsentligen en sorts dokumentation av &DBus; anropen. Du behöver inte inkludera alla &DBus; anrop, bara de du känner att slutanvändare kan dra störst nytta av (oftast anrop som <quote
>modifierar gränssnittet</quote
> istället för <quote
>informationsinsamlande</quote
> anrop). </para>
    </sect2>

    <sect2>
      <title
>Skapa</title>
      <procedure>

        <step>
          <title
>&DBus;</title>
          <para
>Försäkra dig om att programmet du vill skapa profilen för tillhandahåller funktioner via &DBus;. I stort sett kan du kontrollera det genom att försöka lägga till åtgärder för programmet med den manuella metoden i &kdelirc;. Programmet <quote
>qdbusviewer</quote
>  som levereras med installationen av QT4 är också ett mycket bra verktyg för att ta reda på möjligheter med &DBus; i program. </para>
        </step>

        <step>
          <title
>Skapa en profil</title>
          <para
>När du väl har hittat lämpliga &DBus; funktioner, måste du beskriva dem i dokumentet <filename
>pgmnamn.profile.xml</filename
>. Här är en snabbguide om hur man skapar sådana filer: </para>

          <substeps>
            <step>
              <para
>Skapa först en ny fil som har följande innehåll. Ersätt <quote
>mittpgm</quote
> med det körbara namnet på programmet och <quote
>Mitt program</quote
> med ett beskrivande programnamn. </para>
              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="mittpgm" servicename="Mitt program"&gt;
  &lt;/profile&gt;
              </programlisting>
            </step>

            <step>
              <para
>Lägg till namn och information om upphovsmannen inne i taggen <quote
>profile</quote
>. Taggen <quote
>instances</quote
> talar om för &kdelirc; om programmet kan köras flera gånger eller inte. Ställ in <quote
>unique</quote
> till <quote
>0</quote
> om man kan starta programmet flera gånger (det är normalt <quote
>1</quote
>). Egenskapen <quote
>ifmulti</quote
> anger vad &kdelirc; ska göra om flera instanser kör när en knapp trycks ner. Alternativen är <quote
>skicka inte</quote
> (gör ingenting för antal instanser &gt; 1), <quote
>sendtoone</quote
> (skicka anropet till en godtyckligt vald instans) och <quote
>sendtoall</quote
> (skicka till alla instanser). Normalvärdet är <quote
>dontsend</quote
>, dock kan <quote
>sendtoone</quote
> vara det mest användbara under många omständigheter.. </para>

              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="mittpgm" servicename="Mitt program"&gt;
    &lt;name&gt;Mitt program&lt;/name&gt;
    &lt;author&gt;Mig&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
  &lt;/profile&gt;
              </programlisting>
            </step>

            <step>
              <para
>Fyll i profilen med åtgärdstaggar. Varje åtgärdstagg måste innehålla &DBus; objektnamn och funktionsprototypen. </para>

              <para
>&kdelirc; behöver några ytterligare egenskaper för att veta hur en åtgärd ska hanteras. Taggen <quote
>button</quote
> används för funktionen för att fylla i automatiskt. Se <ulink url="http://api.kde.org/4.x-api/kdebase-workspace-apidocs/libs/solid/html/classSolid_1_1Control_1_1RemoteControlButton.html"
>dokumentationen av programmeringsgränssnittet för Solid</ulink
> för en fullständig lista av tillgängliga namn på knappar. Taggen <quote
>repeat</quote
> talar om ifall åtgärden ska utföras flera gånger om knappen på fjärrkontrollen hålles nere (0 = Nej, 1 = Ja). Taggen <quote
>autostart</quote
> definierar om programmet ska startas om det inte redan kör. </para>
              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="mittpgm" servicename="Mitt program"&gt;
    &lt;name&gt;Mitt program&lt;/name&gt;
    &lt;author&gt;Mig&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showint(short int)"
      button="Menu" repeat="0" autostart="0"&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
              </programlisting>
            </step>

            <step>
              <para
>Lägg till ett namn och en kommentar i åtgärden. Detta visas i &kdelirc;s användargränssnitt. </para>

              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="mittpgm" servicename="Mitt program"&gt;
    &lt;name&gt;Mitt program&lt;/name&gt;
    &lt;author&gt;Mig&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showints(short int)"
        button="Menu" repeat="0" autostart="0"&gt;
      &lt;name&gt;Visa heltal&lt;/name&gt;
      &lt;comment&gt;Visar ett inställningsbart heltal&lt;/comment&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
                </programlisting>
            </step>

	    <step>
                <para
>Beskriv varje argument med en kommentar och typegenskap. En lista med giltiga typer finns i <ulink url="http://websvn.kde.org/trunk/KDE/kdeutils/kdelirc/profiles/profile.dtd?view=markup"
>filen med profilbeskrivning</ulink
>. Du måste deklarera ett standardvärde för varje argument mellan taggarna <quote
>default</quote
>: </para>
    
                <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="mittpgm" servicename="Mitt program"&gt;
    &lt;name&gt;Mitt program&lt;/name&gt;
    &lt;author&gt;Mig&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showints(short int)"
        button="Menu" repeat="0" autostart="0"&gt;
      &lt;name&gt;Visa heltal&lt;/name&gt;
      &lt;comment&gt;Visar ett inställningsbart heltal&lt;/comment&gt;
      &lt;argument type="int"&gt;
        &lt;default&gt;5&lt;/default&gt;
        &lt;comment&gt;Heltalet som ska visas&lt;/comment&gt;
      &lt;/argument&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
                </programlisting>
            </step>
            </substeps>
        </step>
      </procedure>
    </sect2>
    <sect2>
      <title
>Installation</title>
        <para
>För att prova och använda profilen måste du kopiera den till <filename
>$(kde_datadir)/profiles</filename
> och starta om &kdelirc;. </para>
        <para
>Om du skulle vilja bidra profilen till &kde;:s programvarusamling, skicka den gärna till &kde;:s verktygsgrupp på <email
>kde-utils-devel@kde.org</email
>. </para>
      </sect2>
  </sect1>
</chapter>

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
