Struct PressureModifier 

pub struct PressureModifier {
    pub config: PressureConfig,
    pub pressure: ScalarField3D,
    pub deformation: ScalarField3D,
    pub enabled: bool,
}

Pressure-driven SDF deformation

Fields

config: PressureConfig

Configuration

pressure: ScalarField3D

Current pressure field (transient)

deformation: ScalarField3D

Accumulated permanent deformation (positive = surface pushed inward)

enabled: bool

Whether modifier is enabled

Implementations

impl PressureModifier

pub fn new( config: PressureConfig, resolution: usize, min: (f32, f32, f32), max: (f32, f32, f32), ) -> Self

Create a new pressure modifier

resolution is clamped to a minimum of 1: ScalarField3D computes its cell size from resolution - 1 and clamps grid reads to resolution - 1, both of which underflow usize for a resolution of 0. Clamping here keeps that invariant instead of deferring a panic to the first call to Self::pressure_at / Self::deformation_at.

pub fn apply_pressure_at( &mut self, x: f32, y: f32, z: f32, force: f32, radius: f32, )

Apply pressure at a point (e.g., from collision contact)

force = contact force magnitude, radius = contact patch radius

pub fn apply_impact( &mut self, x: f32, y: f32, z: f32, impulse: f32, radius: f32, )

Apply impact at a point (immediate dent)

impulse = impact impulse, radius = impact area

pub fn pressure_at(&self, x: f32, y: f32, z: f32) -> f32

Get pressure at a point

pub fn deformation_at(&self, x: f32, y: f32, z: f32) -> f32

Get deformation at a point

impl PressureModifier

pub const PARTICIPANT_KIND: ParticipantKind

Snapshot tag of this type as a world participant: "PRES", the four ASCII bytes read big endian. Never changes.

Trait Implementations

impl Participant for PressureModifier

One update(h) per world substep (h converted with Fix128::to_f32); see the module documentation of crate::sim_modifier for the payload and what is not coupled yet.

Observations: channel 0 the highest cell pressure (absent for a grid without cells), channel 1 the total permanent deformation.

fn kind(&self) -> ParticipantKind

Snapshot tag of this participant type.

fn substep( &mut self, _ctx: &mut SubstepCtx<'_>, h: Fix128, ) -> Result<(), ParticipantFault>

Advance by one world substep of width h (ctx.h()). Read bodies from ctx, stage forces on them through ctx.

fn observe(&self, out: &mut ObservationSink)

Report observable values. The world reports them as Observed::Undecided while a fault is recorded.

fn write_state(&self, out: &mut Vec<u8>)

Append the whole state to out.

fn check_state(&self, bytes: &[u8]) -> Result<(), StateError>

Check that bytes is a payload Self::read_state can apply. Must not change self.

fn read_state(&mut self, bytes: &[u8])

Replace the state with bytes. Only called with a payload Self::check_state accepted.

fn step_rule(&self) -> StepRule

How this participant’s time step relates to the world substep.

fn ports(&self) -> &[Port]

The ports this participant reads and writes, empty by default. The world reads them once, at registration, to fix the execution order (execution_order); they must not change while the participant is registered.

impl PhysicsModifier for PressureModifier

fn modify_distance(&self, x: f32, y: f32, z: f32, original_dist: f32) -> f32

Modify the SDF distance at a world-space point.

fn update(&mut self, dt: f32)

Advance the simulation state by dt seconds.

fn name(&self) -> &'static str

Name of this modifier (for debugging)

fn is_active(&self) -> bool

Whether this modifier has any active effect