# Het handboek van &rocs;

Tomaz
Canabrava
tomaz.canabrava@gmail.com
&Freek.de.Kruijf;&Jaap.Woldringh;
2009
Tomaz Canabrava
&FDLNotice;
2009-11-05
1.0

&rocs; is een hulpmiddel van KDE voor de grafentheorie.

KDE
kdeedu
wiskunde
wiskunde
grafen
knoop
kant

## Inleiding

Het doel van &rocs; is een IDE (geïntegreerde ontwikkelomgeving) te zijn voor de grafentheorie, waarmee docenten de resultaten van een algoritme van die theorie kunnen laten zien, en ook om studenten te helpen bij het uitvoeren van deze algoritmen.

&rocs; heeft een Qt-Scriptmodule, die gebruik maakt van de getekende graaf, waarbij elke verandering van de graaf in het script wordt weergegeven in de getekende graaf.

## &rocs; gebruiken

Er zijn twee vakken in de gebruikersinterface:

- In het vak rechtsboven worden de grafen getekend, in het vak rechtsonder voert u de algoritmen in,

- in de zijbalk links vindt u alle open grafen, per bestand kunnen meerdere grafen open zijn.

### Globale instellingen van &rocs;

In de linker zijbalk vindt u de opties voor elke geopende graaf, al deze opties zijn globaal voor elke grafiek, en kunnen voor elke knoop en kant worden gewijzigd in de dialogen voor de eigenschappen van knopen en kanten.

- Graafnaam

- Knoopkleur voor nieuwe knopen, u kunt de kleur voor alle knopen veranderen door op de knop Alle te klikken

- Kantkleur

De laatste rij opties bestaat uit aan/uit-knoppen:

- Namen tonen in: Knopen of Kanten.

- Waarden tonen in: Knopen of Kanten.

### Werkbalken van &rocs;

Er zijn twee werkbalken, boven. In de hoofdwerkbalk zijn de volgende hulpmiddelen:

- Knoop verplaatsen: verplaatst een knoop in het tekengebied.

- Knoop toevoegen: voegt een knoop toe op de klikpositie in het tekengebied.

- Kant toevoegen: maakt een kant aan tussen twee knopen.

- Selecteren: iets selecteren door erop te klikken.

- Verwijderen: iets verwijderen door erop te klikken.

- U kunt de hulpmiddelen voor uitlijnen gebruiken voor het uitlijnen van de geselecteerde knopen.

Met een rechter muisklik op een knoop of kant krijgt u daarvoor de eigenschappendialoog te zien.

In de opmaakbalk zijn een aantal pictogrammen voor het uitlijnen.

U kunt knopen uitlijnen door op het hulpmiddel Selecteren te klikken, een rechthoek te maken met klikken en slepen, en daarna de gewenste uitlijning te kiezen.

## Maken van scripts in &rocs;

Nadat de graaf op het scherm staat, kunt u hiervoor een script gaan maken. In de scripttaal wordt een syntax gebruikt die lijkt op JavaScript, en hier volgen de objecten Graaf, Knoop en Kant.

### Graaf

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

    (Vert.: node: knoop; edge: kant)

Graafvariabelen die kunnen worden gewijzigd:

    bool gericht
         bool automaat
         string naam
         string knoopStandaardKleur // in HEXA
         string kantStandaardKleur    // in HEXA

### Knopen

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

Knoopvariabelen:

    double x
        double y
        double dikte
        string waarde
        string naam
        string kleur  // in HEXA
        bool begin
        bool eind

### Kanten

    string kleur ( em hexa )
        string waarde
        string naam
        double dikte
        string style ( dot, dash, dash dot, solid )

        node start();
        node  end();

        void self_remove();

    Vert.: dot: punt; dash: streep; solid: aaneengesloten

### Voorbeeld

Hier volgt een eenvoudig voorbeeld van een script, dat de kleuren instelt van de eerste 4 knopen in de eerste graaf:

    /*Een eenvoudig voorbeeld van een script dat de kleuren instelt van de 4 eerste knopen in de eerste graaf: */

    var kleuren = new Array("red", "green", "blue", "yellow");

    /* grafen is een array van grafen, u krijgt toegang tot een bepaalde graaf via de index in de
    array, of met zijn naam, dus als de naam van de eerste graaf Naamloos0 is, is het volgende juist */

    var lijst1= grafen[0].list_nodes();  //  1ste vorm.
    var lijst2=Naamloos0.list_nodes();    // 2de vorm

     for ( var i = 0; i < kleuren.length; i++){
            if (i
    > lijst2.length) break;
            lijst2[i].color = colours[i]
     }

    Vert.: red: rood; green: groen; blue: blauw; yellow: geel

## Overzicht van de opdrachten

### Menu's en sneltoetsen

#### Het menu Bestand

&Ctrl;Q Bestand Afsluiten

  Afsluiten van &rocs;

#### Het menu Instellingen

Instellingen Getoonde werkbalken

  Aan- en uitzetten van de Hoofdwerkbalk en de Opmaakbalk.

Instellingen Statusbalk tonen

  Aan-en uitzetten van de statusbalk.

Instellingen Sneltoetsen instellen...

  Opent de standaard dialoog voor instellingen van &kde; waarin u de sneltoetsen kunt instellen voor de verschillende acties.

Instellingen Werkbalken instellen...

  Instellen van de acties die u in de werkbalken wilt plaatsen.

#### Het menu Help

&help.menu.documentation;

## Dankbetuiging en licentie

&rocs;

Programma copyright 2009 Tomaz Canabrava tcanabrava op kde punt org

Documentatie copyright 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; en Tomaz Canabrava tcanabrava op kde punt org

&meld.fouten;&vertaling.freek; &underFDL; &underGPL;

## Installatie

### Hoe u &rocs; kunt verkrijgen

&install.intro.documentation;

### Compileren en installeren

&install.compile.documentation;

&documentation.index;