# El manual de &rocs;

Tomaz
Canabrava
tomaz.canabrava@gmail.com
Leticia
Martín Hernández

    leticia.martin@gmail.com

Traducción
2009
Tomaz Canabrava
&FDLNotice;
2009-11-05
1.0

&rocs; es un visor de teoría de grafos para KDE.

KDE
kdeedu
matemáticas
matemáticas
grafos
nodo
arista

## Introducción

&rocs; aspira a convertirse en un entorno de desarrollo integrado (o IDE, acrónimo en inglés de «integrated development environment») de teoría de grafos que ayude a los profesores a mostrar los resultados de un algoritmo gráfico y a los estudiantes a aplicar los algoritmos.

&rocs; tiene un módulo de script, hecho en Qt Script, que interactúa con la gráfica dibujada de forma que cualquier cambio en la gráfica debido al script se ve reflejado en la gráfica dibujada.

## Uso de &rocs;

La interfaz del usuario está dividida en dos partes:

- la parte superior derecha es donde usted dibuja sus gráficas, y la parte inferior derecha es donde usted crea sus algoritmos;

- la barra lateral de la izquierda es donde permanecen todos los grafos que ha abierto; puede abrir múltiples grafos por archivo.

### Preferencias globales de &rocs;

En la barra lateral de la izquierda puede encontrar las opciones para cada grafo abierto; estas opciones son globales para cada grafo y pueden ser modificadas para cada nodo y arista usando los cuadros de diálogo «Propiedades del nodo» y «Propiedades de la arista».

- Nombre del grafo.

- Color del nodo se usa para los nodos creados recientemente; puede modificar el color de todos los nodos actuales pulsando el botón Todos.

- Color de la arista.

La última fila de opciones consiste en una serie de botones conmutables:

- Muestra nombres en: Nodos o Aristas.

- Muestra valores en: Nodos o Aristas.

### Barras de herramientas de &rocs;

En la parte superior hay dos barras de herramientas. La principal tiene las siguientes opciones:

- Mover nodo: mueve un nodo a través del área de dibujo.

- Añadir nodo: crea un nuevo nodo en la posición del área de dibujo sobre la que se haga clic.

- Añadir arista: crea una nueva arista entre dos nodos.

- Seleccionar: selecciona elementos haciendo clic en ellos.

- Borrar: borra elementos haciendo clic en ellos.

- Use las herramientas de alineación para colocar los nodos seleccionados.

Si hace clic sobre un nodo o una arista con el botón derecho del ratón, aparecerá un cuadro de diálogo con las propiedades de ese nodo o de esa arista.

La barra de herramientas de diseño consta de varios iconos para el alineamiento.

Para alinear nodos, elija la herramienta Seleccionar, haga clic y arrastre el ratón hasta formar un rectángulo; a continuación, elija el alineamiento que desee.

## Creación de scripts en &rocs;

Una vez que el grafo esté en pantalla, puede comenzar a crear un script. El lenguaje que se emplea es similar a la sintaxis de Javascript. A continuación se muestran los objetos Grafo, Nodo y Arista:

### Grafo

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

Variables del grafo que pueden ser modificadas:

    bool directed
         bool automate
         string name
         string nodeDefaultColor // en HEXA
         string edgeDefaultColor  // en HEXA

### Nodos

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

Variables del nodo:

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

### Aristas

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

        node start();
        node  end();

        void self_remove();

### Ejemplo

Aquí tiene un escript sencillo que determina el color de los 4 primeros nodos en el primer grafo:

    /* Un ejemplo sencillo que determina el color de los 4 primeros nodos en el primer grafo: */

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

    /* graphs es un array de grafos; puede acceder al grafo mediante su índice en el
    array o mediante su nombre, de forma que si el nombre del primer grafo es Untitled0, la siguiente
    frase es correcta  */
    var list1= graphs[0].list_nodes(); // Primera forma
    var list2=Untitled0.list_nodes();              // Segunda forma

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

## Guía de órdenes

### Menús y teclas de acceso rápido

#### El menú Archivo

&Ctrl;Q Archivo Salir

  Cierra &rocs;.

#### El menú Preferencias

Preferencias Barras de herramientas mostradas

  Activa o desactiva la barra de herramientas principal y la barra de herramientas de diseño.

Preferencias Mostrar barra de estado

  Activa o desactiva la barra de estado.

Preferencias Configurar los accesos rápidos...

  Abre un cuadro de configuración estándar de &kde; que le permite elegir diferentes accesos rápidos para diferentes acciones.

Preferencias Configurar las barras de herramientas...

  Configura los elementos que desee incluir en la barra de herramientas.

#### El menú Ayuda

&help.menu.documentation;

## Créditos y licencia

&rocs;

Copyright del programa 2009 Tomaz Canabrava (tcanabrava at kde dot org).

Copyright de la documentación 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; y Tomaz Canabrava (tcanabrava at kde dot org).

Traducido por Leticia Martín Hernández leticia.martin@gmail.com.

&underFDL; &underGPL;

## Instalación

### Cómo obtener &rocs;

&install.intro.documentation;

### Compilación e instalación

&install.compile.documentation;

&documentation.index;