m5stack-tab5-sorting-algorithms/README.md

# M5Stack Tab5 Sorting Lab

Touch-controlled visual guide to Bubble, Insertion, Selection, Shell, Merge,
Quick, Heap, and Radix sort. Each algorithm animates the same 48 shuffled
values and reports comparisons, moves, and elapsed time. **RUN ALL 8** ends
with a fair operation-count chart.

Controls: **Pause/Resume**, **Redo**, **Next**, **Run All 8**, and
**Algorithm Menu**. **No Visual** reruns the selected algorithm without any
animation, touch polling, or intentional delay during the timed section and
reports its duration with microsecond-derived precision. The bar animation is
rendered through a PSRAM-backed canvas for tear-free updates. Animation work is
batched (32 sort operations per candidate frame), the display is capped near
60 FPS, and the independently buffered counter strip updates at 4 Hz so its
rapidly changing digits remain readable without flicker. Build with `pio run`,
upload with `pio run -t upload`.

**All Visual** runs the eight faster animations and then opens a comparison
report. **All Fast** benchmarks all eight without intermediate drawing and
opens the same report with operation-count and measured-time bars.

The PlatformIO platform is pinned to the `54.03.21-2` maintenance release,
which includes esptool 5.0.2 and avoids the Click API error present with the
original `54.03.21` package on some Windows installations.