# Підручник з &rocs;

Tomaz
Canabrava
tomaz.canabrava@gmail.com
Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
2009
Tomaz Canabrava
&FDLNotice;
5 листопада 2009 року
1.0

&rocs; — інструмент перегляду графів, створений для KDE.

KDE
kdeedu
математика
математика
графи
вузол
ребро

## Вступ

&rocs; створено як комплексне середовище розробки для теорії графів, яке допоможе викладачам демонструвати алгоритми теорії графів, а студентам зрозуміти ці алгоритми.

У &rocs; передбачено модуль роботи зі скриптами, створений за допомогою Qt Script, за допомогою якого можна керувати накресленим графом зі скрипту. Зміни, внесені скриптом, буде негайно показано на кресленні графу.

## Користування &rocs;

Інтерфейс користувача програми поділено на дві частини:

- верхню праву частину вікна, на якій ви зможете креслити графи, та нижню праву частину, за допомогою якої можна створювати алгоритми,

- ліву бічну панель зі списком відкритих графів. Ви зможете зберігати декілька графів у одному файлі.

### Загальні параметри &rocs;

На лівій бічній панелі буде наведено параметри кожного з відкритих графів. Всі ці параметри є загальними для окремого графу, їх можна змінити для окремих вузлів та ребер за допомогою діалогових вікон «Властивості вузла» та «Властивості ребра».

- Назва графу

- Колір вузла для нових вузлів. Змінити колір вузлів для всіх поточних вузлів можна натисканням кнопки Всі.

- Колір ребра

У останньому рядку параметрів буде наведено кнопки перемикання:

- Показувати назви у: Вузлах або Ребрах.

- Показувати значення у: Вузлах або Ребрах.

### Панелі інструментів &rocs;

Передбачено також дві панелі інструментів, розташованих у верхній частині вікна. На головній панелі передбачено такі кнопки інструментів:

- Пересунути вузол: пересунути вузол полотном креслення.

- Додати вузол: створити вузол на полотні у точці, на яку буде наведено вказівник миші під час клацання лівою кнопкою миші.

- Додати ребро: створити нове ребро між двома вузлами.

- Позначити: позначити елементи клацанням на них.

- Вилучити: вилучити елементи клацанням на них.

- Цими інструментами вирівнювання можна скористатися для впорядкування позначених вузлів.

Наведення вказівника миші на вузол або ребро з наступним клацанням правою кнопкою миші відкриє діалогове вікно властивостей відповідного елемента.

На панелі компонування програми розташовано різноманітні кнопки зміни компонування.

Щоб вирівняти вузли, позначте їх за допомогою інструменту Позначити: накресліть рамку навколо елементів, які слід позначити, а потім оберіть потрібне вам компонування.

## Робота зі скриптами у &rocs;

Після появи графу на екрані ви зможете розпочати створення скрипту для цього графу. Скрипт слід записувати синтаксичними конструкціями Javascript. Скрипт має працювати з об’єктами Graph, Node та Edge.

### Граф

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

Змінні графів, які можна змінювати:

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

### Вузли

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

Змінні вузлів:

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

### Ребра

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

        node start();
        node  end();

        void self_remove();

### Приклад

Ось простий приклад скрипту, який встановлює кольори перших чотирьох вузлів на першому графі.

    /* Простий приклад, який встановлює кольори перших чотирьох вузлів першого
    графу: */

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

    /* graphs — це масив графів, доступ до окремого графу можна отримувати за його індексом
    у масиві або за його назвою, отже, якщо назвою першого графу є Untitled0, можна скористатися
    такими командами  */
    var list1= graphs[0].list_nodes(); //  перша форма.
    var list2=Untitled0.list_nodes();              // друга форма

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

## Довідка щодо команд

### Меню і клавіатурні скорочення

#### Меню Файл

&Ctrl;Q Файл Вийти

  Завершити роботу &rocs;.

#### Меню Параметри

Параметри Показані панелі

  Перемкнути видимість Головної панелі та панелі Компонування.

Параметри Показати смужку стану

  Увімкнути або вимкнути показ смужки стану.

Параметри Налаштувати скорочення...

  Відкрити звичайне діалогове вікно параметрів &kde;, за допомогою якого ви зможете налаштувати клавіатурні скорочення для різних дій.

Параметри Налаштувати пенали...

  Налаштувати елементи, які ви бажаєте бачити на головній панелі інструментів.

#### Меню Довідка

&help.menu.documentation;

## Подяки і ліцензія

&rocs;

Авторські права на програму належать Tomaz Canabrava tcanabrava at kde dot org, ©2009

Авторські права на документацію до програми належать &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; та Tomaz Canabrava tcanabrava at kde dot org, ©2009

Переклад українською: Юрій Чорноіванyurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

### Як отримати &rocs;

&install.intro.documentation;

### Збирання і встановлення

&install.compile.documentation;

&documentation.index;