Files
paper-racing-gpi/QUICKSTART-WEB.md
2025-10-20 21:07:28 +05:00

4.0 KiB
Raw Blame History

🚀 Быстрый старт - Веб-инструменты

Два независимых приложения

🗺️ Редактор карт

cd map-editor
./open-editor.sh

Для чего: Создание и редактирование карт

🎬 Визуализатор решений

cd solution-player
./open-player.sh

Для чего: Просмотр анимации решений


📖 Полный цикл работы

Шаг 1: Создайте карту

cd map-editor
./open-editor.sh
  1. Нарисуйте трассу
  2. Добавьте точку старта (S, тип 5)
  3. Добавьте чекпоинты (C, тип 4)
  4. Нажмите "📥 Экспорт JSON"
  5. Сохраните как my-map.json

Шаг 2: Решите карту

cd ..
dotnet run --project racing-astar.csproj maps/my-map.json

Решение сохранится в solution.json

Шаг 3: Визуализируйте

cd solution-player
./open-player.sh
  1. Нажмите "📂 Загрузить карту" → выберите my-map.json
  2. Нажмите "🎬 Загрузить решение" → выберите solution.json
  3. Нажмите "▶ Play"
  4. Наслаждайтесь анимацией!

🎯 Быстрый тест с примерами

Вариант 1: Простая карта

cd solution-player
./open-player.sh
  1. Загрузите карту: simple-track.json
  2. Загрузите решение: example-solution.json
  3. Play!

Вариант 2: Демо-карта

cd solution-player
./open-player.sh
  1. Загрузите карту: demo-with-start.json
  2. Загрузите решение: demo-solution.json
  3. Play!

Вариант 3: Сложная траектория

cd solution-player
./open-player.sh
  1. Загрузите карту: demo-with-start.json
  2. Загрузите решение: complex-solution.json
  3. Play!

🎮 Управление визуализатором

  • ▶ Play - автоматическое воспроизведение
  • ⏸ Pause - пауза
  • ⏮ Reset - вернуться к началу
  • Back - шаг назад
  • Forward - шаг вперед
  • Слайдер - скорость 1x-10x

📚 Дополнительная информация

  • WEB-TOOLS.md - подробное описание инструментов
  • map-editor/README.md - документация редактора
  • solution-player/README.md - документация визуализатора
  • SEPARATION-SUMMARY.md - детали разделения проектов

💡 Полезные советы

Для редактора:

  • Используйте ЛКМ для рисования
  • Удерживайте кнопку мыши для быстрого рисования
  • Проверяйте JSON в консоли (F12)

Для визуализатора:

  • Начните с малых скоростей (1x-3x)
  • Используйте пошаговый режим для анализа
  • Следите за красной стрелкой (вектор скорости)
  • Смотрите информацию о каждом шаге внизу

🔧 Troubleshooting

Проблема: Визуализатор не показывает траекторию
Решение: Убедитесь, что на карте есть точка старта (тип 5)

Проблема: Траектория выходит за пределы карты
Решение: Проверьте, что решение создано для правильной карты

Проблема: Браузер не открывается
Решение: Откройте index.html вручную


Приятного использования! 🎉