Struct InteractiveRippleBuffer
#[repr(C)]pub struct InteractiveRippleBuffer {
pub h_prev: [f32; 4096],
pub h_curr: [f32; 4096],
pub h_next: [f32; 4096],
pub center_x: f32,
pub center_z: f32,
pub world_size_m: f32,
pub wave_speed: f32,
pub damping: f32,
}Expand description
A zero-heap 2D discrete wave heightfield solver.
Fields§
§h_prev: [f32; 4096]Previous time-step height buffer $h^{n-1}$
h_curr: [f32; 4096]Current time-step height buffer $h^n$
h_next: [f32; 4096]Next time-step height buffer $h^{n+1}$
center_x: f32World-space center X coordinate
center_z: f32World-space center Z coordinate
world_size_m: f32Physical width of the grid in meters
wave_speed: f32Wave propagation speed $c$ in m/s (typically 1.5 - 3.5 m/s for shallow water ripples)
damping: f32Damping factor per step $\gamma \in (0.0, 1.0)$ (e.g. 0.985)
Implementations§
§impl InteractiveRippleBuffer
impl InteractiveRippleBuffer
pub const fn new(
center_x: f32,
center_z: f32,
world_size_m: f32,
wave_speed: f32,
damping: f32,
) -> InteractiveRippleBuffer
pub const fn new( center_x: f32, center_z: f32, world_size_m: f32, wave_speed: f32, damping: f32, ) -> InteractiveRippleBuffer
Creates a new interactive ripple grid centered at (center_x, center_z) in world space.
pub fn clear(&mut self)
pub fn clear(&mut self)
Resets all height buffers to zero (calm water).
pub fn world_to_grid(&self, wx: f32, wz: f32) -> (f32, f32)
pub fn world_to_grid(&self, wx: f32, wz: f32) -> (f32, f32)
Converts world coordinates $(wx, wz)$ to continuous grid indices $(gx, gz) \in [0, \text{DIM}-1]$.
pub fn inject_impulse(
&mut self,
wx: f32,
wz: f32,
amplitude: f32,
radius_m: f32,
)
pub fn inject_impulse( &mut self, wx: f32, wz: f32, amplitude: f32, radius_m: f32, )
Injects a smooth radial Gaussian impulse into the wave heightfield.
pub fn step(&mut self, dt: f32)
pub fn step(&mut self, dt: f32)
Steps the 2D wave equation forward by $\Delta t$ seconds.
Uses Courant-Friedrichs-Lewy (CFL) stable finite difference: $h^{n+1}{i,j} = \left[ 2h^n{i,j} - h^{n-1}{i,j} + \alpha (h^n{i+1,j} + h^n_{i-1,j} + h^n_{i,j+1} + h^n_{i,j-1} - 4h^n_{i,j}) \right] \cdot \gamma$ where $\alpha = (c \cdot \Delta t / \Delta x)^2 \le 0.5$.
pub fn sample_height(&self, wx: f32, wz: f32) -> f32
pub fn sample_height(&self, wx: f32, wz: f32) -> f32
Bilinear sampling of the water surface height at arbitrary world coordinates $(wx, wz)$.
pub fn sample_normal(&self, wx: f32, wz: f32) -> [f32; 3]
pub fn sample_normal(&self, wx: f32, wz: f32) -> [f32; 3]
Evaluates the normalized surface normal vector $[nx, ny, nz]$ at arbitrary world coordinates.
Trait Implementations§
§impl Clone for InteractiveRippleBuffer
impl Clone for InteractiveRippleBuffer
§fn clone(&self) -> InteractiveRippleBuffer
fn clone(&self) -> InteractiveRippleBuffer
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more