# Manuale di &rocs;

Tomaz
Canabrava
tomaz.canabrava@gmail.com
Francesco
Nigro

    nigro.fry@gmail.com

Traduzione della documentazione
2009
Tomaz Canabrava
&FDLNotice;
2009-11-05
1.0

&rocs; è un visore per lo studio della teoria dei grafi per KDE.

KDE
kdeedu
matematica
matematica
grafi
nodo
arco

## Introduzione

&rocs; mira ad essere uno strumento di sviluppo per la teoria dei grafi e ad aiutare i docenti nel mostrare il risultato di un algoritmo su un grafo, e gli studenti nel realizzare gli algoritmi.

&rocs; utilizza un modulo per gli script, realizzato in QT Script, che interagisce con il grafo disegnato; ogni cambiamento apportato al grafo tramite uno script è riportato sul grafo disegnato.

## Utilizzo di &rocs;

L'interfaccia utente è divisa in due parti:

- nella parte in alto a destra puoi disegnare i grafi, mentre nella parte in basso a destra puoi creare gli algoritmi,

- la barra laterale sinistra contiene i grafi aperti; puoi aprire più grafi per ciascun file.

### Impostazioni globali di &rocs;

La barra laterale sinistra contiene le opzioni per ciascun grafo aperto; queste impostazioni sono generali per il grafo. Puoi cambiare le opzioni per ogni singolo nodo od arco attraverso la finestra Proprietà del nodo e Proprietà dell'arco.

- Nome del grafo

- Colore predefinito del nodo si applica ai nuovi nodi creati. Puoi cambiare il colore di tutti nodi correnti facendo clic sul pulsante Tutti

- Colore predefinito dell'arco

L'ultima riga di opzioni è costituita da tasti di commutazione:

- Grafo orientato

- Grafo automatizzato

- Mostra i nomi dei nodi

- Mostra i nomi degli archi

- Mostra i valori dei nodi

- Mostra i valori degli archi

### Barre degli strumenti di &rocs;

Ci sono due barre degli strumenti in alto. La principale è composta dai seguenti strumenti:

- Sposta nodo: sposta il nodo all'interno dell'area di disegno.

- Aggiungi nodo: aggiunge un nuovo nodo all'area di disegno nella posizione dove si è fatto clic.

- Aggiungi arco: crea un nuovo arco tra due nodi.

- Seleziona: permette di selezionare gli elementi facendo clic su di essi.

- Elimina: permette di eliminare gli elementi facendo clic su di essi.

Facendo clic con il tasto destro del mouse su un nodo o su un arco si visualizza la sua finestra di proprietà.

La barra degli strumenti per l'impaginazione è composta da diverse icone per l'allineamento.

Per allineare dei nodi utilizza lo strumento Seleziona, traccia un rettangolo di selezione e poi scegli l'allineamento che preferisci.

## Script in &rocs;

Una volta che il grafo è sullo schermo, puoi incominciare a creare degli script per manipolarlo. Il linguaggio utilizzato per gli script usa la sintassi di Javascript; di seguito gli oggetti Grafo, Nodo ed Arco.

### Grafo

    array list_nodes();
         array list_edges();
         node add_node(name);
         edge add_edge(da, a);
         node node_byname(QString& name);
         node begin_node();
         array end_nodes();

Variabili del grafo che possono essere modificate:

    bool directed
         bool automate
         string name
         string nodeDefaultColor // in esadecimale
         string edgeDefaultColor  // in esadecimale

### Nodi

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

Variabili del nodo:

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

### Archi

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

        node start();
        node  end();

        void self_remove();

### Esempio

Qui di seguito un semplice script di esempio che imposta il colore dei primi 4 nodi del primo grafo:

    /* Un semplice esempio che imposta il colore dei primi 4 nodi del primo
    grafo: */

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

    /* graphs è un array di grafi; puoi accedere ad un grafo utilizzando l'indice
    dell'array o il suo nome. Se il grafo si chiama, ad esempio SenzaNome0 le seguenti istruzioni sono corrette  */
    var list1= graphs[0].list_nodes(); //  prima forma.
    var list2=SenzaNome0.list_nodes();              // seconda forma

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

## Guida ai comandi

### Menu e scorciatoie da tastiera

#### Il menu File

&Ctrl;Q File Chiudi

  Chiudi &rocs;

#### Il menu Impostazioni

Impostazioni Strumenti

  Commuta le barre degli strumenti Principale, Caratteri Speciali, Aspetto e Lingua.

Impostazioni Mostra la barra di stato

  Commuta la barra di stato.

Impostazioni Configura le scorciatoie...

  Apri la finestra predefinita delle impostazioni di &kde; che ti permette di scegliete diverse scorciatoie da tastiera per differenti azioni.

Impostazioni Configura la barra degli strumenti...

  Configura gli oggetti che vuoi mettere nella barra degli strumenti.

#### Il menu Aiuto

&help.menu.documentation;

## Ringraziamenti e licenza

&rocs;

Copyright del programma 2009 Tomaz Canabrava tcanabrava at kde dot org

Copyright della documentazione 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; e Tomaz Canabrava tcanabrava at kde dot org

Traduzione di Francesco Nigronigro.fry@gmail.com

&underFDL; &underGPL;

## Installazione

### Come ottenere &rocs;

&install.intro.documentation;

### Compilazione e installazione

&install.compile.documentation;

&documentation.index;