<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&rocs;"> <!ENTITY package "kdereview"> <!ENTITY % addindex "IGNORE"> <!ENTITY % Swedish "INCLUDE" > ]> <book lang="&language;"> <bookinfo> <title >Handbok &rocs;</title> <authorgroup> <author ><personname > <firstname >Tomaz</firstname > <surname >Canabrava</surname > </personname > <email >tomaz.canabrava@gmail.com</email > </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> <copyright> <year >2009</year> <holder >Tomaz Canabrava</holder> </copyright> <legalnotice >&FDLNotice;</legalnotice> <date >2009-11-05</date> <releaseinfo >1.0</releaseinfo> <abstract> <para >&rocs; är ett grafteoretisk visningsverktyg för KDE </para> </abstract> <keywordset> <keyword >KDE</keyword> <keyword >kdeedu</keyword> <keyword >matematik</keyword> <keyword >matematik</keyword> <keyword >grafer</keyword> <keyword >nod</keyword> <keyword >båge</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title >Inledning</title> <para >&rocs; syfte är att vara en integrerad utvecklingsmiljö för grafteori, för att hjälpa lärare att visa resultaten av en grafalgoritm, och också hjälpa elever att göra algoritmerna.</para> <para >&rocs; har en skriptmodul, skapad med Qt Script, som påverkar den ritade grafen, där varje ändring av grafen med skriptet avspeglas i den ritade grafen.</para> </chapter> <chapter id="using-rocs"> <title >Använda &rocs;</title> <para >Användargränssnittet är uppdelat i två delar: </para > <itemizedlist> <listitem ><para >Den övre högra delen där graferna ritas, och den nedre högra delen där algoritmer skapas. </para ></listitem> <listitem ><para >Den vänstra sidoraden är platsen där alla öppna grafer finns. Det går att öppna flera grafer per fil. </para ></listitem> </itemizedlist> <sect1 id="rocs-features"> <title >&rocs; allmänna inställningar</title> <para >I den vänstra sidoraden finns alternativ för varje öppen graf. Alla dessa alternativ är allmänna per graf, och kan ändras per nod och båge med dialogrutorna Nodegenskaper och Bågegenskaper.</para> <itemizedlist> <listitem ><para> <guilabel >Grafnamn</guilabel> </para ></listitem> <listitem ><para ><guilabel >Standardnodfärg</guilabel > För nyskapade noder, kan nodfärgen för alla aktuella noder ändras genom att klicka på knappen Alla. </para ></listitem> <listitem ><para> <guilabel >Standardbågfärg</guilabel> </para ></listitem> </itemizedlist> <para >Den sista raden alternativ består av alternativknappar:</para> <itemizedlist> <listitem ><para> <guilabel >Orienterad graf</guilabel> </para ></listitem> <listitem ><para> <guilabel >Automatiserad graf</guilabel> </para ></listitem> <listitem ><para> <guilabel >Visa alla noders namn</guilabel> </para ></listitem> <listitem ><para> <guilabel >Visa alla bågars namn</guilabel> </para ></listitem> <listitem ><para> <guilabel >Visa alla noders värden</guilabel> </para ></listitem> <listitem ><para> <guilabel >Visa alla bågars värden</guilabel> </para ></listitem> </itemizedlist> </sect1> <sect1 id="rocs-toolbars"> <title >&rocs; verktygsrader</title> <para >Det finns två verktygsrader längst upp. Huvudverktygsraden har följande verktyg:</para> <itemizedlist> <listitem ><para ><guilabel >Flytta nod</guilabel >: Flyttar omkring en not runt i ritområdet.</para ></listitem> <listitem ><para ><guilabel >Lägg till nod</guilabel >: Skapar en ny nod på den position som klickas i ritområdet.</para ></listitem> <listitem ><para ><guilabel >Lägg till båge</guilabel >: Skapar en ny båge mellan två noder.</para ></listitem> <listitem ><para ><guilabel >Markera</guilabel >: Markera objekt genom att klicka på dem.</para ></listitem> <listitem ><para ><guilabel >Ta bort</guilabel >: Ta bort objekt genom att klicka på dem.</para ></listitem> </itemizedlist> <para >Ett klick på en nod eller båge med höger musknapp visar egenskapsdialogrutan för den noden eller bågen.</para> <para >Layoutverktygsraden består av diverse justeringsikoner.</para> <para >För att justera noder, välj verktyget <guiicon >Markera</guiicon >, klicka och dra en rektangel, och välj därefter justeringen du vill använda. </para> </sect1> </chapter> <chapter id="scripting-rocs"> <title >Använda skript i &rocs;</title> <para >Efter grafen visas på skärmen, kan du börja skapa dess skript. Språket använder Javascript-syntax och följande objekt används för grafer, noder och bågar.</para> <sect1 id="script-graph"> <title >Graf</title> <programlisting > array list_nodes(); array list_edges(); node add_node(name); edge add_edge(from, to); node node_byname(QString& name); node begin_node(); array end_nodes(); </programlisting > <para >Grafvariabler som kan ändras:</para> <programlisting > bool directed bool automate string name string nodeDefaultColor // hexadecimal string edgeDefaultColor // hexadecimal </programlisting> </sect1> <sect1 id="script-nodes"> <title >Noder</title> <programlisting > array adj_nodes(); array adj_edges(); array input_edges(); array output_edges(); array loop_edges(); array connected_edges(Node *n); void self_remove(); </programlisting > <para >Nodvariabler</para> <programlisting > double x double y double width string value string name string color // hexadecimal bool begin bool end </programlisting> </sect1> <sect1 id="script-edges"> <title >Bågar</title> <programlisting > string color ( em hexa ) string value string name double width string style ( dot, dash, dash dot, solid ) node start(); node end(); void self_remove(); </programlisting > </sect1> <sect1 id="script-example"> <title >Exempel</title> <para >Här är ett enkelt exempel på ett skript som ställer in färgen på de fyra första noderna i den första grafen:</para> <programlisting >/* Ett enkelt exempel som ställer in färgen på de fyra första noderna i den första grafen: */ var colours = new Array("red", "green", "blue", "yellow"); /* graphs är ett fält av grafer, du kan komma åt en graf med dess index i fältet eller med dess namn, så om den första grafens namn är Untitled0, är följande sats riktig */ var list1 = graphs[0].list_nodes(); // 1:a formen var list2 = Untitled0.list_nodes(); // 2.a formen for ( var i = 0; i < colours.length; i++){ if (i > list2.length) break; list2[i].color = colours[i] } </programlisting> </sect1> </chapter> <chapter id="commands"> <title >Kommandoreferens</title> <sect1 id="rocs-mainwindow"> <title >Menyer och snabbtangenter</title> <sect2> <title >Menyn <guimenu >Arkiv</guimenu ></title> <variablelist> <varlistentry> <term ><menuchoice ><shortcut > <keycombo action="simul" >&Ctrl;<keycap >Q</keycap ></keycombo > </shortcut > <guimenu >Arkiv</guimenu > <guimenuitem >Avsluta</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Avslutar</action > &rocs;</para ></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title >Menyn <guimenu >Inställningar</guimenu ></title> <variablelist> <varlistentry> <term ><menuchoice ><guimenu >Inställningar</guimenu > <guisubmenu >Verktygsrader</guisubmenu > </menuchoice ></term> <listitem ><para ><action >Visa eller dölj</action > verktygsraderna <guimenuitem >Huvudverktygsrad</guimenuitem >, <guimenuitem >Specialtecken</guimenuitem >, <guimenuitem >Utseende</guimenuitem > och <guimenuitem >Språk</guimenuitem >.</para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Inställningar</guimenu > <guimenuitem >Visa statusrad</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Visa eller dölj</action > statusraden.</para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Inställningar</guimenu > <guimenuitem >Anpassa genvägar...</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Öppnar</action > den vanliga inställningsdialogrutan i &kde; som låter dig välja olika snabbtangenter för olika åtgärder. </para ></listitem> </varlistentry> <varlistentry> <term ><menuchoice ><guimenu >Inställningar</guimenu > <guimenuitem >Anpassa verktygsrader...</guimenuitem > </menuchoice ></term> <listitem ><para ><action >Anpassa</action > objekt som du vill placera i verktygsraden. </para ></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title >Menyn <guimenu >Hjälp</guimenu ></title> &help.menu.documentation; </sect2> </sect1> </chapter> <chapter id="credits"> <title >Tack till och licens</title> <para >&rocs; </para> <para >Program copyright 2009 Tomaz Canabrava tcanabrava snabela kde punkt org </para> <para >Dokumentation copyright 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; och Tomaz Canabrava tcanabrava snabela kde punkt org </para> <para >Översättning Stefan Asserhäll <email >stefan.asserhall@comhem.se</email ></para > &underFDL; &underGPL; </chapter> <appendix id="installation"> <title >Installation</title> <sect1 id="getting-rocs"> <title >Hur man skaffar &rocs;</title> &install.intro.documentation; </sect1> <sect1 id="compilation"> <title >Kompilering och installation</title> &install.compile.documentation; </sect1> </appendix> &documentation.index; </book> <!-- Local Variables: mode: sgml sgml-minimize-attributes: nil sgml-general-insert-case: lower sgml-indent-step:0 sgml-indent-data:nil End: -->