SFParticleEntity

SFParticleEntity 是支撑稳定流体（SF）烟雾的粒子实体，由 gs.materials.SF.Smoke 材质创建，并由 SF 求解器仿真。

class genesis.engine.entities.sf_entity.SFParticleEntity(scene, solver, material, morph, surface, particle_size, idx, particle_start, name: str | None = None)

Bases: ParticleEntity

PBD-based entity represented solely by particles.

process_input(in_backward=False)

Push position, velocity, and activation target states into the simulator.

Parameters:

in_backward (bool, default=False) – Whether the simulation is in the backward gradient pass.

Returns:

inputs – The inputs applied at this step, of any type, for the simulator to tape.

Return type:

tuple

sample()

Sample particles from the morph based on its type and the specified sampler.

Raises:

GenesisException – If no particles are sampled, or sampled particles lie outside the solver’s domain.

update_particles(particles)