================================================================================
  MATILDE TRACKER 1.11
================================================================================

Build Date: 2025-10-09

================================================================================
  OVERVIEW
================================================================================

This version includes significant enhancements to the sample resampling engine,
featuring SINC interpolation with AVX2 SIMD optimizations for both realtime and 
offline rendering.

================================================================================
  NEW FEATURES
================================================================================

1. SINC INTERPOLATION
   - Hann window function: 0.5 + 0.5 * cos(x / num_taps * π)
   - Adaptive anti-aliasing based on playback speed
   - Division-by-zero protection for numerical stability

2. SINC 64 (REALTIME)
   - 65-tap filter (32 taps each side) for realtime playback
   - On-the-fly coefficient computation

3. SINC 256 (OFFLINE)
   - 257-tap filter (128 taps each side) for offline bounce
   - 4x higher quality than SINC 64
   - Optimized for maximum offline rendering quality
   - Same proven algorithm as SINC 64, scaled up

4. AVX2 SIMD OPTIMIZATIONS
   - Process 8 samples at a time using AVX2 instructions
   - FMA (Fused Multiply-Add) for efficient accumulation
   - SINC 64: 8 AVX2 iterations per sample
   - SINC 256: 32 AVX2 iterations per sample
   - Requires 2013+ CPU

5. NEW MACHINE ATTRIBUTE: "Offline SINC 512 Bounce"
   - Control offline rendering quality independently
   - Values: 0 = Enabled (default), 1 = Disabled
   - When Enabled: Uses SINC 256 for offline bounce (max quality)
   - When Disabled: Uses selected filter mode for both realtime/offline
   - Allows choosing between max quality or consistent rendering

================================================================================
  FILTER MODES
================================================================================

0 = Nearest Neighbor  - No interpolation (lo-fi)
1 = Linear            - Fast, smooth (standard)
2 = Spline            - Cubic interpolation (higher quality)
3 = SINC              - Best quality (realtime: 64 taps, offline: 256 taps*)

* When "Offline SINC 512 Bounce" attribute is enabled (default)

================================================================================
  OFFLINE RENDERING BEHAVIOR
================================================================================

Offline SINC 512 Bounce = ENABLED (0, default):
  - Any filter mode + Offline bounce = SINC 256 (maximum quality)
  - Realtime playback = Selected filter mode

Offline SINC 512 Bounce = DISABLED (1):
  - Offline bounce = Selected filter mode
  - Realtime playback = Selected filter mode
  - Consistent quality between realtime and offline

Examples:
  Filter=Linear, Attribute=Enabled  → Realtime: Linear, Offline: SINC 256
  Filter=Linear, Attribute=Disabled → Realtime: Linear, Offline: Linear
  Filter=SINC,   Attribute=Enabled  → Realtime: SINC 64, Offline: SINC 256
  Filter=SINC,   Attribute=Disabled → Realtime: SINC 64, Offline: SINC 64

================================================================================
  SYSTEM REQUIREMENTS
================================================================================

- Windows 10 or later
- CPU with AVX2 support (recommended, not required)
  * AVX2 available on Intel Haswell (2013+) and AMD Excavator (2015+)
  * Automatic fallback to scalar code on older CPUs

================================================================================
  COMPATIBILITY
================================================================================

- Fully backward compatible with Matilde Tracker 1.10
- No changes to saved song format
- Existing projects load without modification

================================================================================
  CREDITS
================================================================================

Original Matilde Tracker: Carsten Sørensen / https://www.rift.dk
SINC Algorithm: George Reales

For more information, visit: https://forums.jeskola.net/

================================================================================
