summaryrefslogtreecommitdiff
path: root/src/gltf_render/math.zig
diff options
context:
space:
mode:
Diffstat (limited to 'src/gltf_render/math.zig')
-rw-r--r--src/gltf_render/math.zig67
1 files changed, 67 insertions, 0 deletions
diff --git a/src/gltf_render/math.zig b/src/gltf_render/math.zig
new file mode 100644
index 0000000..6279ce4
--- /dev/null
+++ b/src/gltf_render/math.zig
@@ -0,0 +1,67 @@
+const std = @import("std");
+pub const Mat4 = [16]f32;
+pub const identity: Mat4 = .{ 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1 };
+pub fn multiply(a: Mat4, b: Mat4) Mat4 {
+ var out: Mat4 = @splat(0);
+ for (0..4) |col| for (0..4) |row| {
+ for (0..4) |k| out[col * 4 + row] += a[k * 4 + row] * b[col * 4 + k];
+ };
+ return out;
+}
+fn sub(a: [3]f32, b: [3]f32) [3]f32 {
+ return .{ a[0] - b[0], a[1] - b[1], a[2] - b[2] };
+}
+fn dot(a: [3]f32, b: [3]f32) f32 {
+ return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+fn cross(a: [3]f32, b: [3]f32) [3]f32 {
+ return .{ a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0] };
+}
+fn unit(a: [3]f32) [3]f32 {
+ const n = @sqrt(dot(a, a));
+ return .{ a[0] / n, a[1] / n, a[2] / n };
+}
+pub const Camera = struct {
+ eye: [3]f32,
+ target: [3]f32,
+ up: [3]f32 = .{ 0, 1, 0 },
+ fov: f32 = std.math.pi / 3.0,
+ near: f32 = 0.1,
+ far: f32 = 300,
+ aspect_ratio: ?f32 = null,
+ orthographic: ?struct { xmag: f32, ymag: f32 } = null,
+ /// Right-handed, column-major; depth range 0..1, camera forward -Z.
+ pub fn matrix(c: Camera, aspect: f32) Mat4 {
+ const z = unit(sub(c.eye, c.target));
+ const x = unit(cross(c.up, z));
+ const y = cross(z, x);
+ const view: Mat4 = .{ x[0], y[0], z[0], 0, x[1], y[1], z[1], 0, x[2], y[2], z[2], 0, -dot(x, c.eye), -dot(y, c.eye), -dot(z, c.eye), 1 };
+ const scale = 1 / @tan(c.fov / 2);
+ const d = c.near - c.far;
+ const projection: Mat4 = if (c.orthographic) |o|
+ .{ 1 / o.xmag, 0, 0, 0, 0, 1 / o.ymag, 0, 0, 0, 0, 1 / d, 0, 0, 0, c.near / d, 1 }
+ else if (std.math.isInf(c.far))
+ .{ scale / (c.aspect_ratio orelse aspect), 0, 0, 0, 0, scale, 0, 0, 0, 0, -1, -1, 0, 0, -c.near, 0 }
+ else
+ .{ scale / (c.aspect_ratio orelse aspect), 0, 0, 0, 0, scale, 0, 0, 0, 0, c.far / d, -1, 0, 0, c.near * c.far / d, 0 };
+ return multiply(projection, view);
+ }
+};
+test "perspective maps near and far to zero and one" {
+ const camera: Camera = .{ .eye = .{ 0, 0, 0 }, .target = .{ 0, 0, -1 } };
+ const m = camera.matrix(1);
+ try std.testing.expectApproxEqAbs(@as(f32, 0), (m[10] * -camera.near + m[14]) / camera.near, 0.00001);
+ try std.testing.expectApproxEqAbs(@as(f32, 1), (m[10] * -camera.far + m[14]) / camera.far, 0.00001);
+}
+
+test "orthographic and infinite perspective keep valid depth" {
+ var camera: Camera = .{ .eye = .{ 0, 0, 0 }, .target = .{ 0, 0, -1 }, .orthographic = .{ .xmag = 2, .ymag = 3 } };
+ const ortho = camera.matrix(1);
+ try std.testing.expectApproxEqAbs(@as(f32, 0), ortho[10] * -camera.near + ortho[14], 0.00001);
+ try std.testing.expectApproxEqAbs(@as(f32, 1), ortho[10] * -camera.far + ortho[14], 0.00001);
+ camera.orthographic = null;
+ camera.far = std.math.inf(f32);
+ const infinite = camera.matrix(1);
+ for (infinite) |v| try std.testing.expect(std.math.isFinite(v));
+ try std.testing.expectApproxEqAbs(@as(f32, 0), (infinite[10] * -camera.near + infinite[14]) / camera.near, 0.00001);
+}