turtle/turtle-lib-macroquad

turtle-lib-macroquad

The main turtle graphics library built on Macroquad with Lyon tessellation.

See the main README for complete documentation.

Features

✅ Complete Lyon Integration - All drawing operations use GPU-optimized tessellation

• Unified rendering pipeline for lines, arcs, circles, and fills
• ~410 lines of code eliminated through architectural simplification
• Consistent high-quality rendering across all primitives

✅ Multi-Contour Fill System - Advanced fill capabilities with automatic hole detection

• EvenOdd fill rule for complex shapes with holes (like cheese or yin-yang symbols)
• pen_up() closes current contour, pen_down() opens next contour
• Progressive fill preview during animations
• Support for self-intersecting paths

✅ Smooth Animation - Tweening system with live rendering

• Configurable speed control
• Frame-rate independent animation
• Live fill preview during circle/arc drawing

Quick Examples

# Run from this directory
cargo run --example square          # Basic square drawing
cargo run --example yinyang         # Multi-contour fills with holes
cargo run --example fill_advanced   # Self-intersecting fills
cargo run --example koch            # Recursive fractals
cargo run --example fill_demo       # Multiple independent fills

Architecture Highlights

Rendering Pipeline

All drawing operations → Lyon tessellation → GPU mesh rendering

DrawCommand Enum

Simplified from 5 variants to 1:

• Mesh(MeshData) - unified variant for all drawing operations

Fill System

• FillState tracks multiple contours (completed + current)
• Pen state management automatically handles contour creation
• EvenOdd tessellation provides automatic hole detection

See LYON_COMPLETE.md and MULTI_CONTOUR_FILLS.md for implementation details.

Status

✅ Stable - Lyon integration complete, multi-contour fills working, all examples passing.

See ../README.md for full API documentation and project status.