final

2026-06-10 10:25:30 +03:00 · 2026-03-03 21:55:57 +03:00
parent 000a587211
commit 9bca5735e8
9 changed files with 278 additions and 90 deletions
@@ -0,0 +1,190 @@
+# 🎯 SortLab
+
+### ⚡ Интерактивный визуализатор алгоритмов сортировки
+
+![C++](https://img.shields.io/badge/C++-17-00599C?style=flat&logo=cplusplus&logoColor=white)
+![SFML](https://img.shields.io/badge/SFML-2.6-8CC445?style=flat&logo=sfml&logoColor=white)
+![CMake](https://img.shields.io/badge/CMake-3.16+-064F8C?style=flat&logo=cmake&logoColor=white)
+![Platform](https://img.shields.io/badge/Platform-Windows-0078D4?style=flat&logo=windows&logoColor=white)
+![License](https://img.shields.io/badge/License-MIT-yellow?style=flat)
+
+---
+
+![SortLab Preview](assets/preview.png)
+
+---
+
+## 📖 О проекте
+
+**SortLab** — учебный инструмент для наглядного изучения алгоритмов сортировки.
+Каждый элемент массива отображается как столбик. Высота = значение. Цвет = состояние.
+
+Программа показывает работу алгоритма в реальном времени, шаг за шагом, с подсветкой
+сравниваемых и переставляемых элементов, счётчиком операций и визуализацией прогресса.
+
+---
+
+## 🧮 Алгоритмы
+
+| # | Алгоритм | Время (лучшее / среднее / худшее) | Память |
+|---|---|---|---|
+| `1` | 🫧 Bubble Sort | O(n) / O(n²) / O(n²) | O(1) |
+| `2` | 🔍 Selection Sort | O(n²) / O(n²) / O(n²) | O(1) |
+| `3` | 🃏 Insertion Sort | O(n) / O(n²) / O(n²) | O(1) |
+| `4` | 🔀 Merge Sort | O(n log n) / O(n log n) / O(n log n) | O(n) |
+| `5` | ⚡ Quick Sort | O(n log n) / O(n log n) / O(n²) | O(log n) |
+
+---
+
+## 🎮 Управление
+
+| Клавиша | Действие |
+|---|---|
+| `Space` | ▶️ Старт / ⏸️ Пауза |
+| `R` | 🔀 Перемешать массив |
+| `→` | 👣 Один шаг (в режиме паузы) |
+| `↑` / `↓` | 🐇 / 🐢 Увеличить / уменьшить скорость |
+| `1` — `5` | 🔢 Выбрать алгоритм |
+| `I` | ℹ️ Справка о программе |
+| `Q` | 🚪 Выход |
+
+---
+
+## 🖥️ Интерфейс
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ 📊 Algorithm: Quick Sort   Time: O(n log n)   Comparisons: 1.2k │  ← UI панель
+├────────────────────────────────────┬─────────────────────────┤
+│                                    │                         │
+│         📈 Столбики массива        │   🗺️ Progress Map       │
+│                                    │                         │
+├────────────────────────────────────┴─────────────────────────┤
+│  📉 Δ Comparisons / step  [гистограмма]                      │  ← нижняя панель
+└──────────────────────────────────────────────────────────────┘
+```
+
+- 📊 **Главная область** — столбики с цветовой индикацией состояний
+- 🗺️ **Progress Map** — миниатюрная сетка всего массива, зеленеет по мере сортировки
+- 📉 **Δ Гистограмма** — количество сравнений на каждом шаге (пульс алгоритма)
+
+### 🎨 Цветовая схема
+
+| Цвет | Состояние |
+|---|---|
+| 🔵 Синий | Обычный элемент |
+| 🩵 Голубой | Сравниваемые элементы |
+| 🟠 Оранжевый | Переставляемые элементы |
+| 🟢 Зелёный | Отсортированный элемент |
+
+---
+
+## 🔧 Сборка
+
+### 📦 Зависимости
+- 🛠️ [CMake](https://cmake.org/download/) ≥ 3.16
+- 💻 [Visual Studio 2022](https://visualstudio.microsoft.com/) с компонентом **Desktop development with C++**
+- 🌐 Git (для FetchContent — SFML скачивается автоматически)
+
+### 🚀 Установка
+
+```bash
+git clone https://github.com/your-username/SortLab.git
+cd SortLab
+cmake -S . -B build
+cmake --build build --config Release
+.\build\Release\SortLab.exe
+```
+
+> 💡 SFML 2.6 скачивается и компилируется автоматически при первой сборке.
+> ⏱️ Первый запуск `cmake -S . -B build` займёт 1–3 минуты.
+
+### 🔤 Шрифт
+Скачай [JetBrains Mono](https://www.jetbrains.com/lp/mono/) и положи файл в:
+```
+assets/fonts/JetBrainsMono-Regular.ttf
+```
+
+---
+
+## 📁 Структура проекта
+
+```
+SortLab/
+├── 🎨 assets/
+│   ├── fonts/JetBrainsMono-Regular.ttf
+│   ├── icon.ico
+│   ├── icon.png
+│   ├── preview.png
+│   └── app.rc
+├── 📋 include/
+│   ├── App.hpp
+│   ├── Array.hpp
+│   ├── Sorter.hpp
+│   ├── UI.hpp
+│   ├── OperationsHistory.hpp
+│   ├── ProgressMap.hpp
+│   └── sorters/
+│       ├── BubbleSorter.hpp
+│       ├── SelectionSorter.hpp
+│       ├── InsertionSorter.hpp
+│       ├── MergeSorter.hpp
+│       └── QuickSorter.hpp
+├── 💻 src/
+│   ├── main.cpp
+│   ├── App.cpp
+│   ├── App_audio.cpp
+│   ├── Array.cpp
+│   ├── Sorter.cpp
+│   ├── UI.cpp
+│   ├── OperationsHistory.cpp
+│   ├── ProgressMap.cpp
+│   └── sorters/
+│       ├── BubbleSorter.cpp
+│       ├── SelectionSorter.cpp
+│       ├── InsertionSorter.cpp
+│       ├── MergeSorter.cpp
+│       └── QuickSorter.cpp
+└── ⚙️ CMakeLists.txt
+```
+
+---
+
+## 🏗️ Архитектура
+
+```
+main()
+  └── App::run()
+        ├── handleEvents()   — ввод с клавиатуры
+        ├── update(dt)       — шаг сортировки + гистограмма
+        └── render()
+              ├── Array bars          — основная визуализация
+              ├── UI overlay          — текст, статистика
+              ├── ProgressMap         — мини-карта
+              └── HistogramRenderer   — Δ гистограмма
+
+Sorter (abstract)
+  ├── BubbleSorter
+  ├── SelectionSorter
+  ├── InsertionSorter
+  ├── MergeSorter
+  └── QuickSorter
+```
+
+> 🔑 Ключевой паттерн: все алгоритмы реализованы как **конечные автоматы** (state machines).
+> Метод `step()` выполняет ровно одну атомарную операцию и возвращает управление,
+> не блокируя главный поток рендеринга.
+
+---
+
+## 📜 Лицензия
+
+```
+MIT License — 2026
+```
+
+---
+
+<div align="center">
+  <sub>🎓 made for college coursework &nbsp;|&nbsp; built with ❤️ and C++17</sub>
+</div>