Struct PhaseChangeModifier 

pub struct PhaseChangeModifier {
    pub config: PhaseChangeConfig,
    pub temperature: ScalarField3D,
    pub phase: ScalarField3D,
    pub latent_heat: ScalarField3D,
    pub sdf_offset: ScalarField3D,
    pub enabled: bool,
}

Phase-change SDF modifier with solid/liquid/gas transitions

Fields

config: PhaseChangeConfig

Configuration

temperature: ScalarField3D

Temperature field

phase: ScalarField3D

Phase state per cell (stored as f32: 0=Solid, 1=Liquid, 2=Gas)

latent_heat: ScalarField3D

Latent heat buffer (energy absorbed/released during phase transition)

sdf_offset: ScalarField3D

Accumulated SDF offset (positive = material removed)

enabled: bool

Whether modifier is enabled

Implementations

impl PhaseChangeModifier

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

Create a new phase change modifier

pub fn apply_heat_at( &mut self, x: f32, y: f32, z: f32, amount: f32, radius: f32, )

Apply heat at a position

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

Get temperature at a point

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

Get phase at a point

impl PhaseChangeModifier

pub const PARTICIPANT_KIND: ParticipantKind

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

Trait Implementations

impl CoupledScalar for PhaseChangeModifier

The temperature field is shared through a deterministic Fix128 channel.

The counterpart of the impl on crate::thermal::ThermalModifier: the two modifiers hold independent copies of the same physical quantity, and crate::coupled_field::reconcile_mean is what makes a point have one temperature instead of two.

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

Name of the quantity shared, for diagnostics ("temperature", …).

fn coupled_channel(&self) -> Result<CoupledField, CoupledFieldError>

A zero-filled channel on this subsystem’s grid.

fn publish(&self, out: &mut CoupledField) -> Result<(), CoupledFieldError>

Write this subsystem’s field into out.

fn adopt(&mut self, src: &CoupledField) -> Result<(), CoupledFieldError>

Replace this subsystem’s field with the channel’s contents.

fn check_adopt(&self, src: &CoupledField) -> Result<(), CoupledFieldError>

Report, without changing anything, whether Self::adopt would accept src.

impl Participant for PhaseChangeModifier

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 temperature (absent for a grid without cells), channel 1 the number of cells that are not solid (stored phase ≥ 0.5), channel 2 the total SDF offset.

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 PhaseChangeModifier

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