Руководство по Симулятору Робота Кумир

1. Редактор Кода (Слева)

• Область для кода: Здесь ты пишешь или вставляешь свой код на языке Кумир. Редактор подсвечивает ключевые слова для удобства.
• Кнопки управления программой:
  • 🗑️ (Очистить): Стирает весь код в редакторе.
  • 🛑 (Стоп): Немедленно останавливает выполнение программы (если она запущена) и анимацию.
  • ▶️ (Старт): Запускает выполнение написанного кода. Кнопка неактивна во время выполнения.
  • 🔄 (Сброс): Возвращает поле и позицию робота к начальному состоянию (пустое поле 7x7, робот в 0,0) и очищает код.
• Слайдер Скорости: Позволяет настроить скорость анимации шагов выполнения кода. Передвинь влево для замедления, вправо для ускорения (крайнее правое положение - мгновенное выполнение без анимации).
• Строка Статуса (под кнопками): Показывает текущую позицию робота (X,Y), размеры поля (Ширина x Высота) и активный режим ('Ред.' - Редактирование, 'Упр.' - Управление).
• Консоль/Лог (внизу): Отображает сообщения от симулятора, вывод программы (командой вывод) и сообщения об ошибках.

2. Панель Управления (Справа)

Эти кнопки позволяют управлять роботом и полем вручную, без написания кода.

• Движение (Стрелки ↑, ↓, ←, →): Перемещают робота на одну клетку в выбранном направлении, если путь не преграждает стена или граница поля. (Горячие клавиши: W, S, A, D)
• Маркеры:
  • Маркер + (Q): Ставит белый круглый маркер в текущую клетку робота (если там еще нет маркера).
  • Маркер - (E): Убирает маркер из текущей клетки робота (если он там есть).
• Клетки:
  • Клетка + (Z): Закрашивает текущую клетку робота серым цветом (если она не закрашена).
  • Клетка - (X): Убирает закраску с текущей клетки (если она была закрашена).
• Режим Редактирования:
  • Вкл/Выкл Ред. (R): Переключает режим взаимодействия с полем.
    • Режим Управления (Выкл): Клики по полю ничего не делают. Роботом можно управлять кнопками или кодом.
    • Режим Редактирования (Вкл): Позволяет изменять поле мышкой (см. раздел "Поле").
• Размеры Поля (Доступно только в режиме Ред.):
  • Шире / Уже: Увеличивает / уменьшает ширину поля на 1 клетку.
  • Выше / Ниже: Увеличивает / уменьшает высоту поля на 1 клетку.
  • Примечание: Минимальный размер поля - 1x1. При уменьшении размера робот может сместиться, если окажется за пределами новых границ.
• Прочее:
  • Помощь (F1): Открывает это окно справки.
  • Импорт .fil: Позволяет загрузить состояние поля (размеры, стены, маркеры, клетки, символы, радиацию, температуру, позицию робота) из специального файла формата .fil.

3. Поле (Центр)

• Отображает текущее состояние: сетку, позицию робота (красный ромб), стены (оранжевые - добавленные, коричневые - границы поля), маркеры (белые круги), закрашенные клетки (серые), символы (черные буквы/цифры).
• Масштабирование: Используй колесо мыши над полем для приближения или отдаления.
• Взаимодействие (только в Режиме Редактирования):
  • Левая кнопка мыши (ЛКМ):
    • Клик рядом с границей клетки: ставит или убирает стену. Границы поля изменять нельзя!
    • Клик в центр клетки: закрашивает или очищает клетку.
    • Клик и перетаскивание робота: позволяет переместить робота в другую клетку.
  • Правая кнопка мыши (ПКМ): Ставит или убирает маркер в клетке, по которой кликнули.

4. Область Статуса (Под полем)

• Отображает текстовые подсказки о последнем действии или текущем состоянии.
• Показывает сообщения об ошибках или результат выполнения программы.
• Во время выполнения кода с активной анимацией (не мгновенной) здесь отображается текущий выполняемый шаг или команда.

использовать Робот

Движение

• вверх - Переместить робота на одну клетку вверх.
• вниз - Переместить робота на одну клетку вниз.
• влево - Переместить робота на одну клетку влево.
• вправо - Переместить робота на одну клетку вправо.

Ошибки: Если на пути робота находится стена или граница поля, выполнение команды прервется с ошибкой "Стена/граница!".

Действия с Клеткой

• закрасить - Закрашивает текущую клетку, где стоит робот. Если клетка уже закрашена, произойдет ошибка (в стандартном Кумире ошибки нет, но здесь она добавлена для явности).
• Примечание: Команд для установки/снятия стен или маркеров из кода Кумира в этой версии симулятора нет. Используй Панель Управления в Режиме Редактирования.

Датчики (Проверка Условий)

Эти команды возвращают логическое значение да (истина) или нет (ложь). Они часто используются в конструкциях если или нц пока.

• Стены/Границы:
  • сверху стена / сверху свободно
  • снизу стена / снизу свободно
  • слева стена / слева свободно
  • справа стена / справа свободно
• Состояние Клетки:
  • клетка закрашена - Проверяет, закрашена ли текущая клетка.
  • клетка чистая - Проверяет, НЕ закрашена ли текущая клетка.
• Примечание: Датчиков для проверки маркеров в этой версии симулятора нет.

Измерения

Эти команды возвращают числовые значения из текущей клетки робота.

• радиация - Возвращает значение уровня радиации (вещественное число). Если не установлено, возвращает 0.0.
• температура - Возвращает значение температуры (целое число). Если не установлено, возвращает 0.

Значения радиации и температуры можно задать только при импорте поля из файла .fil.

Структура Программы

Простая программа на Кумире для Робота обычно выглядит так:

использовать Робот
алг МояПрограмма | Название алгоритма (необязательно для основной)
нач
  | Здесь пишутся команды Робота и другие команды Кумира
  влево
  закрасить
  ...
кон

• алг: Начало алгоритма. После него может идти имя алгоритма.
• нач: Начало блока команд алгоритма.
• кон: Конец блока команд и конец алгоритма.
• | или #: Символ комментария. Все, что идет после него до конца строки, игнорируется.

Переменные

• Объявление: Перед использованием переменную нужно объявить, указав ее тип и имя.

  цел счетчик   | Целое число
  вещ расстояние | Вещественное (дробное) число
  лог стена_справа | Логическое (да/нет)
  лит сообщение    | Строка текста
  сим буква        | Один символ

• Присваивание: Используется оператор :=.

  счетчик := 0
  расстояние := 12.5
  сообщение := "Робот на базе"
  стена_справа := справа стена | Присваивание результата датчика

• Таблицы (Массивы): Объявляются с указанием типа элементов и размерностей в квадратных скобках (индексы от и до). В текущей версии симулятора размерности только записываются, но проверка выхода за границы при доступе может не работать!

  цел таб Матрица[1:10, 0:5] | Двумерная таблица целых чисел
  вещ таб Координаты[1:3]   | Одномерная таблица вещественных чисел
  ...
  Матрица[2, 3] := 100     | Доступ к элементу

Выражения

• Арифметические: +, -, *, / (деление), div (целочисленное деление), mod (остаток от деления).
• Логические: и (И), или (ИЛИ), не (НЕ).
• Сравнения: = (равно), <> (не равно), <, >, <=, >=.
• Пример: если не (справа стена) и счетчик < 10 то ...

Ввод и Вывод

• вывод ...: Выводит значения (числа, строки, результаты выражений) в область Консоли/Лога под редактором кода. Аргументы перечисляются через запятую.

  вывод "Счетчик равен: ", счетчик
  вывод "Привет!"

• вывод ... нс: То же, что и вывод, но не добавляет перевод строки в конце.
• ввод Переменная: Внимание! В этой версии симулятора команда ввод не работает интерактивно. Она прервет выполнение кода и попросит тебя ввести значение во всплывающем окне браузера. После ввода значения нужно будет запустить код снова, чтобы он продолжил работу с введенным значением (если бэкенд это поддерживает, текущая реализация требует ручного перезапуска).

Управление Выполнением

• Условие (Если):

  если условие то
    | Команды, если условие = да
    команда1
  иначе
    | Команды, если условие = нет (блок иначе необязателен)
    команда2
  все

• Выбор (Вариант): Выполняет блок команд, соответствующий первому истинному условию при. Если ни одно условие не истинно, выполняется блок иначе (если он есть).

  выбор
  при условие1: команда1
  при условие2:
    | Блок команд для условия 2
    команда2_1
    команда2_2
  иначе
    | Команды, если ни одно 'при' не подошло (необязательно)
    команда3
  все

• Циклы (Повторение):
  • Для (счетчик):

    нц для Счетчик от Начало до Конец [шаг Шаг]
      | Команды внутри цикла
    кц

    Шаг необязателен, по умолчанию 1. Счетчик автоматически увеличивается (или уменьшается, если шаг отрицательный).
  • Пока (условие):

    нц пока условие
      | Команды (выполняются, пока условие = да)
    кц

    Условие проверяется перед каждой итерацией.
  • N раз:

    нц N раз | где N - целое число или выражение
      | Команды (повторяются N раз)
    кц

  • Бесконечный цикл:

    нц
      | Команды (повторяются бесконечно!)
      | Обязательно используй 'выход' внутри!
    кц

    Будь осторожен! Без команды выход такой цикл приведет к зависанию или ошибке превышения времени выполнения на сервере.
• Управление циклом:
  • выход: Немедленно прерывает выполнение текущего цикла (нц ... кц) и передает управление на команду после кц.
• Пауза и Остановка:
  • пауза или ждать N: В этом симуляторе эти команды не останавливают выполнение на сервере. Вместо этого, они влияют на визуальную задержку между шагами, если включена анимация (слайдер скорости не в крайнем правом положении). Аргумент `N` у `ждать` игнорируется.
  • стоп: Полностью останавливает выполнение всей программы.

Ширина Высота
Нач_X Нач_Y
X1 Y1 КодСтен1 Закраска1 Радиация1 Температура1 СимволВерх1 СимволНиз1 Маркер1
X2 Y2 КодСтен2 Закраска2 Радиация2 Температура2 СимволВерх2 СимволНиз2 Маркер2
...
XN YN КодСтенN ЗакраскаN РадиацияN ТемператураN СимволВерхN СимволНизN МаркерN