VulkanDonut

VulkanDonut 1.0
===============
A Vulkan 1.3 rotating torus demo for AmigaOS4 PPC
by Maijestro

DESCRIPTION
-----------
VulkanDonut is a real-time 3D demo using the Vulkan 1.3 API via the
VulkanOS4 library by Richard Gibbs. It demonstrates what modern GPU
hardware can do on AmigaOS4 using Warp3D Nova.

This is a fully native AmigaOS4 development. No SDL2 or any other
compatibility layer is required. The demo uses a native Intuition
window directly, communicating with the GPU via the VulkanOS4 library.

FEATURES
--------
- Two rotating tori (main + satellite) with orbiting camera
- AmigaOS4 logo texture on the torus surface
- Phong lighting (ambient, diffuse, specular)
- Pulsing heartbeat glow effect
- Rainbow color gradient with rim lighting
- Lightning bolts on the torus surface
- Burst/explosion effect and lens flare
- Tunnel background with rainbow grid
- Sine-wave scroller at the bottom of the screen
- FPS display in the window title

PERFORMANCE
-----------
167-168 FPS on AmigaOne X5000 with Radeon RX GPU.

REQUIREMENTS
------------
- AmigaOS4.1 Final Edition
- AmigaOne X5000 or compatible PPC system
- Warp3D Nova compatible GPU (Radeon RX recommended)
- VulkanOS4 library by Richard Gibbs (available on OS4Depot)

USAGE
-----
Simply double-click VulkanDonut from Workbench or run from Shell.
Press any key or close the window to quit.

KNOWN ISSUES
------------
- No music in this release (SDL2_mixer/newlib compatibility issue)
  Music support may be added in a future version.

THANKS
------
- Richard Gibbs for VulkanOS4 (Vulkan 1.3 for AmigaOS4)
- The AmigaOS4 community

LICENSE
-------
MIT License - free to use, modify and distribute.

CHANGES
-------
1.0 (March 2026) - Initial release