# Manual do &rocs;

Tomaz
Canabrava
tomaz.canabrava@gmail.com
Marcus
Gama

    marcus.gama@gmail.com

Tradução
2009
Tomaz Canabrava
&FDLNotice;
05/11/2009
1.0

O &rocs; é uma ferramenta de visualização da teoria dos grafos para o KDE.

KDE
kdeedu
matemática
matemática
grafos
nó
aresta

## Introdução

O &rocs; pretende ser um IDE da Teoria dos Grafos para ajudar os professores a mostrar os resultados de um algoritmo de grafos e também para ajudar os alunos a criar os algoritmos.

O &rocs; tem um módulo de programação, feito em Qt Script, que interage com o grafo desenhado, sendo que todas as alterações no grafo com o programa são refletidas no grafo desenhado.

## Usando o &rocs;

A interface do usuário está dividida em duas partes:

- a parte superior-direita é onde você desenha os seus grafos, enquanto a inferior-direita é onde cria os seus algoritmos,

- a barra lateral esquerda é onde ficam todos os seus grafos abertos, sendo que você poderá abrir vários grafos por cada arquivo.

### Configuração global do &rocs;

Na barra lateral, você poderá encontrar as opções para cada grafo aberto, sendo que estas opções são globais por cada grafo, podendo ser alteradas para cada nó e aresta nas Propriedades dos nós e das janelas de Propriedades das arestas.

- Nome do Grafo

- Cor dos nós para os nós recém criados, você poderá alterar a cor do nó para todos os nós atuais, clicando no botão Tudo

- Cor das arestas

A última linha de opções consiste em botões de comutação:

- Mostrar nomes em: Nós ou Arestas.

- Mostrar valores em: Nós ou Arestas.

### Barras de ferramentas do &rocs;

Existem duas barras de ferramentas no topo. A principal possui as seguintes ferramentas:

- Mover o Nó: move um nó pela área de desenho.

- Adicionar um Nó: cria um novo nó na posição da área de desenho onde clicou.

- Adicionar uma aresta: cria uma nova aresta entre os dois nós.

- Selecionar: seleciona os itens ao clicar neles.

- Apagar: apaga os itens ao clicar neles.

- Use as ferramentas de alinhamento para posicionar os nós selecionados.

Um clique com o botão direito do mouse num nó ou aresta, irá invocar a janela de propriedades para esse item.

A barra de disposição consiste em vários ícones de alinhamento.

Para alinhar os nós, escolha a ferramenta Selecionar, clique e arraste um retângulo e escolha o alinhamento desejado.

## Programar no &rocs;

Após o grafo estar na tela, você poderá começar a criar o programa para ele. A linguagem usa uma sintaxe de JavaScript e consiste nos objetos grafo, nó e aresta.

### Grafo

    array list_nodes();
         array list_edges();
         node add_node(nome);
         edge add_edge(de, para);
         node node_byname(QString& nome);
         node begin_node();
         array end_nodes();

As variáveis do grafo que podem ser alteradas:

    bool directed
         bool automate
         string name
         string nodeDefaultColor // em HEXADECIMAL
         string edgeDefaultColor  // em HEXADECIMAL

### Nós

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

Variáveis do Nó:

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

### Arestas

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

        node start();
        node  end();

        void self_remove();

### Exemplo

Aqui está um programa simples de exemplo que altera a cor dos 4 primeiros nós do primeiro grafo:

    /* Um exemplo simples que altera a cor dos 4 primeiros nós do primeiro grafo: */

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

    /* 'grafos' é uma lista de grafos, onde você poderá acessar um grafo pelo seu índice
    na lista ou pelo seu nome, assim se o nome do primeiro grafo for 'SemTitulo0',
    ambas as instruções a seguir estão corretas */
    var lista1= graphs[0].list_nodes(); //  1ª forma
    var lista2=SemTitulo0.list_nodes();              // 2ª forma

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

## Referência de comandos

### Menus e Teclas de Atalho

#### O menu Arquivo

&Ctrl;Q Arquivo Sair

  Sai do &rocs;

#### O menu Configurações

Configurações Barras de ferramentas exibidas

  Ativa ou desativa as barras de ferramentas Principal e de Disposição.

Configurações Exibir barra de status

  Ativa ou desativa a barra de estado.

Configurações Configurar atalhos...

  Abre a janela de configuração padrão do &kde; que lhe permite escolher teclas de atalho diferentes para as ações diferentes.

Configurações Configurar barras de ferramentas...

  Configura os itens que você deseja colocar na barra de ferramentas.

#### O Menu Ajuda

&help.menu.documentation;

## Créditos e licença

&rocs;

Programa com 'copyright' 2009 de Tomaz Canabrava tcanabrava at kde dot org

Documentação com 'copyright' 2009 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; e Tomaz Canabrava tcanabrava at kde dot org

Tradução de Marcus Gamamarcus.gama@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &rocs;

&install.intro.documentation;

### Compilação e instalação

&install.compile.documentation;

&documentation.index;