Replace HLSL shaders with GLSL pipeline; rename Mathlib float types to GLSL convention

- Write GLSL (Vulkan 4.5) source shaders for all examples
- Pipeline: glslc (GLSL→SPIR-V) + shadercross (SPIR-V→MSL, SDL3-aware)
- Update Examples/Makefile.am and Xcode build phase to use new pipeline
- Rename Mathlib types: float2→vec2, float3→vec3, float4→vec4, float4x4→mat4
- Update README with shader pipeline documentation and install instructions
- Drop HLSL sources and dxil outputs from all build artifacts

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: jdolan

Examples/Hello-iOS/Hello-iOS.c

@@ -34,23 +34,23 @@ static const char *vertex_shader_msl =
 "using namespace metal;\n"
 "\n"
 "struct type_UBO {\n"
-"    float4x4 ModelViewProj;\n"
+"    mat4 ModelViewProj;\n"
 "};\n"
 "\n"
 "struct main0_out {\n"
-"    float4 out_color [[user(locn0)]];\n"
-"    float4 gl_Position [[position]];\n"
+"    vec4 out_color [[user(locn0)]];\n"
+"    vec4 gl_Position [[position]];\n"
 "};\n"
 "\n"
 "struct main0_in {\n"
-"    float3 in_position [[attribute(0)]];\n"
-"    float3 in_color    [[attribute(1)]];\n"
+"    vec3 in_position [[attribute(0)]];\n"
+"    vec3 in_color    [[attribute(1)]];\n"
 "};\n"
 "\n"
 "vertex main0_out main0(main0_in in [[stage_in]], constant type_UBO& UBO [[buffer(0)]]) {\n"
 "    main0_out out = {};\n"
-"    out.out_color  = float4(in.in_color, 1.0);\n"
-"    out.gl_Position = UBO.ModelViewProj * float4(in.in_position, 1.0);\n"
+"    out.out_color  = vec4(in.in_color, 1.0);\n"
+"    out.gl_Position = UBO.ModelViewProj * vec4(in.in_position, 1.0);\n"
 "    return out;\n"
 "}\n";
 
@@ -59,10 +59,10 @@ static const char *fragment_shader_msl =
 "using namespace metal;\n"
 "\n"
 "struct main0_in {\n"
-"    float4 in_color [[user(locn0)]];\n"
+"    vec4 in_color [[user(locn0)]];\n"
 "};\n"
 "\n"
-"fragment float4 main0(main0_in in [[stage_in]]) {\n"
+"fragment vec4 main0(main0_in in [[stage_in]]) {\n"
 "    return in.in_color;\n"
 "}\n";
 

Examples/Hello.c

@@ -38,8 +38,8 @@ typedef struct {
 } Scene;
 
 typedef struct {
-	float3 position;
-	float3 color;
+	vec3 position;
+	vec3 color;
 } Vertex;
 
 static const Vertex vertexes[] = {
@@ -62,7 +62,7 @@ static const Vertex vertexes[] = {
  */
 static void drawScene(Scene *scene) {
 
-  static float2 angles;
+  static vec2 angles;
   static Uint64 lastTicks;
 
   Uint64 ticks = SDL_GetTicks();
@@ -84,12 +84,12 @@ static void drawScene(Scene *scene) {
   SwapchainTexture swapchain = { 0 };
   $(cmd, waitAndAcquireSwapchainTexture, &swapchain);
 
-  float4x4 modelView = float4x4_rotation(angles.x, float3_new(1.f, 0.f, 0.f));
-  modelView = float4x4_mul(float4x4_rotation(angles.y, float3_new(0.f, 1.f, 0.f)), modelView);
-  modelView = float4x4_mul(float4x4_translation(float3_new(0.f, 0.f, -2.5f)), modelView);
+  mat4 modelView = mat4_rotation(angles.x, vec3_new(1.f, 0.f, 0.f));
+  modelView = mat4_mul(mat4_rotation(angles.y, vec3_new(0.f, 1.f, 0.f)), modelView);
+  modelView = mat4_mul(mat4_translation(vec3_new(0.f, 0.f, -2.5f)), modelView);
 
-  const float4x4 projection = float4x4_perspective(45.f, (float) swapchain.size.w / (float) swapchain.size.h, 0.01f, 100.f);
-  const float4x4 modelViewProjection = float4x4_mul(projection, modelView);
+  const mat4 projection = mat4_perspective(45.f, (float) swapchain.size.w / (float) swapchain.size.h, 0.01f, 100.f);
+  const mat4 modelViewProjection = mat4_mul(projection, modelView);
 
   SDL_GPUColorTargetInfo colorTarget = {
     .texture = swapchain.texture,

Examples/Hello.frag.glsl

@@ -0,0 +1,40 @@
+/*
+ * ObjectivelyGPU: SDL3 GPU API wrapper for GNU C.
+ * Copyright (C) 2014 Jay Dolan <jay@jaydolan.com>
+ *
+ * This software is provided 'as-is', without any express or implied
+ * warranty. In no event will the authors be held liable for any damages
+ * arising from the use of this software.
+ *
+ * Permission is granted to anyone to use this software for any purpose,
+ * including commercial applications, and to alter it and redistribute it
+ * freely, subject to the following restrictions:
+ *
+ * 1. The origin of this software must not be misrepresented; you must not
+ * claim that you wrote the original software. If you use this software
+ * in a product, an acknowledgment in the product documentation would be
+ * appreciated but is not required.
+ *
+ * 2. Altered source versions must be plainly marked as such, and must not be
+ * misrepresented as being the original software.
+ *
+ * 3. This notice may not be removed or altered from any source distribution.
+ */
+
+/**
+ * @file Hello.frag.glsl
+ * @brief Hello example fragment shader.
+ *
+ * Inputs (location 0): vec4 color from vertex stage
+ * Output             : vec4 RGBA
+ */
+
+#version 450
+
+layout(location = 0) in vec4 in_color;
+
+layout(location = 0) out vec4 out_color;
+
+void main() {
+	out_color = in_color;
+}

Examples/Hello.frag.hlsl

@@ -3,20 +3,20 @@
 
 using namespace metal;
 
-struct fs_main_out
+struct main0_out
 {
-    float4 _entryPointOutput [[color(0)]];
+    float4 out_color [[color(0)]];
 };
 
-struct fs_main_in
+struct main0_in
 {
-    float4 input_color [[user(locn0)]];
+    float4 in_color [[user(locn0)]];
 };
 
-fragment fs_main_out fs_main(fs_main_in in [[stage_in]])
+fragment main0_out main0(main0_in in [[stage_in]])
 {
-    fs_main_out out = {};
-    out._entryPointOutput = in.input_color;
+    main0_out out = {};
+    out.out_color = in.in_color;
     return out;
 }
 

Examples/Hello.frag.msl

@@ -0,0 +1,48 @@
+/*
+ * ObjectivelyGPU: SDL3 GPU API wrapper for GNU C.
+ * Copyright (C) 2014 Jay Dolan <jay@jaydolan.com>
+ *
+ * This software is provided 'as-is', without any express or implied
+ * warranty. In no event will the authors be held liable for any damages
+ * arising from the use of this software.
+ *
+ * Permission is granted to anyone to use this software for any purpose,
+ * including commercial applications, and to alter it and redistribute it
+ * freely, subject to the following restrictions:
+ *
+ * 1. The origin of this software must not be misrepresented; you must not
+ * claim that you wrote the original software. If you use this software
+ * in a product, an acknowledgment in the product documentation would be
+ * appreciated but is not required.
+ *
+ * 2. Altered source versions must be plainly marked as such, and must not be
+ * misrepresented as being the original software.
+ *
+ * 3. This notice may not be removed or altered from any source distribution.
+ */
+
+/**
+ * @file Hello.vert.glsl
+ * @brief Hello example vertex shader.
+ *
+ * Inputs  (location 0): vec3 position
+ *         (location 1): vec3 color
+ * Uniform (set=1, b=0): mat4 ModelViewProj
+ * Output              : vec4 gl_Position, vec4 color
+ */
+
+#version 450
+
+layout(location = 0) in vec3 in_position;
+layout(location = 1) in vec3 in_color;
+
+layout(location = 0) out vec4 out_color;
+
+layout(set = 1, binding = 0, std140) uniform UBO {
+	mat4 ModelViewProj;
+};
+
+void main() {
+	out_color   = vec4(in_color, 1.0);
+	gl_Position = ModelViewProj * vec4(in_position, 1.0);
+}

Examples/Hello.frag.spv

@@ -8,23 +8,23 @@ struct UBO
     float4x4 ModelViewProj;
 };
 
-struct vs_main_out
+struct main0_out
 {
-    float4 _entryPointOutput_color [[user(locn0)]];
+    float4 out_color [[user(locn0)]];
     float4 gl_Position [[position]];
 };
 
-struct vs_main_in
+struct main0_in
 {
-    float3 input_position [[attribute(0)]];
-    float3 input_color [[attribute(1)]];
+    float3 in_position [[attribute(0)]];
+    float3 in_color [[attribute(1)]];
 };
 
-vertex vs_main_out vs_main(vs_main_in in [[stage_in]], constant UBO& _40 [[buffer(0)]])
+vertex main0_out main0(main0_in in [[stage_in]], constant UBO& _30 [[buffer(0)]])
 {
-    vs_main_out out = {};
-    out._entryPointOutput_color = float4(in.input_color, 1.0);
-    out.gl_Position = _40.ModelViewProj * float4(in.input_position, 1.0);
+    main0_out out = {};
+    out.out_color = float4(in.in_color, 1.0);
+    out.gl_Position = _30.ModelViewProj * float4(in.in_position, 1.0);
     return out;
 }