Vulkan 1.3 implementation for AmigaOS 4.

VulkanOS4 brings the Vulkan graphics API to PowerPC Amiga hardware. It provides a complete Vulkan 1.3 runtime with two installable client drivers (ICDs), a loader library, and a full SDK for developing Vulkan applications on AmigaOS 4.

• vulkan.library -- Vulkan loader. Discovers and dispatches to installed ICDs automatically, selecting the best available driver.
• software_vk.library -- Software ICD. Pure CPU rendering with a SPIR-V bytecode interpreter. Works on any AmigaOS 4 system without GPU requirements. Useful for development, validation, and systems without supported GPUs.
• ogles2_vk.library -- GPU ICD. Hardware-accelerated rendering via ogles2.library and Warp3D Nova. Uses SPIRV-Cross to transpile SPIR-V shaders to GLSL ES 3.1 for GPU execution. Typically 10--300x faster than the software renderer.
• SDK -- Vulkan headers, inline macros, and link library for compiling Vulkan programs on AmigaOS 4.

Both ICDs implement 218 Vulkan functions (100% Vulkan 1.3 core + WSI) and support 210+ SPIR-V opcodes.

• AmigaOS 4.1 Final Edition or later
• PowerPC-based Amiga (AmigaOne X5000, X1000, A1222, Sam460, or similar)
• For software rendering: no additional requirements
• For GPU rendering (ogles2_vk.library):
  • Supported Radeon GPU (RX 500/400 series or HD 7000+ series)
  • RadeonRX or RadeonHD graphics driver
  • Warp3D Nova (Warp3DNova.library)
  • ogles2.library (OpenGL ES 2.0)

• Docker
• walkero/amigagccondocker:os4-gcc11 Docker image (GCC 11.5.0 cross-compiler)
• GNU Make
• For the GPU ICD, the following must be downloaded into external/:
  • SPIRV-Cross -- SPIR-V to GLSL transpiler (compiled as libspirv-cross.a)
  • VMA -- Vulkan Memory Allocator (C++ header-only, requires g++)
  • OGLES2 SDK headers (external/OGLES2/)
  • Warp3D Nova SDK headers (external/Warp3DNova/)

See external/*/README.md for download and setup instructions for each dependency.

The distribution includes an Autoinstall script. From the VulkanOS4 directory on your Amiga:

Execute Autoinstall

This installs:

• LIBS:vulkan.library -- Vulkan loader
• LIBS:Vulkan/software_vk.library -- Software ICD
• LIBS:Vulkan/ogles2_vk.library -- GPU ICD
• DEVS:Vulkan/icd.d/software_vk.json -- Software ICD manifest
• DEVS:Vulkan/icd.d/ogles2_vk.json -- GPU ICD manifest
• C:vulkaninfo -- Device information tool
• C:VulkanPrefs -- ICD preferences tool

Copy the files to the following locations:

copy Libs/vulkan.library              LIBS:
copy Libs/Vulkan/software_vk.library  LIBS:Vulkan/
copy Libs/Vulkan/ogles2_vk.library    LIBS:Vulkan/
copy Devs/Vulkan/icd.d/software_vk.json  DEVS:Vulkan/icd.d/
copy Devs/Vulkan/icd.d/ogles2_vk.json    DEVS:Vulkan/icd.d/
copy Tools/VulkanPrefs                C:
copy Tools/vulkaninfo                 C:

SDK files must be copied manually to your AmigaOS SDK:

copy SDK/include/include_h/vulkan SDK:include/include_h/vulkan ALL CLONE
copy SDK/include/include_h/interfaces/vulkan.h SDK:include/include_h/interfaces/
copy SDK/include/include_h/inline4/vulkan.h SDK:include/include_h/inline4/
copy SDK/include/include_h/proto/vulkan.h SDK:include/include_h/proto/
copy SDK/include/include_h/clib/vulkan_protos.h SDK:include/include_h/clib/
copy SDK/newlib/lib/libvulkan_loader.a SDK:newlib/lib/

Minimal compile command:

gcc -mcrt=newlib -D__USE_INLINE__ -o myapp myapp.c -lvulkan_loader -lauto

Required flags:

• -D__USE_INLINE__ -- enables inline macros (vkCreateInstance() etc.)
• -lvulkan_loader -- links the auto-open stub for vulkan.library
• -lauto -- auto-opens exec.library, intuition.library, etc.

Required includes in your source code:

#include <proto/exec.h>        /* always needed */
#include <proto/intuition.h>   /* if using windows/WSI */
#include <proto/vulkan.h>      /* Vulkan API */

A project template is provided in Template/ with a ready-to-use Makefile and source file.

All components are cross-compiled via Docker. Pull the Docker image first:

docker pull walkero/amigagccondocker:os4-gcc11

make test-build    # Verify Docker cross-compilation works
make all           # Build everything (loader + both ICDs + examples + tools)
make loader        # Build vulkan.library + libvulkan_loader.a
make icd           # Build software_vk.library
make gpu-icd       # Build ogles2_vk.library
make examples      # Build all 22 example programs
make tools         # Build vulkaninfo, VulkanPrefs, AmigaMark
make dist          # Create distribution directory in dist/VulkanOS4/
make dist-lha      # Create dist/VulkanOS4.lha archive
make check         # Validate build output (ELF header verification)
make clean         # Remove all build artifacts

make all builds components in the correct order. To build individually, the dependencies are:

1. make loader -- no dependencies
2. make icd -- no dependencies
3. make gpu-icd -- requires external dependencies (see Requirements)
4. make examples -- depends on loader (for libvulkan_loader.a)
5. make tools -- depends on loader

22 example programs are included, covering basic rendering through to 3D geometry, texturing, instancing, and glTF model loading. Run them from the distribution directory on your Amiga:

Examples/01_enumerate/01_enumerate
Examples/08_triangle/08_triangle
Examples/09_rotating/09_rotating
Examples/12_wireframe_cube/12_wireframe_cube
Examples/20_torus/20_torus

Examples 21 and 22 require optional third-party headers (stb_image.h and cgltf.h respectively). They include procedural fallbacks and will still compile and run without the external headers.

Displays Vulkan device information, supported features, memory properties, and queue families.

vulkaninfo

Manages ICD priority and enable/disable state. Reads and writes ENVARC:Vulkan/vulkan.prefs.

VulkanPrefs               ; Show current ICD configuration
VulkanPrefs -list          ; List discovered ICDs
VulkanPrefs -disable sw    ; Disable software ICD
VulkanPrefs -enable sw     ; Re-enable software ICD
VulkanPrefs -priority gpu 1 ; Set GPU ICD as highest priority

Vulkan benchmark tool. Measures rendering performance with timed FPS reporting.

AmigaMark

VulkanOS4 uses the following third-party libraries and resources:

OGLES2 and Warp3D Nova SDK headers are proprietary (A-EON Technology) and must be obtained separately.

See THIRD_PARTY.md for full attribution details.

Initial release.

• Vulkan 1.3 loader (vulkan.library) with automatic ICD discovery and dispatch
• Software ICD (software_vk.library) with SPIR-V bytecode interpreter, triangle rasteriser with depth testing, and Bresenham line rasteriser
• GPU ICD (ogles2_vk.library) with OGLES2/Warp3D Nova backend and SPIRV-Cross transpiler for SPIR-V to GLSL ES 3.1
• 218 Vulkan functions per ICD (100% Vulkan 1.3 core + WSI coverage)
• 210+ SPIR-V opcodes including vertex/fragment shader operations, matrix math, texture sampling, control flow, and type conversions
• 22 example programs from basic triangle to glTF model viewer
• SDK headers with AmigaOS interface definitions, inline macros, and link library
• VulkanPrefs CLI tool for ICD priority management
• vulkaninfo device enumeration tool
• AmigaMark benchmark tool
• Autoinstall script for AmigaOS 4
• Optimised software rasteriser with incremental edge functions, active varying mask, and shader state allocation pooling
• GPU ICD optimisations including VBO caching and batched resource cleanup

See individual source files for license information.