# Handbok &rocs;

## Inledning

&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.

&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.

## Använda &rocs;

Användargränssnittet är uppdelat i två delar:

- Den övre högra delen där graferna ritas, och den nedre högra delen där algoritmer skapas.

- Den vänstra sidoraden är platsen där alla öppna grafer finns. Det går att öppna flera grafer per fil.

### &rocs; allmänna inställningar

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.

- Grafnamn

- Nodfärg För nyskapade noder, kan nodfärgen för alla aktuella noder ändras genom att klicka på knappen Alla.

- Bågfärg

Den sista raden alternativ består av alternativknappar:

- Visa namn för: Noder eller Bågar.

- Visa värden för: Noder eller Bågar.

### &rocs; verktygsrader

Det finns två verktygsrader längst upp. Huvudverktygsraden har följande verktyg:

- Flytta nod: Flyttar omkring en not runt i ritområdet.

- Lägg till nod: Skapar en ny nod på den position som klickas i ritområdet.

- Lägg till båge: Skapar en ny båge mellan två noder.

- Markera: Markera objekt genom att klicka på dem.

- Ta bort: Ta bort objekt genom att klicka på dem.

- Använd justeringsverktygen för att placera markerade noder.

Ett klick på en nod eller båge med höger musknapp visar egenskapsdialogrutan för den noden eller bågen.

Layoutverktygsraden består av diverse justeringsikoner.

För att justera noder, välj verktyget Markera, klicka och dra en rektangel, och välj därefter justeringen du vill använda.

## Använda skript i &rocs;

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.

### Graf

         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();

Grafvariabler som kan ändras:

         bool directed
         bool automate
         string name
         string nodeDefaultColor  // hexadecimal
         string edgeDefaultColor  // hexadecimal

### Noder

         array adj_nodes();
         array adj_edges();
         array  input_edges();
         array output_edges();
         array loop_edges();
         array connected_edges(Node *n);
         void self_remove();

Nodvariabler

        double x
        double y
        double width
        string value
        string name
        string color  // hexadecimal
        bool begin
        bool end

### Bågar

        string color ( em hexa )
        string value
        string name
        double width
        string style ( dot, dash, dash dot, solid )

        node start();
        node  end();

        void self_remove();

### Exempel

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:

    /* 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]
     }

## Kommandoreferens

### Menyer och snabbtangenter

#### Menyn Arkiv

&Ctrl;Q Arkiv Avsluta

- Avslutar &rocs;

#### Menyn Inställningar

Inställningar Visade verktygsrader

- Visa eller dölj verktygsraderna Huvudverktygsrad och Layoutverktygsrad.

Inställningar Visa statusrad

- Visa eller dölj statusraden.

Inställningar Anpassa genvägar...

- Öppnar den vanliga inställningsdialogrutan i &kde; som låter dig välja olika snabbtangenter för olika åtgärder.

Inställningar Anpassa verktygsrader...

- Anpassa objekt som du vill placera i verktygsraden.

#### Menyn Hjälp

&help.menu.documentation;

## Tack till och licens

&rocs;

Program copyright 2009 Tomaz Canabrava tcanabrava snabela kde punkt org

Dokumentation copyright 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; och Tomaz Canabrava tcanabrava snabela kde punkt org

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;

## Installation

### Hur man skaffar &rocs;

&install.intro.documentation;

### Kompilering och installation

&install.compile.documentation;
&documentation.index;