Skip to main content

SPRING_DAMPER_GRID_WGSL

Constant SPRING_DAMPER_GRID_WGSL 

Source
pub const SPRING_DAMPER_GRID_WGSL: &str = "// Analytical Mass-Spring-Damper Multi-Instance Grid Compute Kernel\n// Evaluates parallel closed-form spring dynamics across thousands of vertices/particles.\n\nstruct SpringParticle {\n    pos_x: f32,\n    pos_y: f32,\n    pos_z: f32,\n    vel_x: f32,\n    vel_y: f32,\n    vel_z: f32,\n    target_x: f32,\n    target_y: f32,\n    target_z: f32,\n    stiffness: f32,\n    damping: f32,\n    mass: f32,\n};\n\nstruct SpringParams {\n    count: u32,\n    dt: f32,\n    _pad0: f32,\n    _pad1: f32,\n};\n\n@group(0) @binding(0) var<uniform> params: SpringParams;\n@group(0) @binding(1) var<storage, read> particles_in: array<SpringParticle>;\n@group(0) @binding(2) var<storage, read_write> particles_out: array<SpringParticle>;\n\nfn step_spring_1d(pos: f32, vel: f32, target: f32, k: f32, c: f32, m: f32, dt: f32) -> vec2<f32> {\n    let x0 = pos - target;\n    let v0 = vel;\n    let mass_safe = max(m, 1e-4);\n    let k_safe = max(k, 1e-4);\n\n    let omega_n = sqrt(k_safe / mass_safe);\n    let zeta = c / (2.0 * sqrt(mass_safe * k_safe));\n\n    if (abs(zeta - 1.0) < 1e-3) {\n        // Critical damping\n        let decay = exp(-omega_n * dt);\n        let c1 = x0;\n        let c2 = v0 + omega_n * x0;\n        let x = (c1 + c2 * dt) * decay;\n        let v = (c2 - omega_n * (c1 + c2 * dt)) * decay;\n        return vec2<f32>(target + x, v);\n    } else if (zeta < 1.0) {\n        // Under-damped oscillation\n        let omega_d = omega_n * sqrt(1.0 - zeta * zeta);\n        let decay = exp(-zeta * omega_n * dt);\n        let cos_t = cos(omega_d * dt);\n        let sin_t = sin(omega_d * dt);\n        let c1 = x0;\n        let c2 = (v0 + zeta * omega_n * x0) / omega_d;\n        let x = decay * (c1 * cos_t + c2 * sin_t);\n        let v = decay * ((-zeta * omega_n * c1 + omega_d * c2) * cos_t - (omega_d * c1 + zeta * omega_n * c2) * sin_t);\n        return vec2<f32>(target + x, v);\n    } else {\n        // Over-damped\n        let gamma = omega_n * sqrt(zeta * zeta - 1.0);\n        let r1 = -zeta * omega_n + gamma;\n        let r2 = -zeta * omega_n - gamma;\n        let c2 = (v0 - r1 * x0) / (r2 - r1);\n        let c1 = x0 - c2;\n        let x = c1 * exp(r1 * dt) + c2 * exp(r2 * dt);\n        let v = c1 * r1 * exp(r1 * dt) + c2 * r2 * exp(r2 * dt);\n        return vec2<f32>(target + x, v);\n    }\n}\n\n@compute @workgroup_size(64)\nfn spring_grid_main(@builtin(global_invocation_id) global_id: vec3<u32>) {\n    let idx = global_id.x;\n    if (idx >= params.count) {\n        return;\n    }\n\n    let p = particles_in[idx];\n    let res_x = step_spring_1d(p.pos_x, p.vel_x, p.target_x, p.stiffness, p.damping, p.mass, params.dt);\n    let res_y = step_spring_1d(p.pos_y, p.vel_y, p.target_y, p.stiffness, p.damping, p.mass, params.dt);\n    let res_z = step_spring_1d(p.pos_z, p.vel_z, p.target_z, p.stiffness, p.damping, p.mass, params.dt);\n\n    var out_p = p;\n    out_p.pos_x = res_x.x;\n    out_p.vel_x = res_x.y;\n    out_p.pos_y = res_y.x;\n    out_p.vel_y = res_y.y;\n    out_p.pos_z = res_z.x;\n    out_p.vel_z = res_z.y;\n\n    particles_out[idx] = out_p;\n}\n";